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.

Clone an existing Telegraf configuration

Use the InfluxDB user interface (UI) to clone a Telegraf configuration.

  1. In the navigation menu on the left, select Data (Load Data) > Telegraf.

  2. Hover over the configuration you want to clone, click the icon, and then click Clone. The clone appears in your list of Telegraf configurations.

Was this page helpful?

Thank you for your feedback!

Introducing InfluxDB 3.0

The new core of InfluxDB built with Rust and Apache Arrow. Available today in InfluxDB Cloud Dedicated.

Learn more

State of the InfluxDB Cloud Serverless documentation

The new documentation for InfluxDB Cloud Serverless is a work in progress. We are adding new information and content almost daily. Thank you for your patience!

If there is specific information you’re looking for, please submit a documentation issue.

InfluxDB Cloud Serverless powered by IOx