Documentation

Use Telegraf to write data

InfluxDB 3 Core is in Public Alpha

InfluxDB 3 Core 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.

Alpha expectations and recommendations

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

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 to

  • AUTH_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 alpha, InfluxDB 3 Core 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 Core.

Use Telegraf with 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 3 Open Source Now in Public Alpha

InfluxDB 3 Open Source is now available for alpha testing, licensed under MIT or Apache 2 licensing.

We are releasing two products as part of the alpha.

InfluxDB 3 Core, is our new open source product. It is a recent-data engine for time series and event data. InfluxDB 3 Enterprise is a commercial version that builds on Core’s foundation, adding historical query capability, read replicas, high availability, scalability, and fine-grained security.

For more information on how to get started, check out: