show ports qosmonitor {congestion}

show ports port_list qosmonitor {congestion} {no-refresh | refresh}
Note

Note

This description describes command operation on the BlackDiamond X8 series switches, BlackDiamond 8800, SummitStack, and Summit family switches.

Description

Displays egress packet counts or dropped-traffic counts for each QoS profile on the specified ports.

Syntax Description

port_list Specifies one or more slots and ports.
congestion Specifies the display of packets dropped at ingress due to port congestion.
no-refresh Specifies a static snapshot of data instead of the default dynamic display.
refresh Specifies a continuous refresh of output.

Default

Displays egress packet counts in real-time.

Usage Guidelines

The bottom line in the real-time display shows keys that you can press to change the display. For example, the spacebar toggles the display between egress packet counts and ingress dropped-packet counts.

Note

Note

This command does not work properly if another CLI session is displaying congestion statistics in real time.

If you specify the no-refresh parameter, the system displays a snapshot of the data at the time you issue the command.

You can simultaneously display packet counts for multiple ports, but they must be from different slots or modules. The dropped packet display is limited to the 8 most-significant digits.

When you display the packet counts for a port, this action configures the hardware to monitor that port. If the slot or module hardware was previously configured to monitor a different port, the counters are reset for the new port. If the selected port is the last port displayed on the module, the counters are not reset.

Example

The following example shows the egress packet counts for the specified ports:
# show ports 2:1, 3:6 qosmonitor
Qos Monitor Req Summary                                Thu Mar  2 10:58:23 2006
Port      QP1      QP2      QP3      QP4      QP5      QP6      QP7      QP8
Pkt      Pkt      Pkt      Pkt      Pkt      Pkt      Pkt      Pkt
Xmts     Xmts     Xmts     Xmts     Xmts     Xmts     Xmts     Xmts
================================================================================
2:1         0        0        0        0        0        0        0        0
3:6         0        0        0        0        0        0        0        0
================================================================================
> indicates Port Display Name truncated past 8 characters
Spacebar->Toggle screen 0->Clear counters  U->Page up  D->Page down ESC->exit
The next example shows the dropped packet counts for the specified ports:
# show ports 2:1, 3:6 qosmonitor congestion
QoS Monitor Req Summary                             Thu Jun 12 01:17:14 2008
Port    QP1      QP2      QP3      QP4      QP5      QP6      QP7      QP8
Pkt      Pkt      Pkt      Pkt      Pkt      Pkt      Pkt      Pkt
Cong     Cong     Cong     Cong     Cong     Cong     Cong     Cong
================================================================================
2:1     0        0        0        0        0        0        0        0
3:6     8745     0        129      0        0        0        0        0
================================================================================
> indicates Port Display Name truncated past 8 characters
Spacebar->Toggle screen 0->Clear counters U->Page up D->Page down ESC->exit

History

This command was first available in ExtremeXOS 10.1.

You must specify the ports in ExtremeXOS 11.0.

The no-refresh keyword was added in ExtremeXOS 11.3.

The congestion keyword was added in ExtremeXOS 12.2, and the toggling functionality was modified to switch between egress packets and dropped packets.

The refresh keyword was added in ExtremeXOS 16.1.

Platform Availability

This command is available on all platforms.