monitor interface

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

interface-name — (Optional) Display real-time statistics for the specified interface.

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 17. The keys are not case-sensitive.

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 18. The keys are not case-sensitive.

Required Privilege Level

List of Sample Output

Output Fields

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.

Table 19 describes the output fields for the monitor interface command. Output fields are listed in the approximate order in which they appear.

Sample Output

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. x—Time taken for the last polling (in milliseconds). y—Minimum time taken across all pollings (in milliseconds). z—Maximum time taken across all pollings (in milliseconds).	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
Statistics	For an explanation of the interface statistics, see the description of the show interfaces extensive command for a particular interface type in the JUNOS Interfaces Command Reference.	All levels
Description	With the traffic option, displays the interface description configured at the [edit interfaces interface-name] hierarchy level.	detail

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 (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

Syntax