2022-06-07 07:04:28 +08:00
|
|
|
# Unpivot Processor Plugin
|
2019-06-15 06:26:56 +08:00
|
|
|
|
2022-06-07 07:04:28 +08:00
|
|
|
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.
|
2019-06-15 06:26:56 +08:00
|
|
|
|
|
|
|
|
To perform the reverse operation use the [pivot] processor.
|
|
|
|
|
|
2021-11-25 02:47:11 +08:00
|
|
|
## Configuration
|
2019-06-15 06:26:56 +08:00
|
|
|
|
2022-05-25 22:59:41 +08:00
|
|
|
```toml @sample.conf
|
2022-04-07 04:49:41 +08:00
|
|
|
# Rotate multi field metric into several single field metrics
|
2019-06-15 06:26:56 +08:00
|
|
|
[[processors.unpivot]]
|
|
|
|
|
## Tag to use for the name.
|
|
|
|
|
tag_key = "name"
|
|
|
|
|
## Field to use for the name of the value.
|
|
|
|
|
value_key = "value"
|
|
|
|
|
```
|
|
|
|
|
|
2021-11-25 02:47:11 +08:00
|
|
|
## Example
|
2019-06-15 06:26:56 +08:00
|
|
|
|
|
|
|
|
```diff
|
|
|
|
|
- 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
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
[pivot]: /plugins/processors/pivot/README.md
|
