Use Telegraf to write data
InfluxDB 3 Enterprise is in Public Alpha
InfluxDB 3 Enterprise is in public alpha and available for testing and feedback, but is not meant for production use. Both the product and this documentation are works in progress. We welcome and encourage your input about your experience with the alpha 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 Enterprise and
write metrics collected by Telegraf to InfluxDB 3 Enterprise.
# ...
[[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 Enterprise authorization token. Store this in a secret store or environment variable to avoid exposing the raw token string.While in alpha, InfluxDB 3 Enterprise does not require an authorization token. For the
token
option, provide an arbitrary, non-empty token string.
See how to Configure Telegraf to write to InfluxDB 3 Enterprise.
Use Telegraf with InfluxDB
Configure Telegraf to write to InfluxDB 3 Enterprise
Update existing or create new Telegraf configurations to use the influxdb_v2
output plugin to write to InfluxDB 3 Enterprise. 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 Enterprise.
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 Enterprise and this documentation. To find support, use the following resources:
Customers with an annual or support contract can contact InfluxData Support.