Configure Telegraf for InfluxDB

Limited availability

InfluxDB Clustered is currently only available to a limited group of InfluxData customers. If interested in being part of the limited access group, please contact the InfluxData Sales team.

Use the Telegraf influxdb_v2 output plugin to collect and write metrics to InfluxDB Clustered. Learn how to enable the plugin in new and existing Telegraf configurations, and then start Telegraf using the custom configuration file.

View the requirements for using Telegraf with InfluxDB Clustered.

Configure Telegraf input and output plugins

Configure Telegraf input and output plugins in the Telegraf configuration file (typically named telegraf.conf). Input plugins collect metrics. Output plugins define destinations where metrics are sent.

This guide assumes you followed Setup instructions in the Get Started tutorial to set up InfluxDB and configure authentication credentials.

Add Telegraf plugins

To add any of the available Telegraf plugins, follow the steps below.

  1. Find the plugin you want to enable from the complete list of available Telegraf plugins.
  2. Click View to the right of the plugin name to open the plugin page on GitHub. For example, view the MQTT plugin GitHub page.
  3. Copy and paste the example configuration into your Telegraf configuration file (typically named telegraf.conf).

Enable and configure the InfluxDB v2 output plugin

To send data to InfluxDB Clustered, enable the influxdb_v2 output plugin in the telegraf.conf.

  urls = [""]
  # INFLUX_TOKEN is an environment variable you created for your database WRITE token

  token = "${INFLUX_TOKEN}"
  organization = ""
  bucket = "

Replace the following:

  • DATABASE_NAME: the name of the InfluxDB database to write data to

The InfluxDB output plugin configuration contains the following options:


An array of URL strings. To write to InfluxDB Clustered, include your InfluxDB cluster URL using the HTTPS protocol:


Your InfluxDB Clustered database token with write permission to the database.

In the examples, INFLUX_TOKEN is an environment variable assigned to a database token that has write permission to the database.


For InfluxDB Clustered, set this to an empty string ("").


The name of the InfluxDB Clustered database to write data to.

Write to InfluxDB v1.x and InfluxDB Clustered

If a Telegraf agent is already writing to an InfluxDB v1.x database, enabling the InfluxDB v2 output plugin will write data to both v1.x and your InfluxDB cluster.

Other Telegraf configuration options

influx_uint_support: supported in InfluxDB v3.

For more plugin options, see influxdb on GitHub.

Start Telegraf

Start the Telegraf service using the --config flag to specify the location of your telegraf.conf.

telegraf --config /path/to/custom/telegraf.conf

Was this page helpful?

Thank you for your feedback!

The future of Flux

Flux is going into maintenance mode. You can continue using it as you currently are without any changes to your code.

Flux is going into maintenance mode and will not be supported in InfluxDB 3.0. This was a decision based on the broad demand for SQL and the continued growth and adoption of InfluxQL. We are continuing to support Flux for users in 1.x and 2.x so you can continue using it with no changes to your code. If you are interested in transitioning to InfluxDB 3.0 and want to future-proof your code, we suggest using InfluxQL.

For information about the future of Flux, see the following: