Use Telegraf to write data
InfluxDB 3 Core is in Public Beta
InfluxDB 3 Core is in public beta and available for testing and feedback, but is not meant for production use yet. Both the product and this documentation are works in progress. We welcome and encourage your input about your experience with the beta and invite you to join our public channels for updates and to share feedback.
Telegraf is a 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 that are 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 plugin
to connect to the InfluxDB v2 write API included in InfluxDB 3 Core and
write metrics collected by Telegraf to InfluxDB 3 Core.
# ...
[[outputs.influxdb_v2]]
urls = ["http://localhost:8181"]
token = "AUTH_TOKEN"
organization = ""
bucket = "DATABASE_NAME"
# ...
Replace the following:
DATABASE_NAME: the name of the database to write data toAUTH_TOKEN: your InfluxDB 3 Core authorization token. Store this in a secret store or environment variable to avoid exposing the raw token string.While in beta, InfluxDB 3 Core does not require an authorization token. For the
tokenoption, provide an arbitrary, non-empty token string.
See how to Configure Telegraf to write to InfluxDB 3 Core.
Use Telegraf with InfluxDB
Configure Telegraf to write to InfluxDB 3 Core
Update existing or create new Telegraf configurations to use the influxdb_v2 output plugin to write to InfluxDB 3 Core. Start Telegraf using the custom configuration.
Use Telegraf to dual write to InfluxDB
Configure Telegraf to write data to multiple InfluxDB instances or clusters simultaneously.
Use Telegraf to write CSV data
Use the Telegraf file input plugin to read and parse CSV data into line protocol and write it to InfluxDB 3 Core.
Data Collection with Telegraf
Learn how to use Telegraf to make data time series data collection easy in this free InfluxDB University course.
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 3 Core and this documentation. To find support, use the following resources:
Customers with an annual or support contract can contact InfluxData Support.