Documentation

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.

Read more

InfluxDB v3 enhancements and InfluxDB Clustered is now generally available

New capabilities, including faster query performance and management tooling advance the InfluxDB v3 product line. InfluxDB Clustered is now generally available.

InfluxDB v3 performance and features

The InfluxDB v3 product line has seen significant enhancements in query performance and has made new management tooling available. These enhancements include an operational dashboard to monitor the health of your InfluxDB cluster, single sign-on (SSO) support in InfluxDB Cloud Dedicated, and new management APIs for tokens and databases.

Learn about the new v3 enhancements


InfluxDB Clustered general availability

InfluxDB Clustered is now generally available and gives you the power of InfluxDB v3 in your self-managed stack.

Talk to us about InfluxDB Clustered

InfluxDB Cloud powered by TSM