Performance Data Configuration

Sometimes you might want to tweak performance data and therefore all checks support the perf-config argument to apply tweaks to them.

Syntax

check_plugin perf-config="selector(key:value;...)"

For example:

check_drivesize "perf-config= used %(ignored:true) used(unit:G)"

This will convert used disk space bytes into gigabytes. It also removes the percent performance data from the output completely.

The following keys are available:

Key	Value	Description
`ignored`	`true` or `false`	Remove the performance value from the list if true.
`prefix`	`string`	Change the prefix to something else.
`suffix`	`string`	Change the suffix to something else.
`unit`	`string`	Change the unit to something else.
`magic`	`number`	Apply magic factor to performance data.

The perf-config selector supports wildcards, so something like this will work:

check_plugin perf-config="*(unit:G)"

SNClient will use the options in order and apply the first matching configuration, for example:

check_plugin perf-config="used(ignored:true) *(unit:G)"

will hide used performance data and apply unit G to everything else.

There are several useful conversions available.

The base unit B for bytes can be converted into more human-readable units.

A common pattern is *(unit:G) to simply convert all performance data into gigabytes.

check_plugin perf-config="*(unit:G)"

You can choose from these units:

Durations with the base unit s for seconds can be converted into the following units:

For example, convert the uptime to days:

check_uptime "perf-config=*(unit:d)"

Performance data with a value, a minimum, and a maximum can be converted to a percentage.

check_plugin perf-config="*(unit:%)"