Thresholds
Important
A threshold can be enabled and have any value (including 0), or be disabled completely.
The
<threshold> (without suffix) is used to set any threshold value (but not 0) or to disable a threshold.
To
disable a threshold: Set the threshold setting to
0.
To
use the value 0: Set <threshold>_set_0 to
true.
The <threshold>_set_0 value has priority. If it is used, the threshold will not be disabled.
Types
Threshold Type | Disable Setting | Zero Value Setting | Triggered on |
High Warning | threshold_w = 0 | threshold_w_set_0 = true | Result above value. |
High Error | threshold_e = 0 | threshold_e_set_0 = true | Result above value. |
Low Warning | threshold_lo_w = 0 | threshold_lo_w_set_0 = true | Result below value. |
Low Error | threshold_lo_e = 0 | threshold_lo_e_set_0 = true | Result below value. |
Examples
High Error is disabled:
threshold_e: 0
Low Warning threshold is 0:
threshold_lo_w_set_0: true
Dynamic Threshold Values
Threshold values can be automatically calculated by using the '
_dynamic' setting.
When a dynamic settings are enabled, the corresponding values are determined according to the defined '
_dynamic' properties.
Warning Type | Dynamic Setting | Modifies |
High Warning | threshold_w_dynamic | threshold_w |
High Error | threshold_e_dynamic | threshold_e |
Low Warning | threshold_lo_w_dynamic | threshold_lo_w |
Low Error | threshold_lo_e_dynamic | threshold_lo_e |
Each '
_dynamic' setting consists of the following properties:
baseline_measure,
baseline_period_h,
factor,
offset.
Setting the '
_dynamic' object to empty
{} will disable dynamic calculations.
Baselines measures
Dynamic thresholds calculation can be based on one of the 3 baselines measures: average, median or standard deviation of check’s returned value:
Baseline measure | Value | Calculation |
Average | avg | factor * average returned value for the last baseline_period_h hours + offset |
Median | mdn | factor * median returned value for the last baseline_period_h hours + offset |
Standard Deviation | std | (factor * check's standard deviation of returned value for the last baseline_period_h hours) + average returned value for the last baseline_period_h hours + offset. |
Examples
High Error dynamic calculation is disabled:
threshold_e_dynamic: {}
High Warning is dynamically calculated with the Average baseline for the last 2 hours with factor 1.5 and offset 1:
threshold_w_dynamic: {
baseline_measure: "avg",
baseline_period_h: 2,
factor: 1.5,
offset: 1
}
High Warning is disabled and dynamic calculation of High Warning is disabled:
threshold_w: 0,
threshold_w_dynamic: {}