monitor interface
To monitor interface counters in real time, use the monitor interface command in XR EXEC mode or System Admin EXEC mode.
monitor interface [ type1 interface-path-id1 [ . . . [ type32 interface-path-id32 ] ] [ wide ] [ full-name ] ]
Syntax Description
type |
Interface type. For more information, use the question mark ( ? ) online help function. |
||
interface-path-id |
Physical interface or virtual interface.
For more information about the syntax for the router, use the question mark ( ? ) online help function. |
||
wide |
Display detailed statistics of the interfaces. |
||
full-name |
Display full name of the interfaces. For more information, use the question mark ( ? ) online help function. |
Command Default
Use the monitor interface command without an argument to display statistics for all interfaces in the system.
Command History
Release |
Modification |
---|---|
Release 7.0.12 |
This command was introduced. |
Release 7.5.4 |
The argument full-name was introduced. |
Usage Guidelines
The argument full-name is applicable only for Release 7.5.4
Use the monitor interface command without any keywords or arguments to display interface counters for all interfaces. The display refreshes every 2 seconds.
Use the monitor interface command with the type interface-path-id arguments to display counters for a single interface. For example: monitor
To display more than one selected interface, enter the monitor interface command with multiple type interface-path-id arguments. For example: monitor interface
To display a range of interfaces, enter the monitor interface command with a wildcard. For example: monitor
You can display up to 32 specific interfaces and ranges of interfaces.
The interactive commands that are available during an interface monitoring session are described in this table.
Use the monitor interface command with the wide argument to display detailed statistics of the interfaces. For example: monitor interface HundredGigE0/0/0/0 HundredGigE0/0/0/1 HundredGigE0/0/0/2 wide
Use the monitor interface command with the full-name argument to display full name of the interfaces. Full name is more useful especially for Named interfaces, which has large character lengths. For example: monitor interface HundredGigE0/0/0/0 HundredGigE0/0/0/1 tunnel-te FROM-INDBGL-AAA-TO-USASJC-BBB-TO-CANAD-CCC full-name
Use the monitor interface command with the wide and full-name arguments to display detailed statistics of the interfaces with its full name. For example: monitor interface HundredGigE0/0/0/0 HundredGigE0/0/0/1 tunnel-te FROM-INDBGL-AAA-TO-USASJC-BBB-TO-CANAD-CCC wide full-name
Command |
Description |
Use the following keys to suspend or resume the counter refresh: |
|
f |
Freezes the display screen, thereby suspending the display of fresh counters. |
t |
Thaws the display screen, thereby resuming the display of fresh counters. |
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 (“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. You are prompted to enter the interface type and interface path ID 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. |
q |
Terminates the interface monitoring session. |
Task ID
Task ID |
Operations |
---|---|
basic-services |
execute |
monitor |
read |
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 HundredGigE interface, enter the command and wildcard monitor interface HundredGigE * .
- To display statistics for three specified interfaces, enter the command monitor interface HundredGigE 0/0/0/0 HundredGigE 0/0/0/1 HundredGigE 0/0/0/0 .
This is the sample output for the monitor interface command entered without an argument. This command displays statistics for all interfaces in the system.
Router# monitor interface
Mon Jan 16 11:14:01.107 UTC
R1 Monitor Time: 00:00:30 SysUptime: 00:48:19
Protocol:General
Interface In(bps) Out(bps) InBytes/Delta OutBytes/Delta
FH0/0/0/0 0/ 0% 0/ 0% 0/0 0/0
FH0/0/0/1 0/ 0% 0/ 0% 0/0 0/0
FH0/0/0/10 0/ 0% 0/ 0% 0/0 0/0
FH0/0/0/11 0/ 0% 0/ 0% 0/0 0/0
FH0/0/0/12 0/ 0% 0/ 0% 0/0 0/0
FH0/0/0/13 0/ 0% 0/ 0% 0/0 0/0
FH0/0/0/14 0/ 0% 0/ 0% 0/0 0/0
FH0/0/0/15 0/ 0% 0/ 0% 0/0 0/0
FH0/0/0/16 0/ 0% 0/ 0% 0/0 0/0
FH0/0/0/17 0/ 0% 0/ 0% 0/0 0/0
FH0/0/0/18 0/ 0% 0/ 0% 0/0 0/0
FH0/0/0/19 0/ 0% 0/ 0% 0/0 0/0
FH0/0/0/2 0/ 0% 0/ 0% 0/0 0/0
FH0/0/0/20 0/ 0% 0/ 0% 0/0 0/0
FH0/0/0/21 0/ 0% 0/ 0% 0/0 0/0
Quit='q', Clear='c', Freeze='f', Thaw='t',
Next set='n', Prev set='p', Bytes='y', Packets='k'
(General='g', IPv4 Uni='4u', IPv4 Multi='4m', IPv6 Uni='6u', IPv6 Multi='6m')
This is the sample output for the monitor interface command entered with single type interface-path-id argument. This command displays statistics for the entered single interface.
Router# monitor interface fourHundredGigE 0/0/0/0
Mon Jan 16 11:08:07.126 UTC
R1 Monitor Time: 00:00:18 SysUptime: 00:42:13
FourHundredGigE0/0/0/0 is administratively down, line protocol is administratively down
Encapsulation ARPA
Traffic Stats:(2 second rates) Delta
Input Packets: 0 0
Input pps: 0
Input Bytes: 0 0
Input Kbps (rate): 0 ( 0%)
Output Packets: 0 0
Output pps: 0
Output Bytes: 0 0
Output Kbps (rate): 0 ( 0%)
Errors Stats:
Input Total: 0 0
Input CRC: 0 0
Input Frame: 0 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'
This is the sample output for the monitor interface command entered with multiple type interface-path-id arguments. This command displays statistics for all entered interfaces.
Router# monitor interface fourHundredGigE 0/0/0/0 fourHundredGigE 0/0/0/1 tunnel-te FROM-BGL-AA-BB-TO-SJC-CC-DD-1 tunnel-te FROM-BGL-AA-BB-TO-SJC-CC-DD-2
Mon Jan 16 11:11:03.775 UTC
R1 Monitor Time: 00:00:12 SysUptime: 00:45:03
Protocol:General
Interface In(bps) Out(bps) InBytes/Delta OutBytes/Delta
FH0/0/0/0 0/ 0% 0/ 0% 0/0 0/0
FH0/0/0/1 0/ 0% 0/ 0% 0/0 0/0
FROM-BGL-AA- 0/ --% 0/ --% 0/0 0/0
FROM-BGL-AA- 0/ --% 0/ --% 0/0 0/0
Quit='q', Clear='c', Freeze='f', Thaw='t',
Next set='n', Prev set='p', Bytes='y', Packets='k'
(General='g', IPv4 Uni='4u', IPv4 Multi='4m', IPv6 Uni='6u', IPv6 Multi='6m')
This is the sample output for the monitor interface command entered with type interface-path-id and wide arguments. This command displays detailed statistics of the interfaces.
Router# monitor interface fourHundredGigE 0/0/0/0 fourHundredGigE 0/0/0/1 tunnel-te FROM-BGL-AA-BB-TO-SJC-CC-DD-1 tunnel-te FROM-BGL-AA-BB-TO-SJC-CC-DD-2 wide
Mon Jan 16 11:12:48.388 UTC
R1 Monitor Time: 00:00:04 SysUptime: 00:46:40
Protocol:General
Interface In(bps) Out(bps) InBytes/Delta OutBytes/Delta ErrIn/Delta ErrCRC/Delta ErrFr/Delta ErrOvr/Delta ErrOut/Delta ErrUnd/Delta
FH0/0/0/0 0/ 0% 0/ 0% 0/0 0/0 0/0 0/0 0/0 0/0 0/0 0/0
FH0/0/0/1 0/ 0% 0/ 0% 0/0 0/0 0/0 0/0 0/0 0/0 0/0 0/0
FROM-BGL-AA- 0/ --% 0/ --% 0/0 0/0 0/0 0/0 0/0 0/0 0/0 0/0
FROM-BGL-AA- 0/ --% 0/ --% 0/0 0/0 0/0 0/0 0/0 0/0 0/0 0/0
Quit='q', Clear='c', Freeze='f', Thaw='t',
Next set='n', Prev set='p', Bytes='y', Packets='k'
(General='g', IPv4 Uni='4u', IPv4 Multi='4m', IPv6 Uni='6u', IPv6 Multi='6m')
This is the sample output for the monitor interface command entered with full-name argument. This command displays statistics of all interfaces in the system with their full name.
Router# monitor interface full-name
Mon Jan 16 11:15:36.431 UTC
R1 Monitor Time: 00:00:04 SysUptime: 00:49:28
Protocol:General
In(bps) Out(bps) InBytes/Delta OutBytes/Delta Interface
0/ 0% 0/ 0% 0/0 0/0 FourHundredGigE0/0/0/0
0/ 0% 0/ 0% 0/0 0/0 FourHundredGigE0/0/0/1
0/ 0% 0/ 0% 0/0 0/0 FourHundredGigE0/0/0/10
0/ 0% 0/ 0% 0/0 0/0 FourHundredGigE0/0/0/11
0/ 0% 0/ 0% 0/0 0/0 FourHundredGigE0/0/0/12
0/ 0% 0/ 0% 0/0 0/0 FourHundredGigE0/0/0/13
0/ 0% 0/ 0% 0/0 0/0 FourHundredGigE0/0/0/14
0/ 0% 0/ 0% 0/0 0/0 FourHundredGigE0/0/0/15
0/ 0% 0/ 0% 0/0 0/0 FourHundredGigE0/0/0/16
0/ 0% 0/ 0% 0/0 0/0 FourHundredGigE0/0/0/17
0/ 0% 0/ 0% 0/0 0/0 FourHundredGigE0/0/0/18
0/ 0% 0/ 0% 0/0 0/0 FourHundredGigE0/0/0/19
0/ 0% 0/ 0% 0/0 0/0 FourHundredGigE0/0/0/2
0/ 0% 0/ 0% 0/0 0/0 FourHundredGigE0/0/0/20
0/ 0% 0/ 0% 0/0 0/0 FourHundredGigE0/0/0/21
Quit='q', Clear='c', Freeze='f', Thaw='t',
Next set='n', Prev set='p', Bytes='y', Packets='k'
(General='g', IPv4 Uni='4u', IPv4 Multi='4m', IPv6 Uni='6u', IPv6 Multi='6m')
This is the sample output for the monitor interface command entered with the type interface-path-id and full-name arguments. This command displays statistics of the interfaces with their full name.
Router# monitor interface fourHundredGigE 0/0/0/0 fourHundredGigE 0/0/0/1 tunnel-te FROM-BGL-AA-BB-TO-SJC-CC-DD-1 tunnel-te FROM-BGL-AA-BB-TO-SJC-CC-DD-2 full-name
Mon Jan 16 11:16:30.346 UTC
R1 Monitor Time: 00:00:04 SysUptime: 00:50:22
Protocol:General
In(bps) Out(bps) InBytes/Delta OutBytes/Delta Interface
0/ 0% 0/ 0% 0/0 0/0 FourHundredGigE0/0/0/0
0/ 0% 0/ 0% 0/0 0/0 FourHundredGigE0/0/0/1
0/ --% 0/ --% 0/0 0/0 FROM-BGL-AA-BB-TO-SJC-CC-DD-1
0/ --% 0/ --% 0/0 0/0 FROM-BGL-AA-BB-TO-SJC-CC-DD-2
Quit='q', Clear='c', Freeze='f', Thaw='t',
Next set='n', Prev set='p', Bytes='y', Packets='k'
(General='g', IPv4 Uni='4u', IPv4 Multi='4m', IPv6 Uni='6u', IPv6 Multi='6m')
This is the sample output for the monitor interface command entered with the type interface-path-id wide and full-name arguments. This command displays detailed statistics of the interfaces with their full name.
Router# monitor interface fourHundredGigE 0/0/0/0 fourHundredGigE 0/0/0/1 tunnel-te FROM-BGL-AA-BB-TO-SJC-CC-DD-1 tunnel-te FROM-BGL-AA-BB-TO-SJC-CC-DD-2 wide full-name
Mon Jan 16 11:17:39.694 UTC
R1 Monitor Time: 00:00:14 SysUptime: 00:51:41
Protocol:General
In(bps) Out(bps) InBytes/Delta OutBytes/Delta ErrIn/Delta ErrCRC/Delta ErrFr/Delta ErrOvr/Delta ErrOut/Delta ErrUnd/Delta
Interface : FourHundredGigE0/0/0/0
0/ 0% 0/ 0% 0/0 0/0 0/0 0/0 0/0 0/0 0/0 0/0
Interface : FourHundredGigE0/0/0/1
0/ 0% 0/ 0% 0/0 0/0 0/0 0/0 0/0 0/0 0/0 0/0
Interface : FROM-BGL-AA-BB-TO-SJC-CC-DD-1
0/ --% 0/ --% 0/0 0/0 0/0 0/0 0/0 0/0 0/0 0/0
Interface : FROM-BGL-AA-BB-TO-SJC-CC-DD-2
0/ --% 0/ --% 0/0 0/0 0/0 0/0 0/0 0/0 0/0 0/0
Quit='q', Clear='c', Freeze='f', Thaw='t',
Next set='n', Prev set='p', Bytes='y', Packets='k'
(General='g', IPv4 Uni='4u', IPv4 Multi='4m', IPv6 Uni='6u', IPv6 Multi='6m')