History

Sebastian Spaink d67f75e557 docs: Remove warning not to remove go:embed (#11797 ) Co-authored-by: Joshua Powers <powersj@fastmail.com>		2022-09-13 12:47:58 -05:00
..
README.md	feat(x509_cert): add proxy support (#9319 )	2022-06-21 15:50:06 -05:00
datadog.go	docs: Remove warning not to remove go:embed (#11797 )	2022-09-13 12:47:58 -05:00
datadog_test.go	feat: add compression to Datadog Output (#9963 )	2022-01-07 10:38:19 -06:00
sample.conf	docs: Sync sample.conf for recent features (#11348 )	2022-06-22 08:01:56 -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
  # use_system_proxy = false
  # 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.