Performance Management Commands on Cisco IOS XR Software

Performance Management Commands on Cisco IOS XR Software

This chapter describes the performance management and monitoring commands on the Cisco IOS XR software used to monitor, collect, and report statistics, and to adjust statistics gathering for Border Gateway Protocol (BGP), Open Shortest Path First (OSPF) protocol, generic interfaces, and individual nodes.

For detailed information about performance management concepts, configuration tasks, and examples, see the Implementing Performance Management on Cisco IOS XR Software module.

MNR-251Cisco IOS XR System Monitoring Command Reference

Performance Management Commands on Cisco IOS XR Softwaremonitor controller fabric

monitor controller fabricTo monitor controller fabric counters in real time, use the monitor controller fabric command in EXEC mode.

monitor controller fabric {plane-id | all}

Syntax Description

Defaults No default behavior or values

Command Modes EXEC

Command History

Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Use the monitor controller fabric command to display controller fabric counters. The display refreshes every 2 seconds.

The interactive commands that are available during a controller fabric monitoring session are described in Table 26.

plane-id Plane ID number of the fabric plane to be monitored. The range is from 0 to 7.

all Monitors all fabric planes.

Release Modification

Release 2.0 This command was introduced on the Cisco CRS-1.

Release 3.0 No modification.

Release 3.2 This command was supported on the Cisco XR 12000 Series Router.

Release 3.3.0 No modification.


Table 26 Interactive Commands Available for the monitor controller fabric Command

Command Description

c Resets controller fabric counters to 0.

f Freezes the display screen, thereby suspending the display of fresh counters.

t Thaws the display screen, thereby resuming the display of fresh counters.

q Terminates the controller fabric monitoring session.

s Enables you to jump to a nonsequential fabric plane. You are prompted to enter the plane ID of the fabric to be monitored.


Performance Management Commands on Cisco IOS XR Softwaremonitor controller fabric

Task ID

Examples The following is sample output from the monitor controller fabric command. The output in this example displays fabric controller counters from fabric plane 0.

RP/0/0/CPU0:router# monitor controller fabric 0

rack3-3 Monitor Time: 00:00:24 SysUptime: 03:37:57

Controller fabric for 0x0

Controller Fabric Stats: Delta In Cells 0 ( 0 per-sec) 0 Out Cells 0 ( 0 per-sec) 0 CE Cells 0 ( 0 per-sec) 0 UCE Cells 0 ( 0 per-sec) 0 PE Cells 0 ( 0 per-sec) 0

Quit='q', Freeze='f', Thaw='t', Clear='c', Select controller='s'

Task ID Operations

fabric read

basic-services execute

monitor read


Performance Management Commands on Cisco IOS XR Softwaremonitor controller SONET

monitor controller SONETTo monitor controller SONET counters, use the monitor controller SONET command in EXEC mode.

monitor controller SONET instance

Syntax Description

Command Modes EXEC

Command History


Use the monitor controller SONET command to display controller SONET counters. The display refreshes every 2 seconds.

The interactive commands that are available during a controller SONET monitoring session are described in Table 27.

instance Either a physical interface instance or a virtual interface instance as follows:

• Physical interface instance. Naming notation is rack/slot/module/port and a slash between values is required as part of the notation.

– rack: Chassis number of the rack.

– slot: Physical slot number of the modular services card or line card.

– module: Module number. A physical layer interface module (PLIM) is always 0.

– port: Physical port number of the interface.

Note In references to a Management Ethernet interface located on a route processor card, the physical slot number is alphanumeric (RP0 or RP1) and the module is CPU0. Example: interface MgmtEth0/RP1/CPU0/0.

• Virtual interface instance. Number range varies depending on interface type.

For more information about the syntax for the router, use the question mark (?) online help function.








Performance Management Commands on Cisco IOS XR Softwaremonitor controller SONET

Task ID

Examples The following is sample output from the monitor controller SONET command. The output in this example displays counters from SONET interface instance 0/3/0/0.

RP/0/0/CPU0:router# monitor controller SONET 0/3/0/0

rack3-3 Monitor Time: 00:00:06 SysUptime: 01:23:56

Controller for SONET0_3_0_0

Controller Stats: Delta Path LOP 0 ( 0 per-sec) 0 Path AIS 0 ( 0 per-sec) 0 Path RDI 0 ( 0 per-sec) 0 Path BIP 0 ( 0 per-sec) 0 Path FEBE 0 ( 0 per-sec) 0 Path NEWPTR 0 ( 0 per-sec) 0 Path PSE 0 ( 0 per-sec) 0 Path NSE 0 ( 0 per-sec) 0 Line AIS 0 ( 0 per-sec) 0 Line RDI 0 ( 0 per-sec) 0 Line BIP 0 ( 0 per-sec) 0 Line FEBE 0 ( 0 per-sec) 0 Section LOS 1 ( 0 per-sec) 1 Section LOF 0 ( 0 per-sec) 0 Section BIP 0 ( 0 per-sec) 0

Quit='q', Freeze='f', Thaw='t', Clear='c', Select controller='s'

Table 27 Interactive Commands Available for the monitor controller SONET Command

Command Description

c Resets controller SONET counters to 0.



q Terminates the controller SONET monitoring session.

s Enables you to jump to a nonsequential SONET interface instance. You are prompted to enter the SONET interface instance to be monitored.

Task ID Operations

fabric read


monitor read


Performance Management Commands on Cisco IOS XR Softwaremonitor interface

monitor interfaceTo monitor interface counters in real time, use the monitor interface command in EXEC mode.

monitor interface [type instance]

Syntax Description

Defaults Use the monitor interface command without an argument to display statistics for all interfaces in the system.

Command Modes EXEC

Command History

type Interface type. For more information, use the question mark (?) online help function.














Release 3.3.0 Support was added for multiple interface instances.

Support was added for default behavior to monitor all interfaces.

Support was added for wildcards in the interface instance syntax.

Support was added for additional display options.





Use the monitor interface command to display interface counters for all interfaces. The display refreshes every 2 seconds.

Use the monitor interface command with the type instance argument to display counters for a single interface. For example: monitor interface POS0/2/0/0

To display more than one selected interface, enter the monitor interface command with multiple type instance arguments. For example: monitor interface POS0/2/0/0 POS0/5/0/1 POS0/5/0/2

To display a range of interfaces, or interface types, interface, enter the monitor interface command with a wildcard. For example: monitor interface POS0/5/*

The interactive commands that are available during an interface monitoring session are described in.

Table 28 Interactive Commands Available for the monitor interface Command (Functional

Summary)

Command Description

Use the following keys to suspend or resume the counter refresh:



Use the following key to reset the counters:

c Resets interface counters to 0.

Use the following keys when displaying statistics for a single interface. These keys display counters in normal or detailed view.

d Changes the display mode for the interface monitoring session to display detailed counters. Use the b interactive command to return to the regular display mode.

r Displays the protocol divided by IPv4 or IPv6, and multicast and unicast. When the statistics are displayed using the r option, you can also use the k, y, or o keys to display statistics in packets (“k”), bytes(“y”) or packets and bytes(“o”).

b Returns the interface monitoring session to the regular display mode for counters. Statistics are not divided by protocol.

Use the following keys when displaying statistics for multiple interfaces. These keys modify the display to show statistics in bytes, packets, or bytes and packets.

k Displays statistics in packets (“k”).

y (Default) Displays statistics in bytes (“y”).

o Displays statistics in both bytes and packets (“o”).

Use the following keys to display statistics for a different interface:

i Enables you to jump to a nonsequential interface instance. You are prompted to enter the interface type and instance to be monitored.

p Displays the previous sequential interface in the list of available interfaces.

n Displays the next sequential interface in the list of available interfaces.

Use the following key to terminate the monitoring session:

q Terminates the interface monitoring session.



Task ID

Examples When more than one interface is specified, the statistics for each interface are displayed on a separate line. This display format appears anytime more than one interface is specified. For example:

• To display statistics for all interfaces, enter the command monitor interface.

• To display all the interfaces for an interface type, such as all POS interface, enter the command and wildcard monitor interface POS *.

• To display statistics for three specified interfaces, enter the command monitor interface POS0/2/0/0 POS0/5/0/1 POS0/5/0/2.

The following is sample output from the monitor interface command entered without an argument. This command displays statistics for all interfaces in the system.

RP/0/RP0/CPU0:router# monitor interface

Interface In(bps) Out(bps) InBytes/Delta OutBytes/DeltaMgmtEth0/RP0/CPU0/0 1142/ 0% 8057/ 0% 14.9M/300 11.5M/2115 FINT0/RP0/CPU0 0/ 0% 0/ 0% 50459/0 66906/0 MgmtEth0/RP1/CPU0/0 0/ 0% 0/ 0% 3.7M/0 1.7M/0 FINT0/RP1/CPU0 0/ 0% 0/ 0% 9180/0 0/0 GigabitEthernet0/1/5/0 0/ 0% 0/ 0% 4608/0 3024/0 POS0/1/0/0 0/ 0% 0/ 0% 7.9M/0 2.2M/0 POS0/1/0/1 0/ 0% 0/ 0% 275.6M/0 275.4M/0 GigabitEthernet0/1/5/1 0/ 0% 0/ 0% 5.9M/0 168/0 GigabitEthernet0/6/5/0 0/ 0% 0/ 0% 14.9M/0 2.4M/0 POS0/6/0/0 0/ 0% 0/ 0% 7.9M/0 2.2M/0 POS0/6/0/1 0/ 0% 0/ 0% 3.4M/0 2.2M/0 GigabitEthernet0/6/5/1 0/ 0% 0/ 0% 4608/0 3066/0 POS0/6/4/4 0/ 0% 0/ 0% 23.2M/0 2.2M/0 POS0/6/4/5 0/ 0% 0/ 0% 3.4M/0 2.2M/0 POS0/6/4/6 0/ 0% 0/ 0% 2.1M/0 2.2M/0 POS0/6/4/7 0/ 0% 0/ 0% 3.4M/0 2.2M/0

Quit='q', Clear='c', Freeze='f', Thaw='t',Next set='n', Prev set='p', Bytes='y', Packets='k'

The following output is from the monitor interface pos *. This command displays statistics for all POS interfaces:

RP/0/RP0/CPU0:router# monitor interface POS 0/*

router Monitor Time: 00:00:02 SysUptime: 186:37:44

Interface In(bps) Out(bps) InBytes/Delta OutBytes/DeltaPOS0/1/0/0 1263/ 0% 0/ 0% 5.3M/330 1.4M/0 POS0/1/0/1 84/ 0% 0/ 0% 274.8M/22 274.6M/0 POS0/6/0/0 1275/ 0% 0/ 0% 5.3M/330 1.4M/0 POS0/6/0/1 85/ 0% 0/ 0% 2.6M/22 1.4M/0 POS0/6/4/4 0/ 0% 0/ 0% 15.1M/0 1.4M/0 POS0/6/4/5 85/ 0% 0/ 0% 2.6M/22 1.4M/0 POS0/6/4/6 0/ 0% 0/ 0% 1.3M/0 1.4M/0 POS0/6/4/7 85/ 0% 0/ 0% 2.6M/22 1.4M/0

Quit='q', Clear='c', Freeze='f', Thaw='t',

Task ID Operations


monitor read



Next set='n', Prev set='p', Bytes='y', Packets='k'

The following is sample output for a single interface using the monitor interface command with the type instance argument. In this example, the output displays interface counters from POS interface 0/6/4/4. By default, statistics are displayed in “Brief” state (statistics are not divided by protocol).

RP/0/RP0/CPU0:router# monitor interface POS0/6/4/4


POS0/6/4/4 is up, line protocol is upEncapsulation HDLC

Traffic Stats:(2 second rates) Delta Input Packets: 232450 0 Input pps: 0 Input Bytes: 15179522 0 Input Kbps (rate): 0 ( 0%) Output Packets: 67068 0 Output pps: 0 Output Bytes: 1475484 0 Output Kbps (rate): 0 ( 0%)

Errors Stats: Input Total: 2146 0 Input CRC: 2134 0 Input Frame: 2135 0 Input Overrun: 0 0 Output Total: 0 0 Output Underrun: 0 0

Quit='q', Freeze='f', Thaw='t', Clear='c', Interface='i',Next='n', Prev='p'

Brief='b', Detail='d', Protocol(IPv4/IPv6)='r'

The following is sample output from the monitor interface command in the protocol state for the POS interface 0/6/4/4. Use the r key to display statics by protocol:

RP/0/RP0/CPU0:router# monitor interface POS0/6/4/4


POS0/6/4/4 is up, line protocol is upEncapsulation HDLC

Traffic Stats:(2 second rates) Delta Input Bytes: 15188186 0 Input Kbps (rate): 0 ( 0%) Output Bytes: 1476298 0 Output Kbps (rate): 0 ( 0%) IPv4 Unicast Input Bytes: 0 0 Input Kbps (rate): 0 ( 0%) Output Bytes: 0 0 Output Kbps (rate): 0 ( 0%) IPv4 Multicast Input Bytes: 10160304 66 Input Kbps (rate): 0 ( 0%) Output Bytes: 0 0 Output Kbps (rate): 0 ( 0%) IPv6 Unicast Input Bytes: 0 0



Input Kbps (rate): 0 ( 0%) Output Bytes: 0 0 Output Kbps (rate): 0 ( 0%) IPv6 Multicast Input Bytes: 0 0 Input Kbps (rate): 0 ( 0%) Output Bytes: 0 0 Output Kbps (rate): 0 ( 0%)

Errors Stats: Input Total: 2146 0 Input CRC: 2134 0 Input Frame: 2135 0 Input Overrun: 0 0 Output Total: 0 0 Output Underrun: 0 0

Quit='q', Freeze='f', Thaw='t', Clear='c', Interface='i',Next='n', Prev='p'

Brief='b', Detail='d', Protocol(IPv4/IPv6)='r' (Additional options in 'Protocol'): Bytes='y', Packets='k', Both of bytes/packets='o'


Performance Management Commands on Cisco IOS XR Softwareperformance-mgmt apply monitor

performance-mgmt apply monitorTo apply a statistics template to gather one sampling-size set of samples for a particular instance, use the performance-mgmt apply monitor command in global configuration mode. To stop monitoring statistics, use the no form of this command.

performance-mgmt apply monitor entity {ip-address | interface-type | interface-instance | node-id | node-id process-id | process-name} {template-name | default}

no performance-mgmt apply monitor

Syntax Description entity Specifies an entity for which you want to apply the statistics template:

• bgp—Applies a template for monitoring a Border Gateway Protocol (BGP) neighbor.

• interface data-rates—Applies a template for monitoring data rates on an interface.

• interface generic-counters—Applies a template for monitoring generic counters on an interface

• mpls ldp—Applies a template for monitoring an MPLS Label Distribution Protocol (LDP) neighbor.

• node cpu—Applies a template for monitoring the central processing unit (CPU) on a node. Use the node-id argument with this entity.

• node memory—Applies a template for monitoring memory utilization on a node. Use the node-id argument with this entity.

• node process—Applies a template for monitoring a process on a node. Use the node-id and process-id arguments with this entity.

• ospf v2protocol—Applies a template for monitoring an Open Shortest Path First v2 (OSPFv2) process instance.

• ospf v3protocol—Applies a template for monitoring an OSPFv3 process instance.

ip-address IP or neighbor address. Used with the bgp or ldp keyword.

interface-type Interface type. Used with the interface data-rates or interface generic-counter keyword. For more information, use the question mark (?) online help function.



Defaults Monitoring is disabled.

Command History

interface-instance Either a physical interface instance or a virtual interface instance. Used with the interface data-rates or interface generic-counter keyword as follows:









node-id Designated node. Used with the node cpu or node memory keyword. The node-id argument is entered in the rack/slot/module notation.

node-id process-id Designated node and process ID. Used with the node process keyword. The node-id argument is entered in the rack/slot/module notation.

process-name Process name of the OSPF instance. Used with the ospfv2protocol and ospfv3protocol keywords.

template-name Name of a predefined template used for statistics collection. A template name can be any combination of alphanumeric characters, and may include the underscore character (_). Use the show running performance-mgmt command to display a list of available templates.

default Applies the default template.




Release 3.2 The enable keyword was replaced by the apply keyword. In previous releases, this command was referred to as performance-mgmt enable monitor. The disable keyword was deprecated. The ospf v2protocol and ospf v3protocol keywords were introduced to support the monitoring of OSPF entity instances.

Release 3.3.0 Removed support for MPLS interfaces.




Command Modes Global configuration


Use the performance-mgmt apply monitor command to apply a statistics template and enable monitoring. This command captures one cycle of a sample to analyze an instance of an entity. Rather than collect statistics for all instances, which is the purpose of the performance-mgmt apply statistics command, the performance-mgmt apply monitor command captures statistics for a specific entity instance for one sampling period.

For information about creating templates, see the performance-mgmt statistics command.

Task ID

Examples The following example shows how to enable the BGP protocol monitoring using the criterion set in the default template:

RP/0/RP0/CPU0:router(config)# performance-mgmt apply monitor bgp 10.0.0.0 default

The following example shows how to enable monitoring for data rates according to the criterion set in the default template:

RP/0/RP0/CPU0:router(config)# performance-mgmt apply monitor interface data-rates pos 0/2/0/0 default

The following example shows how to enable memory monitoring based on the criterion set in the default template:

RP/0/RP0/CPU0:router(config)# performance-mgmt apply monitor node memory 0/1/cpu0 default

Related Commands

Task ID Operations

monitor read/write/execute

Command Description

performance-mgmt apply statistics Applies a statistics template and enables statistics collection.

performance-mgmt statistics Creates a template to use for collecting performance management statistics.

show running performance-mgmt Displays a list of templates and the template being applied.


Performance Management Commands on Cisco IOS XR Softwareperformance-mgmt apply statistics

performance-mgmt apply statisticsTo apply a statistics template and enable statistics collection, use the performance-mgmt apply statistics command in configuration mode. To stop statistics collection, use the no form of this command.

performance-mgmt apply statistics entity [location {all | node-id}] {template-name | default}

no performance-mgmt apply statistics

Syntax Description entity Specifies an entity for which you want to apply a statistics template:

• bgp—Applies a statistics collection template for Border Gateway Protocol (BGP).

• interface data-rates—Applies a statistics collection template for data rates.

• interface generic-counters—Applies a statistics collection template for generic counters.


• node cpu—Applies a statistics collection template for the central processing unit (CPU). Use the location keyword with the all keyword or node-id argument when enabling a statistics collection template for this entity.

• node memory—Applies a statistics collection template for memory utilization. Use the location keyword with the all keyword or node-id argument when enabling a statistics collection template for this entity.

• node process—Applies a statistics collection template for processes. Use the location keyword with the all keyword or node-id argument when enabling a statistics collection template for this entity.

• ospf v2protocol—Applies a statistics collection template for Open Shortest Path First v2 (OSPFv2) process instances.

• ospf v3protocol—Applies a statistics collection template for OSPFv3 process instances.

location {all | node-id} Specifies all nodes or a particular node.

Specify the location all keywords for all nodes, or the node-id argument to specify a particular node. The node-id argument is entered in the rack/slot/module notation. You must specify either the location all keywords or the location keyword and node-id argument with the node cpu, node memory, or node process entity.

template-name Name of a predefined template used for statistics collection. A template name can be any combination of alphanumeric characters, and may include the underscore character (_). Use the show running performance-mgmt command to display a list of available templates.




Defaults Statistics collection is disabled.

Command History


Usage Guidelines To use this command, you must be in a user group associated with a task group that includes the proper task IDs.For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.

Use the performance-mgmt apply statistics command to apply a statistics template and enable statistics collection. Only one template for each entity can be enabled at a time. After samples are taken, the data is sent to a directory on an external TFTP server, and a new collection cycle starts. The directory where data is copied to is configured using the performance-mgmt resources tftp-server command. The statistics data in the directory contains the type of entity, parameters, instances, and samples. They are in binary format and must be viewed using a customer-supplied tool, or they can be queried as they are being collected using XML.

Use the performance-mgmt apply statistics command to collect data for all the instances on a continuous basis. To analyze a particular instance for a limited period of time, use the performance-mgmt apply monitor command.

Use the no form of the command to disable statistics collection. Because only one performance management statistics collection can be enabled for any given entity at any given time, you are not required to specify the template name with the default keyword or template keyword and template-name argument when disabling a performance management statistics collection.

For information about creating templates, see the performance-mgmt statistics command.

Caution Each particular collection enabled requires a certain amount of resources. These resources are allocated for as long as the collection is enabled.

Task ID




Release 3.2 The enable keyword was replaced by the apply keyword. In previous releases, this command was referred to as performance-mgmt enable statistics. The disable keyword was deprecated. The ospf v2protocol and ospf v3protocol keywords were introduced to support the enabling of statistics collection templates for the OSPF entity. The location keyword was added. The global keyword was deprecated and replaced by the location all keywords.



Task ID Operations




Examples The following example shows how to start statistics collection for BGP using the template named bgp1:

RP/0/RP0/CPU0:router(config)# performance-mgmt apply statistics bgp template bgp1

The following example shows how to enable statistics collection for generic counters using the default template:

RP/0/RP0/CPU0:router(config)# performance-mgmt apply statistics interface generic-counters default

The following example shows how to enable CPU statistics collection based on the settings set in the default template:

RP/0/RP0/CPU0:router(config)# performance-mgmt apply statistics node cpu global default

Related Commands Command Description

performance-mgmt apply monitor Applies a statistics template to gather one sampling-size set of samples for a particular instance.

performance-mgmt apply thresholds Applies a threshold template and enables threshold monitoring.

performance-mgmt resources tftp-server Configures a destination TFTP server for statistics collections.

performance-mgmt statistics Creates a template to use for collecting performance management statistics.



Performance Management Commands on Cisco IOS XR Softwareperformance-mgmt apply thresholds

performance-mgmt apply thresholdsTo apply a thresholds template and enable threshold collection, use the performance-mgmt apply thresholds command in global configuration mode. To stop threshold collection, use the no form of this command.

performance-mgmt apply thresholds entity [location {all | node-id] {template-name | default}

no performance-mgmt apply thresholds

Syntax Description entity Specifies an entity for which you want to apply a threshold template:

• bgp—Applies a threshold monitoring template for Border Gateway Protocol (BGP).

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

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


• node cpu—Applies a threshold monitoring template for central processing unit (CPU) utilization. Use the location keyword in conjugation with the all keyword or node-id argument when enabling a statistics collection template for this entity.

• node memory—Applies a threshold monitoring template for memory utilization. Use the location keyword in conjugation with the all keyword or node-id argument when enabling a statistics collection template for this entity.

• node process—Applies a threshold monitoring template for processes. Use the location keyword in conjugation with the all keyword or node-id argument when enabling a statistics collection template for this entity.

• ospf v2protocol—Applies a threshold monitoring template for OSPFv2.

• ospf v3protocol—Applies a threshold monitoring template for OSPFv3.

location {all | node-id} Specifies all nodes or a particular node.

Specify the location all keywords for all nodes, or the node-id argument to specify a particular node. The node-id argument is entered in the rack/slot/module notation. You must specify either the location all keywords or the location keyword and node-id argument with the node cpu, node memory, or node process entity.

template-name 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 command to display a list of available templates.




Defaults Threshold collection is disabled.

Command History



Use the performance-mgmt apply thresholds command to apply a threshold template and enable threshold collection. Several templates can be configured, but only one template for each entity can be enabled at a time.

Use the no form of the command to disable threshold collection. Because only one performance management threshold monitoring template can be enabled for any given entity at any given time, you are not required to specify the template name with the default keyword or template keyword and template-name argument when disabling a performance management statistics collection.

For information about creating threshold templates, see the performance-mgmt thresholds command.

Task ID

Examples The following example shows how to start statistics collection for BGP using a template named stats1:

RP/0/RP0/CPU0:router(config)# performance-mgmt apply thresholds bgp stats1

The following example shows how to enable statistics collection for generic counters using a template named stats2:

RP/0/RP0/CPU0:router(config)# performance-mgmt apply thresholds interface generic-counters stats2




Release 3.2 The enable keyword was replaced by the apply keyword. In previous releases, this command was referred to as performance-mgmt enable thresholds.

The disable keyword was deprecated.

The ospf v2protocol and ospf v3protocol keywords were introduced to support the enabling of threshold monitoring templates for the OSPF entity.

The location keyword was added. The global keyword was deprecated and replaced by the location all keywords.



Task ID Operations




The following example shows how to enable CPU statistics collection using the template named cpu12:

RP/0/RP0/CPU0:router(config)# performance-mgmt apply thresholds node cpu global cpu12


performance-mgmt thresholds Creates a template to use for threshold collection.



Performance Management Commands on Cisco IOS XR Softwareperformance-mgmt resources memory

performance-mgmt resources memoryTo configure memory consumption limits for performance management (PM), use the performance-mgmt resources memory command in global configuration mode. To restore the default memory consumption limits, use the no form of this command.

performance-mgmt resources memory max-limit kilobytes min-reserved kilobytes

no performance-mgmt resources memory

Syntax Description

Defaults max-limit—50000 kilobytesmin-reserved—10000 kilobytes


Command History


Use the performance-mgmt resource memory command to ensure that the total memory consumed by data buffers in PM does not exceed a maximum limit and that any new PM data request does not cause available memory in the system to fall below a certain threshold.

Task ID

max-limit kilobytes Specifies the maximum amount of memory (specified with the kilobytes argument) that the PM statistics collector can use for serving data collection requests. The range is from 0 to 4294967295 kilobytes.The default is 50000 kilobytes.

min-reserved kilobytes Specifies a minimum amount of memory (specified with the kilobytes argument) that must remain available in the system after allowing a new PM data collection request. The range is from 0 to 4294967295 kilobytes. The default is 10000 kilobytes.


Release 3.2 This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.



Task ID Operations

monitor read/write


Performance Management Commands on Cisco IOS XR Softwareperformance-mgmt resources memory

Examples The following example shows how to ensure that the total memory consumed by PM data buffers does not exceed 30,000 kilobytes and that any new PM data request does not cause available memory in the system to fall below 5000 kilobytes:

RP/0/RP0/CPU0:router(config)# performance-mgmt resources memory max-limit 30000 min-reserved 5000


Performance Management Commands on Cisco IOS XR Softwareperformance-mgmt resources tftp-server

performance-mgmt resources tftp-serverTo configure a destination TFTP server for PM statistics collections, use the performance-mgmt resources tftp-server command in global configuration mode. To disable the resource, use the no form of this command.

performance-mgmt resources tftp-server ip-address directory dir-name

no performance-mgmt resources tftp-server

Syntax Description

Defaults A destination TFTP server is not configured and data is not copied out of the system after a collection cycle (sampling-size) ends.

Command History



Use the performance-mgmt resources tftp-server command to configure a TFTP resource for performance management. By creating a directory name on the TFTP server, you create a place where statistics can be collected when statistics collection is enabled.

Use the no form of this command to disable the TFTP resource.

Note Files copied to the TFTP server contain a timestamp in their name, which makes them unique. For that reason the TFTP server used should support creation of files as data is transferred, without requiring users to manually create them at the TFTP server host in advance.

tftp-server ip-address Specifies the IP address of the TFTP server.

directory dir-name Specifies the directory where performance management statistics will be copied.








Performance Management Commands on Cisco IOS XR Softwareperformance-mgmt resources tftp-server

Task ID

Examples The following example shows how to specify a TFTP server with the IP address 192.168.134.254 as the performance management resource and a directory named /user/perfmgmt/tftpdump as the destination for PM statistic collections:

RP/0/RP0/CPU0:router(config)# performance-mgmt resources tftp-server 192.168.134.254 directory /user/perfmgmt/tftpdump

Related Commands

Task ID Operations

monitor read/write

Command Description


performance-mgmt apply thresholds Applies a threshold template and enables threshold monitoring.


Performance Management Commands on Cisco IOS XR Softwareperformance-mgmt statistics

performance-mgmt statisticsTo create a template to use for collecting performance management statistics, use the performance-mgmt statistics command in global configuration mode. To remove a template, use the no form of this command.

performance-mgmt statistics entity {template template-name | default} [sample-size size] [sample-interval minutes]

no performance-mgmt statistics

Syntax Description

Defaults Statistics collections for all entities is disabled.

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

• bgp—Creates a statistics collection template for Border Gateway Protocol (BGP).

• interface data-rates—Creates a statistics collection template for data rates.

• interface generic-counters—Creates a statistics collection template for generic counters.


• node cpu—Creates a statistics collection template for the central processing unit (CPU).

• node memory—Creates a statistics collection template for memory utilization.

• node process—Creates a statistics collection template for processes.

• ospf v2protocol—Creates a statistics template for Open Shortest Path First v2 (OSPFv2) protocol instances.

• ospf v3protocol—Creates a statistics template for OSPFv3 protocol instances.

template Specifies that a template will be used for collection.

template-name A template name can be any combination of alphanumeric characters, and may include the underscore character (_).

Use the show running performance-mgmt to display information about templates, and to display the templates that are being used.

default Applies the settings of the default template. The default template contains the following statistics and values. Values are in minutes.

Each entity has a default template. In each default template, the sample interval is 10 minutes, and the default sample count is 5.

sample-size size (Optional) Sets the number of samples to be taken.

sample-interval minutes

(Optional) Sets the frequency of each sample, in minutes.


Performance Management Commands on Cisco IOS XR Softwareperformance-mgmt statistics

Command History



If you have not yet created a directory for the statistics, use the performance-mgmt resources tftp-server command to create a directory on an external TFTP server. When you apply the template and enable statistics collection with the performance-mgmt apply statistics command, the samples are collected and sent to that directory for later retrieval.

The statistics collected contain type of entity, parameters, instances, and samples. The collection files on the TFTP server are in binary format and must be viewed using a customer-supplied tool or they can be queried as they are being collected using XML.

Task ID

Examples The following example shows how to create a template named int_data_rates for data rate statistics collection, how to set the sample size to 25, and how to set the sample interval to 5 minutes:

RP/0/RP0/CPU0:router(config)# performance-mgmt statistics interface data-rates int_data_ratesRP/0/RP0/CPU0:router(config_stats-if-rate)# sample-size 25RP/0/RP0/CPU0:router(config_stats-if-rate)# sample-interval 5

Related Commands




Release 3.2 The ospf v2protocol and ospf v3protocol keywords were introduced to support the creation of statistics collection templates for the OSPF entity.



Task ID Operations

monitor read/write

Command Description


performance-mgmt resources tftp-server Configures resources for the performance management system that are independent from any particular entity.

performance-mgmt thresholds Configures a template for collecting threshold statistics.



Performance Management Commands on Cisco IOS XR Softwareperformance-mgmt thresholds

performance-mgmt thresholdsTo configure a template for threshold checking, use the performance-mgmt thresholds command in global configuration 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 data-rates—Creates a threshold monitoring template for data rates.

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


• 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 Specifies that a template will be used for collection.

template-name 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 to display information about templates, and to display the templates that are being used.

default Applies the settings of the default template.

attribute The attributes for the entity. See Table 30 for a list of attributes.

operation A limiting operation for thresholding:

• 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.




Command History



Use the percent argument to specify a value relative to the previous sample interval value. When you use the percent argument with a value of 50, the calculation is as follows, 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

value The base value you want to sample against.

value2 (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 Specifies a value relative to the previous sample interval value. See the “Usage Guidelines” section for more information.

rearm{toggle | window}

(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 the following way. If a condition is true, a syslog error message is generated, but it will not be generated again until the condition is false, 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 per window. If a condition is true, a syslog error message will be 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 only want notification of the event (for each instance in an entity) every 20 minutes if the condition has been met.

window-size The number of intervals to use with the rearm keyword.




Release 3.2 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.





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

The threshold behavior is shown in Table 29, assuming the values for BGPInputErrors are at consecutive samplings.

Table 30 contains the attribute values supported by the entities.

Table 29 Threshold Behavior

Value Calculation Event

10 — —

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

Generate event

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

No event generated

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

Generate event

Table 30 Attribute Values

Entity Attributes Description

bgp ConnDropped Number of times the connection was dropped.

ConnEstablished Number of times the connection was established.

ErrorsReceived Number of error notifications received on the connection.

ErrorsSent Number of error notifications sent on the connection.

InputMessages Number of messages received.

InputUpdateMessages Number of update messages received.

OutputMessages Number of messages sent.

OutputUpdateMessages Number of update messages sent.

interface data-rates

Bandwidth Bandwidth, in kbps.

InputDataRate Input data rate in kbps.

InputPacketRate Input packets per second.

InputPeakRate Peak input data rate.

InputPeakPkts Peak input packet rate.

OutputDataRate Output data rate in kbps.

OutputPacketRate Output packets per second.

OutputPeakPkts Peak output packet rate.

OutputPeakRate Peak output data rate.



interface generic-counters

InBroadcastPkts Broadcast packets received.

InMulticastPkts Multicast packets received.

InOctets Bytes received.

InPackets Packets received.

InputCRC Inbound packets discarded with incorrect CRC.

InputFrame Inbound framing errors.

InputOverrun Input overruns.

InputQueueDrops Input queue drops.

InputTotalDrops Inbound correct packets discarded.

InputTotalErrors Inbound incorrect packets discarded.

InUcastPkts Unicast packets received.

InputUnknownProto Inbound packets discarded with unknown proto.

OutBroadcastPkts Broadcast packets sent.

OutMulticastPkts Multicast packets sent.

OutOctets Bytes sent.

OutPackets Packets sent.

OutputTotalDrops Outbound correct packets discarded.

OutputTotalErrors Outbound incorrect packets discarded.

OutUcastPkts Unicast packets sent.

OutputUnderrun Output underruns.

Table 30 Attribute Values (continued)




mpls ldp AddressMsgsRcvd Address messages received.

AddressMsgsSent Address messages sent.

AddressWithdrawMsgsRcvd Address withdraw messages received.

AddressWithdrawMsgsSent Address withdraw messages sent.

InitMsgsSent Initial messages sent.

InitMsgsRcvd Initial messages received.

KeepaliveMsgsRcvd Keepalive messages received.

KeepaliveMsgsSent Keepalive messages sent.

LabelMappingMsgsRcvd Label mapping messages received.

LabelMappingMsgsSent Label mapping messages sent.

LabelReleaseMsgsRcvd Label release messages received.

LabelReleaseMsgsSent Label release messages sent.

LabelWithdrawMsgsRcvd Label withdraw messages received.

LabelWithdrawMsgsSent Label withdraw messages sent.

NotificationMsgsRcvd Notification messages received.

NotificationMsgsSent Notification messages sent.

TotalMsgsRcvd Total messages received.

TotalMsgsSent Total messages sent.

node cpu AverageCPUUsed Average system percent CPU utilization.

NoProcesses Number of processes.

node memory CurrMemory Current application memory (in bytes) in use.

PeakMemory Maximum system memory (in MB) used since bootup.

node process AverageCPUUsed Average percent CPU utilization.

NumThreads Number of threads.

PeakMemory Maximum dynamic memory (in KB) used since startup time.





ospf v2protocol InputPackets Total number of packets received

OutputPackets Total number of packets sent

InputHelloPackets Number of Hello packets received

OutputHelloPackets Number of Hello packets sent

InputDBDs Number of DBD packets received

InputDBDsLSA Number of LSA received in DBD packets

OutputDBDs Number of DBD packets sent.

OutputDBDsLSA Number of LSA sent in DBD packets

InputLSRequests Number of LS requests received.

InputLSRequestsLSA Number of LSA received in LS requests.

OutputLSRequests Number of LS requests sent.

OutputLSRequestsLSA Number of LSA sent in LS requests.

InputLSAUpdates Number of LSA updates received.

InputLSAUpdatesLSA Number of LSA received in LSA updates.

OutputLSAUpdates Number of LSA updates sent.

OutputLSAUpdatesLSA Number of LSA sent in LSA updates.

InputLSAAcks Number of LSA acknowledgements received.

InputLSAAcksLSA Number of LSA received in LSA acknowledgements.

OutputLSAAcks Number of LSA acknowledgements sent.

OutputLSAAcksLSA Number of LSA sent in LSA acknowledgements.

ChecksumErrors Number of packets received with checksum errors.





Task ID

Examples The following example shows how to create a template for monitoring BGP thresholds that 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/RP0/CPU0:router(config)# performance-mgmt thresholds bgp template bgp_thresh1RP/0/RP0/CPU0:router(config-threshold-bgp)# ConnDropped GT 50 rearm toggle

The following 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/RP0/CPU0:router(config)# performance-mgmt thresholds node cpu template cpu_thresh1RP/0/RP0/CPU0:router(config-threshold-bgp)# AverageCPUUsed GT 25 percent

ospf v3protocol InputPackets Total number of packets received.

OutputPackets Total number of packets sent.

InputHelloPackets Number of Hello packets received.

OutputHelloPackets Number of Hello packets sent.

InputDBDs Number of DBD packets received.

InputDBDsLSA Number of LSA received in DBD packets.

OutputDBDs Number of DBD packets sent.

OutputDBDsLSA Number of LSA sent in DBD packets.

InputLSRequests Number of LS requests received.


OutputLSRequests Number of LS requests sent.

OutputLSRequestsLSA Number of LSA sent in LS requests.

InputLSAUpdates Number of LSA updates received.


OutputLSAUpdates Number of LSA updates sent.

OutputLSAUpdatesLSA Number of LSA sent in LSA updates.

InputLSAAcks Number of LSA acknowledgements received.

InputLSAAcksLSA Number of LSA received in LSA acknowledgements.

OutputLSAAcks Number of LSA acknowledgements sent

OutputLSAAcksLSA Number of LSA sent in LSA acknowledgements.



Task ID Operations

monitor read/write



The following 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/RP0/CPU0:router(config)# performance-mgmt thresholds interface generic_ctr template intf_crc_thresh1RP/0/RP0/CPU0:router(config-threshold-bgp)# InputCRC GE 1000


performance-mgmt apply thresholds Enables threshold monitoring for BGP.

performance-mgmt resources tftp-server Configures a TFTP resource for performance management.



Performance Management Commands on Cisco IOS XR Softwareshow performance-mgmt bgp

show performance-mgmt bgpTo display performance management (PM) data from Border Gateway Protocol (BGP) entity instance monitoring or statistics collections, use the show performance-mgmt bgp command in EXEC mode.

show performance-mgmt {monitor | statistics} bgp {ip-address | all} {sample-id | all-samples | last-sample}

Syntax Description


Command Modes EXEC

Command History


Task ID

monitor Displays the data collected for an entity instance monitoring collection. The data gathered is from one sample cycle of a BGP statistics collection template. The data is available only as the monitor data is enabled.

statistics Displays the data collected from statistics collection samples.

ip-address IP address of a BGP peer.

all Displays all BGP peer instances.

Note This option is available only with the statistics keyword. It is not available with the monitor keyword because an entity instance monitoring collection captures data from an entity instance for one sampling cycle.

sample-id Sample ID of the monitoring or statistics collection to be displayed.

all-samples Displays all collected samples.

last-sample Displays the last collected samples.





Task ID Operations

monitor read


Performance Management Commands on Cisco IOS XR Softwareshow performance-mgmt bgp

Examples The following is sample output from the show performance-mgmt bgp command:

RP/0/0/CPU0:router# show performance-mgmt monitor bgp 10.0.0.0 all-samples

BGP Neighbor: 10.0.0.0 Sample no: 1----------------------------------------------InputMessages: 0 OutputMessages: 0InputUpdateMessages: 0 OutputUpdateMessages: 0ConnEstablished: 0 ConnDropped: 0ErrorsReceived: 0 ErrorsSent: 0

BGP Neighbor: 10.0.0.0 Sample no: 2----------------------------------------------InputMessages: 0 OutputMessages: 0InputUpdateMessages: 0 OutputUpdateMessages: 0ConnEstablished: 0 ConnDropped: 0ErrorsReceived: 0 ErrorsSent: 0

BGP Neighbor: 10.0.0.0 Sample no: 3---------------------------------------------------InputMessages: 0 OutputMessages: 0InputUpdateMessages: 0 OutputUpdateMessages: 0ConnEstablished: 0 ConnDropped: 0ErrorsReceived: 0 ErrorsSent: 0

Table 31 describes the significant fields in the display.

Table 31 show performance-mgmt bgp Field Descriptions

Field Description

ConnDropped Number of times the connection was dropped.

ConnEstablished Number of times the connection was established.

ErrorsReceived Number of error notifications received on the connection.

ErrorsSent Number of error notifications sent on the connection.

InputMessages Number of messages received.

InputUpdateMessages Number of update messages received.

OutputMessages Number of messages sent.

OutputUpdateMessages Number of update messages sent.


Performance Management Commands on Cisco IOS XR Softwareshow performance-mgmt interface

show performance-mgmt interface To display performance management (PM) data from interface entity instance monitoring or statistics collections, use the show performance-mgmt interface command in EXEC mode.

show performance-mgmt {monitor | statistics} interface {data-rates | generic-counters} {type instance | all} {sample-id | all-samples | last-sample}

Syntax Description monitor Displays the data collected for an entity instance monitoring collection. The data gathered is from one sample cycle from one instance of an interface data entity collection template.

Note The data is available to be display only as the monitor data is collected.


data-rates Displays data from interface data rates entity collections.

generic-counters Displays data from interface generic counters entity collections.

type Interface type. For more information, use the question mark (?) online help function.










all Displays all interface instances.

Note This option is available only with the statistics keyword. It is not available with the monitor keyword because a entity instance monitoring collection captures data from an entity instance for one sampling cycle.







Command Modes EXEC

Command History


Task ID

Examples The following is sample output from the show performance-mgmt interface command:

RP/0/RP0/CPU0:router# show performance-mgmt monitor interface generic-counters pos 0/3/0/0 all-samples

Interface: POS0_3_0_0 Sample no: 1------------------------------------------------InPackets: 0 OutPackets: 0InOctets: 0 OutOctets: 0InUcastPkts: 0 OutUcastPkts: 0InMulticastPkts: 0 OutMulticastPkts: 0InBroadcastPkts: 0 OutBroadcastPkts: 0InputTotalDrops: 0 OutputTotalDrops: 0InputTotalErrors: 0 OutputTotalErrors: 0InputOverrun: 0 OutputUnderrun: 0InputQueueDrops: 0 InputUnknownProto: 0InputCRC: 0 InputFrame: 0

Interface: POS0_3_0_0 Sample no: 2------------------------------------------------InPackets: 0 OutPackets: 0InOctets: 0 OutOctets: 0InUcastPkts: 0 OutUcastPkts: 0InMulticastPkts: 0 OutMulticastPkts: 0InBroadcastPkts: 0 OutBroadcastPkts: 0InputTotalDrops: 0 OutputTotalDrops: 0InputTotalErrors: 0 OutputTotalErrors: 0InputOverrun: 0 OutputUnderrun: 0InputQueueDrops: 0 InputUnknownProto: 0InputCRC: 0 InputFrame: 0





Task ID Operations

monitor read



Table 32 describes the significant fields shown in the display.

Table 32 show performance-mgmt interface Field Descriptions

Field Description

InBroadcastPkts Broadcast packets received.

InMulticast Pkts Multicast packets received.

InOctets Bytes received.

InPackets Packets received.

InputCRC Inbound packets discarded with incorrect CRC.

InputFrame Inbound framing errors.

InputOverrun Input overruns.

InputQueueDrops Input queue drops.

InputTotalDrops Inbound correct packets discarded.

InputTotalErrors Inbound incorrect packets discarded.

InUcastPkts Unicast packets received.

InputUnknownProto Inbound packets discarded with unknown proto.

OutBroadcastPkts Broadcast packets sent.

OutMulticastPkts Multicast packets sent.

OutOctets Bytes sent.

OutPackets Packets sent.

OutputTotalDrops Outbound correct packets discarded.

OutputTotalErrors Outbound incorrect packets discarded.

OutUcastPkts Unicast packets sent.

OutputUnderrun Output underruns.


Performance Management Commands on Cisco IOS XR Softwareshow performance-mgmt mpls

show performance-mgmt mplsTo display performance management (PM) data for Multiprotocol Label Switching (MPLS) entity instance monitoring and statistics collections, use the show performance-mgmt mpls command in EXEC mode.

show performance-mgmt {monitor | statistics} mpls ldp {ip-address | all}} {sample-id | all-samples | last-sample}

Syntax Description


Command Modes EXEC

Command History


monitor Displays the data collected for an entity instance monitoring collection. The data gathered is from one sample cycle from one instance of an MPLS entity collection template.

Note The data is available to be displayed only as the monitor data is collected.


ldp Displays data from MPLS Label Distribution Protocol (LDP) collections.

ip-address IP address of LDP session instance.

all Displays data from all LDP session instances.










Performance Management Commands on Cisco IOS XR Softwareshow performance-mgmt mpls

Task ID

Examples The following is sample output from the show performance-mgmt mpls command:

RP/0/0/CPU0:router# show performance-mgmt monitor mpls ldp 11.11.11.11 last-sample

LDP Neighbor: 11.11.11.11 Sample no: 2-------------------------------------------------------TotalMsgsSent: 131, TotalMsgsRcvd: 131InitMsgsSent: 1, InitMsgsRcvd: 1AddressMsgsSent: 1, AddressMsgsRcvd: 1AddressWithdrawMsgsSent: 0, AddressWithdrawMsgsRcvd: 0LabelMappingMsgsSent: 6, LabelMappingMsgsRcvd: 7LabelWithdrawMsgsSent: 0, LabelWithdrawMsgsRcvd: 0LabelReleaseMsgsSent: 0, LabelReleaseMsgsRcvd: 0NotificationMsgsSent: 0 NotificationMsgsRcvd: 0


Task ID Operations

monitor read

Table 33 show performance-mgmt mpls Field Descriptions

Field Description

InitMsgsSent Initial messages sent.

InitMsgsRcvd Initial messages received.

TotalMsgsSent Total messages sent.

TotalMsgsRcvd Total messages received.

AddressMsgsSent Address messages sent.


Performance Management Commands on Cisco IOS XR Softwareshow performance-mgmt node

show performance-mgmt nodeTo display performance management (PM) data for node entity monitoring and statistics collections, use the show performance-mgmt node command in EXEC mode.

show performance-mgmt {monitor | statistics} node {cpu | memory | process} {location {node-id | all} {sample-id | all-samples | last-sample}

Syntax Description


Command Modes EXEC

Command History


monitor Displays the data collected for an entity instance monitoring collection. The data gathered is from one sample cycle from one instance of a node entity collection template.

Note The data is only available to be displayed as the monitor data is collected.


cpu Displays data from the central processing unit (CPU).

memory Displays data from memory.

process Displays data from processes

location Specifies the location of data origination.

node-id Location of the node. The node-id argument is entered in the rack/slot/module notation.

all Displays data from all LDP session instances.







Performance Management Commands on Cisco IOS XR Softwareshow performance-mgmt node

Task ID

Examples The following is sample output from the show performance-mgmt node command:

RP/0/RP0/CPU0:router# show performance-mgmt monitor node process location 0/RP1/CPU0 process 614587 last-sample

Node ID: 0_RP1_CPU0 Sample no: 1----------------------------------------------

Process ID: 614587----------------------------------------------

PeakMemory: 908 AverageCPUUsed: 0NoThreads: 5


Task ID Operations

monitor read

Table 34 show performance-mgmt node Field Descriptions

Field Description

PeakMemory Maximum system memory (in MB) used since bootup.

AverageCPUused Average system percent CPU utilization.

NoThreads Number of threads.


Performance Management Commands on Cisco IOS XR Softwareshow running performance-mgmt

show running performance-mgmtUse the show running performance-mgmt command in EXEC mode to display a list of configured templates and the template being applied.

show running performance-mgmt [apply | resources | statistics | thresholds]

Syntax Description

Command History


Command Modes EXEC


Task ID

Examples The following example shows the list of statistic and threshold templates, the configuration of each template, and at the end, which templates are enabled for collection:

RP/0/RP0/CPU0:router(config)# show running performance-mgmt

performance-mgmt resources tftp-server 192.168.134.254 directory muckier/jagrelo/pmtestperformance-mgmt statistics bgp template template3 sample-size 5 sample-interval 60!performance-mgmt statistics node cpu template template4

apply Displays the list of apply template commands in the current configuration.

resources Displays the existing resource configuration commands applied.

statistics Displays the list of configured statistics templates.

thresholds Displays the list of configured threshold templates.







Task ID Operations

monitor read/write


Performance Management Commands on Cisco IOS XR Softwareshow running performance-mgmt

sample-size 30 sample-interval 2!performance-mgmt statistics interface generic-counters template template2 sample-size 3 sample-interval 10!performance-mgmt statistics interface data-rates template template1 sample-size 10 sample-interval 5!performance-mgmt statistics node memory template template5 sample-size 30 sample-interval 2!performance-mgmt statistics node process template template6 sample-size 10 sample-interval 5!performance-mgmt thresholds node cpu template template20 AverageCpuUsed GT 75 sample-interval 5!performance-mgmt apply statistics interface generic-counters template2performance-mgmt apply statistics node memory global template5performance-mgmt apply statistics node process 0/0/CPU0 template6performance-mgmt apply thresholds node cpu global template20


Performance Management Commands on Cisco IOS XR Softwareshow system verify

show system verifyUse the show system verify command in EXEC mode to verify the system parameters.

show system verify [start | report | detail]

Syntax Description


Command Modes EXEC

Command History


You must run the show system verify command with the start keyword before generating any reports.

Task ID

Examples The following example shows how to prepare for system verification:

RP/0/RP1/CPU0:router# show system verify start

Storing initial router status ...done.

The following example shows output from running the show system verify command:

RP/0/RP1/CPU0:router# show system verify

Getting current router status ... System Verification Report

start Performs an initial analysis of the system and stores the information for subsequent verification.

detail Generates a detailed report for the system verification process.

report Generates a report for the system verification process.


Release 3.2 This command was first supported on the Cisco CRS-1 and the Cisco XR 12000 Series Router.



Task ID Operations

system read



==========================- Verifying Memory Usage- Verified Memory Usage : [OK] - Verifying CPU Usage- Verified CPU Usage : [OK]

- Verifying Blocked Processes- Verified Blocked Processes : [OK] - Verifying Aborted Processes- Verified Aborted Processes : [OK] - Verifying Crashed Processes- Verified Crashed Processes : [OK]

- Verifying LC Status- Verified LC Status : [OK] - Verifying QNET StatusUnable to get current LC status info- Verified QNET Status : [FAIL]

- Verifying GSP Fabric Status- Verified GSP Fabric Status : [OK] - Verifying GSP Ethernet Status gsp WARNING messages for router Current set of gsp ping nodes does not match initial set of nodes- Verified GSP Ethernet Status : [WARNING]

- Verifying POS interface Status- Verified POS interface Status : [OK] - Verifying TenGigE interface Status- Verified TenGigE interface Status : [OK]

- Verifying TCP statistics- Verified TCP statistics : [OK] - Verifying UDP statistics tcp_udp_raw WARNING messages for router UDP Packets sent has not increased during this period.- Verified UDP statistics : [WARNING]- Verifying RAW statistics- Verified RAW statistics : [OK]

- Verifying RIB Status- Verified RIB Status : [OK] - Verifying CEF Status- Verified CEF Status : [OK] - Verifying CEF Consistency Status- Verified CEF Consistency Status : [OK] - Verifying BGP Status- Verified BGP Status : [OK] - Verifying ISIS Status- Verified ISIS Status : [OK] - Verifying OSPF Status- Verified OSPF Status : [OK]

- Verifying Syslog Messages- Verified Syslog Messages : [OK]

System may not be stable. Please look into WARNING messages.




Table 35 show system verify Field Descriptions

Field Description

Type Type of memory

Initial Initial usage determined when the command is run with the start keyword

Current Current usage

Application Memory used for applications

Available Memory available for applications

Physical Total physical memory

nodes Devices in the system such as linecards, route processors, fabric cards, and so forth

blocked processes Number of blocked processes on the router

aborted processes Number of aborted processes on the router

crashed processes Number of crashed processes on the router

LC Status on Router Linecard status

QNET Status on router Internal communications protocol status

GSP Fabric Status on router Internal communications protocol status

GSP Ethernet Status on router Internal communications protocol status

POS Interface Status on router Packet-over-SONET status

Protocol Protocol on the interface

IP address IP Address of the interface

Encapsulation Encapsulation method used on the interface

MTU Maximum Transmission Units for the interface

Keep alive Keep alives messages on the interface

Packets Input Total number packets input to the interface

Bytes Input Total number of bytes input to the interface

Packets Output Total number of packets output by the interface

Byte Output Total number of bytes output by the interface

TenGigE interface Status on router 10 Gigabit Ethernet interface status

TCP statistics on router Transmission Control Protocol statistics

UDP statistics on router User Datagram Protocol statistics

RAW statistics on router RAW statistics

PCBs Protocol Control Blocks

RIB Status on router Routing Information Base status

CEF Status on node...... Cisco Express Forwarding status

CEF Consistency Status on router Cisco Express Forwarding consistency status

BGP Status on router Border Gateway Protocol status

neighbors Number of BGP neighbors



established Number of BGP neighbors in ‘established’ state

ISIS Status on router Intermediate System-to-Intermediate System status

up Number of ISIS links up

failed Number of failed ISIS links

init Initial number of ISIS links

OSPF Status on router Open Shortest Path First status

interfaces Number of interfaces configured in OSPF

interfaces_up Number of interfaces configured in OSPF that are in the ‘up’ state

virtual_int Number of virtual interfaces

neighbors Number of OSPF neighbors configured

neighbors_adj Number of OSPF configured neighbors that are ‘adjacent’

Syslog Messages on router Number of syslog messages

Table 35 show system verify Field Descriptions (continued)

Field Description


Performance Management Commands on Cisco IOS XR Software

Technology

Transcript of Performance Management Commands on Cisco IOS XR Software