2015-10-26 18:31:21 +00:00
|
|
|
# Datadog Output Plugin
|
|
|
|
|
|
2020-05-06 18:25:21 +00:00
|
|
|
This plugin writes to the [Datadog Metrics API][metrics] and requires an
|
|
|
|
|
`apikey` which can be obtained [here][apikey] for the account.
|
2015-10-26 18:31:21 +00:00
|
|
|
|
|
|
|
|
|
2020-05-06 18:25:21 +00:00
|
|
|
### Configuration
|
|
|
|
|
|
|
|
|
|
```toml
|
|
|
|
|
[[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"
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### 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.
|
|
|
|
|
|
|
|
|
|
[metrics]: https://docs.datadoghq.com/api/v1/metrics/#submit-metrics
|
|
|
|
|
[apikey]: https://app.datadoghq.com/account/settings#api
|
