4f7afb8cb5 | ||
---|---|---|
.. | ||
client | ||
README.md | ||
influxdb.go | ||
influxdb_test.go |
README.md
InfluxDB Output Plugin
This plugin writes to InfluxDB via HTTP or UDP.
Configuration:
# Configuration for influxdb server to send metrics to
[[outputs.influxdb]]
## The full HTTP or UDP URL for your InfluxDB instance.
##
## Multiple urls can be specified as part of the same cluster,
## this means that only ONE of the urls will be written to each interval.
# urls = ["udp://127.0.0.1:8089"] # UDP endpoint example
urls = ["http://127.0.0.1:8086"] # required
## The target database for metrics (telegraf will create it if not exists).
database = "telegraf" # required
## Name of existing retention policy to write to. Empty string writes to
## the default retention policy.
retention_policy = ""
## Write consistency (clusters only), can be: "any", "one", "quorum", "all"
write_consistency = "any"
## Write timeout (for the InfluxDB client), formatted as a string.
## If not provided, will default to 5s. 0s means no timeout (not recommended).
timeout = "5s"
# username = "telegraf"
# password = "metricsmetricsmetricsmetrics"
## Set the user agent for HTTP POSTs (can be useful for log differentiation)
# user_agent = "telegraf"
## Set UDP payload size, defaults to InfluxDB UDP Client default (512 bytes)
# udp_payload = 512
## Optional SSL Config
# ssl_ca = "/etc/telegraf/ca.pem"
# ssl_cert = "/etc/telegraf/cert.pem"
# ssl_key = "/etc/telegraf/key.pem"
## Use SSL but skip chain & host verification
# insecure_skip_verify = false
## HTTP Proxy Config
# http_proxy = "http://corporate.proxy:3128"
## Optional HTTP headers
# http_headers = {"X-Special-Header" = "Special-Value"}
## Compress each HTTP request payload using GZIP.
# content_encoding = "gzip"
Required parameters:
urls
: List of strings, this is for InfluxDB clustering support. On each flush interval, Telegraf will randomly choose one of the urls to write to. Each URL should start with eitherhttp://
orudp://
database
: The name of the database to write to.
Optional parameters:
write_consistency
: Write consistency (clusters only), can be: "any", "one", "quorum", "all".retention_policy
: Name of existing retention policy to write to. Empty string writes to the default retention policy.timeout
: Write timeout (for the InfluxDB client), formatted as a string. If not provided, will default to 5s. 0s means no timeout (not recommended).username
: Username for influxdbpassword
: Password for influxdbuser_agent
: Set the user agent for HTTP POSTs (can be useful for log differentiation)udp_payload
: Set UDP payload size, defaults to InfluxDB UDP Client default (512 bytes)ssl_ca
: SSL CAssl_cert
: SSL CERTssl_key
: SSL keyinsecure_skip_verify
: Use SSL but skip chain & host verification (default: false)http_proxy
: HTTP Proxy URIhttp_headers
: HTTP headers to add to each HTTP requestcontent_encoding
: Compress each HTTP request payload using gzip if set to: "gzip"