show ports statistics

show ports {port_list | stack-ports stacking-port-list} statistics {no-refresh | refresh}

Description

Displays real-time port statistic information. The switch automatically refreshes the output unless otherwise specified.

Syntax Description

stacking-port-list Specifies one or more stacking slots and ports. Applies to SummitStack and the ExtremeSwitching series switches only.
port_list Specifies one or more ports or slots and ports.
no-refresh Specifies that auto-refresh is disabled. The output provides a real-time snapshot of the port statistics at the time the command is issued. This setting is not saved.
refresh Specifies a continuous refresh of output.

Default

The switch automatically refreshes the output.

Usage Guidelines

If you do not specify a port number or range of ports, statistics are displayed for all ports.

If you do not specify the no-refresh parameter, the switch automatically refreshes the output (this is the default behavior).

If you specify the no-refresh parameter, the output provides a snapshot of the real-time port statistics at the time you issue the command and displays the output in page-by-page mode (this was the default behavior in ExtremeXOS 11.2 and earlier). This setting is not saved; therefore, you must specify the no-refresh parameter each time you want a snapshot of the port statistics.

Jumbo frame statistics are displayed for switches only that are configured for jumbo frame support.

This status information may be useful for your technical support representative if you have a network problem.

Collected Port Statistics

The switch collects the following port statistic information:
  • Port Number.

  • Link State—The current state of the link. Options are:
    • Active (A)—The link is present at this port.

    • Ready (R)—The port is ready to accept a link.

    • Loopback (L)—The port is in Loopback mode.

  • Transmitted Packet Count (Tx Pkt Count)—The number of packets that have been successfully transmitted by the port.

  • Transmitted Byte Count (Tx Byte Count)—The total number of data bytes successfully transmitted by the port.

  • Received Packet Count (RX Pkt Count)—The total number of good packets that have been received by the port.

  • Received Byte Count (RX Byte Count)—The total number of bytes that were received by the port, including bad or lost frames. This number includes bytes contained in the Frame Check Sequence (FCS), but excludes bytes in the preamble.

  • Received Broadcast (RX Bcast)—The total number of frames received by the port that are addressed to a broadcast address.
    Note

    Note

    On switches, when a broadcast jumbo frame is sent, the RX Bcast counter is not updated. The RX Pkt counter is updated to reflect the received broadcast jumbo frames.

  • Received Multicast (RX Mcast)—The total number of frames received by the port that are addressed to a multicast address.

Port Monitoring Display Keys

The following table describes the keys used to control the display that appears if auto-refresh is enabled (the default behavior).
Table 1. Port Monitoring Display Keys with Auto-Refresh Enabled
Key(s) Description

U

Displays the previous page of ports.

D

Displays the next page of ports.

[Esc]

Exits from the screen.

0

Clears all counters.

The following table describes the keys used to control the display that appears if you auto-refresh is disabled.
Table 2. Port Monitoring Displays Keys with Auto-Refresh Disabled
Key Description

Q

Exits from the screen.

[Space]

Displays the next page of ports.

Example

The following command displays port statistics for all ports on switches with auto-refresh enabled (the default behavior):

show ports statistics

The following is truncated sample output from this command:

Port Statistics                                   Tue Jul  5 14:18:34 UTC 2005
Port     Link      Tx Pkt     Tx Byte       Rx Pkt     Rx Byte   Rx      Rx
State     Count     Count        Count      Count     Bcast   Mcast
===========================================================================
1        R           0           0            0           0       0       0
2        R           0           0            0           0       0       0
3        R           0           0            0           0       0       0
4        R           0           0            0           0       0       0
5        R           0           0            0           0       0       0
6        R           0           0            0           0       0       0
7        R           0           0            0           0       0       0
8        R           0           0            0           0       0       0
9        R           0           0            0           0       0       0
10       R           0           0            0           0       0       0
11       R           0           0            0           0       0       0
12       R           0           0            0           0       0       0
13       R           0           0            0           0       0       0
14       R           0           0            0           0       0       0
15       R           0           0            0           0       0       0
16       R           0           0            0           0       0       0
17       R           0           0            0           0       0       0
================================================================================
Link State: A-Active, R-Ready, NP-Port Not Present, L-Loopback
0->Clear Counters  U->page up  D->page down ESC->exitPort Statistics

History

This command was first available in ExtremeXOS 10.1.

The link state information was updated to include NP-Port not present in ExtremeXOS 11.2.

Support for the auto-refresh functionality and the no-refresh parameter were added in ExtremeXOS 11.3. Auto-refresh continually updates the display. The no-refresh parameter takes a real-time snapshot of the display at the time you issue the command.

The refresh keyword was added in ExtremeXOS 16.1.

Platform Availability

This command is available on ExtremeSwitching 5320, 5420, 5520, and 5720 series switches.