.. _datadog_metrics_sink_connector_config:


Datadog Metrics Sink Connector Configuration Properties
-------------------------------------------------------

To use this connector, specify the name of the connector class in the ``connector.class``
configuration property.

.. codewithvars:: properties

    connector.class=io.confluent.connect.datadog.metrics.DatadogMetricsSinkConnector

Connector-specific configuration properties are described below.


Credentials
^^^^^^^^^^^

``datadog.api.key``
  An API key is used to log all requests made to the Datadog API.

  * Type: String
  * Importance: HIGH


Datadog
^^^^^^^

``datadog.domain``
  This configuration is used to identify the location of your Datadog service.
  It is used in URL while establishing connection or sending data to API.
  It can only be either ``COM`` or ``EU``.

  * Type: String
  * Importance: HIGH


General
^^^^^^^

``behavior.on.error``
  Error handling behavior setting. Must be configured to one of the following:

  ``fail``

  Stops the connector when an error occurs while preparing metrics from Kafka records or pushing it to Datadog.

  ``ignore``

  Continues to process next set of records. when an error occurs while preparing metrics from Kafka records or pushing it to Datadog.

  ``log``

  Logs the error message when an error occurs while preparing metrics from Kafka records or pushing it to Datadog, continues to process next set of records, available in ``${connector-name}-error`` topic.

  * Type: string
  * Default: FAIL
  * Valid Values: one of [log, ignore, fail]
  * Importance: medium

``max.retry.time.seconds``
  In case or error while executing post request, connector will retry until the time (in seconds) elapses.

  * Type: Int
  * Importance: Low
  * Default Value: 10
  * Valid Values: [0,…]


|kconnect| Reporter
^^^^^^^^^^^^^^^^^^^

.. include:: ../includes/reporter-more-about.rst

.. include:: ../includes/connect-reporter-configs.rst

Proxy
^^^^^

``datadog.proxy.url``
  Proxy URL if needed. format: protocol:Host:port for e.g. https://localhost:port.

  * Type: String
  * Importance: Low

``datadog.proxy.user``
  Proxy username for authentication of proxy.

  * Type: String
  * Importance: Low

``datadog.proxy.password``
  Proxy username for authentication of proxy.

  * Type: String
  * Importance: Low


.. _datadog_metrics_sink_connector_license_config:

|cp| license
^^^^^^^^^^^^

``confluent.topic.bootstrap.servers`` A list of host/port pairs to use for
establishing the initial connection to the Kafka cluster used for licensing. All
servers in the cluster will be discovered from the initial connection. This list
should be in the form ``host1:port1,host2:port2,...``. Because these
servers are just used for the initial connection to discover the full cluster
membership that may change dynamically, this list need not contain the full set
of servers. You may want more than one in case a server is down.

* Type: list
* Importance: high

``confluent.topic``
Name of the Kafka topic used for |cp| configuration, including licensing information.

* Type: string
* Default: _confluent-command
* Importance: low

``confluent.topic.replication.factor`` The replication factor for the |ak| topic
used for |cp| configuration, including licensing information. This is used only
if the topic does not already exist, and the default of 3 is appropriate for
production use. If you are using a development environment with less than 3
brokers, you must set this to the number of brokers (typically 1).

* Type: int
* Default: 3
* Importance: low

----------------------------
Confluent license properties
----------------------------

.. include:: ../includes/security-info.rst

.. include:: ../includes/platform-license.rst

.. include:: ../includes/security-configs.rst

.. _datadog_metrics_sink_license_topic_configuration:

.. include:: ../includes/platform-license-detail.rst

.. include:: ../includes/platform-license-acl.rst

.. include:: ../includes/overriding-default-config-properties.rst