VictoriaMetrics/docs/data-ingestion/Telegraf.md
Mathias Palmersheim e65265d2ac
docs: add vmagent and alloy data ingestion docs (#6678)
Adds Prometheus Grafana Alloy and vmagent to the data ingestion
protocols. Grafana Agent was not added since it has been deprecated in
favor of alloy

Signed-off-by: hagen1778 <roman@victoriametrics.com>
Co-authored-by: Roman Khavronenko <roman@victoriametrics.com>
(cherry picked from commit a46d554f74)
2024-08-06 16:30:10 +02:00

3.7 KiB

title weight sort menu aliases
Telegraf 5 5
docs
identifier parent weight
telegraf data-ingestion 5
/data-ingestion/telegraf.html
/data-ingestion/Telegraf.html

You will need to add the following output section to a Telegraf configuration file and reload Telegraf to enable shipping data from Telegraf to VictoriaMetrics. All the options examples below can be combined to fit your use case

To avoid storing Passwords in configuration files you can store as a key value pair in /etc/default/telegraf on Linux as follows

victoriametrics_url="https://metrics.example.com"
victoriametrics_user="telegraf"
victoriametrics_password="password"
victoriametrics_token="my_token"

and they can be referenced in a Telegraf configuration file by prepending the variable name with $ ex. $victoriametrics_url will be translated to https://metrics.example.com if it is referenced in a Telegraf configuration using the values from /etc/default/telegraf in the values seen above. Otherwise, please replace the variables below to fit your setup.

If you want to mimic this behavior on Windows please read Influx Data's blog on storing variables in the registry

Minimum Configuration with no Authentication

[[outputs.influxdb]]
  urls = ["$victoriametrics_url"]
  database = "victoriametrics"
  skip_database_creation = true
  exclude_retention_policy_tag = true
  content_encoding = "gzip"

HTTP Basic Authentication (Username and Password)

This is the same as the minimum configuration, but adds the username and password options

[[outputs.influxdb]]
  urls = ["$victoriametrics_url"]
  username = "$victoriametrics_user"
  password = "$victoriametrics_password"
  database = "victoriametrics"
  skip_database_creation = true
  exclude_retention_policy_tag = true
  content_encoding = "gzip"

Bearer Authentication (Token)

This is the same as the minimum configuration but adds the authorization header

[[outputs.influxdb]]
  urls = ["$victoriametrics_url"]
  http_headers = {"Authorization" = "Bearer $victoriametrics_token"}
  database = "victoriametrics"
  skip_database_creation = true
  exclude_retention_policy_tag = true
  content_encoding = "gzip"

Route certain metrics

If you only want to route certain metrics to VictoriaMetrics use the namepass option with a comma separated list of the measurements you wish to send to VictoriaMetrics.

[[outputs.influxdb]]
  urls = ["$victoriametrics_url"]
  username = "$victoriametrics_user"
  password = "$victoriametrics_password"
  database = "victoriametrics"
  skip_database_creation = true
  exclude_retention_policy_tag = true
  content_encoding = "gzip"
  namepass = ["cpu","disk","measurement1","measurement2"]

Ignore TLS/SSL Certificate errors

This is the same as the minimum configuration but adds insecure_skip_verify = true to the configuration to ignore TLS certificate errors. This is not recommended since it can allow sending metrics to a compromised site.

[[outputs.influxdb]]
  urls = ["$victoriametrics_url"]
  username = "$victoriametrics_user"
  password = "$victoriametrics_password"
  database = "victoriametrics"
  skip_database_creation = true
  exclude_retention_policy_tag = true
  content_encoding = "gzip"
  insecure_skip_verify = true

References