History

Eng Zer Jun 81090be35d refactor: replace strings.Replace with strings.ReplaceAll (#11079 )		2022-05-11 09:53:34 -06:00
..
README.md	fix: datadog count metrics (#10979 )	2022-04-27 17:04:34 -05:00
datadog.go	refactor: replace strings.Replace with strings.ReplaceAll (#11079 )	2022-05-11 09:53:34 -06:00
datadog_sample_config.go	feat: migrate output plugins to new sample config format (#10910 )	2022-04-07 15:55:03 -06:00
datadog_test.go	feat: add compression to Datadog Output (#9963 )	2022-01-07 10:38:19 -06: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.