monitor interface
Syntax
monitor interface <interface-name | traffic <detail>>
Description
Display real-time statistics about interfaces, updating the statistics every second. Check for and display common interface failures, such as SONET/SDH and T3 alarms, loopbacks detected, and increases in framing errors.
On Junos OS Evolved, you can use the monitor interface command over SSH sessions, but console and Telnet sessions are not
supported.
This command is not supported on the QFX3000 QFabric switch.
Options
| none | Display real-time statistics for all interfaces. |
| detail | (Optional) With traffic option only, display detailed output. |
| interface-name | (Optional) Display real-time statistics for the specified interface. In a TX Matrix or TX Matrix Plus router, display real-time statistics for the physical interfaces on the specified line-card chassis (LCC) only. |
| traffic | (Optional) Display traffic data for all active interfaces. In a TX Matrix or TX Matrix Plus router, display real-time statistics for the physical interfaces on the specified LCC only. |
Additional Information
The output of this command shows how
much each field has changed since you started the command or since
you cleared the counters by pressing the c key. For a description
of the statistical information provided in the output of this command,
see the show interfaces extensive command for a particular
interface type in the CLI Explorer. To control
the output of the monitor interface command while it is
running, use the keys listed in Table 1. The keys are not case-sensitive.
Key |
Action |
|---|---|
c |
Clears (returns to zero) the delta
counters since |
f |
Freezes the display, halting the display of updated statistics and delta counters. |
i |
Displays information about a different interface. The command prompts you for the name of a specific interface. |
n |
Displays information about the
next interface. The |
q or Esc |
Quits the command and returns to the command prompt. |
t |
Thaws the display, resuming the update of the statistics and delta counters. |
To control the output of the monitor interface traffic command while it is running, use the keys listed in Table 2. The keys are not case-sensitive.
Key |
Action |
|---|---|
b |
Displays the statistics in units of bytes and bits per second (bps). |
c |
Clears (return to 0) the delta
counters in the |
d |
Displays the |
p |
Displays the statistics in units of packets and packets per second (pps). |
q or Esc |
Quits the command and returns to the command prompt. |
r |
Displays the rate column (instead
of the |
Required Privilege Level
trace
Output Fields
Table 3 describes the output fields for the monitor interface command. Output fields are listed in the approximate order in which
they appear.
Field Name |
Field Description |
Level of Output |
|---|---|---|
|
Hostname of the router. |
All levels |
|
How long the monitor interface command has been running or how long since you last cleared the counters. |
All levels |
|
Current time (UTC). |
All levels |
|
Time difference between when the statistics were displayed and the actual clock time.
|
All levels |
|
Short description of the interface, including its name, status, and encapsulation. |
All levels |
|
State of the link: |
All levels |
|
Cumulative number for the counter in question since the time shown in the Seconds field, which is the time since you started the command or last cleared the counters. |
All levels |
|
(Logical interfaces only) Number and rate of bytes and packets destined to the router or switch through the specified interface. When a burst of traffic is received, the value in the output packet rate field might briefly exceed the peak cell rate. It usually takes less than 1 second for this counter to stabilize.
|
All levels |
|
(Logical interfaces only) Statistics for traffic transiting the router or switch. When a burst of traffic is received, the value in the output packet rate field might briefly exceed the peak cell rate. It usually takes less than 1 second for this counter to stabilize.
|
All levels |
Traffic statistics |
Total number of bytes and packets received and transmitted on the interface. These statistics are the sum of the local and remote statistics. When a burst of traffic is received, the value in the output packet rate field might briefly exceed the peak cell rate. It usually takes less than 1 second for this counter to stabilize.
|
All levels |
|
With the |
|
Input Errors |
Sum of incoming frame aborts and FCS errors. |
All levels |
Input Drops |
Number of packets dropped by the input queue of the I/O Manager ASIC. If the interface is saturated, this number increments once for every packet that is dropped by the ASIC's RED mechanism. |
All levels |
Input Framing errors |
Number of packets received with an invalid frame checksum (FCS). |
All levels |
Policed discards |
Number of frames that the incoming packet match code discarded because they were not recognized or not of interest. Usually, this field reports protocols that the Junos OS does not handle. |
All levels |
L3 incompletes |
Number of incoming packets discarded because they failed
Layer 3 (usually IPv4) sanity checks of the header. For example, a
frame with less than 20 bytes of available IP header is discarded.
L3 incomplete errors can be ignored by configuring the |
All levels |
L2 channel errors |
Number of times the software did not find a valid logical interface for an incoming frame. |
All levels |
L2 mismatch timeouts |
Number of malformed or short packets that caused the incoming packet handler to discard the frame as unreadable. |
All levels |
Sample Output
- monitor interface (Physical)
- monitor interface (OTN Interface)
- monitor interface (MX480 Router with MPC5E and 10-Gigabit Ethernet OTN Interface)
- monitor interface (MX480 Router with MPC5E and 100-Gigabit Ethernet Interface)
- monitor interface (MX2010 Router with MPC6E and 10-Gigabit Ethernet OTN Interface)
- monitor interface (MX2010 Router with MPC6E and 100-Gigabit Ethernet OTN Interface)
- monitor interface (MX2020 Router with MPC6E and 10-Gigabit Ethernet OTN Interface)
- monitor interface (Logical)
- monitor interface (QFX3500 Switch)
- monitor interface traffic
- monitor interface traffic (QFX3500 Switch)
- monitor interface traffic detail (QFX3500 Switch)
monitor interface (Physical)
user@host> monitor interface so-0/0/0 router1 Seconds: 19 Time: 15:46:29 Interface: so-0/0/0, Enabled, Link is Up Encapsulation: PPP, Keepalives, Speed: OC48 Traffic statistics: Current Delta Input packets: 6045 (0 pps) [11] Input bytes: 6290065 (0 bps) [13882] Output packets: 10376 (0 pps) [10] Output bytes: 10365540 (0 bps) [9418] Encapsulation statistics: Input keepalives: 1901 [2] Output keepalives: 1901 [2] NCP state: Opened LCP state: Opened Error statistics: Input errors: 0 [0] Input drops: 0 [0] Input framing errors: 0 [0] Policed discards: 0 [0] L3 incompletes: 0 [0] L2 channel errors: 0 [0] L2 mismatch timeouts: 0 [0] Carrier transitions: 1 [0] Output errors: 0 [0] Output drops: 0 [0] Aged packets: 0 [0] Active alarms : None Active defects: None SONET error counts/seconds: LOS count 1 [0] LOF count 1 [0] SEF count 1 [0] ES-S 0 [0] SES-S 0 [0] SONET statistics: BIP-B1 458871 [0] BIP-B2 460072 [0] REI-L 465610 [0] BIP-B3 458978 [0] REI-P 458773 [0] Received SONET overhead: F1 : 0x00 J0 : 0x00 K1 : 0x00 K2 : 0x00 S1 : 0x00 C2 : 0x00 C2(cmp) : 0x00 F2 : 0x00 Z3 : 0x00 Z4 : 0x00 S1(cmp) : 0x00 Transmitted SONET overhead: F1 : 0x00 J0 : 0x01 K1 : 0x00 K2 : 0x00 S1 : 0x00 C2 : 0xcf F2 : 0x00 Z3 : 0x00 Z4 : 0x00 Next='n', Quit='q' or ESC, Freeze='f', Thaw='t', Clear='c', Interface='i'
monitor interface (OTN Interface)
user@host> monitor interface ge-7/0/0
Interface: ge-7/0/0, Enabled, Link is Up
Encapsulation: Ethernet, Speed: 10000mbps
Traffic statistics:
Input bytes: 0 (0 bps)
Output bytes: 0 (0 bps)
Input packets: 0 (0 pps)
Output packets: 0 (0 pps)
Error statistics:
Input errors: 0
Input drops: 0
Input framing errors: 0
Policed discards: 0
L3 incompletes: 0
L2 channel errors: 0
L2 mismatch timeouts: 0
Carrier transitions: 5
Output errors: 0
Output drops: 0
Aged packets: 0
Active alarms : None
Active defects: None
Input MAC/Filter statistics:
Unicast packets 0
Broadcast packets 0
Multicast packets 0
Oversized frames 0
Packet reject count 0
DA rejects 0
SA rejects 0
Output MAC/Filter Statistics:
Unicast packets 0
Broadcast packets 0
Multicast packets 0
Packet pad count 0
Packet error count 0
OTN Link 0
OTN Alarms: OTU_BDI, OTU_TTIM, ODU_BDI
OTN Defects: OTU_BDI, OTU_TTIM, ODU_BDI, ODU_TTIM
OTN OC - Seconds
LOS 2
LOF 9
OTN OTU - FEC Statistics
Corr err ratio N/A
Corr bytes 0
Uncorr words 0
OTN OTU - Counters
BIP 0
BBE 0
ES 0
SES 0
UAS 422
OTN ODU - Counters
BIP 0
BBE 0
ES 0
SES 0
UAS 422
OTN ODU - Received Overhead APSPCC 0-3: 0
monitor interface (MX480 Router with MPC5E and 10-Gigabit Ethernet OTN Interface)
user@host> monitor interface xe-0/0/3
Interface: xe-0/0/3, Enabled, Link is Up
Encapsulation: Ethernet, Speed: 10000mbps
Traffic statistics: Current delta
Input bytes: 0 (0 bps) [0]
Output bytes: 0 (0 bps) [0]
Input packets: 0 (0 pps) [0]
Output packets: 0 (0 pps) [0]
Error statistics:
Input errors: 0 [0]
Input drops: 0 [0]
Input framing errors: 0 [0]
Policed discards: 0 [0]
L3 incompletes: 0 [0]
L2 channel errors: 0 [0]
L2 mismatch timeouts: 0 [0]
Carrier transitions: 5 [0]
Output errors: 0 [0]
Output drops: 0 [0]
Aged packets: 0 [0]
Active alarms : None
Active defects: None
PCS statistics: Seconds
Bit Errors 0 [0]
Errored blocks 4 [0]
Input MAC/Filter statistics:
Unicast packets 0 [0]
Broadcast packets 0 [0]
Multicast packets 0 [0]
Oversized frames 0 [0]
Packet reject count 0 [0]
DA rejects 0 [0]
SA rejects 0 [0]
Output MAC/Filter Statistics:
Unicast packets 0 [0]
Broadcast packets 0 [0]
Multicast packets 0 [0]
Packet pad count 0 [0]
Packet error count 0 [0]
Next='n', Quit='q' or ESC, Freeze='f', Thaw='t', Clear='c', Interface='i'
monitor interface (MX480 Router with MPC5E and 100-Gigabit Ethernet Interface)
user@host> monitor interface et-2/1/0
Interface: et-2/1/0, Enabled, Link is Up
Encapsulation: Ethernet, Speed: 100000mbps
Traffic statistics: Current delta
Input bytes: 0 (0 bps) [0]
Output bytes: 0 (0 bps) [0]
Input packets: 0 (0 pps) [0]
Output packets: 0 (0 pps) [0]
Error statistics:
Input errors: 0 [0]
Input drops: 0 [0]
Input framing errors: 0 [0]
Policed discards: 0 [0]
L3 incompletes: 0 [0]
L2 channel errors: 0 [0]
L2 mismatch timeouts: 0 [0]
Carrier transitions: 263 [0]
Output errors: 0 [0]
Output drops: 0 [0]
Aged packets: 0 [0]
OTN Link 0
OTN Alarms:
OTN Defects:
OTN OC - Seconds
LOS 129 [0]
LOF 2 [0]
OTN OTU - FEC Statistics
Corr err ratio <8E-5
Corr bytes 169828399453 [0]
Uncorr words 28939961456 [0]
OTN OTU - Counters [0]
BIP 0
BBE 0 [0]
ES 24 [0]
SES 0 [0]
UAS 1255 [0]
OTN ODU - Counters [0]
BIP 0
BBE 0 [0]
ES 24 [0]
SES 0 [0]
UAS 1256 [0]
OTN ODU - Received Overhead [0]
APSPCC 0-3: 00 00 00 00
Next='n', Quit='q' or ESC, Freeze='f', Thaw='t', Clear='c', Interface='i'monitor interface (MX2010 Router with MPC6E and 10-Gigabit Ethernet OTN Interface)
user@host> monitor interface xe-6/1/0
Interface: xe-6/1/0, Enabled, Link is Up
Encapsulation: Ethernet, Speed: 10000mbps
Traffic statistics: Current delta
Input bytes: 0 (0 bps) [0]
Output bytes: 0 (0 bps) [0]
Input packets: 0 (0 pps) [0]
Output packets: 0 (0 pps) [0]
Error statistics:
Input errors: 0 [0]
Input drops: 0 [0]
Input framing errors: 0 [0]
Policed discards: 0 [0]
L3 incompletes: 0 [0]
L2 channel errors: 0 [0]
L2 mismatch timeouts: 0 [0]
Carrier transitions: 1 [0]
Output errors: 0 [0]
Output drops: 0 [0]
Aged packets: 0 [0]
Active alarms : None
Active defects: None
PCS statistics: Seconds
Bit Errors 0 [0]
Errored blocks 1 [0]
Input MAC/Filter statistics:
Unicast packets 0 [0]
Broadcast packets 0 [0]
Multicast packets 0 [0]
Oversized frames 0 [0]
Packet reject count 0 [0]
DA rejects 0 [0]
SA rejects 0 [0]
Output MAC/Filter Statistics:
Unicast packets 0 [0]
Broadcast packets 0 [0]
Multicast packets 0 [0]
Packet pad count 0 [0]
Packet error count 0 [0]
Next='n', Quit='q' or ESC, Freeze='f', Thaw='t', Clear='c', Interface='i'
monitor interface (MX2010 Router with MPC6E and 100-Gigabit Ethernet OTN Interface)
user@host> monitor interface et-9/0/0
Interface: et-9/0/0, Enabled, Link is Up
Encapsulation: Ethernet, Speed: 100000mbps
Traffic statistics: Current delta
Input bytes: 0 (0 bps) [0]
Output bytes: 0 (0 bps) [0]
Input packets: 0 (0 pps) [0]
Output packets: 0 (0 pps) [0]
Error statistics:
Input errors: 0 [0]
Input drops: 0 [0]
Input framing errors: 0 [0]
Policed discards: 0 [0]
L3 incompletes: 0 [0]
L2 channel errors: 0 [0]
L2 mismatch timeouts: 0 [0]
Carrier transitions: 1 [0]
Output errors: 0 [0]
Output drops: 0 [0]
Aged packets: 0 [0]
Next='n', Quit='q' or ESC, Freeze='f', Thaw='t', Clear='c', Interface='i'
monitor interface (MX2020 Router with MPC6E and 10-Gigabit Ethernet OTN Interface)
user@host> monitor interface xe-3/0/0
host name Seconds: 67 Time: 23:46:46
Delay: 0/0/13
Interface: xe-3/0/0, Enabled, Link is Up
Encapsulation: Ethernet, Speed: 10000mbps
Traffic statistics: Current delta
Input bytes: 0 (0 bps) [0]
Output bytes: 0 (0 bps) [0]
Input packets: 0 (0 pps) [0]
Output packets: 0 (0 pps) [0]
Error statistics:
Input errors: 0 [0]
Input drops: 0 [0]
Input framing errors: 0 [0]
Policed discards: 0 [0]
L3 incompletes: 0 [0]
L2 channel errors: 0 [0]
L2 mismatch timeouts: 0 [0]
Carrier transitions: 3 [0]
Output errors: 0 [0]
Output drops: 0 [0]
Aged packets: 0 [0]
OTN Link 0
OTN Alarms:
OTN Defects:
OTN OC - Seconds
LOS 0 [0]
LOF 0 [0]
OTN OTU - FEC Statistics
Corr err ratio N/A
Corr bytes 0 [0]
Uncorr words 0 [0]
OTN OTU - Counters [0]
BIP 0
BBE 0 [0]
ES 0 [0]
SES 0 [0]
UAS 0 [0]
OTN ODU - Counters [0]
BIP 0
BBE 0 [0]
ES 0 [0]
SES 0 [0]
UAS 0 [0]
OTN ODU - Received Overhead [0]
APSPCC 0-3: 00 00 00 00
Next='n', Quit='q' or ESC, Freeze='f', Thaw='t', Clear='c', Interface='i'
monitor interface (Logical)
user@host> monitor interface so-1/0/0.0
host name Seconds: 16 Time: 15:33:39
Delay: 0/0/1
Interface: so-1/0/0.0, Enabled, Link is Down
Flags: Hardware-Down Point-To-Point SNMP-Traps
Encapsulation: PPP
Local statistics: Current delta
Input bytes: 0 [0]
Output bytes: 0 [0]
Input packets: 0 [0]
Output packets: 0 [0]
Remote statistics:
Input bytes: 0 (0 bps) [0]
Output bytes: 0 (0 bps) [0]
Input packets: 0 (0 pps) [0]
Output packets: 0 (0 pps) [0]
Traffic statistics:
Destination address: 192.168.8.193, Local: 192.168.8.21
Next='n', Quit='q' or ESC, Freeze='f', Thaw='t', Clear='c', Interface='i'
monitor interface (QFX3500 Switch)
user@switch> monitor interface ge-0/0/0 Interface: ge-0/0/0, Enabled, Link is Down Encapsulation: Ethernet, Speed: Unspecified Traffic statistics: Current delta Input bytes: 0 (0 bps) [0] Output bytes: 0 (0 bps) [0] Input packets: 0 (0 pps) [0] Output packets: 0 (0 pps) [0] Error statistics: Input errors: 0 [0] Input drops: 0 [0] Input framing errors: 0 [0] Policed discards: 0 [0] L3 incompletes: 0 [0] L2 channel errors: 0 [0] L2 mismatch timeouts: 0 [0] Carrier transitions: 0 [0] Output errors: 0 [0] Output drops: 0 [0] Aged packets: 0 [0] Active alarms : LINK Active defects: LINK Input MAC/Filter statistics: Unicast packets 0 [0] Broadcast packets 0 Multicast packet [0] Interface warnings: o Outstanding LINK alarm
monitor interface traffic
user@host> monitor interface traffic host name Seconds: 15 Time: 12:31:09 Interface Link Input packets (pps) Output packets (pps) so-1/0/0 Down 0 (0) 0 (0) so-1/1/0 Down 0 (0) 0 (0) so-1/1/1 Down 0 (0) 0 (0) so-1/1/2 Down 0 (0) 0 (0) so-1/1/3 Down 0 (0) 0 (0) t3-1/2/0 Down 0 (0) 0 (0) t3-1/2/1 Down 0 (0) 0 (0) t3-1/2/2 Down 0 (0) 0 (0) t3-1/2/3 Down 0 (0) 0 (0) so-2/0/0 Up 211035 (1) 36778 (0) so-2/0/1 Up 192753 (1) 36782 (0) so-2/0/2 Up 211020 (1) 36779 (0) so-2/0/3 Up 211029 (1) 36776 (0) so-2/1/0 Up 189378 (1) 36349 (0) so-2/1/1 Down 0 (0) 18747 (0) so-2/1/2 Down 0 (0) 16078 (0) so-2/1/3 Up 0 (0) 80338 (0) at-2/3/0 Up 0 (0) 0 (0) at-2/3/1 Down 0 (0) 0 (0) Bytes=b, Clear=c, Delta=d, Packets=p, Quit=q or ESC, Rate=r, Up=^U, Down=^D
monitor interface traffic (QFX3500 Switch)
user@switch> monitor interface traffic switch Seconds: 7 Time: 16:04:37 Interface Link Input packets (pps) Output packets (pps) ge-0/0/0 Down 0 (0) 0 (0) ge-0/0/1 Up 392187 (0) 392170 (0) ge-0/0/2 Down 0 (0) 0 (0) ge-0/0/3 Down 0 (0) 0 (0) ge-0/0/4 Down 0 (0) 0 (0) ge-0/0/5 Down 0 (0) 0 (0) ge-0/0/6 Down 0 (0) 0 (0) ge-0/0/7 Down 0 (0) 0 (0) ge-0/0/8 Down 0 (0) 0 (0) ge-0/0/9 Up 392184 (0) 392171 (0) ge-0/0/10 Down 0 (0) 0 (0) ge-0/0/11 Down 0 (0) 0 (0) ge-0/0/12 Down 0 (0) 0 (0) ge-0/0/13 Down 0 (0) 0 (0) ge-0/0/14 Down 0 (0) 0 (0) ge-0/0/15 Down 0 (0) 0 (0) ge-0/0/16 Down 0 (0) 0 (0) ge-0/0/17 Down 0 (0) 0 (0) ge-0/0/18 Down 0 (0) 0 (0) ge-0/0/19 Down 0 (0) 0 (0) ge-0/0/20 Down 0 (0) 0 (0) ge-0/0/21 Down 0 (0) 0 (0) ge-0/0/22 Up 392172 (0) 392187 (0) ge-0/0/23 Up 392185 (0) 392173 (0) vcp-0 Down 0 0 vcp-1 Down 0 0 ae0 Down 0 (0) 0 (0) bme0 Up 0 1568706
monitor interface traffic detail (QFX3500 Switch)
user@switch> monitor interface traffic detail switch Seconds: 74 Time: 16:03:02 Interface Link Input packets (pps) Output packets (pps) Description ge-0/0/0 Down 0 (0) 0 (0) ge-0/0/1 Up 392183 (0) 392166 (0) ge-0/0/2 Down 0 (0) 0 (0) ge-0/0/3 Down 0 (0) 0 (0) ge-0/0/4 Down 0 (0) 0 (0) ge-0/0/5 Down 0 (0) 0 (0) ge-0/0/6 Down 0 (0) 0 (0) ge-0/0/7 Down 0 (0) 0 (0) ge-0/0/8 Down 0 (0) 0 (0) ge-0/0/9 Up 392181 (0) 392168 (0) ge-0/0/10 Down 0 (0) 0 (0) ge-0/0/11 Down 0 (0) 0 (0) ge-0/0/12 Down 0 (0) 0 (0) ge-0/0/13 Down 0 (0) 0 (0) ge-0/0/14 Down 0 (0) 0 (0) ge-0/0/15 Down 0 (0) 0 (0) ge-0/0/16 Down 0 (0) 0 (0) ge-0/0/17 Down 0 (0) 0 (0) ge-0/0/18 Down 0 (0) 0 (0) ge-0/0/19 Down 0 (0) 0 (0) ge-0/0/20 Down 0 (0) 0 (0) ge-0/0/21 Down 0 (0) 0 (0) ge-0/0/22 Up 392169 (0) 392184 (1) ge-0/0/23 Up 392182 (0) 392170 (0) vcp-0 Down 0 0 vcp-1 Down 0 0 ae0 Down 0 (0) 0 (0) bme0 Up 0 1568693
Release Information
Command introduced before Junos OS Release 7.4.