2015-10-27 02:31:21 +08:00
|
|
|
# Datadog Output Plugin
|
|
|
|
|
|
2020-05-07 02:25:21 +08: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-27 02:31:21 +08:00
|
|
|
|
|
|
|
|
|
2020-05-07 02:25:21 +08: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"
|
2021-06-02 05:18:31 +08:00
|
|
|
|
|
|
|
|
## Set http_proxy (telegraf uses the system wide proxy settings if it isn't set)
|
|
|
|
|
# http_proxy_url = "http://localhost:8888"
|
2020-05-07 02:25:21 +08:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### 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
|
