Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

show interfaces (Aggregated Ethernet)

Syntax

Description

(M Series, T Series, MX Series, and PTX Series routers) Display status information about the specified aggregated Ethernet interfaces.

Options

aenumber

Display standard information about the specified aggregated Fast Ethernet or Gigabit Ethernet interface.

brief | detail | extensive | terse

(Optional) Display the specified level of output.

descriptions

(Optional) Display interface description strings.

media

(Optional) Display media-specific information.

snmp-index snmp-index

(Optional) Display information for the specified SNMP index of the interface.

statistics

(Optional) Display static interface statistics.

Note:

On Junos OS Evolved, in untagged aggregated ethernet (ae) interfaces with no logical interface configuration, the ae interface will not be shown as "down" and the speed will not be shown as "unspecified." The speed will be the aggregate speed of all the child member interfaces which are "up." In Junos OS, the speed is shown as "unspecified" in this case.

Required Privilege Level

view

Output Fields

Table 1 lists the output fields for the show interfaces (Aggregated Ethernet) command. Output fields are listed in the approximate order in which they appear.

Table 1: Aggregated Ethernet show interfaces Output Fields

Field Name

Field Description

Level of Output

Physical Interface

Physical interface

Name of the physical interface and state of the interface.

All levels

Enabled

State of the physical interface. Possible values are described in the “Enabled Field” section under Common Output Fields Description.

All levels

Interface index

Index number of the physical interface, which reflects its initialization sequence.

All levels

SNMP ifIndex

SNMP index number for the physical interface.

detail extensive none

Generation

Unique number for use by Juniper Networks technical support only.

detail extensive

Link-level type

Encapsulation being used on the physical interface.

All levels

MTU

Maximum transmission unit size on the physical interface.

All levels

Speed

Speed at which the interface is running.

All levels

Loopback

Loopback status: Enabled or Disabled. If loopback is enabled, type of loopback: Local or Remote.

All levels

Source filtering

Source filtering status: Enabled or Disabled.

All levels

Flow control

Flow control status: Enabled or Disabled.

All levels

Minimum links needed

Number of child links that must be operational for the aggregate interface to be operational.

All levels

Device flags

Information about the physical device. Possible values are described in the “Device Flags” section under Common Output Fields Description.

All levels

Interface flags

Information about the interface. Possible values are described in the “Interfaces Flags” section under Common Output Fields Description.

All levels

Current address

Configured MAC address.

detail extensive

Hardware address

Hardware MAC address.

detail extensive

Last flapped

Date, time, and how long ago the interface went from down to up or from up to down. The format is Last flapped: year-month-day hours:minutes:seconds timezone (hours:minutes:seconds ago). For example, Last flapped: 2002-04-26 10:52:40 PDT (04:33:20 ago).

detail extensive

Input Rate

Input rate in bits per second (bps) and packets per second (pps).

None specified

Output Rate

Output rate in bps and pps.

None specified

Statistics last cleared

Time when the statistics for the interface were last set to zero.

detail extensive

Traffic statistics

Number and rate of bytes and packets received and transmitted on the physical interface.

  • Input bytes—Number of bytes and rate, in bps, at which bytes are received on the interface.

  • Output bytes—Number of bytes and rate, in bps, at which bytes are transmitted on the interface.

  • Input packets—Number of packets and rate, in pps, at which packets are received on the interface.

  • Output packets—Number of packets and rate, in pps, at which packets are transmitted on the interface.

detail extensive

Input errors

Input errors on the interface:

  • Errors—Sum of incoming frame terminates and frame check sequence (FCS) errors.

  • 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 random early detection (RED) mechanism.

  • Framing errors—Number of packets received with an invalid frame checksum (FCS).

  • Runts—Number of frames received that are smaller than the runt threshold.

  • Giants—Number of frames received that are larger than the giant threshold.

  • Policed discards—Number of frames that the incoming packet match code discarded because they were not recognized or were not of interest. Usually, this field reports protocols that Junos OS does not handle.

  • Resource errors—Sum of transmit drops.

detail extensive

Output errors

Output errors on the interface. The following paragraphs explain the counters whose meaning might not be obvious:

  • Carrier transitions —Number of times the interface has gone from down to up. This number does not normally increment quickly, increasing only when the cable is unplugged, the far-end system is powered down and then up, or another problem occurs. If the number of carrier transitions increments quickly (perhaps once every 10 seconds), then the cable, the far-end system, or the PIC is malfunctioning.

  • Errors—Sum of the outgoing frame terminates and FCS errors.

  • Drops—Number of packets dropped by the output 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.

  • MTU errors—Number of packets whose size exceeded the MTU of the interface.

  • Resource errors—Sum of transmit drops.

detail extensive

IPv6 transit statistics

Number of IPv6 transit bytes and packets received and transmitted on the physical interface if IPv6 statistics tracking is enabled.

  • Input bytes—Number of bytes received on the interface.

  • Output bytes—Number of bytes transmitted on the interface.

  • Input packets—Number of packets received on the interface.

  • Output packets—Number of packets transmitted on the interface.

detail extensive

MAC statistics

Display media access control (MAC) statistics.

  • Broadcast packets—Number of broadcast packets received and transmitted.

  • Multicast packets—Number of multicast packets received and transmitted.

detail extensive

Queue counters

CoS queue number and its associated user-configured forwarding class name.

  • Queued packets—Number of queued packets.

  • Transmitted packets—Number of transmitted packets.

  • Dropped packets—Number of packets dropped by the ASIC's RED mechanism.

    Note:

    In DPCs that are not of the enhanced type, such as DPC 40x 1GE R, DPCE 20x 1GE + 2x 10GE R, or DPCE 40x 1GE R, you might notice a discrepancy in the output of the show interfaces command because incoming packets might be counted in the Egress queues section of the output. This problem occurs on non-enhanced DPCs because the egress queue statistics are polled from IMQ (Inbound Message Queuing) block of the I-chip. The IMQ block does not differentiate between ingress and egress WAN traffic; as a result, the combined statistics are displayed in the egress queue counters on the Routing Engine. In a simple VPLS scenario, if there is no MAC entry in DMAC table (by sending unidirectional traffic), traffic is flooded and the input traffic is accounted in IMQ. For bidirectional traffic (MAC entry in DMAC table), if the outgoing interface is on the same I-chip then both ingress and egress statistics are counted in a combined way. If the outgoing interface is on a different I-chip or FPC, then only egress statistics are accounted in IMQ. This behavior is expected with non-enhanced DPCs

detail extensive

Logical Interface

Logical interface

Name of the logical interface.

All levels

Index

Index number of the logical interface (which reflects its initialization sequence).

detail extensive none

SNMP ifIndex

SNMP interface index number of the logical interface.

detail extensive none

Generation

Unique number for use by Juniper Networks technical support only.

detail extensive

Flags

Information about the logical interface. Possible values are described in the “Logical Interface Flags Field” section under Common Output Fields Description.

All levels

VLAN-Tag

Tag Protocol Identifier (TPID) and VLAN identifier.

All levels

Demux

IP demultiplexing (demux) value that appears if this interface is used as the demux underlying interface. The output is one of the following:

  • Source Family Inet

  • Destination Family Inet

detail extensive none

Encapsulation

Encapsulation on the logical interface.

All levels

Statistics

Information about the number of packets, packets per second, number of bytes, and bytes per second on this aggregate interface.

  • Bundle—Information about input and output bundle rates. For Junos OS Evolved, LACP packets and LAG links on the members of an aggregated Ethernet interface are not counted as part of the aggregated Ethernet bundle input or output statistics.

  • Link—(detail and extensive only) Information about specific links in the aggregate, including link state and input and output rates.

  • Adaptive Statistics—(extensive only) Information about adaptive load balancing counter statistics.

    • Adaptive Adjusts—Number of times traffic flow imbalance was corrected by implementation of adaptive load balancing.

    • Adaptive Scans—Number of times the link utilization on each member link of the AE bundle was scanned by for adaptive load balancing

    • Adaptive Tolerance—Tolerance level, in percentage, for load imbalance on link utilization on each member link of the AE bundle.

    • Adaptive Updates—Number of times traffic flow loads have been updated on an AE bundle.

  • Marker Statistics—(detail and extensive only) Information about 802.3ad marker protocol statistics on the specified links.

    • Marker Rx—Number of valid marker protocol data units (PDUs) received on this aggregation port.

    • Resp Tx—Number of marker response PDUs transmitted on this aggregation port.

    • Unknown Rx—Number of frames received that either carry the slow protocols Ethernet type value (43B.4) but contain an unknown PDU, or are addressed to the slow protocols group MAC address (43B.3) but do not carry the slow protocols Ethernet type.

    • Illegal Rx—Number of frames received that carry the slow protocols Ethernet type value (43B.4) but contain a badly formed PDU or an illegal value of protocol subtype (43B.4).

detail extensive none

LACP info

Link Aggregation Control Protocol (LACP) information for each aggregated interface.

  • Role can be one of the following:

    • Actor—Local device participating in LACP negotiation.

    • Partner—Remote device participating in LACP negotiation.

  • System priority—Priority assigned to the system (by management or administrative policy), encoded as an unsigned integer.

  • System identifier—Actor or partner system ID, encoded as a MAC address.

  • Port priority—Priority assigned to the port by the actor or partner (by management or administrative policy), encoded as an unsigned integer.

  • Unknown Rx—Number of frames received that either carry the slow protocols Ethernet type value (43B.4) but contain an unknown protocol data unit (PDU), or are addressed to the slow protocols group MAC address (43B.3) but do not carry the slow protocols Ethernet type.

  • Port key—Operational key value assigned to the port by the actor or partner, encoded as an unsigned integer.

LACP Statistics

LACP statistics for each aggregated interface.

  • LACP Rx—LACP received counter that increments for each normal hello.

  • LACP Tx—Number of LACP transmit packet errors logged.

  • Unknown Rx—Number of unrecognized packet errors logged.

  • Illegal Rx—Number of invalid packets received.

Note:

For LACP Rx and LACP Tx, Packet count is updated only on snmp timer expiry (30 secs).

detail extensive none

protocol-family

Protocol family configured on the logical interface. Possible values are described in the “Protocol Field” section under Common Output Fields Description.

brief

Protocol

Protocol family configured on the logical interface. Possible values are described in the “Protocol Field” section under Common Output Fields Description.

detail extensive none

MTU

Maximum transmission unit size on the logical interface.

detail extensive none

Maximum labels

Maximum number of MPLS labels configured for the MPLS protocol family on the logical interface.

detail extensive none

Generation

Unique number for use by Juniper Networks technical support only.

detail extensive

Route Table

Routing table in which the logical interface address is located. For example, 0 refers to the routing table inet.0.

detail extensive

Flags

Information about protocol family flags. Possible values are described in the “Family Flags Field” section under Common Output Fields Description.

detail extensive none

Mac-Validate Failures

Number of MAC address validation failures for packets and bytes. This field is displayed when MAC address validation is enabled for the logical interface.

detail extensive none

Addresses, Flags

Information about address flags. Possible values are described in the “Addresses Flags” section under Common Output Fields Description.

detail extensive none

Destination

IP address of the remote side of the connection.

detail extensive none

Local

IP address of the logical interface.

detail extensive none

Broadcast

Broadcast address of the logical interface.

detail extensive none

Generation

Unique number for use by Juniper Networks technical support only.

detail extensive

Sample Output

show interfaces (Aggregated Ethernet)

show interfaces brief (Aggregated Ethernet)

show interfaces detail (Aggregated Ethernet)

show interfaces extensive (Aggregated Ethernet)

show interfaces extensive (Aggregated Ethernet with VLAN Stacking)

show interfaces extensive (Aggregated Ethernet for Junos OS)

show interfaces extensive (Aggregated Ethernet for Junos OS Evolved)

Starting in Junos OS Evolved Release 20.3R1, when you configure adaptive load balancing, the show interfaces ae0 extensive command displays adaptive statistics under the physical interface, not the logical interface for the PTX10008 Series routers.

Release Information

Command introduced before Junos OS Release 7.4.