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.

Note

Note

Packets can be dropped at multiple locations along the path through the hardware. Due to hardware limitations, the dropped-packet counters for QoS profiles cannot count dropped packets from all possible locations. Because of these limitations, the sum of all dropped packets for all QoS profiles can be less than the per port count displayed with the command: show ports port_list congestion {no-refresh} .

On BlackDiamond X8 series switches, BlackDiamond 8800 c-, and e-series modules, and Summit X440, you can display packet counts for one port per slot or module at a time. 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. This limitation does not apply to BlackDiamond 8900 series modules.

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.

Note

Note

On BlackDiamond X8 series switches, BlackDiamond 8900 xm-series modules and Summit X670 series switches, QP1-4 support one unicast and one multicast queue for each QoS profile. The QoS monitor counters for QP1-4 tally the unicast and multicast traffic for these QoS profiles. QoS monitor counters for QP5-8 tally only the unicast traffic for these QoS profiles.

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 BlackDiamond X8 series switches, BlackDiamond 8000 series modules, SummitStack, and Summit family switches.