telegraf/plugins/outputs/influxdb/README.md

71 lines
2.4 KiB
Markdown
Raw Normal View History

# InfluxDB Output Plugin
This InfluxDB output plugin writes metrics to the [InfluxDB](https://github.com/influxdata/influxdb) HTTP or UDP service.
2016-08-09 06:50:35 +00:00
### Configuration:
```toml
# Configuration for sending metrics to InfluxDB
2016-08-09 06:50:35 +00:00
[[outputs.influxdb]]
## The full HTTP or UDP URL for your InfluxDB instance.
##
## Multiple URLs can be specified for a single cluster, only ONE of the
## urls will be written to each interval.
# urls = ["unix:///var/run/influxdb.sock"]
# urls = ["udp://127.0.0.1:8089"]
# urls = ["http://127.0.0.1:8086"]
## The target database for metrics; will be created as needed.
# database = "telegraf"
2016-08-09 06:50:35 +00:00
## If true, no CREATE DATABASE queries will be sent. Set to true when using
## Telegraf with a user without permissions to create databases or when the
## database already exists.
# skip_database_creation = false
## Name of existing retention policy to write to. Empty string writes to
## the default retention policy. Only takes effect when using HTTP.
# retention_policy = ""
## Write consistency (clusters only), can be: "any", "one", "quorum", "all".
## Only takes effect when using HTTP.
# write_consistency = "any"
## Timeout for HTTP messages.
# timeout = "5s"
2016-08-09 06:50:35 +00:00
## HTTP Basic Auth
2016-08-09 06:50:35 +00:00
# username = "telegraf"
# password = "metricsmetricsmetricsmetrics"
## HTTP User-Agent
2016-08-09 06:50:35 +00:00
# user_agent = "telegraf"
## UDP payload size is the maximum packet size to send.
2016-08-09 06:50:35 +00:00
# udp_payload = 512
2018-05-04 23:33:23 +00:00
## Optional TLS Config for use on HTTP connections.
# 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
2016-08-09 06:50:35 +00:00
# insecure_skip_verify = false
## HTTP Proxy override, if unset values the standard proxy environment
## variables are consulted to determine which proxy, if any, should be used.
# http_proxy = "http://corporate.proxy:3128"
## Additional HTTP headers
# http_headers = {"X-Special-Header" = "Special-Value"}
## HTTP Content-Encoding for write request body, can be set to "gzip" to
## compress body or "identity" to apply no encoding.
# content_encoding = "identity"
## When true, Telegraf will output unsigned integers as unsigned values,
## i.e.: "42u". You will need a version of InfluxDB supporting unsigned
## integer values. Enabling this option will result in field type errors if
## existing data has been written.
# influx_uint_support = false
2016-08-09 06:50:35 +00:00
```