Influxdata
/
docs-v2
mirror of https://github.com/influxdata/docs-v2.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
docs-v2/content/telegraf/v1/processor-plugins/pivot/_index.md

1.7 KiB
Raw Permalink Blame History

description menu tags introduced os_support related
Telegraf plugin for transforming metrics using Pivot
telegraf_v1_ref
parent name identifier
processor_plugins_reference Pivot processor-pivot
Pivot
processor-plugins
configuration
transformation
v1.12.0 freebsd, linux, macos, solaris, windows
/telegraf/v1/configure_plugins/
https://github.com/influxdata/telegraf/tree/v1.38.0/plugins/processors/pivot/README.md, Pivot Plugin Source

Pivot Processor Plugin

This plugin rotates single-valued metrics into a multi-field metric. The result is a more compact representation for applying mathematical operators to or do comparisons between metrics or flatten fields.

[!TIP] To perform the reverse operation use the unpivot processor.

Introduced in: Telegraf v1.12.0 Tags: transformation OS support: all

Global configuration options

Plugins support additional global and plugin configuration settings for tasks such as modifying metrics, tags, and fields, creating aliases, and configuring plugin ordering. See CONFIGURATION.md for more details.

Configuration

# Rotate a single valued metric into a multi field metric
[[processors.pivot]]
  ## Tag to use for naming the new field.
  tag_key = "name"
  ## Field to use as the value of the new field.
  value_key = "value"

Example

- cpu,cpu=cpu0,name=time_idle value=42i
- cpu,cpu=cpu0,name=time_user value=43i
+ cpu,cpu=cpu0 time_idle=42i
+ cpu,cpu=cpu0 time_user=43i