dom

telegraf

History

Cameron Sparr 10d0a78b96 influxdb output: treat field type conflicts as a successful write If we write a batch of points and get a "field type conflict" error message in return, we should drop the entire batch of points because this indicates that one or more points have a type that doesnt match the database. These errors will never go away on their own, and InfluxDB will successfully write the points that dont have a conflict. closes #2245		2017-01-23 18:26:37 -08:00
..
README.md	Fix typo of 'quorom' to 'quorum' when specifying write consistency. (#1618 )	2016-08-10 17:51:21 +01:00
influxdb.go	influxdb output: treat field type conflicts as a successful write	2017-01-23 18:26:37 -08:00
influxdb_test.go	Throughout telegraf, use telegraf.Metric rather than client.Point	2016-01-27 23:47:32 -07:00

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 endpoint 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://localhost:8089"] # UDP endpoint example
  urls = ["http://localhost:8086"] # required
  ## The target database for metrics (telegraf will create it if not exists).
  database = "telegraf" # required

  ## Retention policy to write to. Empty string writes to the default rp.
  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

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 either http:// or udp://
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: Retention policy to write to.
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 influxdb
password: Password for influxdb
user_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 CA
ssl_cert: SSL CERT
ssl_key: SSL key
insecure_skip_verify: Use SSL but skip chain & host verification (default: false)