77 lines
2.3 KiB
Markdown
77 lines
2.3 KiB
Markdown
|
# Scale Processor Plugin
|
||
|
|
|
||
|
|
The scale processor filters for a set of fields,
|
||
|
|
and scales the respective values from an input range into
|
||
|
|
the given output range according to this formula:
|
||
|
|
|
||
|
|
```math
|
||
|
|
\text{result}=(\text{value}-\text{input\_minimum})\cdot\frac{(\text{output\_maximum}-\text{output\_minimum})}
|
||
|
|
{(\text{input\_maximum}-\text{input\_minimum})} +
|
||
|
|
\text{output\_minimum}
|
||
|
|
```
|
||
|
|
|
||
|
|
Input fields are converted to floating point values.
|
||
|
|
If the conversion fails, those fields are ignored.
|
||
|
|
|
||
|
|
**Please note:** Neither the input nor the output values
|
||
|
|
are clipped to their respective ranges!
|
||
|
|
|
||
|
|
## 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
|
||
|
|
# Scale values with a predefined range to a different output range.
|
||
|
|
[[processors.scale]]
|
||
|
|
## It is possible to define multiple different scaling that can be applied
|
||
|
|
## do different sets of fields. Each scaling expects the following
|
||
|
|
## arguments:
|
||
|
|
## - input_minimum: Minimum expected input value
|
||
|
|
## - input_maximum: Maximum expected input value
|
||
|
|
## - output_minimum: Minimum desired output value
|
||
|
|
## - output_maximum: Maximum desired output value
|
||
|
|
## - fields: a list of field names (or filters) to apply this scaling to
|
||
|
|
|
||
|
|
## Example: Define a scaling
|
||
|
|
# [processors.scale.scaling]
|
||
|
|
# input_minimum = 0
|
||
|
|
# input_maximum = 1
|
||
|
|
# output_minimum = 0
|
||
|
|
# output_maximum = 100
|
||
|
|
# fields = ["temperature1", "temperature2"]
|
||
|
|
|
||
|
|
## Multiple scalings can be defined simultaneously
|
||
|
|
## Example: A second scaling.
|
||
|
|
# [processors.scale.scaling]
|
||
|
|
# input_minimum = 0
|
||
|
|
# input_maximum = 50
|
||
|
|
# output_minimum = 50
|
||
|
|
# output_maximum = 100
|
||
|
|
# fields = ["humidity*"]
|
||
|
|
```
|
||
|
|
|
||
|
|
## Example
|
||
|
|
|
||
|
|
The example below uses these scaling values:
|
||
|
|
|
||
|
|
```toml
|
||
|
|
[processors.scale.scaling]
|
||
|
|
input_minimum = 0
|
||
|
|
input_maximum = 50
|
||
|
|
output_minimum = 50
|
||
|
|
output_maximum = 100
|
||
|
|
fields = ["cpu"]
|
||
|
|
```
|
||
|
|
|
||
|
|
```diff
|
||
|
|
- temperature, cpu=25
|
||
|
|
+ temperature, cpu=75.0
|
||
|
|
```
|