CloudEngine 8800, 7800, 6800, and 5800 V200R005C10 Command Reference
This document describes all the configuration commands of the device, including the command function, syntax, parameters, views, default level, usage guidelines, examples, and related commands.
Discarded Packet Capture Configuration Commands
Only the CE8861EI, CE8868EI, CE8850-64CQ-EI, CE6865EI, and CE6857EI support the discarded packet capture function.
display qos capture statistics drop-packet
Function
The display qos capture statistics drop-packet command displays information about the captured discarded packets.
Format
display qos capture statistics drop-packet { ip | ipv6 | ethernet } { slot slot-id | tcb slot slot-id [ chip chip-id ] }
Parameters
| Parameter | Description | Value |
|---|---|---|
ip |
Displays information about IPv4 packets. |
- |
ipv6 |
Displays information about IPv6 packets. |
- |
ethernet |
Displays Layer 2 information of packets. |
- |
tcb |
Displays information about the packets discarded due to congestion. |
- |
slot slot-id |
Specifies the stack ID of a switch. |
The value must be set according to the device configuration. |
chip chip-id |
Specifies a chip ID. If no chip ID is specified, information about discarded packets in the specified slot is displayed. |
The value must be set according to the device configuration. |
Usage Guidelines
After the discarded packet capture function is enabled using the qos capture drop-packet enable command, the device captures the packets discarded due to congestion on the device chip. You can use the display qos capture statistics drop-packet command to view information about the captured discarded packets, facilitating network fault locating and diagnosis.
The device can record a maximum of 1024 discarded packets. If the number of captured discarded packets exceeds the maximum, the newly captured packets override previously captured packets.
Example
# View information about the IPv4 packets discarded due to congestion in slot 1.
<HUAWEI> display qos capture statistics drop-packet ip tcb slot 1
Time: 2018-06-28 19:36:06
Total Drop Packets: 3
--------------------------------------------------------------------------------
Num Time Source-MAC Destination-MAC Vlan
Source-IP Destination-IP Source-Port Destination-Port
Queue IfName Reason
PacketHeader
--------------------------------------------------------------------------------
0 2018-06-28 11:46:21 0010-9400-0005 0010-9400-0002 100
192.168.1.2 192.168.0.1 0 0
0 100GE1/0/1 Egress admission drop can cause a trigger
0010940000020010940000058100006408004500006ab0d20000fffd886bc0550102c00000010000
00000000000000000000000000000000000000000000000000000000000000000000000000000000
1 2018-06-28 11:46:21 0010-9400-0005 0010-9400-0002 100
192.168.1.2 192.168.0.1 0 0
0 100GE1/0/1 Egress admission drop can cause a trigger
0010940000020010940000058100006408004500006ab8ee0000fffd804fc0550102c00000010000
00000000000000000000000000000000000000000000000000000000000000000000000000000000
2 2018-06-28 11:46:21 0010-9400-0005 0010-9400-0002 100
192.168.1.2 192.168.0.1 0 0
0 100GE1/0/1 Egress admission drop can cause a trigger
0010940000020010940000058100006408004500006ab0d40000fffd8869c0550102c00000010000
00000000000000000000000000000000000000000000000000000000000000000000000000000000
# View information about the IPv6 packets discarded due to congestion in slot 1.
<HUAWEI> display qos capture statistics drop-packet ipv6 tcb slot 1
Time: 2018-06-28 19:38:05
Total Drop Packets: 2
--------------------------------------------------------------------------------
Num Time Source-IP Source-MAC
Source-Port Destination-IP Destination-MAC
Destination-Port Vlan Queue
IfName Reason
PacketHeader
--------------------------------------------------------------------------------
0 2018-06-28 11:32:15 2000::2 0010-9400-0001
0 2000::1 0010-9400-0002
0 100 0
100GE1/0/1 Egress admission drop can cause a trigger
0010940000020010940000018100006486dd6000000000423bff2000000000000000000000000000
00022000000000000000000000000000000100000000000000000000000000000000000000000000
1 2018-06-28 11:32:15 2000::2 0010-9400-0001
0 2000::1 0010-9400-0002
0 100 0
100GE1/0/1 Egress admission drop can cause a trigger
0010940000020010940000018100006486dd6000000000423bff2000000000000000000000000000
00022000000000000000000000000000000100000000000000000000000000000000000000000000
# View Layer 2 information of the packets discarded due to congestion in slot 1.
<HUAWEI> display qos capture statistics drop-packet ethernet tcb slot 1
Time: 2018-06-28 19:39:06
Total Drop Packets: 3
--------------------------------------------------------------------------------
Num Time Ethernet-Type Vlan Source-MAC Destination-MAC
Queue IfName Reason
PacketHeader
--------------------------------------------------------------------------------
0 2018-06-28 11:32:16 0x88B5 100 0010-9400-0001 0010-9400-0002
0 100GE1/0/1 Egress admission drop can cause a trigger
0010940000020010940000018100006488b500000000000000000000000000000000000000000000
00000000000000000000000000000000000000000000000000000000000000000000000000000000
1 2018-06-28 11:32:16 0x88B5 100 0010-9400-0001 0010-9400-0002
0 100GE1/0/1 Egress admission drop can cause a trigger
0010940000020010940000018100006488b500000000000000000000000000000000000000000000
00000000000000000000000000000000000000000000000000000000000000000000000000000000
2 2018-06-28 11:32:16 0x88B5 100 0010-9400-0001 0010-9400-0002
0 100GE1/0/1 Egress admission drop can cause a trigger
0010940000020010940000018100006488b500000000000000000000000000000000000000000000
00000000000000000000000000000000000000000000000000000000000000000000000000000000
Item |
Description |
|---|---|
Total Drop Packets |
Total number of the captured discarded packets. |
Num |
ID of a captured discarded packet. |
Time |
Time when a discarded packet is captured. |
Source-MAC |
Source MAC address of a discarded packet. |
Destination-MAC |
Destination MAC address of a discarded packet. |
Vlan |
VLAN ID of a discarded packet. |
Source-IP |
Source IP address of a discarded packet. |
Destination-IP |
Destination IP address of a discarded packet. |
Source-Port |
Source port number of a discarded packet. |
Destination-Port |
Destination port number of a discarded packet. |
Queue |
Queue ID of a packet discarded. |
IfName |
Source interface name of a packet discarded. |
Reason |
Reason why a packet is discarded. |
Ethernet-Type |
Layer 2 information of a discarded packet. |
PacketHeader |
Header of a discarded packet. A maximum of 80 bytes are supported. |
qos capture drop-packet enable
Function
The qos capture drop-packet enable command enables the discarded packet capture function. This function captures the packets discarded due to congestion.
The undo qos capture drop-packet enable command disables the discarded packet capture function.
By default, the discarded packet capture function is disabled.
Format
qos capture drop-packet enable tcb [ ingress | egress ]
undo qos capture drop-packet enable tcb [ ingress | egress ]
Parameters
| Parameter | Description | Value |
|---|---|---|
tcb |
Captures the packets discarded due to congestion. |
- |
ingress |
Captures the incoming packets discarded due to congestion. |
- |
egress |
Captures the outgoing packets discarded due to congestion. |
If both the ingress and egress parameters are not configured, the device captures the outgoing packets discarded due to congestion. |
Usage Guidelines
Usage Scenario
When packet loss occurs in the chip of a device, the device only records the number of discarded packets, but not detailed information about the packets. Therefore, the impact on services cannot be evaluated, and network faults are hard to locate and diagnose in a timely manner. If packet loss occurs in the device chip, you can run the qos capture drop-packet enable command to enable the discarded packet capture function. This function captures the packets discarded due to congestion on the device chip, enables the device to send the discarded packets to the CPU, and analyzes the characteristics and count of the discarded packets.
Precautions
The device sends the captured discarded packets to the CPU. The maximum rate for sending discarded packets to the CPU is 1000 pps. Therefore, this function is applicable to networks with a few packets discarded. If a large number of packets are discarded on a network, this function cannot capture all the discarded packets.
When you run the qos capture drop-packet enable command multiple times, only the latest configuration takes effect.
Follow-up Procedure
To send the captured discarded packets to a collector through a GRPC interface, run the sensor-path command to set the sampling path of captured discarded packets on a Telemetry sensor to huawei-qos:qos/qosGlobalCfgs/qosCaptureDropstats/qosCaptureDropstat.