show ports utilization

show ports {mgmt | port_list | tag tag | stack-ports stacking-port_list} utilization {bandwidth | bytes | packet}

Description

Displays real-time port utilization information. The total utilization displays as real-time information, constantly refreshing. and the parameter displays show a snapshot of the activity on the port when you issue the command.

Syntax Description

mgmt

Specifies the management port.

port_list

Specifies one or more ports or slots and ports.

tag

Specifies an 802.1Q or 802.1ad tag value.

stacking-port_list

Specifies one or more stacking slots and ports.

bandwidth

Specifies port utilization as percentage of bandwidth.

bytes

Specifies port utilization in bytes per second.

packet

Specifies port utilization in packets per second.

Default

N/A.

Usage Guidelines

The software continuously monitors port utilization and calculates bandwidth as a function of each port‘s maximum link capacity.

The total utilization display presents real-time statistics. Use the spacebar to toggle the real-time displayed information for packets, bytes, and bandwidth in that order. When you use a parameter (packets, bytes, or bandwidth) with the command, the display for the specified type shows a snapshot per port when you issued the command. When the show ports utilization command is run with the bandwidth, bytes, or packets options, the command may need to be repeated a few times in order for the ExtremeXOS software to gather enough statistics to calculate appropriate values.

If you do not specify a port number, range of ports, or tag value, port utilization information is displayed for all ports.

The tag value may be associated with either a VMAN or a VLAN.

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

Example

The following command displays utilization statistics for port 1 on a stand-alone switch:

show ports 1 utilization

The following example shows sample output from the show ports utilization packets command:

Link Utilization Averages                            Mon Oct  6 22:38:25 2008
Port     Link    Rx              Peak Rx          Tx               Peak Tx
State   pkts/sec        pkts/sec         pkts/sec         pkts/sec
================================================================================
1:1       A            47            191                0               0
1:2       A             0              0                0               0
2:1       R             0              0                0               0
2:2       R             0              0                0               0
3:1       R             0              0                0               0
3:2       R             0              0                0               0
4:1       R             0              0                0               0
4:2       R             0              0                0               0
5:1       R             0              0                0               0
5:2       R             0              0                0               0
6:1       R             0              0                0               0
6:2       R             0              0                0               0
7:1       R             0              0                0               0
7:2       R             0              0                0               0
================================================================================
> indicates Port Display Name truncated past 8 characters
Link State: A-Active, R-Ready, NP-Port Not Present, L-Loopback
Spacebar->toggle screen U->page up  D->page down ESC->exit
Note

Note

Use the spacebar to toggle this real-time display for all ports from packets to bytes to bandwidth, in that order.

The following example shows sample output from the show ports utilization bytes command:

Link Utilization Averages                            Mon Oct  6 22:39:22 2008
Port     Link    Rx              Peak Rx          Tx               Peak Tx
State   bytes/sec       bytes/sec        bytes/sec        bytes/sec
================================================================================
1:1       A             0               0               0              63
1:2       A             0              63              63              63
2:1       R             0               0               0               0
2:2       R             0               0               0               0
3:1       R             0               0               0               0
3:2       R             0               0               0               0
4:1       R             0               0               0               0
4:2       R             0               0               0               0
5:1       R             0               0               0               0
5:2       R             0               0               0               0
6:1       R             0               0               0               0
6:2       R             0               0               0               0
7:1       R             0               0               0               0
7:2       R             0               0               0               0
================================================================================
> indicates Port Display Name truncated past 8 characters
Link State: A-Active, R-Ready, NP-Port Not Present, L-Loopback
Spacebar->toggle screen U->page up  D->page down ESC->exit

The following example shows sample output of the show ports utilization bandwidth command:

Link Utilization Averages                            Mon Oct  6 22:39:46 2008
Port     Link    Link   Rx             Peak Rx       Tx            Peak Tx
State   Speed  % bandwidth    % bandwidth   % bandwidth   % bandwidth
================================================================================
1:1       A       100       0.00          0.03          0.00            0.00
1:2       A       100       0.00          0.00          0.00            0.00
2:1       R       0         0.00          0.00          0.00            0.00
2:2       R       0         0.00          0.00          0.00            0.00
3:1       R       0         0.00          0.00          0.00            0.00
3:2       R       0         0.00          0.00          0.00            0.00
4:1       R       0         0.00          0.00          0.00            0.00
4:2       R       0         0.00          0.00          0.00            0.00
5:1       R       0         0.00          0.00          0.00            0.00
5:2       R       0         0.00          0.00          0.00            0.00
6:1       R       0         0.00          0.00          0.00            0.00
6:2       R       0         0.00          0.00          0.00            0.00
7:1       R       0         0.00          0.00          0.00            0.00
7:2       R       0         0.00          0.00          0.00            0.00
================================================================================
> indicates Port Display Name truncated past 8 characters
Link State: A-Active, R-Ready, NP-Port Not Present, L-Loopback
Spacebar->toggle screen U->page up  D->page down ESC->exit

History

This command was first available in ExtremeXOS 11.3.

The tag value was added in ExtremeXOS 12.4.4.

Platform Availability

This command is available on the ExtremeSwitching X435, X440-G2, X450-G2, X460-G2, X465, X590, X620, X670-G2, X690, X695, and X870 series switches. The stack-ports option is available only on SummitStack.