Documentation

Wavefront output data format

Use the wavefront output data format (serializer) to convert Telegraf metrics into the Wavefront Data Format.

Configuration

[[outputs.file]]
  files = ["stdout"]

  ## Data format to output.
  data_format = "wavefront"

  ## Use strict rules to sanitize metric and tag names.
  ## When enabled, forward slash (/) and comma (,) are accepted.
  # wavefront_use_strict = false

  ## Point tags to use as the source name for Wavefront.
  ## If none found, "host" is used.
  # wavefront_source_override = ["hostname", "address", "agent_host", "node_host"]

  ## Disable prefix path conversion.
  ## Default behavior (enabled): prod.prefix.name.metric.name
  ## Disabled behavior: prod.prefix_name.metric_name
  # wavefront_disable_prefix_conversion = false

Configuration options

OptionTypeDefaultDescription
wavefront_use_strictbooleanfalseUse strict sanitization rules
wavefront_source_overridearray[]Tags to use as source name
wavefront_disable_prefix_conversionbooleanfalseDisable path-style prefix conversion

Metrics

A Wavefront metric equals a single field value of a Telegraf measurement. The metric name format is: <measurement_name>.<field_name>

Only boolean and numeric fields are serialized. Other types generate an error.

Example

Input metric:

cpu,cpu=cpu0,host=testHost user=12,idle=88,system=0 1234567890

Output (Wavefront format):

"cpu.user" 12.000000 1234567890 source="testHost" "cpu"="cpu0"
"cpu.idle" 88.000000 1234567890 source="testHost" "cpu"="cpu0"
"cpu.system" 0.000000 1234567890 source="testHost" "cpu"="cpu0"

Was this page helpful?

Thank you for your feedback!


InfluxDB 3.9: Performance upgrade preview

InfluxDB 3 Enterprise 3.9 includes a beta of major performance upgrades with faster single-series queries, wide-and-sparse table support, and more.

InfluxDB 3 Enterprise 3.9 includes a beta of major performance and feature updates.

Key improvements:

  • Faster single-series queries
  • Consistent resource usage
  • Wide-and-sparse table support
  • Automatic distinct value caches for reduced latency with metadata queries

Preview features are subject to breaking changes.

For more information, see:

Telegraf Enterprise now in public beta

Get early access to the Telegraf Controller and provide feedback to help shape the future of Telegraf Enterprise.

See the Blog Post

The upcoming Telegraf Enterprise offering is for organizations running Telegraf at scale and is comprised of two key components:

  • Telegraf Controller: A control plane (UI + API) that centralizes Telegraf configuration management and agent health visibility.
  • Telegraf Enterprise Support: Official support for Telegraf Controller and Telegraf plugins.

Join the Telegraf Enterprise beta to get early access to the Telegraf Controller and provide feedback to help shape the future of Telegraf Enterprise.

For more information:

InfluxDB Docker latest tag changing to InfluxDB 3 Core

On May 27, 2026, the latest tag for InfluxDB Docker images will point to InfluxDB 3 Core. To avoid unexpected upgrades, use specific version tags in your Docker deployments.

If using Docker to install and run InfluxDB, the latest tag will point to InfluxDB 3 Core. To avoid unexpected upgrades, use specific version tags in your Docker deployments. For example, if using Docker to run InfluxDB v2, replace the latest version tag with a specific version tag in your Docker pull command–for example:

docker pull influxdb:2