Cisco IOS XR System Monitoring Command Reference for the Cisco

Performance Management Commands performance-mgmt thresholds

performance-mgmt thresholds

To configure a template for threshold checking, use the performance-mgmt thresholds command in Global

Configuration modeXR Config mode. To remove a threshold template, use the no form of this command.

performance-mgmt thresholds entity {template template-name| default} attribute operation value [ value2 ]

[ percent ] [rearm {toggle| window window-size}] no performance-mgmt thresholds

Syntax Description entity Specify an entity for which you want to create a template:

• bgp —Creates a template for threshold collection for Border Gateway Protocol

(BGP).

• interface basic-counters —Creates a threshold monitoring template for basic counters.

• interface data-rates —Creates a threshold monitoring template for data rates.

• interface generic-counters —Creates a threshold monitoring template for generic counters.

• mpls ldp —Applies a template for monitoring an MPLS Label Distribution Protocol

(LDP) neighbor.

• node cpu —Creates a threshold monitoring template for the central processing unit

(CPU).

• node memory —Creates a threshold monitoring template for memory utilization.

• node process —Creates a threshold monitoring template for processes.

• ospf v2protocol —Creates a threshold monitoring template for Open Shortest Path

First v2 (OSPFv2) process instances.

• ospf v3protocol —Creates a threshold monitoring template for OSPFv3 process instances.

template template-name default attribute

Specifies that a template will be used for collection.

Name of a predefined template used for threshold collection. A template name can be any combination of alphanumeric characters, and may include the underscore character

(_). Use the

show running performance-mgmt, on page 464

to display information about templates, and to display the templates that are being used.

Applies the settings of the default template.

The attributes for the entity. See

Table 36: Attribute Values, on page 442

for a list of attributes.

440

Cisco IOS XR System Monitoring Command Reference for the Cisco CRS Router, Release 4.2.x

OL-26517-02

Performance Management Commands performance-mgmt thresholds operation A limiting operation for thresholding that includes:

• EQ —Equal to.

• GE —Greater than or equal to.

• GT —Greater than.

• LE —Less than or equal to.

• LT —Less than.

• NE —Not equal to.

• RG —Not in range.

value value2

The base value against which you want to sample.

(Optional) This value can only be used with the operator RG . For example, if you use

RG for the operation argument value, you create a range between value and value2 .

percent

rearm {toggle |

window} window-size

(Optional) Specifies a value relative to the previous sample interval value. See the “Usage

Guidelines” section for more information.

(Optional) It can be used to reduce the number of events by suppressing redundant events from being reported. Normally, every time a condition is met in a sample interval, a syslog error is generated. Using the toggle keyword works in this manner: If a condition is true, a syslog error message is generated, but it is not generated again until the condition becomes false, and then true again. In this way, only “fresh” events are seen when the threshold is crossed.

Use the window keyword to specify that an event be sent only once for each window.

If a condition is true, a syslog error message is generated. You set your window size by using the window keyword and specify the number of intervals. With a window size, you specify that you want event notification at that number of intervals. For example, if you window size is 2 and your sample interval is 10, you would want notification of the event (for each instance in an entity) only every 20 minutes when the condition has been met.

The number of intervals to use with the rearm keyword.

Command Default None

Command Modes Global Configuration modeXR Config mode

Command History

Release

Release 2.0

Modification

This command was introduced.

OL-26517-02

Cisco IOS XR System Monitoring Command Reference for the Cisco CRS Router, Release 4.2.x

441

Performance Management Commands performance-mgmt thresholds

Release

Release 2.0

Release 3.2

Release 3.3.0

Release 3.7.2

Release 4.0.1

Release 5.0.0

Modification

This command was introduced.

The ospf v2protocol and ospf v3protocol keywords were introduced to support the creation of OSPF threshold monitoring templates. OSPF attribute values were introduced for threshold monitoring.

Removed support for MPLS interfaces.

This command was introduced.

The interface basic-counters keyword was added to support the creation of threshold monitoring template for the basic counter.

This command was introduced.

Usage Guidelines Use the percent argument to specify a value that is relative to the previous sample's interval value. When you use the percent argument with a value of 50, the calculation is performed in this manner, assuming that your current sampled value is sample1 (S1) and the value sampled in the previous sampling period is sample 0 (S0):

(S1 - S0) GT 50% of S0

For example, if you wanted to check for an increase of 50 percent in the counter BGPInputErrors, you could use the following attribute and operation with the percent argument:

BGPInputErrors GT 50

This table shows threshold behavior, assuming the values for BGPInputErrors are at consecutive samplings.

Table 35: Threshold Behavior

Value

10

16

20

35

Calculation

—

16 - 10 = 6, which is > than 50 percent of 10

Event

—

Generate event

20 - 16 = 4, which is not > than 50 percent of 16

No event generated

35 - 20 = 15, which is > than 50 percent of 20

Generate event

This table shows the attribute values supported by the entities.

442

Cisco IOS XR System Monitoring Command Reference for the Cisco CRS Router, Release 4.2.x

OL-26517-02

Performance Management Commands performance-mgmt thresholds

Table 36: Attribute Values

Entity bgp interface basic-counters

Attributes

ConnDropped

ConnEstablished

ErrorsReceived

ErrorsSent

InputMessages

InputUpdateMessages

OutputMessages

OutputUpdateMessages

InOctets

InPackets

InputQueueDrops

InputTotalDrops

InputTotalErrors

OutOctets

OutPackets

OutputQueueDrops

OutputTotalDrops

OutputTotalErrors

Description

Number of times the connection was dropped.

Number of times the connection was established.

Number of error notifications received on the connection.

Number of error notifications sent on the connection.

Number of messages received.

Number of update messages received.

Number of messages sent.

Number of update messages sent.

Bytes received (64-bit).

Packets received (64-bit).

Input queue drops (64-bit).

Inbound correct packets discarded

(64-bit).

Inbound incorrect packets discarded (64-bit).

Bytes sent (64-bit).

Packets sent (64-bit).

Output queue drops (64-bit).

Outbound correct packets discarded

(64-bit).

Outbound incorrect packets discarded (64-bit).

OL-26517-02

Cisco IOS XR System Monitoring Command Reference for the Cisco CRS Router, Release 4.2.x

443

performance-mgmt thresholds

Entity interface data-rates

Attributes

Bandwidth

InputDataRate

InputPacketRate

InputPeakRate

InputPeakPkts

OutputDataRate

OutputPacketRate

OutputPeakPkts

OutputPeakRate

Performance Management Commands

Description

Bandwidth, in kbps.

Input data rate in kbps.

Input packets per second.

Peak input data rate.

Peak input packet rate.

Output data rate in kbps.

Output packets per second.

Peak output packet rate.

Peak output data rate.

444

Cisco IOS XR System Monitoring Command Reference for the Cisco CRS Router, Release 4.2.x

OL-26517-02

Performance Management Commands

Entity interface generic-counters

Attributes

InBroadcastPkts

InMulticastPkts

InOctets

InPackets

InputCRC

InputFrame

InputOverrun

InputQueueDrops

InputTotalDrops

InputTotalErrors

InUcastPkts

InputUnknownProto

OutBroadcastPkts

OutMulticastPkts

OutOctets

OutPackets

OutputTotalDrops

OutputTotalErrors

OutUcastPkts

OutputUnderrun performance-mgmt thresholds

Description

Broadcast packets received.

Multicast packets received.

Bytes received.

Packets received.

Inbound packets discarded with incorrect CRC.

Inbound framing errors.

Input overruns.

Input queue drops.

Inbound correct packets discarded.

Inbound incorrect packets discarded.

Unicast packets received.

Inbound packets discarded with unknown proto.

Broadcast packets sent.

Multicast packets sent.

Bytes sent.

Packets sent.

Outbound correct packets discarded.

Outbound incorrect packets discarded.

Unicast packets sent.

Output underruns.

OL-26517-02

Cisco IOS XR System Monitoring Command Reference for the Cisco CRS Router, Release 4.2.x

445

performance-mgmt thresholds

Entity mpls ldp node cpu node memory

Performance Management Commands

Attributes

AddressMsgsRcvd

AddressMsgsSent

AddressWithdrawMsgsRcvd

AddressWithdrawMsgsSent

InitMsgsSent

InitMsgsRcvd

KeepaliveMsgsRcvd

KeepaliveMsgsSent

LabelMappingMsgsRcvd

LabelMappingMsgsSent

LabelReleaseMsgsRcvd

LabelReleaseMsgsSent

LabelWithdrawMsgsRcvd

LabelWithdrawMsgsSent

NotificationMsgsRcvd

NotificationMsgsSent

TotalMsgsRcvd

TotalMsgsSent

AverageCPUUsed

NoProcesses

CurrMemory

PeakMemory

Description

Address messages received.

Address messages sent.

Address withdraw messages received.

Address withdraw messages sent.

Initial messages sent.

Initial messages received.

Keepalive messages received.

Keepalive messages sent.

Label mapping messages received.

Label mapping messages sent.

Label release messages received.

Label release messages sent.

Label withdraw messages received.

Label withdraw messages sent.

Notification messages received.

Notification messages sent.

Total messages received.

Total messages sent.

Average system percent CPU utilization.

Number of processes.

Current application memory (in bytes) in use.

Maximum system memory (in MB) used since bootup.

446

Cisco IOS XR System Monitoring Command Reference for the Cisco CRS Router, Release 4.2.x

OL-26517-02

Performance Management Commands

Entity node process

Attributes

AverageCPUUsed

NumThreads

PeakMemory performance-mgmt thresholds

Description

Average percent CPU utilization.

Number of threads.

Maximum dynamic memory (in

KB) used since startup time.

OL-26517-02

Cisco IOS XR System Monitoring Command Reference for the Cisco CRS Router, Release 4.2.x

447

Performance Management Commands performance-mgmt thresholds

Entity ospf v2protocol

Attributes

InputPackets

OutputPackets

InputHelloPackets

OutputHelloPackets

InputDBDs

InputDBDsLSA

OutputDBDs

OutputDBDsLSA

InputLSRequests

InputLSRequestsLSA

OutputLSRequests

OutputLSRequestsLSA

InputLSAUpdates

InputLSAUpdatesLSA

OutputLSAUpdates

OutputLSAUpdatesLSA

InputLSAAcks

InputLSAAcksLSA

OutputLSAAcks

OutputLSAAcksLSA

Description

Total number of packets received

Total number of packets sent

Number of Hello packets received

Number of Hello packets sent

Number of DBD packets received

Number of LSA received in DBD packets

Number of DBD packets sent.

Number of LSA sent in DBD packets

Number of LS requests received.

Number of LSA received in LS requests.

Number of LS requests sent.

Number of LSA sent in LS requests.

Number of LSA updates received.

Number of LSA received in LSA updates.

Number of LSA updates sent.

Number of LSA sent in LSA updates.

Number of LSA acknowledgements received.

Number of LSA received in LSA acknowledgements.

Number of LSA acknowledgements sent.

Number of LSA sent in LSA acknowledgements.

448

Cisco IOS XR System Monitoring Command Reference for the Cisco CRS Router, Release 4.2.x

OL-26517-02

Performance Management Commands

Entity Attributes

ChecksumErrors performance-mgmt thresholds

Description

Number of packets received with checksum errors.

OL-26517-02

Cisco IOS XR System Monitoring Command Reference for the Cisco CRS Router, Release 4.2.x

449

Performance Management Commands performance-mgmt thresholds

Entity ospf v3protocol

Attributes

InputPackets

OutputPackets

InputHelloPackets

OutputHelloPackets

InputDBDs

InputDBDsLSA

OutputDBDs

OutputDBDsLSA

InputLSRequests

InputLSRequestsLSA

OutputLSRequests

OutputLSRequestsLSA

InputLSAUpdates

InputLSRequestsLSA

OutputLSAUpdates

OutputLSAUpdatesLSA

InputLSAAcks

InputLSAAcksLSA

OutputLSAAcks

OutputLSAAcksLSA

Description

Total number of packets received.

Total number of packets sent.

Number of Hello packets received.

Number of Hello packets sent.

Number of DBD packets received.

Number of LSA received in DBD packets.

Number of DBD packets sent.

Number of LSA sent in DBD packets.

Number of LS requests received.

Number of LSA received in LS requests.

Number of LS requests sent.

Number of LSA sent in LS requests.

Number of LSA updates received.

Number of LSA received in LS requests.

Number of LSA updates sent.

Number of LSA sent in LSA updates.

Number of LSA acknowledgements received.

Number of LSA received in LSA acknowledgements.

Number of LSA acknowledgements sent

Number of LSA sent in LSA acknowledgements.

450

Cisco IOS XR System Monitoring Command Reference for the Cisco CRS Router, Release 4.2.x

OL-26517-02

Performance Management Commands performance-mgmt thresholds

Task ID

Task ID monitor

Operations read, write

Examples This example shows how to create a template for monitoring BGP thresholds, which checks if the number of connections dropped exceeds 50 for any BGP peers. The toggle rearm keywords are included so that once the threshold is passed, the event will not be reported unless the value of ConnDropped is reset:

RP/0/0RP0RSP0/CPU0:router:hostname(config)# performance-mgmt thresholds bgp template bgp_thresh1

RP/0/0RP0RSP0/CPU0:router:hostname(config-threshold-bgp)# ConnDropped GT 50 rearm toggle

This example shows how to create a template for monitoring node CPU utilization that checks if there is a 25 percent increase at any given interval:

RP/0/0RP0RSP0/CPU0:router:hostname(config)# performance-mgmt thresholds node cpu template cpu_thresh1

RP/0/0RP0RSP0/CPU0:router:hostname(config-threshold-bgp)# AverageCPUUsed GT 25percent

This example shows how to create a template for monitoring the input CRC errors for interfaces. The rule checks whether the number of errors reach or exceed 1000 for any given interface:

RP/0/0RP0RSP0/CPU0:router:hostname(config)# performance-mgmt thresholds interface generic_ctr template intf_crc_thresh1

RP/0/0RP0RSP0/CPU0:router:hostname(config-threshold-bgp)# InputCRC GE 1000

Related Commands

Command

performance-mgmt apply thresholds, on page 428

Description

Enables threshold monitoring for BGP.

performance-mgmt resources tftp-server, on page

435

show running performance-mgmt, on page 464

Configures a TFTP resource for performance management.

Displays a list of templates and the template being applied.

OL-26517-02

Cisco IOS XR System Monitoring Command Reference for the Cisco CRS Router, Release 4.2.x

451