pivot

README

Pivot Processor Plugin

You can use the pivot processor to rotate single valued metrics into a multi field metric. This transformation often results in data that is more easily to apply mathematical operators and comparisons between, and flatten into a more compact representation for write operations with some output data formats.

To perform the reverse operation use the unpivot 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 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

Documentation

Index

• type Pivot
  • func (p *Pivot) Apply(metrics ...telegraf.Metric) []telegraf.Metric
  • func (*Pivot) SampleConfig() string

Types

type Pivot

type Pivot struct {
	TagKey   string `toml:"tag_key"`
	ValueKey string `toml:"value_key"`
}

func (*Pivot) Apply

func (p *Pivot) Apply(metrics ...telegraf.Metric) []telegraf.Metric

func (*Pivot) SampleConfig

func (*Pivot) SampleConfig() string