Configuring BMC PATROL Agent thresholds

You can define range-based thresholds for the attributes of a monitor type or an instance on the BMC PATROL Agents. You can identify a specific monitor instance by using the instance SID. You can also use regular expressions to search for multiple matching instances. The supported characters for regular expressions are as follows: 

If you want to identify the SID of a specific monitor instance, perform the following tasks:

1. Log on to operator console.
2. In the navigation pane, select Devices > Grid View.
   
3. Click any device.
   The Show Monitors page is displayed. 
4. Hover the mouse over the specific monitor instance, and the tool tip displays the SID for the instance.
5. Note down the SID. You can use the SID value when you configure the agent threshold.

To define an agent threshold configuration

1. On the Agent Threshold Configuration page, click Add. 

2. In the Add Agent Threshold Configuration dialog box, select a solution, its version, and a monitor type.

   Note

   For some KMs, only the internal name is displayed in the Monitor Type list and for other KMs, both the external and internal names are displayed. For example, for Citrix Xen Host, both the internal (VSM_XEN_HOST) and external (Citrix Xen Host) names are displayed.

3. In the Scope list, select one of the following options:
   • Type—Indicates that the threshold applies to the monitor type
   • Instance—Indicates that the threshold applies to the specific instances of the monitor type
4. If you have selected Type as the scope, go to step 6.

5. If you have selected Instance as the scope, in the Instance SID box, type the instance SID of the monitor type.
   
   

   Note

   You can also use regular expressions to search for multiple matching instance SIDs. If you use regular expressions to search for the matching instance SIDs, ensure that you have selected Is a Regular Expression.

   
   

6. In the Attribute list, select a monitor attribute.

   Note

   In the Attribute list, some attributes are designated as key performance indicators (KPIs). Depending on the monitored environment and version, the list of KPIs might appear differently in the operator console.

7. Under Alarm Ranges, perform the following tasks to configure border and alarm ranges for the selected attribute:
   
   
   • If you want to configure border range, under Border, select Enable, and perform the following tasks:
     

     1. In the Min and Max lists, set the minimum and maximum values for the range.

        Note

        If you plan to configure alarm 1 range, the minimum value of the border range must be less than or equal to the minimum value of the alarm 1 range. If you plan to configure alarm 2 range, the maximum value of the border range must be greater than or equal to the maximum value of the alarm 2 range.

     2. In the Issue Alert list, select the type of alert. The supported types are as follows:
        • OK
        • Warn
        • Alarm
     3. In the When to trigger alarm list, select an appropriate condition to trigger the alarm. The supported values are as follows:
     • • Immediately on alarm—Triggers the event immediately after an alarm
       • After alarm occurs N times—Triggers the event after the specified number of alarms. Ensure that you specify a value greater than 0 in the N times box.
       • After all recovery actions fail—Triggers the event after all the recovery actions fail
      

   • If you want to configure alarm 1 range, under Alarm 1, select Enable, and perform step i through step iii.
     

     Note

     If you have configured border range, the minimum value of the alarm 1 range must be greater than or equal to the minimum value of the border range. If you plan to configure alarm 2 range, the maximum value of the alarm 1 range must be less than or equal to the minimum value of the alarm 2 range.

      

   • If you want to configure alarm 2 range, under Alarm 2, select Enable, and perform step i through step iii.
     

     Note

     If you have configured alarm 1 range, the minimum value of the alarm 2 range must be greater than or equal to the maximum value of the alarm 1 range. If you plan to configure border range, the maximum value of the alarm 2 range must be less than or equal to the maximum value of the border range.

8. Click Add.
9. The agent threshold is added.
10. To define additional agent thresholds, repeat step 2 through step 8.
11. (Optional) To return the settings in the current page to default values, click Reset.
12. When you finish configuration, click Close.
13. Click Next or Finish.

After you save or update a policy, the new threshold configurations are pushed to the selected BMC PATROL Agents.

To edit an agent threshold configuration

1. On the Agent Threshold Configuration page, select the attribute for which you want to update the threshold definition, and click Edit .
2. Edit the configuration values, and click Update.
   The changes are saved.

After you update a policy, the updated threshold configurations are pushed to the selected BMC PATROL Agents.

To delete an agent threshold configuration  

You can delete the threshold configuration based on the monitoring solutions, versions, monitor types, or attributes. 

1. On the Agent Threshold Configuration page, in the Defined agent thresholds table, perform one of the following tasks.
   • To delete all the threshold configuration based on a solution name and all its version, in the Solution column, select a value. 
   • To delete all the threshold configuration based on a version of the monitoring solution and its monitor types, in the Version column, select a value.
   • To delete all the threshold configuration based on a monitor type and its attributes, in the Monitor Type column, select a value.
   • To delete the threshold configuration based on an attribute, in the Attribute column, select a value.
2. Click Delete .
3. In the Delete Confirmation dialog box, click Yes.

After you delete an agent threshold configuration and save the policy, the deleted threshold configurations are removed from the selected BMC PATROL Agents.