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.
|
|
|
|
|
|
2022-10-27 03:58:36 +08:00
|
|
|
## 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.
|
|
|
|
|
|
2023-01-12 23:55:21 +08:00
|
|
|
[CONFIGURATION.md]: ../../../docs/CONFIGURATION.md#plugins
|
2022-10-27 03:58:36 +08:00
|
|
|
|
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
|
