Documentation

Wavefront output data format

This page documents an earlier version of Telegraf. Telegraf v1.24 is the latest stable version.

The Wavefront serializer formats and outputs data to the Wavefront Data Format.

Configuration

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

  ## Use Strict rules to sanitize metric and tag names from invalid characters
  ## When enabled forward slash (/) and comma (,) will be accpeted
  # wavefront_use_strict = false

  ## point tags to use as the source name for Wavefront (if none found, host will be used)
  # wavefront_source_override = ["hostname", "address", "agent_host", "node_host"]

  ## Data format to output.
  ## Each data format has its own unique set of configuration options, read
  ## more about them here:
  ## https://github.com/influxdata/telegraf/blob/master/docs/DATA_FORMATS_OUTPUT.md
  data_format = "wavefront"

Metrics

A Wavefront metric is equivalent to a single field value in a Telegraf measurement. The Wavefront metric name is: <measurement_name>.<field_name>. If a prefix is specified, it’s honored. Only boolean and numeric metrics are serialized, other metric types generate an error.

Example

The following Telegraf metric:

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

Serializes into the following Wavefront metrics:

"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!


Linux Package Signing Key Rotation

All signed InfluxData Linux packages have been resigned with an updated key. If using Linux, you may need to update your package configuration to continue to download and verify InfluxData software packages.

For more information, see the Linux Package Signing Key Rotation blog post.