Create a Telegraf configuration
This page documents an earlier version of InfluxDB OSS. InfluxDB 3 Core is the latest stable version.
API token hashing is enabled by default in InfluxDB OSS 2.9.0
Stronger token security: tokens are stored as hashes on disk, so a copy of the database file doesn’t expose usable tokens. Existing tokens are hashed on first startup and the original strings can’t be recovered afterward — capture any plaintext tokens you still need before you upgrade.
For more information, see Token hashing.
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.confCreate a custom Telegraf configuration
- Create a custom Telegraf configuration file that includes the
outputs.influxdb_v2output plugin. See Manually configure Telegraf for more information. - Add and customize Telegraf plugins and save your changes.
- Use the
influx telegrafs createcommand to upload your custom Telegraf configuration to InfluxDB.
Was this page helpful?
Thank you for your feedback!
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for InfluxDB OSS v2 and this documentation. To find support, use the following resources:
Customers with an annual or support contract can contact InfluxData Support.