Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 04-Data buffer commands | 122.61 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
IRF physical interfaces do not support data buffer commands.
Data buffer commands
buffer apply
Use buffer apply to apply manually configured data buffer settings.
Use undo buffer apply to restore the default.
Syntax
buffer apply
undo buffer apply
Views
System view
Predefined user roles
network-admin
mdc-admin
Usage guidelines
For data buffer settings to take effect, you must execute this command after configuring data buffer settings.
After applying manually configured data buffer settings, you cannot directly modify the applied settings. To modify them, you must cancel the application, reconfigure data buffer settings, and reapply the new settings.
Only SF interface modules support this command.
Examples
# Apply manually configured data buffer settings.
<Sysname> system-view
[Sysname] buffer apply
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
mdc-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
mdc-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
mdc-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
mdc-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
In standalone mode:
buffer usage threshold headroom slot slot-number ratio ratio
undo buffer usage threshold headroom slot slot-number ratio
In IRF mode:
buffer usage threshold headroom chassis chassis-number slot slot-number ratio ratio
undo buffer usage threshold headroom chassis chassis-number 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
mdc-admin
Parameters
slot slot-number: Specifies a card by its slot number. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the ID of the IRF member device. The slot-number argument represents the slot number of the card. (In IRF mode.)
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
# (In standalone mode.) Set the global per-queue alarm threshold to 50% for slot 1.
<Sysname> system-view
[Sysname] buffer usage threshold headroom slot 1 ratio 50
# (In IRF mode.) Set the global per-queue alarm threshold to 50% for slot 2 in chassis 1.
<Sysname> system-view
[Sysname] buffer usage threshold headroom chassis 1 slot 2 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
In standalone mode:
buffer { egress | ingress } usage threshold slot slot-number null-queue ratio ratio
undo buffer { egress | ingress } usage threshold slot slot-number null-queue ratio
In IRF mode:
buffer { egress | ingress } usage threshold chassis chassis-number slot slot-number null-queue ratio ratio
undo buffer { egress | ingress } usage threshold chassis chassis-number 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
mdc-admin
Parameters
egress: Specifies the egress buffer.
ingress: Specifies the ingress buffer.
slot slot-number: Specifies a card by its slot number. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the ID of the IRF member device. The slot-number argument represents the slot number of the card. (In IRF mode.)
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
# (In standalone mode.) 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
# (In IRF mode.) Set the global per-interface alarm threshold to 50% in slot 2.
<Sysname> system-view
[Sysname] buffer ingress usage threshold chassis 1 slot 2 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
mdc-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 3/0/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/0/1
[Sysname–Ten-GigabitEthernet3/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
In standalone mode:
burst-mode enable slot slot-number
undo burst-mode enable slot slot-number
In IRF mode:
burst-mode enable chassis chassis-number slot slot-number
undo burst-mode enable chassis chassis-number slot slot-number
Default
The Burst feature is disabled.
Views
System view
Predefined user roles
network-admin
mdc-admin
Parameters
slot slot-number: Specifies a card by its slot number. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. (In IRF mode.)
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 for slot 1.
<Sysname> system-view
[Sysname] burst-mode enable slot 1
# (In IRF mode.) Enable the Burst feature for slot 1 in chassis 1.
<Sysname> system-view
[Sysname] burst-mode enable chassis 1 slot 1
display buffer
Use display buffer to display buffer size settings.
Syntax
In standalone mode:
display buffer [ slot slot-number ] [ queue [ queue-id ] ]
In IRF mode:
display buffer [ chassis chassis-number slot slot-number ] [ queue [ queue-id ] ]
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-operator
Parameters
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command displays buffer size settings for all cards. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify this option, the command displays buffer size settings for all cards of the IRF fabric. (In IRF mode.)
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
# (In standalone mode.) Display buffer size settings.
<Sysname> display buffer
Slot Type Eg(Total-shared , Shared)
1 packet 95 , 100
1 cell 55 , 33
Eg: Size of the sending buffer
Total-shared: Size of the shared buffer for all ports
Shared: Size of the maximum shared buffer per port
Unit: Ratio
# (In standalone mode.) Display the fixed-area ratio and shared-area ratio for the queues.
<Sysname> display buffer queue
Slot Queue Type Eg(Guaranteed , Shared)
1 0-7 packet 11 , 60
1 0-7 cell 12 , 100
Eg: Size of the sending buffer
Guaranteed: Size of the minimum guaranteed buffer per queue
Shared: Size of the maximum shared buffer per queue
Unit: Ratio
# (In IRF mode.) Display buffer size settings for slot 2 in chassis 1.
<Sysname> display buffer chassis 1 slot 2
Slot Type In(Total-shared , Shared) Eg(Total-shared , Shared)
1/2 packet 24 , 2 36 , 2
1/2 cell 50 , 25 -- , --
In: Size of the receiving buffer
Eg: Size of the sending buffer
Total-shared: Size of the shared buffer for all ports
Shared: Size of the maximum shared buffer per port
Unit: Ratio
# (In IRF mode.) Display the fixed-area ratio and shared-area ratio for the queues for slot 2 in chassis 1.
<Sysname> display buffer chassis 1 slot 2 queue
Slot Queue Type In(Guaranteed , Shared) Eg(Guaranteed , Shared)
1/2 0-7 packet 256 , 128 256 , 128
1/2 0-1,3-4,6-7 cell 256 , 128 256 , 128
1/2 2,5 cell 512 , 128 -- , --
In: Size of the receiving buffer
Eg: Size of the sending buffer
Guaranteed: Size of the minimum guaranteed buffer per queue
Shared: Size of the maximum shared buffer per queue
Unit: Byte
Table 1 Command output
|
Field |
Description |
|
Type |
Resource type: packet or cell. |
|
Queue |
Queue ID in the range of 0 to 7. |
|
Eg |
Egress buffer. |
|
(Total-shared , Shared) |
Total-shared indicates the total shared-area ratio. If the device does not support a resource type, this field displays two hyphens (--). Shared indicates the shared-area ratio of a port. 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 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
mdc-admin
mdc-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 3/0/1.
<Sysname> display buffer usage interface ten-gigabitethernet 3/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 2 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 3/0/1.
[Sysname] display buffer usage interface ten-gigabitethernet 3/0/1 verbose
XGE3/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 3 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 |
This field is not supported in the current software version. 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 |
This field is not supported in the current software version. 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 |
This field is not supported in the current software version. 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
mdc-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-GigabitEthernet3/0/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/0/1
[Sysname–Ten-GigabitEthernet3/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
mdc-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-GigabitEthernet3/0/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/0/1
[Sysname-Ten-GigabitEthernet3/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:
In standalone mode:
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
In IRF mode:
buffer transient-capture global [ chassis chassis-number 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 [ chassis chassis-number 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
mdc-admin
Parameters
global: Configures TCB globally. This keyword is supported only in system view.
slot slot-number: Specifies a card by its slot number. If you do not specify a card, this command configures TCB for the active MPU. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the member ID of the IRF member device. The slot-number argument represents the slot number of the card. If you do not specify this option, the command configures TCB for the global active MPU. (In IRF mode.)
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 one chip can be configured with TCB when you configure TCB in interface view.
Examples
# (In standalone mode.) 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 500 pre-sample-rate 10 post-sample-rate 10 poll-frequency 30
# Configure TCB on Ten-GigabitEthernet 3/0/1.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 3/0/1
[Sysname-Ten-GigabitEthernet3/0/1] buffer transient-capture egress enable no-local-analysis acl 3000 start-threshold 10000 stop-threshold 5000 frozen-number 1000 frozen-timer 500 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
In standalone mode:
display buffer transient-capture packet-drop slot slot-number { ethernet | ipv4 | ipv6 }
In IRF mode:
display buffer transient-capture packet-drop chassis chassis-number slot slot-number { ethernet | ipv4 | ipv6 }
Views
Any view
Predefined user roles
network-admin
network-operator
mdc-admin
mdc-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 a card by its slot number. (In standalone mode.)
chassis chassis-number slot slot-number: Specifies a card on an IRF member device. The chassis-number argument represents the ID of the IRF member device. The slot-number argument represents the slot number of the card. (In IRF mode.)
Examples
# (In IRF mode.) Display packet drop information for slot 1 in chassis 1.
<Sysname> display buffer transient-capture packet-drop chassis 1 slot 1 ipv4
TCB STATUS: EgressPort XGE3/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 XGE3/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 XGE3/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 XGE3/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 XGE3/0/1 2
Table 4 Command output
|
Field |
Description |
|
TCB STATUS |
TCB status: · EgressPort XGE3/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. |
