History

Joshua Powers 2fc19fa308 chore: correctly spell embed (#11200 )		2022-05-27 07:13:47 -06:00
..
README.md	chore: embed sample configurations into README for outputs (#11182 )	2022-05-25 08:48:59 -06:00
datadog.go	chore: correctly spell embed (#11200 )	2022-05-27 07:13:47 -06:00
datadog_test.go	feat: add compression to Datadog Output (#9963 )	2022-01-07 10:38:19 -06:00
sample.conf	chore(outputs): migrate sample configs into separate files (#11131 )	2022-05-18 11:30:06 -05:00

README.md

Datadog Output Plugin

This plugin writes to the Datadog Metrics API and requires an apikey which can be obtained here for the account.

Configuration

# Configuration for DataDog API to send metrics to.
[[outputs.datadog]]
  ## Datadog API key
  apikey = "my-secret-key"

  ## Connection timeout.
  # timeout = "5s"

  ## Write URL override; useful for debugging.
  # url = "https://app.datadoghq.com/api/v1/series"

  ## Set http_proxy (telegraf uses the system wide proxy settings if it isn't set)
  # http_proxy_url = "http://localhost:8888"

  ## Override the default (none) compression used to send data.
  ## Supports: "zlib", "none"
  # compression = "none"

Metrics

Datadog metric names are formed by joining the Telegraf metric name and the field key with a . character.

Field values are converted to floating point numbers. Strings and floats that cannot be sent over JSON, namely NaN and Inf, are ignored.

We do not send Rate types. Counts are sent as count, with an interval hard-coded to 1. Note that this behavior does not play super-well if running simultaneously with current Datadog agents; they will attempt to change to Rate with interval=10. We prefer this method, however, as it reflects the raw data more accurately.