Statistics Service Commands


Note

All commands applicable for the Cisco NCS 5500 Series Router are also supported on the Cisco NCS 540 Series Router that is introduced from Cisco IOS XR Release 6.3.2. References to earlier releases in Command History tables apply to only the Cisco NCS 5500 Series Router.


Note

  • Starting with Cisco IOS XR Release 6.6.25, all commands applicable for the Cisco NCS 5500 Series Router are also supported on the Cisco NCS 560 Series Routers.

  • Starting with Cisco IOS XR Release 6.3.2, all commands applicable for the Cisco NCS 5500 Series Router are also supported on the Cisco NCS 540 Series Router.

  • References to releases before Cisco IOS XR Release 6.3.2 apply to only the Cisco NCS 5500 Series Router.

  • Cisco IOS XR Software Release 7.0.1 specific updates are not applicable for the following variants of Cisco NCS 540 Series Routers:

    • N540-28Z4C-SYS-A

    • N540-28Z4C-SYS-D

    • N540X-16Z4G8Q2C-A

    • N540X-16Z4G8Q2C-D

    • N540X-16Z8Q2C-D

    • N540-12Z20G-SYS-A

    • N540-12Z20G-SYS-D

    • N540X-12Z16G-SYS-A

    • N540X-12Z16G-SYS-D

This module describes the Cisco IOS XR software commands related to the collection of interface statistics (StatsD) for system monitoring on the router. Interface statistics on the router are found in hardware (most of the time) and software (exception packets). The counters are always local (relative to the CPU) to the node on which the interface is homed. The Cisco IOS XR software provides an efficient mechanism to collect these counters from various application-specific integrated circuits (ASICs) or NetIO and assemble an accurate set of statistics for an interface. After the statistics are produced, they can be exported to interested parties (command-line interface [CLI], Simple Network Management Protocol [SNMP], and so forth).

The Cisco IOS XR software statistics collection system provides a common framework to be used by all interface owners to export the statistics for interfaces they own. The system also defines a common set of statistics that are relevant to all interfaces and thereby provides a consistent and constant set of counters that are always associated and maintained with any interface on the router.

The statistics collection system includes the statistics manager, the statistics server, one or more statistics collectors, and the necessary libraries. Each node on a router houses one statistics server.

In addition to the statistics server, each node (that has interfaces) has one or more statistics collectors. Statistics collectors are platform specific and can obtain various hardware and software counters to satisfy requests from the statistics server.

The statistics manager does not attempt to produce statistics for interfaces for which no statistics collector has registered. Requests for statistics on interfaces for which no statistics collector has registered results in an error returned to the requestor by the statistics manager.

clear counters

To clear the interface counters, use the clear counters command in XR EXEC mode.

clear counters [all | type interface-path-id]

Syntax Description

all

(Optional) Clears counters on all interfaces.

type

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

interface-path-id

(Optional) Physical interface or virtual interface.

Note

 

Use the show interfaces command to see a list of all interfaces currently configured on the router.

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

Command Default

Counters for all interfaces are cleared.

Command Modes

XR EXEC mode

Command History

Release

Modification

Release 6.0

This command was introduced.

Usage Guidelines

Use the clear counters command to clear all the statistics counters displayed by the show interfaces command. If no optional arguments are supplied or if the all keyword is specified, then the counters for all interfaces are cleared. If an interface type is specified, then only the counters for that interface are cleared.

The clear counters command with the all option clears counters on all interfaces. When you enter this command, the system prompts you for confirmation. You must then press Enter or the y key for the clear counters command to take effect.


Note

This command does not clear counters retrieved using Simple Network Management Protocol (SNMP), but only those counters displayed with the show interfaces command.

Task ID

Task ID

Operations

interface

execute

Examples

This example shows how to clear counters on all interfaces: 


RP/0/RP0/CPU0:router# clear counters all
Clear "show interface" counters on all interfaces [confirm]

load-interval

To specify the interval for load calculation of an interface, use the load-interval command in interface configuration mode. To reset the load interval to the default setting, use the no form of this command.

load-interval seconds

no load-interval seconds

Syntax Description

seconds

Number of seconds for load calculation of an interface. The value range is from 0 to 600 seconds and in increments of 30 (such as 30, 60, 90, and so on). The default is 300 seconds.

Command Default

seconds : 300 seconds (5 minutes)

Command Modes

Interface configuration

Command History

Release

Modification

Release 6.0

This command was introduced.

Usage Guidelines

When load interval is set to zero, load calculation is disabled. If you set the load interval, you must use a multiple of 30 (up to 600 seconds).

Task ID

Task ID

Operations

interface

read/write

Examples

This example shows how to configure the load interval to 30 seconds: 


RP/0/RP0/CPU0:router# configure
RP/0/RP0/CPU0:router(config)# interface hundredGigE 0/1/0/0
RP/0/RP0/CPU0:router(config-if)# load-interval 30

show environment

To display environmental parameters of the system, use the show environment command in the admin prompt.

show environment [ all | fans | last | current | leds | power-supply | table | temperatures | voltages ] node-id

Syntax Description

all

(Optional) Displays information for all environmental monitor parameters.
fans

(Optional) Displays information about the fans.
last

(Optional) Displays the environmental statistics at the time of the last shutdown.
current

(Optional) Displays the environmental sensors information.

leds

(Optional) Displays monitor parameters for LEDs of all cards in the node.

power

(Optional) Displays power supply voltage and current information.

table

(Optional) Displays environmental parameter ranges.

temperatures

(Optional) Displays system temperature information.

voltages

(Optional) Displays system voltage information.

node-id

(Optional) Node whose information you want to display. The node-id argument is expressed in the rack/slot/module notation.

Command Default

All environmental monitor parameters is displayed.

Command Modes

XR EXEC mode

Command History

Release

Modification

Release 3.2

This command was introduced.

Release 3.3.0

The show environment command was moved from the root-system task ID to the system task ID.

Usage Guidelines

The show environment command displays information about the hardware that is installed in the system, including fans, LEDs, power supply voltage, and temperatures.

Task ID

Task ID

Operations

system

read

Examples

This example shows sample output from the show environment command with the all keyword. 

Router# show environment
Possible completions:
  all        All environment monitor parameters
  altitude   Chassis altitude in Meters
Router# show environment altitude 
Thu Nov  21 04:02:01.153 UTC+00:00
================================================================================
   Location      Altitude Value (Meters)     Source
--------------------------------------------------------------------------------
   0             0                           config                   
Router#

Examples

This example shows sample output from the show environment command with the current keyword. 

Router# show environment current 
Thu Nov  21 04:02:07.870 UTC+00:00
================================================================================
Location  CURRENT                     Value    
          Sensor                      (mA)     
--------------------------------------------------------------------------------
0/0/1        
          MPA-P3V3_CFP_IOUT             125  
          MPA-Hot_Swap_IIN             1208  
0/RP0        
          MB-P3V3_SFP_IOUT             2312  
          MB-P1V0_CORE_JER0_IOUT      53500  
          MB-P1V0_AVDD_JER0_IOUT      17750  
          MB-P0V85_SRAM_KBP0_IOUT       750  
          MB-P0V85_CORE_KBP0_IOUT      9250  
          CPU-CPUVCC-IOUT-P3           7500  
          CPU-CPUVCC-IIN-P3            1156  
          CPU-VDDQ-1V2-IOUT-P3         3500  
          CPU-VDDQ-1V2-IIN-P3           375  
          CPU-PVCC-1V05-IOUT-P3        4250  
          CPU-PVCC-1V05-IIN-P3          421  
Router#

Examples

This example shows sample output from the show environment command with the fan keyword to view the chassis fan information. 

Router# show environment fan 
Thu Nov  21 04:02:16.387 UTC+00:00
=============================================
Location    Fan        Speed (rpm)
---------------------------------------------
0/FT0        
            FAN0            12826    
0/FT1        
            FAN0            12796    
0/FT2        
            FAN0            13106    
0/FT3        
            FAN0            13267    
0/FT4        
            FAN0            13106    
0/FT5        
            FAN0            13106    
0/FT6        
            FAN0            13636    
0/FT7        
            FAN0            12857    
0/PM0        
            FAN0            10016    
0/PM1        
            FAN0                0

Examples

This example shows sample output from the show environment command with the power keyword to view the power information of a router. 

Router# show environment power 
Thu Nov  21 04:02:25.247 UTC+00:00
================================================================================
CHASSIS LEVEL POWER INFO: 0
================================================================================
   Total output power capacity (Group 0 + Group 1) :    1200W +       0W
   Total output power required                     :     670W
   Total power input                               :     253W
   Total power output                              :     226W

Power Group 0: 
================================================================================
   Power       Supply     ------Input----   ------Output---      Status
   Module      Type        Volts     Amps    Volts     Amps    
================================================================================
   0/PM0       1.2kW-AC    230.0      1.1     12.0     18.8    OK 

Total of Power Group 0:        253W/  1.1A       226W/ 18.8A

Power Group 1: 
================================================================================
   Power       Supply     ------Input----   ------Output---      Status
   Module      Type        Volts     Amps    Volts     Amps    
================================================================================
   0/PM1       1.2kW-AC      0.0      0.0      0.0      0.0    FAILED or NO PWR 

Total of Power Group 1:          0W/  0.0A         0W/  0.0A

================================================================================
   Location     Card Type            Power       Power       Status
                                     Allocated   Used
                                     Watts       Watts
================================================================================
   0/0/1        NC55-MPA-1TH2H-S         0          14       ON 
   0/0                 -                 0           -       - 
   0/RP0        NCS-55A2-MOD-SE-S      510           -       ON 
   0/FT0        NC55-A2-FAN-FW          20           -       ON 
   0/FT1        NC55-A2-FAN-FW          20           -       ON 
   0/FT2        NC55-A2-FAN-FW          20           -       ON 
   0/FT3        NC55-A2-FAN-FW          20           -       ON 
   0/FT4        NC55-A2-FAN-FW          20           -       ON 
   0/FT5        NC55-A2-FAN-FW          20           -       ON 
   0/FT6        NC55-A2-FAN-FW          20           -       ON 
   0/FT7        NC55-A2-FAN-FW          20           -       ON

Examples

This example shows sample output from the show environment command with the power keyword to view the power information of a specified location. 

Router# show environment power location 0
Possible completions:
  0  0/0  0/0/1  0/FT0  0/FT1  0/FT2  0/FT3  0/FT4  0/FT5  0/FT6  0/FT7  0/PM0  0/PM1  0/RP0
sysadmin-vm:0_RP0# show environment power location 0/RP0
Thu Nov  21 04:02:41.827 UTC+00:00

================================================================================
   Location     Card Type            Power       Power       Status
                                     Allocated   Used
                                     Watts       Watts
================================================================================
   0/RP0        NCS-55A2-MOD-SE-S      510           -       ON 
sysadmin-vm:0_RP0#

Examples

This example shows sample output from the show environment command with the temperatures keyword to view the temperature information of a router. 

Router# show environment temperatures 
Thu Nov  21 04:02:50.992 UTC+00:00
================================================================================
Location  TEMPERATURE                 Value   Crit Major Minor Minor Major  Crit
          Sensor                    (deg C)   (Lo) (Lo)  (Lo)  (Hi)  (Hi)   (Hi)
--------------------------------------------------------------------------------
0/0/1        
          MPA-Port-Side-Temp             26    -10    -5     0   100   105   110
          MPA-DCO-Temp                    -     -3     0     5    70    73    75
          MV88EC808_PHY0_Temp            38    -40   -35   -30   105   108   110
          MV88EC808_PHY1_Temp            34    -40   -35   -30   105   108   110
0/RP0        
          Control Sensor                 31    -10    -5     0    60    71    82
          FAN-side Sensor                34    -10    -5     0   100   105   110
          MB-P1V0_CORE_JER0_TEMP         57    -10    -5     0   125   127   130
          MB-P1V0_AVDD_JER0_TEMP         56    -10    -5     0   125   127   130
          Slice 0 Die Temp               52    -10    -5     0   115   120   125
          Slice 0 TMP421 Temp            47    -10    -5     0   115   120   125
          MV88EC808_PHY0_Temp            52    -40   -35   -30   100   105   110
          MV88EC808_PHY1_Temp            47    -40   -35   -30   100   105   110
          CPU                            36    -10    -5     0    90    96   102
          PORT-side Sensor               28    -10    -5     0   100   105   110
          MAXIM_RMT_CH1                  32    -10    -5     0   125   130   135
          MAXIM_RMT_CH2                  42    -10    -5     0   125   130   135
          MAXIM_RMT_CH3                  30    -10    -5     0   125   130   135
          MAXIM_RMT_CH4                  32    -10    -5     0   125   130   135
          MAXIM_RMT_CH5                  56    -10    -5     0   125   130   135
          MAXIM_RMT_CH6                  35    -10    -5     0   125   130   135
          MAXIM_LCL_CH7                  32    -10    -5     0   125   130   135
0/PM0        
          Inlet Temperature              30    -10    -5     0    70    72    75
0/PM1        
        ! Inlet Temperature               0    -10

Examples

This example shows sample output from the show environment command with the temperatures keyword with a specified location. 

Router# show environment temperatures location 0/0/1 
Thu Nov  21 04:02:59.533 UTC+00:00
================================================================================
Location  TEMPERATURE                 Value   Crit Major Minor Minor Major  Crit
          Sensor                    (deg C)   (Lo) (Lo)  (Lo)  (Hi)  (Hi)   (Hi)
--------------------------------------------------------------------------------
0/0/1        
          MPA-Port-Side-Temp             26    -10    -5     0   100   105   110
          MPA-DCO-Temp                    -     -3     0     5    70    73    75
          MV88EC808_PHY0_Temp            38    -40   -35   -30   105   108   110
          MV88EC808_PHY1_Temp            34    -40   -35   -30   105   108   110
sysadmin-vm:0_RP0#

Examples

This example shows sample output from the show environment command with the voltages keyword to view the voltage information of a router. 

Router# show environment voltages 
Thu Nov  21 04:03:11.932 UTC+00:00
================================================================================
Location  VOLTAGE                     Value   Crit Minor Minor  Crit
          Sensor                      (mV)    (Lo) (Lo)  (Hi)   (Hi)
--------------------------------------------------------------------------------
0/0/1        
          MPA-P12V_VOUT               11993  10800 11040 12960 13200
          MPA-P3V3_STBY_VOUT           3307   2970  3036  3564  3630
          MPA-P3V3_VA_VOUT             3353   2970  3036  3564  3630
          MPA-P2V5_VA_VOUT             2516   2250  2300  2700  2750
          MPA-P1V2_VA_VOUT             1204   1080  1104  1296  1320
          MPA-P1V8_VOUT                1808   1620  1656  1944  1980
          MPA-P1V0_BV_AVDD_VOUT        1007    900   920  1080  1100
          MPA-P1V0_BV_VDD_VOUT         1001    900   920  1080  1100
          MPA-P2V5_BV_VDDO_VOUT        2517   2250  2300  2700  2750
          MPA-P3V3_CFP_VOUT            3344   2970  3036  3564  3630
          MPA-DCO-VOLTAGE_VOUT            -   2970  3036  3564  3630
          MPA-Hot_Swap_VIN            11979  10560 11040 12960 13440
0/RP0        
          MB-P1V0_SEC_S_VOUT           1002    900   920  1080  1100
          MB-P1V0_PHY_S_VOUT            997    900   920  1080  1100
          MB-P1V8_STATS_VOUT           1794   1620  1656  1944  1980
          MB-P5V0_S_VOUT               4992   4500  4600  5400  5500
          MB-P2V5_S_VOUT               2499   2250  2300  2700  2750
          MB-P1V2_S_VOUT               1201   1080  1104  1296  1320
          MB-P3V3_S_VOUT               3311   2970  3036  3564  3630
          MB-P1V2_VA_S_VOUT            1195   1080  1104  1296  1320
          MB-P2V5_VA_S_VOUT            2530   2250  2300  2700  2750
          MB-P3V3_VA_S_VOUT            3305   2970  3036  3564  3630
          MB-P12V_S_VOUT              11982  10800 11040 12960 13200
          MB-P3V3_SFP_VOUT             3311   2970  3036  3564  3630
          MB-P0V72_STATS_VOUT           850    765   782   918   935
          MB-P0V85_STATS_VOUT           843    765   782   918   935
          MB-P0V9_STATS_VOUT            896    810   828   972   990
          MB-P1V2_STATS_VOUT           1200   1080  1104  1296  1320
          MB-P1V0_CORE_JER0_VOUT       1000    900   920  1080  1100
          MB-P1V0_AVDD_JER0_VOUT       1000    900   920  1080  1100
          MB-P3V3_JER0_VOUT            3306   2970  3036  3564  3630
          MB-P1V8_JER0_VOUT            1808   1620  1656  1944  1980
          MB-P1V25_AVDD_JER0_VOUT      1258   1080  1104  1296  1320
          MB-P1V0_DDR_JER0_VOUT        1003    900   920  1080  1100
          MB-P1V35_JER0_VOUT           1353   1215  1242  1458  1485
          MB-P1V2_HVA_KBP0_VOUT        1197   1080  1104  1296  1320
          MB-P0V8_LVA_KBP0_VOUT         880    765   782   918   935
          MB-P0V85_SRAM_KBP0_VOUT       847    765   782   918   935
          MB-P0V85_CORE_KBP0_VOUT       850    765   782   918   935
          CPU-ADM1166_VOUT_CH0         1789   1620  1656  1944  1980
          CPU-ADM1166_VOUT_CH1         2525   2250  2300  2700  2750
          CPU-ADM1166_VOUT_CH2         3312   2970  3036  3564  3630
          CPU-ADM1166_VOUT_CH3         4985   4500  4600  5400  5500
          CPU-ADM1166_VOUT_CH4        11909  10800 11040 12960 13200
          CPU-ADM1166_VOUT_CH5          594    540   552   648   660
          CPU-ADM1166_VOUT_CH6         1304   1170  1196  1404  1430
          CPU-ADM1166_VOUT_CH7         1801   1620  1656  1944  1980
          CPU-ADM1166_VOUT_CH8         1196   1080  1104  1296  1320
          CPU-ADM1166_VOUT_CH9         1050    945   966  1134  1155
          CPU-ADM1166_VOUT_CH10        1702   1530  1564  1836  1870
          CPU-ADM1166_VOUT_CH11        1491   1350  1380  1620  1650
          CPU-CPUVCC-VOUT-P3           1791   1620  1656  1940  1980
          CPU-CPUVCC-VIN-P3           11937  10800 11400 12600 13200
          CPU-VDDQ-1V2-VOUT-P3         1201   1080  1104  1296  1320
          CPU-VDDQ-1V2-VIN-P3         11968  10800 11400 12600 13200
          CPU-PVCC-1V05-VOUT-P3        1051    945   966  1134  1155
          CPU-PVCC-1V05-VIN-P3        11937  10800 11400 12600 13200
sysadmin-vm:0_RP0#