display interface

Function

The display interface command displays the running status of and traffic statistics on an interface.

Format

display interface [ interface-type [ interface-number ] | slot slot-number ]

display interface interface-name

display interface main

display interface interface-type main

Parameters

Parameter Description Value
interface-type

Specifies the type of an interface.

If no interface type is specified, the description of all interfaces is displayed.

-
interface-number

Specifies the number of an interface.

If an interface type is specified but no interface number is specified, the description of all interfaces of this type is displayed.

The value is a string of 1 to 63 case-sensitive characters, spaces not supported.
slot slot-number

Specifies the slot number.

If no slot number is specified, the description of all slots is displayed.

In VS mode, this parameter is supported only by the admin VS.

The value is a string of 1 to 63 case-sensitive characters, spaces not supported.
interface-name

Specifies the name of an interface.

-
main

Displays the running status of and traffic statistics on an interface.

  • If an interface has no Layer 2 or Layer 3 sub-interfaces, the status of and traffic statistics on the interface are displayed whether you specify this parameter or not.
  • If an interface has Layer 2 or Layer 3 sub-interfaces, the status of and traffic statistics on the interface and its Layer 2 or Layer 3 sub-interfaces are displayed if you do not specify this parameter.

-

Views

All views

Default Level

1: Monitoring level

Task Name and Operations

Task Name Operations
interface-mgr read

Usage Guidelines

Usage Scenario

Before you monitor the status of an interface or locate an interface fault, use the display interface command to collect the running status of and statistics on the interface. You can troubleshoot the interface based on the command output.

Perform any of following operations based on the interface status and statistics:

  • If the interface is Down, check whether the link connection is correct or whether interface negotiation succeeds.
  • Interface statistics reflect traffic received and sent. If the interface has a lot of error statistics, check whether the interface is attacked or whether the link quality is stable.
  • If the date and time when the interface last went Up and Down are different from those in the actual situation, contact technical support personnel.

    Compared with the display interface brief command, the display interface command provides more interface information to help locate faults.

Precautions

Physical status and link layer protocol status of an interface: Commonly, the link layer protocol status of a working interface is Up.

Last 300 seconds input rate and last 300 seconds output rate of an interface: The existing traffic on the interface needs to be compared with the interface bandwidth. If the existing traffic exceeds 80% of the interface bandwidth, such a situation must be recorded and confirmed. In addition, check whether error statistics about incoming and outgoing traffic are collected on an interface and take actions if statistics about error packets increase.

The obtained interface bandwidth is converted to 1 Gbps (10^9 bps).

To view statistics about IPv4 or IPv6 traffic in the inbound and outbound directions on an interface, enable statistics collection in both directions on the interface.

When you check information about a FlexE physical interface, the following packet fields are not displayed in the command output: Statistics last cleared, Last 300 seconds input rate, Last 300 seconds output rate, Input, Output, Last 300 seconds input utility rate, and Last 300 seconds output utility rate.

Example

The actual command output varies according to the device. The command output here is only an example.

# Display the status and statistics information about GE0/1/0.
<HUAWEI> display interface gigabitethernet 0/1/0
GigabitEthernet0/1/0 current state : UP (ifindex: 6)
Line protocol current state : UP
Last line protocol up time :  2013-07-29 15:39:29
Description: HUAWEI, GigabitEthernet0/1/0 Interface
Route Port,The Maximum Transmit Unit is 1500
Internet Address is 10.1.1.1/1
IP Sending Frames' Format is PKTFMT_ETHNT_2, Hardware address is 00e0-fc12-3458
Last physical up time   :  2013-07-29 15:39:23
Last physical down time : 2013-07-29 15:38:41
Current system time: 2013-07-30 09:15:33
Statistics last cleared:never
      Last 300 seconds input rate: 23513 bits/sec, 2 packets/sec
      Last 300 seconds output rate: 64319 bits/sec, 3 packets/sec
      Input peak rate 26099 bits/sec, Record time: 2013-07-29 15:40:58
      Output peak rate 64809 bits/sec, Record time: 2013-07-30 03:59:41
      Input: 183126871 bytes, 182525 packets 
      Output: 509287017 bytes, 244628 packets
    Input:
      Unicast: 55 packets, Multicast: 160762 packets
      Broadcast: 21708 packets JumboOctets: 31031 packets
      CRC: 0 packets, Symbol: 0 packets
      Overrun: 0 packets, InRangeLength: 0 packets
      LongPacket: 0 packets, Jabber: 0 packets, Alignment: 0 packets
      Fragment: 0 packets, Undersized Frame: 0 packets
      RxPause: 0 packets
    Output:
      Unicast: 53 packets, Multicast: 243990 packets
      Broadcast: 585 packets JumboOctets: 0 packets
      Lost: 0 packets, Overflow: 0 packets, Underrun: 0 packets
      System: 0 packets, Overruns: 0 packets
      TxPause: 0 packets
    Last 300 seconds input utility rate:  0.01%
    Last 300 seconds output utility rate: 0.01%
Ipv4:        Last 300 seconds input rate: 512 bits/sec, 1 packets/sec       Last 300 seconds output rate: 0 bits/sec, 0 packets/sec       Input 63318 packets,4052352 bytes       Output 0 packets,0 bytes       Input bandwidth utilization: 0.00%       Output bandwidth utilization: 0.00%
Ipv6:       Last 300 seconds input rate: 0 bits/sec, 0 packets/sec       Last 300 seconds output rate: 0 bits/sec, 0 packets/sec       Input 0 packets,0 bytes       Output 0 packets,0 bytes
      Input bandwidth utilization: 0.00%
      Output bandwidth utilization: 0.00%
# Display running status and traffic statistics about an interface on the device.
<HUAWEI> display interface main
GE0/1/0 current state : UP (ifindex: 6)
Line protocol current state : UP 
Description: 
Route Port,The Maximum Transmit Unit is 1500
Internet protocol processing : disabled
IP Sending Frames' Format is PKTFMT_ETHNT_2, Hardware address is 00e0-fc12-3456
Loopback:none, LAN full-duplex mode, Pause Flowcontrol: Receive Enable and Send Enable
Last physical up time   : -
Last physical down time : 2013-09-12 07:57:59
Current system time: 2013-09-12 09:23:39
Statistics last cleared:never
      Last 300 seconds input rate: 23513 bits/sec, 2 packets/sec
      Last 300 seconds output rate: 64319 bits/sec, 3 packets/sec
      Input peak rate 26099 bits/sec, Record time: 2013-07-29 15:40:58
      Output peak rate 64809 bits/sec, Record time: 2013-07-30 03:59:41
      Input: 183126871 bytes, 182525 packets 
      Output: 509287017 bytes, 244628 packets
    Input:
      Unicast: 55 packets, Multicast: 160762 packets
      Broadcast: 21708 packets, JumboOctets: 31031 packets
      CRC: 0 packets, Symbol: 0 packets
      Overrun: 0 packets, InRangeLength: 0 packets
      LongPacket: 0 packets, Jabber: 0 packets, Alignment: 0 packets
      Fragment: 0 packets, Undersized Frame: 0 packets
      RxPause: 0 packets
    Output:
      Unicast: 53 packets, Multicast: 243990 packets
      Broadcast: 585 packets, JumboOctets: 0 packets
      Lost: 0 packets, Overflow: 0 packets, Underrun: 0 packets
      System: 0 packets, Overruns: 0 packets
      TxPause: 0 packets
    Last 300 seconds input utility rate:  0.01%
    Last 300 seconds output utility rate: 0.01%
GE0/1/1 current state : UP (ifindex: 7)
Line protocol current state : UP
Description:    
Route Port,The Maximum Transmit Unit is 1500
Internet protocol processing : disabled
IP Sending Frames' Format is PKTFMT_ETHNT_2, Hardware address is 00e0-fc12-3457
Loopback:none, LAN full-duplex mode, Pause Flowcontrol: Receive Enable and Send Enable
Last physical up time   : -
Last physical down time : 2013-09-12 07:57:59
Current system time: 2013-09-12 09:23:45
Statistics last cleared:never
      Last 300 seconds input rate: 23513 bits/sec, 2 packets/sec
      Last 300 seconds output rate: 64319 bits/sec, 3 packets/sec
      Input peak rate 26099 bits/sec, Record time: 2013-07-29 15:40:58
      Output peak rate 64809 bits/sec, Record time: 2013-07-30 03:59:41
      Input: 183126871 bytes, 182525 packets 
      Output: 509287017 bytes, 244628 packets
    Input:
      Unicast: 55 packets, Multicast: 160762 packets
      Broadcast: 21708 packets, JumboOctets: 31031 packets
      CRC: 0 packets, Symbol: 0 packets
      Overrun: 0 packets, InRangeLength: 0 packets
      LongPacket: 0 packets, Jabber: 0 packets, Alignment: 0 packets
      Fragment: 0 packets, Undersized Frame: 0 packets
      RxPause: 0 packets
    Output:
      Unicast: 53 packets, Multicast: 243990 packets
      Broadcast: 585 packets, JumboOctets: 0 packets
      Lost: 0 packets, Overflow: 0 packets, Underrun: 0 packets
      System: 0 packets, Overruns: 0 packets
      TxPause: 0 packets
    Last 300 seconds input utility rate:  0.01%
    Last 300 seconds output utility rate: 0.01%
GE0/1/2 current state : Administratively DOWN (ifindex: 8)..............
Table 1 Description of the display interface command output
Item Description
current state

Physical status of the interface:

  • UP.
  • Administratively Down: This state is displayed after the network administrator runs the shutdown command on the interface.
  • Flow Down: The status of the data flow on the interface is Down. This state is determined by the status of the mVRRP bound to the interface. If the mVRRP status is Backup or Initialized, the status of the data flow on the interface is Down.
  • DOWN.
    • AUAIS: Administrative unit-alarm indication signal (AU-AIS), which is a higher-order alarm indication.
    • B3TCA fault: B3 threshold-crossing alarm indication.
    • LAIS: Line alarm indication signal.
    • LOF: Loss of frame.
    • LOM: Loss of tributary multiframe.
    • LOP: Loss of pointer.
    • LOS: Loss of signal.
    • LRDI: Line remote defect indication.
    • LREI: Multiplex section-remote error indication.
    • OOF: Out of frame.
    • PAIS: Path alarm indication signal.
    • PRDI: Path remote defect indication.
    • PREI: Path remote error indication.
    • PPLM: Path payload mismatch.
    • RDOOL: Receive data out of lock.
    • RROOL: Receive reference out of lock.
    • SDBERE: Signal degradation.
    • SFBERE: Remote signal failure.
    • TROOL: Transmit reference out of lock.
    • PUNEQ: Path unequipped indication.
    • LCD: Loss of code group synchronization.
    • WLNK: WAN interface link status alarm indication.
    • ODU-AIS: ODU-(optical channel data unit) alarm indication signal.
    • ODU-LCK: ODU-(optical channel data unit) locked.
    • ODU-OCI: ODU-(optical channel data unit) open connection indication.
    • OTU-AIS: OTU-(optical channel transport unit) alarm indication signal.
    • OTU-LOM: OTU-(optical channel transport unit) loss of tributary multiframe.
    • OTU-SD-BER: OTU-(optical channel transport unit) signal degrade.
    • OTU-SF-BER: OTU-(optical channel transport unit) signal fail.
    • PM-BDI: ODU-(optical channel data unit) path monitoring (PM) backward defect indication (BDI).
    • PM-TIM: ODU-(optical channel data unit) path monitoring (PM) trail trace identifier (TTI) mismatch.
    • SM-BDI: OTU-(optical channel transport unit) section monitoring (SM) backward defect indication (BDI).
    • SM-IAE: OTU-(optical channel transport unit) section monitoring (SM) incoming alignment error (IAE).
    • SM-TIM: OTU-(optical channel transport unit) section monitoring (SM) trail trace identifier (TTI) mismatch.
    • OFFLINE: Alarm indicating that the optical module is offline.
    • B1TCA: B1 threshold-crossing alarm indication.
    • B2TCA: B2 threshold-crossing alarm indication.
    • clock fault: Component fault.
    • link fault: Link fault.
    • negotiation fail: Auto-negotiation failure.
    • PMA fault: Physical medium attachment fault.
    • WIS fault: WAN interface sublayer fault.
    • PCS fault: Physical coding sublayer fault.
    • XGXS fault: XGMII extender sublayer fault.
    • local fault: Fault at the local end.
    • remote fault: Fault at the remote end.
    • high BER: High bit error rate in received packets.
    • transceiver fault: Transceiver fault.
    • IIC fault: Inter-integrated circuit fault.
    • local fault and remote fault: Fault at both the local and remote ends.
    • chip fault: Chip fault.
    • PREFEC TCA: Pre-forward error correction threshold-crossing alarm.
    • transceiver offline: Alarm indicating that the transceiver is offline (no optical module is inserted).
    • transceiver unmatch: Mismatch between the transceiver type and the port mode.
    • group id unmatch: Mismatch between the transceiver type and the port mode.
    • bandwidth limit: Bandwidth limit.
    • ODU-SD-BER: ODU-(optical channel data unit) signal degrade.
  • no client-id: no client id is configured on the FlexE service interface.
  • no timeslot: no bandwidth or timeslot is bound to the FlexE service interface.
  • subtype mismatch: the sub-timeslot granularities of FlexE service interfaces at both ends do not match. both ends report subtype mismatch.
  • delay difference overlong: the delay of the physical interface in the group to which the FlexE service interface belongs is excessively long.
  • tx timeslot null: the tx timeslot fails to be configured for the FlexE service interface or timeslots cannot be allocated.
  • rx timeslot null: the FlexE service interface does not have rx timeslots.
  • rx timeslot error: the rx timeslot of the FlexE service interface does not match the local rx timeslot table.
Line protocol current state

Link layer protocol status of the interface:

  • UP: The link layer protocol of this interface is working properly.
  • (mf): mac-flapping blocked. Traffic on the interface is interrupted due to a network loop.
  • DOWN (BFD status down): The bidirectional forwarding detection (BFD) session bound to the interface goes Down.
  • DOWN (Main BFD status down): The BFD session bound to the main interface goes Down, which changes the BFD session status on the Layer 2 or Layer 3 sub-interface correspondingly. This state is available only for the Layer 2 or Layer 3 sub-interface.
  • DOWN (Main bit-error-detection down): The status displayed on Layer 2 or Layer 3 sub-interfaces when the bit error ratio of the interface exceeds the alarm threshold. By default, the bit error function on an interface associates with that on Layer 2 or Layer 3 sub-interfaces.
  • DOWN (Bit-error-detection down): The bit error ratio on the interface exceeds the alarm threshold.
  • DOWN (dampening suppressed):The interface is being suppressed by the protocol module.
  • DOWN: The link layer protocol status of the interface is Down or no IP address is assigned to the interface.

    For example, if no IP address is assigned to an IP service-capable interface,its protocol status is Down.

  • UP (spoofing): The link layer protocol of the interface is always Up with the spoofing feature enabled.
Last line protocol up time

Last time the link-layer protocol of the interface went Up.
Last physical up time

Last time when the physical status of the interface went Up.

A hyphen (-) indicates that the physical status of the interface does not change.

When the interface goes Up, if the system is configured with a time zone and is in the summer time, the time is displayed in the format of YYYY/MM/DD HH:MM:SS UTC±HH:MM DST.
Last physical down time

Last time when the physical status of the interface goes Down.

A hyphen (-) indicates that the physical status of the interface does not change.

When the interface goes Down, if the system is configured with a time zone and is in the summer time, the time is displayed in the format of YYYY/MM/DD HH:MM:SS UTC±HH:MM DST.
Last 300 seconds input rate

Rate of the bit and the input packet that pass through the interface in the last 5 minutes:

  • If the interface is in the hybrid mode, that is, it reads about all the packets on the LAN, use the error to test the traffic.
  • If the interface is not in the hybrid mode, that is, the interface records only the traffic sent and received by itself, the error displays only the traffic sent and received by the interface.

You can run the set flow-stat interval command to change the interval at which traffic statistics are collected.
Last 300 seconds output rate

Rate of the bit and the output packet that pass through the interface in the last 5 minutes:

  • If the interface is in the hybrid mode, that is, it reads about all the packets on the LAN, use the error to test the traffic.
  • If the interface is not in the hybrid mode, that is, the interface records only the traffic sent and received by itself, the error displays only the traffic sent and received by the interface.

You can run the set flow-stat interval command to change the interval at which traffic statistics are collected.
Last 300 seconds output utility rate

Percentage of the rate for sending packets to the total bandwidth.
Route Port

Layer 3 interface.
Internet Address is

IP address and subnet mask of the interface.
IP Sending Frames' Format

Format of Ethernet frames sent by the interface.

PKTFMT_ETHNT_2 is the default frame format. When receiving frames, an Ethernet interface can identify the following formats:

  • PKTFMT_ETHNT_2.
  • Ethernet_SNAP.
  • 802.2.
  • 802.3.
Hardware address

MAC address of the interface.
Current system time

Current system time.

If the system is configured with a time zone and is in the summer time, the time is displayed in the format of YYYY/MM/DD HH:MM:SS UTC±HH:MM DST.
Statistics last cleared

Last time when statistics on the interface were deleted.
Input peak rate

Maximum average rate at which packets were received during all statistical intervals. During each statistical interval, packets are received at a specific rate.

You can run the set flow-stat interval command to change the interval at which traffic statistics are collected. The value is an integer ranging from 10 to 600, in seconds. It must be an integer multiple of 10.

The default interval is 300 seconds.
Input

Total number and total bytes of received packets on an interface. Packets include correct packets (unicast, broadcast, multicast packets and JumboOctets), incorrect packets, and dropped packets.

  • 183126871 bytes, 182525 packets: number of correctly sent packets and bytes. The number of sent packets is the sum of the sent unicast, broadcast, and multicast packets.
  • Number of correctly received packets and bytes. The packets include:
    • Unicast.
    • Multicast.
    • Broadcast.
    • JumboOctets: Long packets with the packet length greater than or equal to 1518 bytes and less than or equal to the maximum value (9636 bytes), excluding other format errors.
  • Number of received incorrect packets and dropped packets of the following types:
    • CRC: Packets whose length is in the normal range but that contain that CRC error.
    • Symbol: Error packets at the physical layer.
    • Overrun: Packets that are discarded due to overflow.
    • InRangeLength: Packets with lengths ranging from 46 bytes to 1500 bytes, excluding other format errors.
    • LongPacket: Packets longer than the maximum packet length (9636 bytes), excluding other format errors.
    • Jabber: Packets longer than the maximum length (9636 bytes) and that contain the CRC error.
    • Alignment: Packets longer than 64 bytes and less than 1518 bytes and that contains the CRC error.
    • Fragment: Packets less than the minimum packet length and that contain the CRC error.
    • Undersized Frame: Short packets less than the minimum packet length.
    • RxPause: Received Pause packets.
Input bandwidth utilization

Utilization of the bandwidth about IPv4/IPv6 packets received by the interface.
Output peak rate

Maximum average rate at which packets were sent during all statistical intervals. During each statistical interval, packets are sent at a specific rate.

You can run the set flow-stat interval command to change the interval at which traffic statistics are collected. The value is an integer ranging from 10 to 600, in seconds. It must be an integer multiple of 10.

The default interval is 300 seconds.
Output

Total number and total bytes of sent packets on an interface. Packets include correct packets (unicast, broadcast, multicast packets and JumboOctets), incorrect packets, and dropped packets.

  • 183126871 bytes, 182525 packets: number of correctly sent packets and bytes. The number of sent packets is the sum of the sent unicast, broadcast, and multicast packets.
  • Number of correctly sent packets of the following types:
    • Unicast.
    • Multicast.
    • Broadcast.
    • JumboOctets: Long packets with the packet length greater than or equal to 1518 bytes and less than or equal to the maximum value (9636 bytes), excluding other format errors.
  • Number of sent incorrect packets and dropped packets of the following types:
    • Lost: Lost packets.
    • Overflow: Packets that are discarded due to overflow.
    • Underrun: Half packets.
    • System: Packets when system error occurs.
    • Overruns: Packets that are discarded due to overflow.
    • TxPause: Sent Pause packets.
Output bandwidth utilization

Utilization of the bandwidth about IPv4/IPv6 packets sent by the interface.
The Maximum Transmit Unit

MTU of the interface.

For example, the default MTU of an Ethernet interface is 1500 bytes. The packet whose size is greater than the MTU is fragmented before being transmitted. If fragmentation is not allowed, the packets are discarded.
The Maximum Transmit Unit is

MTU of the interface.
Description

Interface description.

A maximum of 242 case-sensitive characters (including spaces) can be entered. The description helps you know the functions of the interface.

If the description command is not used to configure the interface description, the description is empty by default.
ifindex

Interface index.
Ipv4

Traffic statistics about IPv4 packets sent and received by the interface. This field is displayed only after the statistic enable command is run in the main interface view and then the statistic mode forward command is run in the interface view.
Ipv6

Traffic statistics about IPv6 packets sent and received by the interface. This field is displayed only after the statistic enable command is run in the main interface view and then the statistic mode forward command is run in the interface view.
Parent Topic: Basic Interface Configuration Commands
Copyright © Huawei Technologies Co., Ltd.
Copyright © Huawei Technologies Co., Ltd.
< Previous topic Next topic >