Type
  • Miscellaneous
Description
  • This article explains how to manage thresholds in Hardware Sentry KM for PATROL.
Additional Keywords
  • Thresholds, Tuning

Related Topics

Knowledge Base

Managing Thresholds: the Tuning Thresholds Mechanism

KB1109 - Feb 21, 2013

Description

The Tuning thresholds mechanism relies on PATROL internal features to set thresholds (also called “Parameter Overrides” or “Tuning”). A PATROL Agent version 3.4.11 or higher is required.
Thresholds can be applied to a single instance of a class (instance-specific) or to all instances of a single class (such thresholds are called global and are referred to as “ALL_INSTANCES thresholds”). When both types of thresholds are applied to a parameter, the single instance thresholds take precedence over the ALL_INSTANCES thresholds.

Note: “Parameter Overrides” thresholds are stored in the PATROL Agent’s configuration, under the /___tuning___ folder. This is why they are also called “Tuning” thresholds.

Applying Thresholds to a Single Instance

Thresholds apply to the instance specified by the configuration variable path.

Configuration Variable Path

Thresholds are set in the following configuration variable:

        /___tuning___/<class name>/<object ID>/<parameter name> 

Example

        /___tuning___/MS_HW_FAN/MS_HW_DellOpenManagehdflocalhost_11/Speed 

This variable contains the thresholds that apply to the “Speed” parameter of the “MS_HW_DellOpenManagehdflocalhost_11” PATROL instance of the MS_HW_FAN class.

Variable Format

The format of the variable is:

# Example Content definition
1 1 Parameter activation (0 = inactive, 1 = active)
2 31 History retention period (in days)
3 -1 Polling interval in seconds. Set to -1 if not a collector
4 0 Border activation (0 = inactive, 1 = active)
5 0 Border minimum threshold
6 0 Border maximum threshold
7 VOID Border alarm type
8 1 Alarm 1 activation (0 = inactive, 1 = active)
9 1 Alarm 1 minimum threshold
10 1 Alarm 1 maximum threshold
11 WARN Alarm 1 type
12 1 Alarm 2 activation (0 = inactive, 1 = active)
13 2 Alarm 2 minimum threshold
14 2 Alarm 2 maximum threshold
15 ALARM Alarm 2 type
16 1 Border trigger type (immediately, after n times,  after all recovery actions have failed)
17 1 Border Max number of occurences (n times)
18 1 Alarm 1 trigger type (immediately, after n times,  after all recovery actions have failed)
19 1 Alarm 1 Max number of occurences (n times)
20 1 Alarm 2 trigger type (immediately, after n times,  after all recovery actions have failed)
21 1 Alarm 2 Max number of occurences (n times)

Example

Tresholds that immediately trigger a warning if value is 1 and an alarm if value is 2.

        1, 31, -1, 0, 0, 0, VOID, 1, 1, 1, WARN, 1, 2, 2, ALARM, 1, 1, 1, 1, 1, 1,  EOD 

Applying Thresholds to all Instances of a Parameter

Configuration Variable Path

Thresholds are set in the following configuration variable:

        /___tuning___/<class>/ALL_INSTANCES/<parameter> 

Example

      /___tuning___/MS_HW_FAN/ALL_INSTANCES/Speed 

This variable contain the thresholds that apply to all instances of the “Speed” parameter of the MS_HW_FAN class.

Variable Format

The content of the variable is identical to the content of the single instance thresholds variable.
Important Note: “Tuning” thresholds in the agent’s configuration are not taken into account immediately, but only when the corresponding instances are created. You need to restart the PATROL Agent for the new “Tuning” thresholds to take effect.