Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 03-Data buffer commands | 114.20 KB |
buffer packet-drop alarm enable
buffer packet-drop alarm interval
buffer threshold alarm interval
buffer usage threshold headroom
buffer usage threshold null-queue
buffer usage threshold queue (interface view)
display buffer usage interface
port buffer usage threshold headroom null-queue
port buffer usage threshold null-queue
buffer transient-capture enable
display buffer transient-capture packet-drop
Data buffer commands
Data buffer commands
buffer packet-drop alarm enable
Use buffer packet-drop alarm enable to enable packet-drop alarms.
Use undo buffer packet-drop alarm enable to disable packet-drop alarms.
Syntax
buffer packet-drop alarm enable
undo buffer packet-drop alarm enable
Default
Packet-drop alarms are disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
The device generates and reports packet-drop alarms to a network management system (such as IMC) for displaying the data buffer usage.
This command does not take effect only on the Headroom buffer.
Examples
# Enable packet-drop alarms.
<Sysname> system-view
[Sysname] buffer packet-drop alarm enable
Related commands
buffer usage threshold queue (interface view)
buffer packet-drop alarm interval
buffer packet-drop alarm interval
Use buffer packet-drop alarm interval to set the interval for sending packet-drop alarms.
Use undo buffer packet-drop alarm interval to restore the default.
Syntax
buffer packet-drop alarm interval interval
undo buffer packet-drop alarm interval
Default
The interval for sending packet-drop alarms is 5 seconds.
Views
System view
Predefined user roles
network-admin
Parameters
interval: Specifies the interval for sending packet-drop alarms, in the range of 0 to 60 seconds. The value of 0 indicates that packet-drop alarms are sent immediately after they are generated.
Usage guidelines
This command takes effect only when packet-drop alarms are enabled.
Examples
# Set the interval for sending packet-drop alarms to 20 seconds.
<Sysname> system-view
[Sysname] buffer packet-drop alarm interval 20
Related commands
buffer packet-drop alarm enable
buffer threshold alarm enable
Use buffer threshold alarm enable to enable threshold-crossing alarms.
Use undo buffer threshold alarm enable to disable threshold-crossing alarms.
Syntax
buffer threshold alarm { egress | headroom | ingress } enable
undo buffer threshold alarm { egress | headroom | ingress } enable
Default
Threshold-crossing alarms are disabled.
Views
System view
Predefined user roles
network-admin
Parameters
ingress: Specifies the ingress buffer.
headroom: Specifies the Headroom buffer.
egress: Specifies the egress buffer.
Usage guidelines
The device generates and reports threshold-crossing alarms to a network management system (such as IMC) for displaying the data buffer usage.
Examples
# Enable threshold-crossing alarms.
<Sysname> system-view
[Sysname] buffer threshold alarm ingress enable
Related commands
buffer usage threshold headroom
buffer usage threshold queue (interface view)
buffer threshold alarm interval
Use buffer threshold alarm interval to set the interval for sending threshold-crossing alarms.
Use undo buffer threshold alarm interval to restore the default.
Syntax
buffer threshold alarm { egress | headroom | ingress } interval interval
undo buffer threshold alarm { egress | headroom | ingress } interval
Default
The interval for sending threshold-crossing alarms is 5 seconds.
Views
System view
Predefined user roles
network-admin
Parameters
ingress: Specifies the ingress buffer.
headroom: Specifies the Headroom buffer.
egress: Specifies the egress buffer.
interval: Specifies the interval for sending threshold-crossing alarms, in the range of 0 to 60 seconds. 0 indicates that threshold-crossing alarms are sent immediately after they are generated.
Usage guidelines
This command takes effect only when threshold-crossing alarms are enabled.
Examples
# Set the interval for sending threshold-crossing alarms to 20 seconds.
<Sysname> system-view
[Sysname] buffer threshold alarm ingress interval 20
Related commands
buffer threshold alarm enable
buffer usage threshold headroom
buffer usage threshold queue (interface view)
buffer usage threshold headroom
Use buffer usage threshold headroom to set the global per-queue alarm threshold for the Headroom buffer.
Use undo buffer usage threshold headroom to restore the default.
Syntax
buffer usage threshold headroom slot slot-number ratio ratio
undo buffer usage threshold headroom slot slot-number ratio
Default
The global per-queue alarm threshold for the Headroom buffer is 100%.
Views
System view
Predefined user roles
network-admin
Parameters
slot slot-number: Specifies an IRF member device by its member ID (slot number).
ratio ratio: Specifies the alarm threshold in percentage, in the range of 1 to 100.
Usage guidelines
This command takes effect only when threshold-crossing alarms are enabled. When a queue exceeds the global alarm threshold for the Headroom buffer, the device generates and reports a threshold-crossing alarm to a network management system (such as IMC).
Examples
# Set the global per-queue alarm threshold to 50% for slot 1.
<Sysname> system-view
[Sysname] buffer usage threshold headroom slot 1 ratio 50
Related commands
buffer threshold alarm enable
buffer usage threshold null-queue
Use buffer usage threshold null-queue to set the global per-interface alarm threshold for the ingress or egress buffer.
Use undo buffer usage threshold null-queue to restore the default.
Syntax
buffer { egress | ingress } usage threshold slot slot-number null-queue ratio ratio
undo buffer { egress | ingress } usage threshold slot slot-number null-queue ratio
Default
The global per-queue alarm threshold for the ingress or egress buffer is 100%.
Views
System view
Predefined user roles
network-admin
Parameters
egress: Specifies the egress buffer.
ingress: Specifies the ingress buffer.
slot slot-number: Specifies an IRF member device by its member ID (slot number).
ratio ratio: Specifies the alarm threshold in percentage, in the range of 1 to 100.
Usage guidelines
This command takes effect only when threshold-crossing alarms are enabled.
When the alarm threshold is exceeded, the device generates and reports a threshold-crossing alarm to a network management system (such as IMC).
If you configure both the global alarm threshold and the alarm threshold on an interface, the latter takes effect.
If you configure this command multiple times, the most recent configuration takes effect.
Examples
# Set the global per-interface alarm threshold to 50% in slot 1.
<Sysname> system-view
[Sysname] buffer ingress usage threshold slot 1 interface ratio 50
Related commands
buffer threshold alarm enable
port buffer usage threshold null-queue
buffer usage threshold queue (interface view)
Use buffer usage threshold queue to set the buffer alarm threshold for a queue on an interface.
Use undo buffer usage threshold queue to restore the default.
Syntax
buffer egress usage threshold queue queue-id ratio ratio
undo buffer egress usage threshold queue queue-id ratio
Default
The egress buffer alarm threshold for a queue on an interface is 100%.
Views
Interface view
Predefined user roles
network-admin
Parameters
egress: Specifies the egress buffer.
queue-id: Specifies a queue by its ID in the range of 0 to 7.
ratio ratio: Specifies the alarm threshold in percentage, in the range of 1 to 100.
Usage guidelines
This command takes effect only when threshold-crossing alarms are enabled. When a queue exceeds the alarm threshold for the egress buffer, the device generates and reports a threshold-crossing alarm to a network management system (such as IMC).
Examples
# Set the egress buffer alarm threshold to 50% for queue 1 on Ten-GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] buffer egress usage threshold queue 1 ratio 50
Related commands
buffer threshold alarm enable
burst-mode enable
Use burst-mode enable to enable the Burst feature.
Use undo burst-mode enable to disable the Burst feature.
Syntax
burst-mode enable
undo burst-mode enable
Default
The Burst feature is disabled.
Views
System view
Predefined user roles
network-admin
Usage guidelines
The Burst feature is especially useful for reducing packet losses under the following circumstances:
· Broadcast or multicast traffic is intensive, resulting in bursts of traffic.
· Traffic enters a device from a high-speed interface and goes out of a low-speed interface.
· Traffic enters a device from multiple same-rate interfaces and goes out of an interface with the same rate.
Examples
# Enable the Burst feature.
<Sysname> system-view
[Sysname] burst-mode enable
display buffer
Use display buffer to display buffer size settings.
Syntax
display buffer [ slot slot-number ] [ queue [ queue-id ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
slot slot-number: Specifies an IRF member device by its member ID (slot number). If you do not specify an IRF member device, this command displays buffer size settings for all IRF member devices.
queue queue-id: Specifies a queue by its number in the range of 0 to 7. If you specify a queue, this command displays the fixed-area ratio and shared-area ratio for the specified queue. If you specify the queue keyword without the queue-id argument, this command displays the fixed-area ratio and shared-area ratio for each queue. If you do not specify the queue keyword, this command displays the total shared-area ratio.
Examples
# Display buffer size settings.
<Sysname> display buffer
Slot Type Eg(Total-shared)
1 cell 100%
Eg: Size of the sending buffer
Total-shared: Size of the shared buffer for all ports
# Display the fixed-area ratio and shared-area ratio for the queues.
<Sysname> display buffer queue
Slot Queue Type Eg(Guaranteed , Shared)
1 0-1,3-6 cell 0% , 0%
1 2 cell 0% , 20%
1 7 cell 100% , 0%
Eg: Size of the sending buffer
Guaranteed: Size of the minimum guaranteed buffer per queue
Shared: Size of the maximum shared buffer per queue
Table 1 Command output
|
Field |
Description |
|
Type |
Resource type. |
|
Queue |
Queue ID in the range of 0 to 7. |
|
Eg |
Egress buffer. |
|
(Total-shared) |
Total-shared indicates the total shared-area ratio. If the device does not support a resource type, this field displays two hyphens (--). |
|
(Guaranteed , Shared) |
· Guaranteed indicates the fixed-area ratio of a queue. · Shared indicates the shared-area ratio of a queue. |
display buffer usage
Use display buffer usage to display buffer usage.
Syntax
display buffer usage [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
slot slot-number: Specifies an IRF member device by its member ID (slot number). If you do not specify an IRF member device, this command displays buffer usage for all IRF member devices.
Examples
# Display buffer usage.
<Sysname> display buffer usage
Egress total-shared cell buffer usage on slot 1 :
XPE 0
Total: 4033 KB
Used: 0 KB
Free: 4033 KB
XPE 1
Total: 4033 KB
Used: 0 KB
Free: 4033 KB
XPE 2
Total: 4033 KB
Used: 0 KB
Free: 4033 KB
XPE 3
Total: 4033 KB
Used: 0 KB
Free: 4033 KB
5sec 1min 5min
------------------------------------------------------------------
Ten-GigabitEthernet1/0/1 XPE 0 0% 0% 0%
XPE 1 0% 0% 0%
XPE 2 0% 0% 0%
XPE 3 0% 0% 0%
Ten-GigabitEthernet1/0/2 XPE 0 0% 0% 0%
XPE 1 0% 0% 0%
XPE 2 0% 0% 0%
XPE 3 0% 0% 0%
Ten-GigabitEthernet1/0/3 XPE 0 0% 0% 0%
XPE 1 0% 0% 0%
XPE 2 0% 0% 0%
XPE 3 0% 0% 0%
Table 2 Command output
|
Field |
Description |
|
Egress total-shared cell buffer usage on slot |
Usage of cell resources in the shared area on an IRF member device. |
|
Unit |
Chip number. |
|
XPE |
Type of the data buffer. |
|
Block |
Block where the port resides. The block where the ports on the front panel of the device reside is fixed to Block 1. |
|
Total |
Total size of the data buffer. |
|
Used |
Size of used data buffer. |
|
Free |
Size of free data buffer. |
|
5sec |
Percentage of the buffer that the port uses for the last 5 seconds. |
|
1min |
Percentage of the buffer that the port uses for the last 1 minute. |
|
5min |
Percentage of the buffer that the port uses for the last 5 minutes. |
display buffer usage interface
Use display buffer usage interface to display buffer usage statistics for interfaces.
Syntax
display buffer usage interface [ interface-type [ interface-number ] ] [ verbose ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface-type [ interface-number ]: Specifies an interface by its type and number. If you do not specify the interface-type argument, this command displays buffer usage statistics for all Ethernet interfaces. If you specify the interface-type argument without the interface-number argument, this command displays buffer usage statistics for all Ethernet interfaces of the specified type.
verbose: Displays detailed buffer usage statistics. If you do not specify this keyword, the command displays brief buffer usage statistics.
Examples
# Display brief buffer usage statistics for Ten-GigabitEthernet 1/0/1.
<Sysname> display buffer usage interface ten-gigabitethernet 1/0/1
Interface QueueID Total Used Threshold(%) Violations
--------------------------------------------------------------------------------
GE1/0/1 0 9418032 0 30 0
1 9418032 0 30 0
2 9418032 0 30 0
3 9418032 0 30 0
4 9418032 0 30 0
5 9418032 0 30 0
6 9418032 0 30 0
7 9418032 0 30 0
Table 3 Command output
|
Field |
Description |
|
Total |
Data buffer size in bytes allowed for a queue. |
|
Used |
Data buffer size in bytes that has been used by a queue. |
|
Threshold(%) |
Buffer usage threshold for a queue. The threshold value is the same as the per-interface threshold value. |
|
Violations |
Number of threshold violations for a queue. The value of this field is reset upon a switch reboot. |
# Display detailed buffer usage statistics for Ten-GigabitEthernet 1/0/1.
[Sysname] display buffer usage interface ten-gigabitethernet 1/0/1 verbose
XGE1/0/1
Ingress:
QueueID: 0
Total: -- Used: 2 Threshold(%): 3
Violations: 4 Shared: 5 Headroom: 6
XoffThres: 7 IsDynamic: 1
Used(%): 6 Free: 15 UsedPeak: 17
HeadroomUsed(%): 3 HeadroomFree: 19 HeadroomPeak: 20
QueueID: 1
Total: -- Used: 4 Threshold(%): 6
Violations: 8 Shared: 10 Headroom: 12
XoffThres: 14 IsDynamic: 1
Used(%): 12 Free: 30 UsedPeak: 34
HeadroomUsed(%): 6 HeadroomFree: 38 HeadroomPeak: 40
QueueID: 2
Total: -- Used: 6 Threshold(%): 9
Violations: 12 Shared: 15 Headroom: 18
XoffThres: 21 IsDynamic: 1
Used(%): 18 Free: 45 UsedPeak: 51
HeadroomUsed(%): 9 HeadroomFree: 57 HeadroomPeak: 60
QueueID: 3
Total: -- Used: 8 Threshold(%): 12
Violations: 16 Shared: 20 Headroom: 24
XoffThres: 28 IsDynamic: 1
Used(%): 24 Free: 60 UsedPeak: 68
HeadroomUsed(%): 12 HeadroomFree: 76 HeadroomPeak: 80
QueueID: 4
Total: -- Used: 10 Threshold(%): 15
Violations: 20 Shared: 25 Headroom: 30
XoffThres: 35 IsDynamic: 1
Used(%): 30 Free: 75 UsedPeak: 85
HeadroomUsed(%): 15 HeadroomFree: 95 HeadroomPeak: 100
QueueID: 5
Total: -- Used: 12 Threshold(%): 18
Violations: 24 Shared: 30 Headroom: 36
XoffThres: 42 IsDynamic: 1
Used(%): 36 Free: 90 UsedPeak: 102
HeadroomUsed(%): 18 HeadroomFree: 114 HeadroomPeak: 120
QueueID: 6
Total: -- Used: 14 Threshold(%): 21
Violations: 28 Shared: 35 Headroom: 42
XoffThres: 49 IsDynamic: 1
Used(%): 42 Free: 105 UsedPeak: 119
HeadroomUsed(%): 21 HeadroomFree: 133 HeadroomPeak: 140
QueueID: 7
Total: -- Used: 16 Threshold(%): 24
Violations: 32 Shared: 40 Headroom: 48
XoffThres: 56 IsDynamic: 1
Used(%): 48 Free: 120 UsedPeak: 136
HeadroomUsed(%): 24 HeadroomFree: 152 HeadroomPeak: 160
Egress:
QueueID: 0
Total: 9 Used: 10 Threshold(%): 11
Violations: 12 TailDropThres: 13 IsDynamic: 1
DeadlockCount: 21 DeadlockRecover: 22
Used(%): 2 Free: 23 UsedPeak: 25
QueueID: 1
Total: 18 Used: 20 Threshold(%): 22
Violations: 24 TailDropThres: 26 IsDynamic: 1
DeadlockCount: 42 DeadlockRecover: 44
Used(%): 4 Free: 46 UsedPeak: 50
QueueID: 2
Total: 27 Used: 30 Threshold(%): 33
Violations: 36 TailDropThres: 39 IsDynamic: 1
DeadlockCount: 63 DeadlockRecover: 66
Used(%): 6 Free: 69 UsedPeak: 75
QueueID: 3
Total: 36 Used: 40 Threshold(%): 44
Violations: 48 TailDropThres: 52 IsDynamic: 1
DeadlockCount: 84 DeadlockRecover: 88
Used(%): 8 Free: 92 UsedPeak: 100
QueueID: 4
Total: 45 Used: 50 Threshold(%): 55
Violations: 60 TailDropThres: 65 IsDynamic: 1
DeadlockCount: 105 DeadlockRecover: 110
Used(%): 10 Free: 115 UsedPeak: 125
QueueID: 5
Total: 54 Used: 60 Threshold(%): 66
Violations: 72 TailDropThres: 78 IsDynamic: 1
DeadlockCount: 126 DeadlockRecover: 132
Used(%): 12 Free: 138 UsedPeak: 150
QueueID: 6
Total: 63 Used: 70 Threshold(%): 77
Violations: 84 TailDropThres: 91 IsDynamic: 1
DeadlockCount: 147 DeadlockRecover: 154
Used(%): 14 Free: 161 UsedPeak: 175
QueueID: 7
Total: 72 Used: 80 Threshold(%): 88
Violations: 96 TailDropThres: 104 IsDynamic: 1
DeadlockCount: 168 DeadlockRecover: 176
Used(%): 16 Free: 184 UsedPeak: 200
Table 4 Command output
|
Field |
Description |
|
Ingress |
Usage statistics for the ingress buffer. |
|
Egress |
Usage statistics for the egress buffer. |
|
Total |
Data buffer size allowed for a queue, in bytes. |
|
Used |
Data buffer size that has been used by a queue, in bytes. |
|
Threshold(%) |
Buffer usage threshold for a queue. The threshold value is the same as the per-interface threshold value. |
|
Violations |
Number of threshold violations for a queue. The value of this field is reset upon a switch reboot. |
|
Shared |
Number of cell resources in the shared area used by a queue. |
|
Headroom |
Number of cell resources in the Headroom area used by a queue. When a queue on an interface enabled with PFC enters PFC XOFF state, the interface sends XOFF frames to notify the peer interface to stop sending packets to that queue. Packets sent by the peer interface before it receives XOFF frames are stored in the Headroom area. |
|
XoffThres |
Back pressure frame triggering threshold. If a dynamic back pressure frame triggering threshold is configured, this field displays a percentage value. If a static back pressure frame triggering threshold is configured, this field displays an absolute value. |
|
TailDropThres |
Tail drop threshold, in the number of cell resources calculated according to the ratio value set in the buffer queue shared command. |
|
IsDynamic |
For the inbound direction, this field can be one of the following values: · 0—Indicates a static back pressure frame triggering threshold. · 1—Indicates a dynamic back pressure frame triggering threshold. For the outbound direction, this field can only be 1, which indicates a dynamic tail drop threshold. |
|
Used(%) |
Buffer usage in percentage. |
|
Free |
Free buffer in bytes. |
|
UsedPeak |
Peak used buffer in bytes during the time between two executions of the display buffer usage interface command. |
|
HeadroomUsed(%) |
Headroom area usage in percentage for the ingress buffer. |
|
HeadroomFree |
Free Headroom area in bytes for the ingress buffer. |
|
HeadroomPeak |
Peak used Headroom area in bytes during the time between two executions of the display buffer usage interface command. |
|
DeadlockCount |
Number of times the device entered the PFC deadlock state in the egress buffer. |
|
DeadlockRecover |
Number of times the device released the PFC deadlock state in the egress buffer. |
|
|
NOTE: For more information about back pressure frame triggering thresholds and PFC deadlock, see Ethernet interface configuration in Interface Configuration Guide. |
port buffer usage threshold headroom null-queue
Use port buffer usage threshold headroom null-queue to set the per-interface alarm threshold for the Headroom buffer.
Use undo port buffer usage threshold headroom null-queue to restore the default.
Syntax
port buffer usage threshold headroom null-queue ratio ratio
undo port buffer usage threshold headroom null-queue ratio
Default
The global alarm threshold for the Headroom buffer is used.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Parameters
ratio ratio: Specifies the alarm threshold in percentage, in the range of 1 to 100.
Usage guidelines
This command takes effect only when threshold-crossing alarms are enabled. When the global alarm threshold for the Headroom buffer is exceeded, the device generates and reports a threshold-crossing alarm to a network management system (such as IMC).
If you configure both the global alarm threshold and the alarm threshold on an interface, the latter takes effect.
If you configure this command multiple times, the most recent configuration takes effect.
Examples
# Set the alarm threshold to 50% on Ten-GigabitEthernet1/0/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname–Ten-GigabitEthernet1/0/1] port buffer usage threshold headroom null-queue ratio 50
Related commands
buffer threshold alarm enable
buffer usage threshold headroom
port buffer usage threshold null-queue
Use port buffer usage threshold null-queue to set the per-interface alarm threshold for the ingress or egress buffer.
Use undo port buffer usage threshold null-queue to restore the default.
Syntax
port buffer { egress | ingress } usage threshold null-queue ratio ratio
undo port buffer { egress | ingress } usage threshold null-queue ratio
Default
The global alarm threshold for the ingress or egress buffer is used.
Views
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Parameters
egress: Specifies the egress buffer.
ingress: Specifies the ingress buffer.
ratio ratio: Specifies the alarm threshold in percentage, in the range of 1 to 100.
Usage guidelines
This command takes effect only when threshold-crossing alarms are enabled. When the global alarm threshold for the Headroom buffer is exceeded, the device generates and reports a threshold-crossing alarm to a network management system (such as IMC).
If you configure both the global alarm threshold and the alarm threshold on an interface, the latter takes effect.
If you configure this command multiple times, the most recent configuration takes effect.
Examples
# Set the alarm threshold to 50% on Ten-GigabitEthernet1/0/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] port buffer ingress usage threshold null-queue ratio 50
Related commands
buffer threshold alarm enable
buffer usage threshold null-queue
TCB commands
buffer transient-capture enable
Use buffer transient-capture enable to enable and configure TCB.
Use undo buffer transient-capture enable to disable TCB.
Syntax
System view:
buffer transient-capture global [ slot slot-number ] { egress | ingress } enable [ no-local-analysis ] [ acl { ipv4-acl-number | name ipv4-acl-name } ] [ start-threshold start-threshold-value stop-threshold stop-threshold-value ] [ frozen-number frozen-number frozen-timer timer-value ] [ pre-sample-rate pre-sample-rate post-sample-rate post-sample-rate ] [ poll-frequency frequency-value ]
undo buffer transient-capture global [ slot slot-number ] enable
Interface view:
buffer transient-capture { egress [ queue queue-id ] | ingress } enable [ no-local-analysis ] [ acl { ipv4-acl-number | name ipv4-acl-name } ] [ start-threshold start-threshold-value stop-threshold stop-threshold-value ] [ frozen-number frozen-number frozen-timer timer-value ] [ pre-sample-rate pre-sample-rate post-sample-rate post-sample-rate ] [ poll-frequency frequency-value ]
undo buffer transient-capture enable
Default
TCB is disabled.
Views
System view
Layer 2 Ethernet interface view
Layer 3 Ethernet interface view
Predefined user roles
network-admin
Parameters
global: Configures TCB globally. This keyword is supported only in system view.
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a member device, this command configures TCB for the master device.
egress: Specifies the egress buffer.
queue-id: Specifies a queue by its ID in the range of 0 to 7. If you do not specify a queue, this command enables TCB for all queues. This argument is supported only in interface view.
ingress: Specifies the ingress buffer.
no-local-analysis: Reports raw packet data and packet drop reason without performing local analysis. If you do not specify this parameter, local analysis is performed.
acl: Specifies an ACL. If you do not specify an ACL, this command enables TCB for all traffic.
· ipv4-acl-number: Specifies an advanced IPv4 ACL by its number in the range of 3000 to 3999.
· name ipv4-acl-name: Specifies an advanced IPv4 ACL by its name, a case-insensitive string of 1 to 63 characters. The ACL name must start with an English letter.
start-threshold start-threshold-value: Specifies the queue length in bytes above which packet capturing will be started. The value range for the start-threshold-value argument is 1 to 67108352. The default is 2500. The value for the start-threshold-value argument must be greater than the value for the stop-threshold-value argument.
stop-threshold stop-threshold-value: Specifies the queue length in bytes below which packet capturing will be stopped. The value range for the stop-threshold-value argument is 1 to 67108352. The default is 1500. The value for the stop-threshold-value argument must be greater than the value for the start-threshold-value argument.
frozen-number frozen-number: Specifies the number of packets to be captured before the TCB state machine moves to the frozen state. The value range for the frozen-number argument is 3 to 1024. The default is 256.
frozen-timer timer-value: Specifies the capture timer for moving the TCB state machine to the frozen state. The value range for the timer-value argument is 1 to 400. The default is 400.
pre-sample-rate pre-sample-rate: Specifies the number of packets captured in the pre-trigger state. The value range for the pre-sample-rate argument is 1 to 16. The default is 16. If the value range is 1 to 16, the specified number of packets are sampled out of 16 packets. If you specify 16, all packets are captured.
post-sample-rate post-sample-rate: Specifies the number of packets captured in the post-trigger state. The value range for the post-sample-rate argument is 1 to 16. The default is 16. If the value range is 1 to 16, the specified number of packets are sampled out of 16 packets. If you specify 16, all packets are captured.
poll-frequency frequency-value: Specifies the number of times that data is reported per minute. The value range for the frequency-value argument is 1 to 600. The default is 20.
Usage guidelines
The TCB feature monitors packet drop events on queues. When a packet is dropped on a queue, the system collects the drop time, drop reason, packet metadata, and other information and reports them to an NMS through gRPC.
You can configure TCB in system view or interface view, but not in both views at the same time. For example, if you have configured TCB in system view, to configure TCB in interface view, you must first delete the TCB configuration in system view.
The TCB configuration in system view takes effect on all TCB-capable interfaces. The TCB configuration in interface view takes effect only on the specified interface.
Only one interface on the device can be configured with TCB when you configure TCB in interface view.
Examples
# Configure TCB for slot 1.
<Sysname> system-view
[Sysname] buffer transient-capture global slot 1 egress enable no-local-analysis acl 3000 start-threshold 10000 stop-threshold 5000 frozen-number 1000 frozen-timer 400 pre-sample-rate 10 post-sample-rate 10 poll-frequency 30
# Configure TCB on Ten-GigabitEthernet 1/0/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] buffer transient-capture egress enable no-local-analysis acl 3000 start-threshold 10000 stop-threshold 5000 frozen-number 1000 frozen-timer 400 pre-sample-rate 10 post-sample-rate 10 poll-frequency 30
display buffer transient-capture packet-drop
Use display buffer transient-capture packet-drop to display packet drop information.
Syntax
display buffer transient-capture packet-drop slot slot-number { ethernet | ipv4 | ipv6 }
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
ethernet: Displays packet drop information for Ethernet frames.
ipv4: Displays packet drop information for IPv4 packets.
ipv6: Displays packet drop information for IPv6 packets.
slot slot-number: Specifies an IRF member device by its member ID (slot number).
Examples
# Display packet drop information for slot 1.
<Sysname> display buffer transient-capture packet-drop slot 1 ipv4
TCB STATUS: EgressPort XGE1/0/1
--------------------------------------------------------------------------------
No. Time SMAC DMAC VLAN SIP DIP SPort DPort Queue IfName Reason
--------------------------------------------------------------------------------
Total Drop Packets in Ring Buffer of XPE 0:2047
0 8a44900 0010-9400-0005 0010-9400-0002 100 192.168.1.2 192.168.0.1 0 0 0 XGE1/0/1 2
Total Drop Packets in Ring Buffer of XPE 1:2047
0 8a44800 0010-9400-0005 0010-9400-0002 100 192.168.1.2 192.168.0.1 0 0 0 XGE1/0/1 2
Total Drop Packets in Ring Buffer of XPE 2:2047
0 8a44800 0010-9400-0005 0010-9400-0002 100 192.168.1.2 192.168.0.1 0 0 0 XGE1/0/1 2
Total Drop Packets in Ring Buffer of XPE 3:2047
0 8a44800 0010-9400-0005 0010-9400-0002 100 192.168.1.2 192.168.0.1 0 0 0 XGE1/0/1 2
Table 5 Command output
|
Field |
Description |
|
TCB STATUS |
TCB status: · EgressPort XGE1/0/1—TCB is configured in the outbound direction of the interface. · Global—TCB is configured globally. |
|
Time |
Time when packets were dropped, in the form of UNIX timestamps (time since 00:00:00 01/01/1970). |
|
Reason |
Packet drop reason: · 1—Dropped when enqueued. · 2—Dropped when dequeued. · 3—Dropped by WRED. · 4—Dropped due to insufficient cell resources. |
|
Total packets dropped on XPE0 |
Total number of packets dropped on XPE0. XPE is a data buffer type. |
