telegraf/plugins/outputs/warp10/README.md

51 lines
1.4 KiB
Markdown
Raw Normal View History

# Warp10 Output Plugin
2020-01-09 19:29:16 +00:00
The `warp10` output plugin writes metrics to [Warp 10][].
2020-01-09 19:29:16 +00:00
### Configuration
2020-01-09 19:29:16 +00:00
```toml
[[outputs.warp10]]
# Prefix to add to the measurement.
prefix = "telegraf."
2020-01-09 19:29:16 +00:00
# URL of the Warp 10 server
warp_url = "http://localhost:8080"
2020-01-09 19:29:16 +00:00
# Write token to access your app on warp 10
token = "Token"
2020-01-09 19:29:16 +00:00
# Warp 10 query timeout
# timeout = "15s"
2020-01-09 19:29:16 +00:00
## Print Warp 10 error body
# print_error_body = false
2020-01-09 19:29:16 +00:00
## Max string error size
# max_string_error_size = 511
## Optional TLS Config
# tls_ca = "/etc/telegraf/ca.pem"
# tls_cert = "/etc/telegraf/cert.pem"
# tls_key = "/etc/telegraf/key.pem"
## Use TLS but skip chain & host verification
# insecure_skip_verify = false
2020-01-09 19:29:16 +00:00
```
### Output Format
Metrics are converted and sent using the [Geo Time Series][] (GTS) input format.
The class name of the reading is produced by combining the value of the
`prefix` option, the measurement name, and the field key. A dot (`.`)
character is used as the joining character.
The GTS form provides support for the Telegraf integer, float, boolean, and
string types directly. Unsigned integer fields will be capped to the largest
64-bit integer (2^63-1) in case of overflow.
Timestamps are sent in microsecond precision.
2020-01-09 19:29:16 +00:00
[Warp 10]: https://www.warp10.io
[Geo Time Series]: https://www.warp10.io/content/03_Documentation/03_Interacting_with_Warp_10/03_Ingesting_data/02_GTS_input_format