Create a Telegraf configuration

Telegraf has an extensive list of plugins for many different technologies and use cases. Not all plugins are available through the InfluxDB UI, but you can create and upload custom Telegraf configurations to include any of the available Telegraf plugins.

Use the InfluxDB user interface (UI) or the influx CLI to create a Telegraf configuration.

To create a Telegraf configuration, do one of the following:

Use the InfluxDB UI

Use the InfluxDB UI to automatically generate and store new Telegraf configurations in InfluxDB. Creating the configuration in the UI lets you select from a list of available technologies and generates a Telegraf configuration to collect metrics from those technologies. For more information, see Automatically configure Telegraf.

Use the influx CLI

Use the influx telegrafs create command to upload a Telegraf configuration file from your local machine and create a new Telegraf configuration in InfluxDB.

Provide the following:

  • Telegraf configuration name
  • Telegraf configuration description
  • Telegraf configuration file

If a name and description are not provided, they are set to empty strings.

# Syntax
influx telegrafs create \
  -n <telegraf-config-name> \
  -d <telegraf-config-description> \
  -f /path/to/telegraf.conf

# Example
influx telegrafs create \
  -n "Example Telegraf config"
  -d "This is a description for an example Telegraf configuration."
  -f /path/to/telegraf.conf

Create a custom Telegraf configuration

  1. Create a custom Telegraf configuration file that includes the outputs.influxdb_v2 output plugin. See Manually configure Telegraf for more information.
  2. Add and customize Telegraf plugins and save your changes.
  3. Use the influx telegrafs create command to upload your custom Telegraf configuration to InfluxDB.

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: