Table Of Contents
Threshold Configuration
Threshold Management
Creating a Threshold
Editing a Threshold
Deleting a Threshold
Filtering Thresholds
Viewing Threshold Configuration Details
Threshold Configuration
This chapter explains about configuring and managing thresholds for a MIB variable. Threshold is an optimal value for a MIB variable as set by the user.
Threshold rule can be set for only one MIB variable at a time and you can set many thresholds for each MIB variable. You can set threshold rules for all the MIB variables on a device selected for polling.
CiscoWorks HUM compares this threshold rule with the polled data. If the threshold rule is violated for a consecutive number of times, HUM generates an alert. This condition is called threshold violation.
CiscoWorks HUM allows you to use user-defined external commands or scripts. These external commands or scripts are run whenever there is a threshold violation. CiscoWorks HUM does not track the results generated from the user-defined external commands or scripts.
You can also configure HUM to send alert notifications as an e-mail.
To configure and manage thresholds, see Threshold Management.
Threshold Management
From the Threshold Setup page you can create a threshold for a MIB variable, modify the threshold set for a MIB variable and delete the threshold.
To access the Threshold Setup page go to LMS Portal and select Health and Utilization Monitor > Threshold Management > Threshold Setup. The List of Thresholds dialog box appears.
Table 5-1 describes the fields and buttons in the List of Thresholds dialog box.
Table 5-1 List of Thresholds Fields and Buttons
Field / Button Name
|
Description
|
Threshold Name
|
Configured threshold. For example, CPU Threshold
|
No. of Devices
|
Number of devices associated with the threshold.
|
Variable
|
MIB variable associated with the threshold. For example, cpmCPUTotal5minRev
|
Condition
|
Condition applied for monitoring threshold violation. For example, >=
|
Value
|
Displays the threshold value.
|
Violation Count
|
Configured violation count.
An alert is triggered if the specified violation count matches with the actual number of violations.
|
Severity
|
Severity level of the threshold violation. For example, Critical, Medium, Low
Severity is a user preference set based on the threshold requirement.
|
Script
|
Displays the user-defined external command or script.
|
E-Mail
|
E-mail address to which alert notifications are sent when threshold violation occurs.
|
Create
(button)
|
Creates threshold for MIB variable. See Creating a Threshold.
|
Edit
(button)
|
Modifies an existing threshold. See Editing a Threshold.
|
Delete
(button)
|
Deletes an existing threshold. See Deleting a Threshold.
|
Filter
|
Select the filter criteria and enter the data.
Use one of the following filter criteria and click Show:
• Threshold Name
•Variable Name
•Severity
•Violation Count
See Filtering Thresholds.
|
You can perform the following tasks from the List of Thresholds dialog box:
•Creating a Threshold
•Editing a Threshold
•Deleting a Threshold
•Filtering Thresholds
•Viewing Threshold Configuration Details
Creating a Threshold
You can set and monitor the optimal value for a MIB variable by defining threshold rules. This is done by selecting a template, choosing an appropriate MIB variable, selecting MIB variable instances and applying a threshold criteria. You can configure the threshold criteria based on your requirement.
To create a threshold:
Step 1 Go to LMS Portal and select Health and Utilization Monitor > Threshold Management > Threshold Setup.
The List of Thresholds dialog box appears.
Step 2 Click Create.
The Threshold Configuration dialog box appears.
Table 5-2 describes the fields in the Threshold Configuration dialog box.
Table 5-2 Threshold Configuration Fields
Field / Button
|
Description
|
Threshold Details
|
Threshold Name
|
Enter a descriptive name for the threshold. The name must be unique.
The name can contain a mix of alphabets, numerals and special characters (such as -_.#@&$).
|
Template Name
|
Displays a list of System-defined and User-defined templates as a drop-down list.
Select a template name from the drop-down list. For example, CPU Utilization.
|
Variable Name
|
Displays a list of MIB variables polled using the template as a drop-down list.
Select a MIB variable from the drop-down list. For example, cpmCPUTotal5min.
For Device Availability and Interface Availability, only the following MIB variables are listed:
•sysUpTime (for Device Availability)
•ifOperStatus (for Interface Availability)
|
Threshold Criteria
|
Condition
|
Displays a list of conditions (such as >=, <=, >, <, ==, !=). Select a condition for applying the threshold.
The condition is applied to the value entered in the Value field.
To set thresholds for device availability and interface availability, the condition must be specified as equals (==).
|
Value
|
Enter the threshold value.
This value acts as a benchmark to monitor the MIB variable. You will be notified if the polled data violates the condition set (such as >=, <=, >, <, ==, !=) for the threshold value.
If you have selected the template name as Device Availability or Interface Availability, then the following values are displayed in the Value drop-down list:
•Device Availability
–Sys Down
–Sys Up
•Interface Availability
–Down
–Up
|
No. of Violations
|
Enter a value to indicate the number of violations allowed before generating alerts.
Based on the value entered, an alert is triggered if the threshold value is violated for consecutive polling cycles.
If the threshold value is not violated during any one polling cycle, the No. of Violations count is reset to zero.
The following example shows you what happens when the threshold violation is alerted and reset.
Set the following Threshold Criteria to monitor the CPU Utilization:
•Condition: >=
•Value: 70 %
•No. of Violations: 3
Case 1:
Assume that these are the CPU Utilization values:
•During first polling cycle — 72 %
•During second polling cycle — 75%
•During third polling cycle — 74%
In this case, the threshold value is violated consecutively for three polling cycles. Hence, an alert is triggered when the threshold value is violated on the third polling cycle.
Case 2:
Assume that these are the CPU Utilization values:
•During first polling cycle — 72%
•During second polling cycle — 75%
•During third polling cycle — 68%
In this case, the threshold value is not violated consecutively for three polling cycles. Hence, the No. of Violation count is reset to zero.
|
Severity
|
Select any of the following applicable severities from the drop-down list:
•Critical
•Medium
•Low
Severity is a user preference set based on the threshold requirement.
|
Script
|
Use the Browse button to select a user-defined external command or script. This external command or script is executed when threshold violation occurs.
You are allowed to select user-defined external command or a script only from the following directory paths:
•In Windows, $NMSROOT\hum\thresholdscript
•In Solaris, $NMSROOT/hum/thresholdscript
$NMSROOT is the default CiscoWorks HUM installation directory.
|
Notify Me
|
Enable the checkbox for alert notification through e-mail.
|
E-Mail ID
|
Enter the e-mail address to which HUM sends alert messages. The e-mail address must be in the format: user@domain.com.
You can enter multiple e-mail addresses, separated by commas.
|
Select Instances
|
Search Input
|
Enter your search expression in this field.
You can enter the device name. For example, 3500XL.
|
All
|
Click All to view all the device instances for the selected MIB variable.
Check the checkboxes to select the instances.
|
Search Results
|
Displays all your Simple or Advanced search results and you can select all instances, clear all instances, or select a few instances from the list.
|
Selection
|
Lists all the instances that you have selected in the All or Search Results tab or through a combination of both. You can also use this tab to deselect the instances you have already selected.
|
Create
(button)
|
Creates the threshold and resets the fields in the Threshold Configuration dialog box to add a new threshold.
|
Cancel
(button)
|
Cancels the creation of threshold.
|
Step 3 Go to the Threshold Details pane.
Step 4 Enter a descriptive name for the Threshold. For example, CPU Threshold.
Step 5 Select a template from the drop-down list.
The drop-down list shows a list of all the System-defined and User-defined templates.
Step 6 Select a MIB variable from the drop-down list.
The drop-down list shows a list of MIB variables polled using the selected template. For example, cpmCPUTotal5minRev.
The selected MIB variable displays all the polled device instances in the Select Instances pane.
Step 7 Go to the Select Instances pane.
Step 8 Select the required instances from the instance tree.
Step 9 Go to the Threshold Criteria pane.
Step 10 Select a condition from the drop-down list.
The condition is set based on the threshold value entered in the Value field.
To know the device availability and interface availability, you must select the condition as equals (==).
Step 11 Enter the threshold value in the Value field.
If you have selected the template name as Device Availability or Interface Availability, then the following values are displayed in the Value drop-down list:
•For Device Availability
–Sys Down
–Sys Up
•For Interface Availability
–Down
–Up
Step 12 Enter a value in the No. of Violations field.
This value indicates the number of violations permitted during consecutive polling cycles. If the threshold value is not violated during any one polling cycle, the No. of Violations value is reset to zero.
Step 13 Select a severity from the Severity drop-down list. For example, Critical, Medium or Low.
Step 14 Click Browse.
The Server Side File Browser dialog box appears, prompting you to locate the external command or script from the directory path where HUM is installed.
You are allowed to select an external command or script only from the following directory paths:
•In Windows, $NMSROOT\hum\thresholdscript
•In Solaris, $NMSROOT/hum/thresholdscript
If you try to access any other directory path an appropriate error message is displayed.
Table 5-3 describes the fields in the Server Side File Browser dialog box.
Table 5-3 Server Side File Browser Fields
Field
|
Description
|
File
|
Displays the directory path to locate the external command or script.
|
Directory Content
|
Displays the files and folders within the directory path.
|
Step 15 Locate the external command or script and click OK.
The script should be of an extension .bat for Windows and .sh for Solaris and should have proper executable permissions.
CiscoWorks HUM executes the script when threshold violation occurs.
The following environmental variables are passed to the script:
•Threshold Name—Name of the threshold set for a MIB variable.
Environmental variable key passed to the script: ThresholdName.
•Device Name—Name of the device for which the threshold violation occurred.
Environmental variable key passed to the script: DeviceName.
•MIB Variable Name—Name of the MIB variable which violated the threshold.
Environmental variable key passed to the script: MibVarName.
•Instance Name—Name of the device instance for which the threshold violation occurred. For example, CPU of Switching Processor.
Environmental variable key passed to the script: InstanceName.
•Configured Value—Value set for monitoring threshold violation.
Environmental variable key passed to the script: ConfiguredValue.
•Breach Value—Actual value of threshold violation.
Environmental variable key passed to the script: BreachValue.
•Number of Violations—Number of consecutive threshold violations occurred.
Environmental variable key passed to the script: NoOfOccurrences.
•Severity—Severity of the threshold such as Critical, Medium, Low.
Environmental variable key passed to the script: Severity.
•Date and Time—Date and time at which the threshold violation occurred.
Environmental variable key passed to the script: TimeOfOccurance.
CiscoWorks HUM does not track the results generated from the user-defined external command or script.
Step 16 Select the Notify Me checkbox and enter the e-mail address in the E-mail ID field to receive E-mail notifications of threshold violation.
The E-mail address must be in the format: user@domain.com.
The E-mail ID field supports multiple e-mail addresses, separated by commas.
Step 17 Click Create to add the threshold.
A message appears, confirming that threshold is added successfully.
Step 18 Click OK.
The Threshold Configuration dialog box appears, allowing you to create more thresholds.
Or
Click Cancel to cancel the threshold creation process.
The created threshold is listed in the List of Thresholds dialog box.
Editing a Threshold
You can modify the threshold criteria of an existing threshold using the Edit button. You can only make changes to the threshold criteria and the selection of instances. You cannot make changes to the threshold details (Threshold Name, Template Name, Variable Name).
You can edit only one threshold at a time. If you select multiple thresholds using the checkbox, the Edit button is disabled.
To edit a threshold:
Step 1 Go to LMS Portal and select Health and Utilization Monitor > Threshold Management > Threshold Setup.
The List of Thresholds dialog box appears.
Step 2 Select the threshold by checking the corresponding checkbox.
If you select multiple thresholds the Edit button is disabled.
Step 3 Click Edit.
The Threshold Configuration dialog box appears.
See Creating a Threshold for the descriptions of the fields that appear in the Threshold Configuration dialog box.
Step 4 Make the necessary changes to the Select Instances and Threshold Criteria panes.
Step 5 Click Update.
A message appears, confirming that the threshold is updated successfully.
The updated threshold is listed in the List of Thresholds dialog box.
Deleting a Threshold
CiscoWorks HUM allows you to delete thresholds using the Delete button. You are allowed to delete only one threshold at a time.
Before a threshold is deleted, you are prompted to confirm the deletion because you cannot restore a threshold that you have deleted from the database.
To delete a threshold:
Step 1 Go to LMS Portal and select Health and Utilization Monitor > Threshold Management > Threshold Setup.
The List of Thresholds dialog box appears.
Step 2 Select the threshold by checking the corresponding checkbox.
Step 3 Click Delete.
A message appears, prompting you to confirm the deletion.
Step 4 Click OK to delete the threshold or Cancel to cancel the operation.
If you choose to click OK, a message appears that the threshold is deleted successfully.
The List of Thresholds dialog box appears.
Filtering Thresholds
This section describes how you can use the filter option to display the threshold information based on a specific criteria.
To filter threshold information:
Step 1 Go to LMS Portal and select Health and Utilization Monitor > Threshold Management > Threshold Setup.
The List of Thresholds dialog box appears.
Step 2 Select a criteria for filtering from the drop-down list.
Step 3 Enter the data to be filtered in the text field.
Table 5-4 describes the methods you can follow to filter the data.
Step 4 Click Show.
The List of Thresholds dialog box appears, displaying the threshold information based on the filter criteria.
Table 5-4 describes the criteria available to filter.
Table 5-4 Threshold Filter Fields
Filter Criteria
|
Description
|
Threshold Name
|
Select Threshold Name and enter the data. You can use any of the following methods to filter by entering:
•Complete threshold name
•Any three consecutive characters of the threshold name
|
Variable Name
|
Select Variable Name and enter the data. You can use any of the following methods to filter by entering:
•Complete MIB variable name
•Any three consecutive characters of the MIB variable name
|
Severity
|
Select Severity and enter the severity as Critical, Medium, or Low.
|
Violation Count
|
Select Violation Count and enter the violation count numeric value.
|
Viewing Threshold Configuration Details
You can view the threshold configuration details listed for each device, in a tabular format.
To view a threshold configuration:
Step 1 Go to LMS Portal and select Health and Utilization Monitor > Threshold Management > Threshold Setup.
The List of Thresholds dialog box appears.
Step 2 Click on the threshold name link.
The Threshold View page appears, displaying the threshold configuration details.
Table 5-5 describes the fields in the Threshold View page.
Table 5-5 Threshold View Field Description
Field Name
|
Description
|
Instances
|
Displays the list of instances selected for the device.
|
Go to Device
|
Select a device name from the drop-down list. The threshold configuration details for the selected device is displayed.
|
Export
|
Click the Export icon to export threshold configuration details to a file of CSV or PDF format.
|
Print
|
View the threshold configuration details in a printer-friendly format.
|
