Cisco DCNM Fundamentals Guide, Release 6.x
Working With Threshold Rules
Downloads: This chapterpdf (PDF - 195.0KB) The complete bookPDF (PDF - 11.54MB) | Feedback

Working With Threshold Rules

Table Of Contents

Working With Threshold Rules

Information About Threshold Rules

Threshold Rules Overview

Rising Threshold

Falling Threshold

Threshold Rule Properties

Threshold Rule Actions

Threshold Rule Examples

Triggering an Action Each Time a Threshold is Crossed

Triggering an Action Only Once in a Period When a Threshold is Crossed

Triggering an Action Every Fourth Period When a Threshold is Crossed

Licensing Requirements for Threshold Rules

Configuring Threshold Rules

Creating Threshold Rules

Deleting Threshold Rules

Editing Threshold Rules

Viewing Threshold Rules

Applying a Threshold Rule to a Chart

Additional References

Related Documents

Standards

Feature History for Threshold Rules


Working With Threshold Rules


This chapter describes how to configure threshold rules using Cisco Data Center Network Manager for LAN (DCNM-LAN).

This chapter includes the following sections:

Information About Threshold Rules

Licensing Requirements for Threshold Rules

Configuring Threshold Rules

Additional References

Feature History for Threshold Rules

Information About Threshold Rules

This section includes the following topics:

Threshold Rules Overview

Threshold Rule Examples

Threshold Rules Overview

DCNM-LAN provides a feature that you use to specify rising or falling threshold rules for sample variables in collected statistical data. Depending on the rule definition, a set of actions are performed by DCNM-LAN. You define the threshold rule on the Threshold Rules page, and you apply the threshold rule to the existing chart.

This section includes the following topics:

Rising Threshold

Falling Threshold

Threshold Rule Properties

Threshold Rule Actions

Rising Threshold

The rising threshold is the upper threshold for a sample variable. When the current sampled variable is greater than or equal to the specified threshold, a set of actions is performed.

Falling Threshold

The falling threshold is the lower threshold for a sample variable. When the current sampled variable is lower than or equal to the specified threshold a set of actions is performed.


Note You can specify only one rising threshold and one falling threshold for a single sampled variable.


Threshold Rule Properties

Threshold rule properties are as follows:

Name—Specifies the threshold rule name.

Frequency—Specifies the number of times the sampled variable must cross a threshold before triggering any actions.

Period—Specifies the interval of time the frequency is monitored.

Repeat—Prevents the timer from resetting after triggering an action within the period.

Trend—Specifies the rising or falling threshold.

Threshold Rule Actions

Threshold rule actions are as follows:

Send an email or SMS to a mail server or mail to SMS gateway.

Run a script on the server.

Send an event to the current DCNM JMS channel.

Threshold Rule Examples


Note The granularity of a period is driven by the minimal interval of the collected data. Consequently, the period must be higher than that interval.


This section includes the following topics:

Triggering an Action Each Time a Threshold is Crossed

Triggering an Action Only Once in a Period When a Threshold is Crossed

Triggering an Action Every Fourth Period When a Threshold is Crossed

Triggering an Action Each Time a Threshold is Crossed

To trigger an action each time a threshold is crossed, set properties as follows:

Frequency—1

Repeat—Yes

Figure 24-1 shows the trigger action when you set rule properties to the preceding values.

Figure 24-1 Trigger an Action Each Time a Threshold is Crossed

If the sampled variable crosses the threshold, an action is taken the first time it crosses the threshold. As a result, an action is performed each time the threshold is crossed.

Triggering an Action Only Once in a Period When a Threshold is Crossed

To trigger an action only once in a period when a threshold is crossed, set properties as follows:

Frequency—1

Period—300

Repeat—No

Figure 24-2 shows the trigger action when you set rule properties to the preceding values.

Figure 24-2 Trigger an Action Only Once When a Threshold is Crossed Within a Period

If the sampled variable crosses the threshold, an action is taken the first time it crosses the threshold. For the remaining 5 minutes, an action will not be taken. As a result, an action is performed only once during the specified period.

Triggering an Action Every Fourth Period When a Threshold is Crossed

To trigger an action every fourth period when a threshold is crossed, set properties as follows:

Frequency—4

Period—300

Repeat—No

Figure 24-3 shows the trigger action when you set rule properties to the preceding values.

Figure 24-3 Trigger an Action Every Fourth Period When a Threshold is Crossed

If the sampled variable crosses the threshold, an action is taken the fourth time it crosses the threshold. For the remaining 5 minutes, an action is not taken. As a result, an action is performed only once during the specified period.

Licensing Requirements for Threshold Rules

The following table shows the licensing requirements for this feature:

Product
License Requirement

Cisco DCNM-LAN

Threshold rules require no license.


Configuring Threshold Rules

With this feature, you can create, delete, edit, view, and apply a rule to a chart.

The following sections provide more details about the feature.

This section includes the following topics:

Creating Threshold Rules

Deleting Threshold Rules

Editing Threshold Rules

Viewing Threshold Rules

Applying a Threshold Rule to a Chart

Creating Threshold Rules

You can create threshold rules using DCNM-LAN.

DETAILED STEPS


Step 1 From the Feature Selector pane, choose DCNM Server Administration > Threshold Rules.

Step 2 From the toolbar, choose New, and then choose New Threshold Rule.

The Details and Threshold Bindings tabs appear in the Details pane, with the Details tab open.

Step 3 Create a threshold rule as follows:

a. In the Name field, enter a name.

b. In the Description field, enter a description of the threshold rule.

After you have enter a description, the Rising Threshold check box is automatically checked and the Threshold field in the Settings area is outlined in red.


Note A field outlined in red indicates that an entry is required. A field outlined in yellow indicates that the entry is satisfactory.


c. In the Settings area, enter a value in the Threshold field.

Once you have entered a value, the three options in the Action area are outlined in red.

d. In the Action area, provide one of the following:

Enter email addresses (delimited with commas)

Select Sent Event to forward events to the DCNM-LAN Event Browser

Enter a script name

The script receives all data regarding the crossed threshold. The script can be written in any programming language and saved in one of the directories of the system PATH.

Table 24-1 describes the available parameters.

Table 24-1 Parameters Passed to Script

Parameter
Description

$1

Device name

$2

Threshold name

$3

Timestamp

$4

Severity

$5

Monitored metric that is a counter or a non-counter.

When used as a counter, it represents a rate in metric units /second.

When used as a non-counter, it represents an absolute in metric units.

$6

Threshold for the monitored metric that is a counter or a non-counter.

When used as a counter, it represents a rate in metric units /second.

When used as a non-counter, it represents an absolute in metric units.

$7

Trend type

The possible values are:

rate

which is a counter.

absolute

which is a non-counter

$8

Threshold type

The possible values are:

rising

falling

$9

Statistic class

$10

Statistic variable

$11

Source object



Note Ensure that the DCNM-LAN server is configured for an SMTP server. For more information about configuring the DCNM-LAN server, see the Cisco DCNM Installation and Licensing Guide, Release 5.x.


e. (Optional) In the corresponding Settings and Action areas, configure a Falling Threshold.

f. (Optional) Click the Threshold Bindings tab to view bindings.

g. Click Deploy.

The rule is deployed.

When you exit DCNM-LAN and Save Pending Changes is checked in the Warning dialog box, click Yes to save the rule.


Deleting Threshold Rules

You can delete rules using DCNM-LAN.

DETAILED STEPS


Step 1 From the Feature Selector pane, choose DCNM Server Administration > Threshold Rules.

The rules appear in the Summary pane.

Step 2 From the Summary pane, right-click the appropriate rule.

Step 3 From the drop-down list, choose Delete Threshold Rule.

A warning dialog box appears and displays "Are you sure you want to delete?"

Step 4 Click Yes.

The rule is deleted.


Editing Threshold Rules

You can view threshold rules using DCNM-LAN.

DETAILED STEPS


Step 1 From the Feature Selector pane, choose DCNM Server Administration > Threshold Rules.

The rules appear in the Summary pane.

Step 2 Edit any appropriate areas.


Note You cannot edit the Name field.



Viewing Threshold Rules

You can view threshold rules using DCNM-LAN.

DETAILED STEPS


Step 1 From the Feature Selector pane, choose DCNM Server Administration > Threshold Rules.

The rules appear in the Summary pane.

Step 2 Click on a rule to view it.


Applying a Threshold Rule to a Chart

You can apply threshold rules using DCNM-LAN.

DETAILED STEPS


Step 1 From the Feature Selector pane, choose the appropriate feature. For example, if you wanted to see statistics for an Ethernet port, choose Interfaces > Physical > Ethernet.

The available devices appear in the Summary pane.

Step 2 From the Summary pane, choose the appropriate device.

Step 3 Click the Statistics tab.

Step 4 In the toolbar, click New Chart and then from the drop-down list choose the chart that you want to view. For example, if you wanted to see statistics for traffic, choose Traffic Statistics Chart.

Step 5 In the chart toolbar, click Launch Threshold Setting.


Additional References

For additional information related to administering threshold rules, see the following sections:

Related Documents

Standards

Related Documents

Related Topic
Document Title

Events

System Management Configuration Guide, Cisco DCNM for LAN, Release 5.x

Statistical Data Collection

Chapter 25 "Administering Statistical Data Collection"


Standards

Standards
Title

No new or modified standards are supported by this feature, and support for existing standards has not been modified by this feature.


Feature History for Threshold Rules

Table 24-2 lists the release history for this feature.

Table 24-2 Feature History for Threshold Rules 

Feature Name
Releases
Feature Information

Threshold Rules

5.2(0)