Documentation

Use Telegraf to dual write to InfluxDB

Use Telegraf to write your data simultaneously to multiple InfluxDB instances or clusters. This method, known as “dual writing,” is useful for backing up data to a separate instance or for migrating from other versions of InfluxDB to InfluxDB 3 Core.

The following example configures Telegraf for dual writing to InfluxDB 3 Core and an InfluxDB v2 OSS instance. Specifically, it uses the following:

  • The InfluxDB v2 output plugin twice–the first pointing to InfluxDB 3 Core and the other to an InfluxDB v2 OSS instance.
  • Two different tokens–one for InfluxDB v2 OSS and one for InfluxDB 3 Core. Configure both tokens as environment variables and use string interpolation in your Telegraf configuration file to reference each environment variable.

Sample configuration

# Include any other input, processor, or aggregator plugins that you want to
# include in your configuration.

# Send data to InfluxDB 3 Core
[[outputs.influxdb_v2]]
  ## The InfluxDB 3 Core URL
  urls = ["http://localhost:8181"]
  ## InfluxDB 3 Core authorization token
  token = "${INFLUX_TOKEN}"
  ## For InfluxDB 3 Core, set organization to an empty string
  organization = ""
  ## Destination database to write into
  bucket = "DATABASE_NAME"

# Send data to InfluxDB v2 OSS
[[outputs.influxdb_v2]]
  ## The InfluxDB v2 OSS URL
  urls = ["http://localhost:8086"]
  ## OSS token for authentication
  token = "${INFLUX_TOKEN_OSS}"
  ## Organization is the name of the organization you want to write to.
  organization = "ORG_NAME_OSS"
  ## Destination bucket to write to
  bucket = "BUCKET_NAME_OSS"

Telegraf lets you dual write data to any version of InfluxDB using the influxdb (InfluxDB v1) and influxdb_v2 output plugins. A single Telegraf agent sends identical data sets to all target outputs. You cannot filter data based on the output.

InfluxDB v1 does not support the unsigned integer data type. You can only write unsigned integer field values to InfluxDB v2- and 3-based products.


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

New in InfluxDB 3.4

Key enhancements in InfluxDB 3.4 and the InfluxDB 3 Explorer 1.2.

See the Blog Post

InfluxDB 3.4 is now available for both Core and Enterprise, which introduces offline token generation for use in automated deployments and configurable license type selection that lets you bypass the interactive license prompt. InfluxDB 3 Explorer 1.2 is also available, which includes InfluxDB cache management and other new features.

For more information, check out: