History

Joshua Powers 49ac03fa80 docs: add global configuration header (#12107 )		2022-10-26 14:58:36 -05:00
..
README.md	docs: add global configuration header (#12107 )	2022-10-26 14:58:36 -05:00
sample.conf	chore(processors): migrate sample configs into separate files (#11125 )	2022-05-18 11:29:43 -05:00
unpivot.go	docs: Remove warning not to remove go:embed (#11797 )	2022-09-13 12:47:58 -05:00
unpivot_test.go	Add pivot and unpivot processors (#5991 )	2019-06-14 15:26:56 -07:00

README.md

Unpivot Processor Plugin

You can use the unpivot processor to rotate a multi field series into single valued metrics. This transformation often results in data that is more easy to aggregate across fields.

To perform the reverse operation use the pivot processor.

Global configuration options

In addition to the plugin-specific configuration settings, plugins support additional global and plugin configuration settings. These settings are used to modify metrics, tags, and field or create aliases and configure ordering, etc. See the CONFIGURATION.md for more details.

Configuration

# Rotate multi field metric into several single field metrics
[[processors.unpivot]]
  ## Tag to use for the name.
  tag_key = "name"
  ## Field to use for the name of the value.
  value_key = "value"

Example

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