-
Cisco IOS XR System Monitoring Command Reference, Release 3.6
-
Preface
-
Alarm Management and Logging Correlation Commands on Cisco IOS XR Software
-
Embedded Event Manager Commands on Cisco IOS XR Software
-
IP Service Level Agreement Commands on Cisco IOS XR Software
-
Logging Services Commands on Cisco IOS XR Software
-
Onboard Failure Logging Commands on Cisco IOS XR Software
-
Performance Management Commands on Cisco IOS XR Software
-
Statistics Service Commands on Cisco IOS XR Software
-
Index
-
Table Of Contents
Performance Management Commands on Cisco IOS XR Software
performance-mgmt apply monitor
performance-mgmt apply statistics
performance-mgmt apply thresholds
performance-mgmt resources memory
performance-mgmt resources tftp-server
show performance-mgmt interface
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 in Cisco IOS XR System Monitoring Configuration Guide.
monitor controller fabric
To monitor controller fabric counters in real time, use the monitor controller fabric command in EXEC mode.
monitor controller fabric {plane-id | all}
Syntax Description
plane-id
Plane ID number of the fabric plane to be monitored. The range is from 0 to 7.
all
Monitors all fabric planes.
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 1.
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 0rack3-3 Monitor Time: 00:00:24 SysUptime: 03:37:57Controller fabric for 0x0Controller Fabric Stats: DeltaIn Cells 0 ( 0 per-sec) 0Out Cells 0 ( 0 per-sec) 0CE Cells 0 ( 0 per-sec) 0UCE Cells 0 ( 0 per-sec) 0PE Cells 0 ( 0 per-sec) 0Quit='q', Freeze='f', Thaw='t', Clear='c', Select controller='s'monitor controller sonet
To monitor controller counters, use the monitor controller sonet command in EXEC mode.
monitor controller sonet instance
Syntax Description
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 sonet command to display SONET controller counters. The display refreshes every 2 seconds.
The interactive commands that are available during a controller monitoring session are described in Table 2.
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/0rack3-3 Monitor Time: 00:00:06 SysUptime: 01:23:56Controller for SONET0_3_0_0Controller Stats: DeltaPath LOP 0 ( 0 per-sec) 0Path AIS 0 ( 0 per-sec) 0Path RDI 0 ( 0 per-sec) 0Path BIP 0 ( 0 per-sec) 0Path FEBE 0 ( 0 per-sec) 0Path NEWPTR 0 ( 0 per-sec) 0Path PSE 0 ( 0 per-sec) 0Path NSE 0 ( 0 per-sec) 0Line AIS 0 ( 0 per-sec) 0Line RDI 0 ( 0 per-sec) 0Line BIP 0 ( 0 per-sec) 0Line FEBE 0 ( 0 per-sec) 0Section LOS 1 ( 0 per-sec) 1Section LOF 0 ( 0 per-sec) 0Section BIP 0 ( 0 per-sec) 0Quit='q', Freeze='f', Thaw='t', Clear='c', Select controller='s'monitor interface
To monitor interface counters in real time, use the monitor interface command in EXEC or administration 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
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 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.
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.
•
•
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 interfaceInterface In(bps) Out(bps) InBytes/Delta OutBytes/DeltaMgmtEth0/RP0/CPU0/0 1142/ 0% 8057/ 0% 14.9M/300 11.5M/2115FINT0/RP0/CPU0 0/ 0% 0/ 0% 50459/0 66906/0MgmtEth0/RP1/CPU0/0 0/ 0% 0/ 0% 3.7M/0 1.7M/0FINT0/RP1/CPU0 0/ 0% 0/ 0% 9180/0 0/0GigabitEthernet0/1/5/0 0/ 0% 0/ 0% 4608/0 3024/0POS0/1/0/0 0/ 0% 0/ 0% 7.9M/0 2.2M/0POS0/1/0/1 0/ 0% 0/ 0% 275.6M/0 275.4M/0GigabitEthernet0/1/5/1 0/ 0% 0/ 0% 5.9M/0 168/0GigabitEthernet0/6/5/0 0/ 0% 0/ 0% 14.9M/0 2.4M/0POS0/6/0/0 0/ 0% 0/ 0% 7.9M/0 2.2M/0POS0/6/0/1 0/ 0% 0/ 0% 3.4M/0 2.2M/0GigabitEthernet0/6/5/1 0/ 0% 0/ 0% 4608/0 3066/0POS0/6/4/4 0/ 0% 0/ 0% 23.2M/0 2.2M/0POS0/6/4/5 0/ 0% 0/ 0% 3.4M/0 2.2M/0POS0/6/4/6 0/ 0% 0/ 0% 2.1M/0 2.2M/0POS0/6/4/7 0/ 0% 0/ 0% 3.4M/0 2.2M/0Quit='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:44Interface In(bps) Out(bps) InBytes/Delta OutBytes/DeltaPOS0/1/0/0 1263/ 0% 0/ 0% 5.3M/330 1.4M/0POS0/1/0/1 84/ 0% 0/ 0% 274.8M/22 274.6M/0POS0/6/0/0 1275/ 0% 0/ 0% 5.3M/330 1.4M/0POS0/6/0/1 85/ 0% 0/ 0% 2.6M/22 1.4M/0POS0/6/4/4 0/ 0% 0/ 0% 15.1M/0 1.4M/0POS0/6/4/5 85/ 0% 0/ 0% 2.6M/22 1.4M/0POS0/6/4/6 0/ 0% 0/ 0% 1.3M/0 1.4M/0POS0/6/4/7 85/ 0% 0/ 0% 2.6M/22 1.4M/0Quit='q', Clear='c', Freeze='f', Thaw='t',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/4router Monitor Time: 00:00:24 SysUptime: 186:43:04POS0/6/4/4 is up, line protocol is upEncapsulation HDLCTraffic Stats:(2 second rates) DeltaInput Packets: 232450 0Input pps: 0Input Bytes: 15179522 0Input Kbps (rate): 0 ( 0%)Output Packets: 67068 0Output pps: 0Output Bytes: 1475484 0Output Kbps (rate): 0 ( 0%)Errors Stats:Input Total: 2146 0Input CRC: 2134 0Input Frame: 2135 0Input Overrun: 0 0Output Total: 0 0Output Underrun: 0 0Quit='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/4router Monitor Time: 00:00:02 SysUptime: 186:49:15POS0/6/4/4 is up, line protocol is upEncapsulation HDLCTraffic Stats:(2 second rates) DeltaInput Bytes: 15188186 0Input Kbps (rate): 0 ( 0%)Output Bytes: 1476298 0Output Kbps (rate): 0 ( 0%)IPv4 UnicastInput Bytes: 0 0Input Kbps (rate): 0 ( 0%)Output Bytes: 0 0Output Kbps (rate): 0 ( 0%)IPv4 MulticastInput Bytes: 10160304 66Input Kbps (rate): 0 ( 0%)Output Bytes: 0 0Output Kbps (rate): 0 ( 0%)IPv6 UnicastInput Bytes: 0 0Input Kbps (rate): 0 ( 0%)Output Bytes: 0 0Output Kbps (rate): 0 ( 0%)IPv6 MulticastInput Bytes: 0 0Input Kbps (rate): 0 ( 0%)Output Bytes: 0 0Output Kbps (rate): 0 ( 0%)Errors Stats:Input Total: 2146 0Input CRC: 2134 0Input Frame: 2135 0Input Overrun: 0 0Output Total: 0 0Output Underrun: 0 0Quit='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-mgmt apply monitor
To 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
Defaults
Monitoring is disabled.
Command History
Command Modes
Global configuration
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 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 defaultThe 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 defaultThe 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 defaultRelated Commands
performance-mgmt apply statistics
To 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:
•
•
•
•
•
•
•
•
•
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.
default
Applies the default template.
Defaults
Statistics collection is disabled.
Command History
Command Modes
Global configuration
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
Task ID
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 bgp1The 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 defaultThe 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 defaultRelated Commands
performance-mgmt apply thresholds
To 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:
•
•
•
•
•
•
•
•
•
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.
default
Applies the default template.
Defaults
Threshold collection is disabled.
Command History
Command Modes
Global configuration
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 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 stats1The 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 stats2The 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 cpu12Related Commands
Creates a template to use for threshold collection.
Displays a list of templates and the template being applied.
performance-mgmt resources memory
To 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 kilobytes
min-reserved—10000 kilobytesCommand Modes
Global configuration
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 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
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 5000performance-mgmt resources tftp-server
To 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
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.
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
Command Modes
Global configuration
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
