monitor interface
Syntax
Release Information
Command introduced before Junos OS Release 7.4.
Command introduced in Junos OS Release 9.0 for EX Series switches.
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.
Options
- none
Display real-time statistics for all interfaces.
- interface-name
(Optional) Display real-time statistics for the specified interface.
- traffic
(Optional) Display traffic data for all active interfaces.
- detail
(Optional) With traffic option only, display detailed output.
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 using 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 Junos Interfaces Command Reference. To control the output of the monitor interface interface-name command while it is running, use the keys listed in Table 1. The keys are not case-sensitive.
Table 1: Output Control Keys for the monitor interface interface-name Command
Key | Action |
|---|---|
c | Clears (returns to zero) the delta counters since monitor interface was started. This does not clear the accumulative counter. To clear the accumulative counter, use the clear interfaces interval command. |
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 monitor interface command displays the physical or logical interfaces in the same order as the show interfaces terse command. |
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.
Table 2: Output Control Keys for the monitor interface traffic Command
Key | Action |
|---|---|
b | Displays the statistics in units of bytes and bytes per second (bps). |
c | Clears (return to 0) the delta counters in the Current Delta column. The statistics counters are not cleared. |
d | Displays the Current Delta column (instead of the rate column) in bps or packets per second (pps). |
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 Current Delta column) in bps and pps. |
Required Privilege Level
trace
List of Sample Output
monitor interface (Physical)monitor interface (OTN Interface)
monitor interface (Logical)
monitor interface traffic
monitor interface traffic detail
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.
Table 3: monitor interface Output Fields
Field Name | Field Description | Level of Output |
|---|---|---|
router1 | Hostname of the router. | All levels |
Seconds | How long the monitor interface command has been running or how long since you last cleared the counters. | All levels |
Time | Current time (UTC). | All levels |
Delay x/y/z | Time difference between when the statistics were displayed and the actual clock time.
| All levels |
Interface | Short description of the interface, including its name, status, and encapsulation. | All levels |
Link | State of the link: Up, Down, or Test. | All levels |
Current delta | 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 |
Local Statistics | (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 takes awhile (generally, less than 1 second) for this counter to stabilize.:
| All levels |
Remote Statistics | (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 takes awhile (generally, 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 takes awhile (generally, less than 1 second) for this counter to stabilize.
| All levels |
Description | With the traffic option, displays the interface description configured at the [edit interfaces interface-name] hierarchy level. | detail |
Sample Output
monitor interface (Physical)
user@host> monitor interface so-0/0/0router1 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 (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 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 detail
user@host> monitor interface traffic detail host name Seconds: 15 Time: 12:31:09 Interface Link Input packets (pps) Output packets (pps) Description t1-0/1/1:0 Up 19769 (0) 0 (0) To-OSAKA-1 ... Bytes=b, Clear=c, Delta=d, Packets=p, Quit=q or ESC, Rate=r, Up=^U, Down=^D
