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 Summit family 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.

    • Not Present (NP)—The port is configured, but the module is not installed in the slot (modular switches only).

    • 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 Summit 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).
Click to expand in new window

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.
Click to expand in new window

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 slot 1, ports 1 through 2 on a modular switch with auto-refresh disabled:

show ports 1:1-1:2 statistics no-refresh

The following is sample output from this command:

Port Statistics
Port    Link    Tx Pkt   Tx Byte     Rx Pkt    Rx Byte       Rx       Rx
State   Count    Count     Count     Count         Bcast    Mcast
==========================================================================
1:1     A       7241    2722608      14482    3968068          0        0
1:2     R          0          0          0          0          0        0
==========================================================================
Link State: A-Active, R-Ready, NP-Port not present, L-Loopback

The following command displays port statistics for all ports on the Summit family 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 all platforms.

The stack-ports option is available on SummitStack and the Summit Family switches only.