Use Telegraf to write data
Telegraf is InfluxData’s data collection agent for collecting and reporting metrics. Its vast library of input plugins and “plug-and-play” architecture lets you quickly and easily collect metrics from many different sources.
For a list of available plugins, see Telegraf plugins.
Requirements
- Telegraf 1.9.2 or greater. For information about installing Telegraf, see the Telegraf Installation instructions.
Basic Telegraf usage
Telegraf is a plugin-based agent with plugins are that enabled and configured in
your Telegraf configuration file (telegraf.conf
).
Each Telegraf configuration must have at least one input plugin and one output plugin.
Telegraf input plugins retrieve metrics from different sources. Telegraf output plugins write those metrics to a destination.
Use the outputs.influxdb_v2
to write metrics collected by Telegraf to InfluxDB.
# ...
[[outputs.influxdb_v2]]
urls = ["http://localhost:8086"]
token = "${INFLUX_TOKEN}"
organization = "ORG_ID"
bucket = "BUCKET_NAME"
# ...
Replace the following:
ORG_ID
: your InfluxDB Serverless organization ID.BUCKET_NAME
: the name of the bucket to write to.
In the example, INFLUX_TOKEN
is an environment variable assigned to an InfluxDB API token with write permission to the bucket.
For more information, see Manually configure Telegraf.
Use Telegraf with InfluxDB
Configure Telegraf for InfluxDB
Telegraf is a plugin-based agent with plugins are that enabled and configured in your Telegraf configuration file (telegraf.conf
). Learn how to create Telegraf configuration files that work with InfluxDB.
Manage Telegraf configurations
InfluxDB Cloud Serverless lets you automatically generate Telegraf configurations or upload customized Telegraf configurations that collect metrics and write them to InfluxDB Cloud Serverless.
Dual write to InfluxDB OSS and InfluxDB Cloud
Configure Telegraf to write data to both InfluxDB OSS and InfluxDB Cloud Serverless simultaneously.
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 and this documentation. To find support, use the following resources:
InfluxDB Cloud and InfluxDB Enterprise customers can contact InfluxData Support.