41 lines
1.3 KiB
Markdown
41 lines
1.3 KiB
Markdown
|
# 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 <!-- @/docs/includes/plugin_config.md -->
|
||
|
|
|
||
|
|
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][CONFIGURATION.md] for more details.
|
||
|
|
|
||
|
|
[CONFIGURATION.md]: ../../../docs/CONFIGURATION.md#plugins
|
||
|
|
|
||
|
|
## Configuration
|
||
|
|
|
||
|
|
```toml @sample.conf
|
||
|
|
# 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
|
||
|
|
|
||
|
|
```diff
|
||
|
|
- 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
|
||
|
|
```
|
||
|
|
|
||
|
|
[unpivot]: /plugins/processors/unpivot/README.md
|