Login
- Table of Contents
- Related Documents
-
| Title | Size | Download |
|---|---|---|
| 04-Data buffer commands | 82.59 KB |
buffer packet-drop alarm enable
buffer packet-drop alarm interval
buffer threshold alarm interval
buffer usage threshold headroom
buffer usage threshold headroom queue
buffer usage threshold queue (interface view)
buffer usage threshold queue (system view)
display buffer usage interface
Data buffer commands
Inappropriate data buffer changes can cause system problems. Before manually changing data buffer settings, make sure you understand its impact on your device. As a best practice, use the burst-mode enable command if the system requires large buffer spaces. The burst-mode enable command and the buffer apply command are mutually exclusive. If you have configured the data buffer by using one command, you must execute the undo form of the command before using the other command.
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
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.
If you use gRPC and the gRPC transport protocol to send data to collectors, set the interval for sending packet-drop alarms to be greater than or equal to 10 seconds as a best practice. If you set the interval to be smaller than 10 seconds, you can use gRPC and the UDP transport protocol to send data to collectors. For more information about gRPC, see Telemetry Configuration Guide.
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.
The alarm threshold for the Headroom buffer is fixed at 100% and is not configurable.
Examples
# Enable threshold-crossing alarms.
<Sysname> system-view
[Sysname] buffer threshold alarm ingress enable
Related commands
buffer usage threshold queue
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.
If you use gRPC and the gRPC transport protocol to send data to collectors, set the interval for sending threshold-crossing alarms to be greater than or equal to 10 seconds as a best practice. If you set the interval to be smaller than 10 seconds, you can use gRPC and the UDP transport protocol to send data to collectors. For more information about gRPC, see Telemetry Configuration Guide.
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 queue
buffer usage threshold
Use buffer usage threshold to set a per-interface buffer usage threshold.
Use undo buffer usage threshold to restore the default.
Syntax
buffer usage threshold slot slot-number ratio ratio
undo buffer usage threshold slot slot-number
Default
The per-interface buffer usage threshold is 100%.
Views
System view
Predefined user roles
network-admin
Parameters
slot slot-number: Specifies a card by its slot number.
ratio ratio: Specifies the buffer usage threshold in percentage, in the range of 1 to 100.
Usage guidelines
This command takes effect only when the packet statistics collection mode is queue (configured by using the statistic mode queue command).
After you configure this command, the switch automatically records buffer usage for each interface. When a queue on an interface uses more buffer space than the set threshold, the system counts one threshold violation for the queue.
To display the buffer usage statistics for interfaces, use the display buffer usage interface command.
Examples
# Set the per-interface buffer usage threshold to 50% for card 3.
<Sysname> system-view
[Sysname] buffer usage threshold slot 3 ratio 50
Related commands
display buffer usage interface
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-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 a card by its 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).
This command takes effect only on interface cards.
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 headroom queue
Use buffer usage threshold headroom queue to set the Headroom buffer alarm threshold for a queue on an interface.
Use undo buffer usage threshold headroom queue to restore the default.
Syntax
buffer usage threshold headroom queue queue-id ratio ratio
undo buffer usage threshold headroom queue queue-id ratio
Default
The global per-queue 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
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, the device generates and reports a threshold-crossing alarm to a network management system (such as IMC).
Examples
# Set the Headroom buffer alarm threshold to 50% for queue 1 on HundredGigE 1/0/1.
<Sysname> system-view
[Sysname] interface hundredgige 1/0/1
[Sysname–HundredGigE1/0/1] buffer usage threshold headroom queue 1 ratio 50
Related commands
buffer threshold alarm enable
buffer usage threshold queue (interface view)
Use buffer usage threshold queue to set the ingress or egress buffer alarm threshold for a queue on an interface.
Use undo buffer usage threshold queue to restore the default.
Syntax
buffer { egress | ingress } usage threshold queue queue-id ratio ratio
undo buffer { egress | ingress } usage threshold queue queue-id ratio
Default
The global per-queue 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
ingress: Specifies the ingress buffer.
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 ingress or egress buffer, the device generates and reports a threshold-crossing alarm to a network management system (such as IMC).
Examples
# Set the ingress buffer alarm threshold to 50% for queue 1 on HundredGigE 1/0/1.
<Sysname> system-view
[Sysname] interface hundredgige 1/0/1
[Sysname–HundredGigE1/0/1] buffer ingress usage threshold queue 1 ratio 50
Related commands
buffer threshold alarm enable
buffer usage threshold queue (system view)
Use buffer usage threshold queue to set the global ingress or egress buffer alarm threshold for a queue.
Use undo buffer usage threshold queue to restore the default.
Syntax
buffer { egress | ingress } usage threshold slot slot-number queue queue-id ratio ratio
undo buffer { egress | ingress } usage threshold slot slot-number queue queue-id ratio
Default
The global ingress or egress buffer alarm threshold for a queue is 100%.
Views
System view
Predefined user roles
network-admin
Parameters
ingress: Specifies the ingress buffer.
egress: Specifies the egress buffer.
slot slot-number: Specifies a card by its slot number.
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 cannot executed for an MPU.
This command takes effect only when threshold-crossing alarms are enabled. When a queue exceeds the global ingress or egress alarm threshold, the device generates and reports a threshold-crossing alarm to a network management system (such as IMC).
Examples
# Set the global ingress alarm threshold to 50% for queue 1 in slot 1.
<Sysname> system-view
[Sysname] buffer ingress usage threshold slot 1 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 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 buffer usage statistics for HundredGigE 1/0/1.
<Sysname> display buffer usage interface hundredgige 1/0/1
Interface QueueID Total Used Threshold(%) Violations
--------------------------------------------------------------------------------
HGE1/0/1 0 838860800 0 100 0
1 838860800 0 100 0
2 838860800 0 100 0
3 838860800 0 100 0
4 838860800 0 100 0
5 838860800 0 100 0
6 838860800 0 100 0
7 838860800 0 100 0
Table 1 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 HundredGigE 1/0/1.
[Sysname] display buffer usage interface hundredgige 1/0/1 verbose
HundredGigE1/0/1
Ingress:
QueueID: 0
Total: -- Used: -- Threshold(%): --
Violations: -- Shared: 0 Headroom: 0
XoffThres: 0 IsDynamic: 0
Used(%): 0 Free: 268435456 UsedPeak: 0
HeadroomUsed(%): 0 HeadroomFree: 100000 HeadroomPeak: 0
…
QueueID: 7
Total: -- Used: -- Threshold(%): --
Violations: -- Shared: 0 Headroom: 0
XoffThres: 0 IsDynamic: 0
Used(%): 0 Free: 268435456 UsedPeak: 0
HeadroomUsed(%): 0 HeadroomFree: 100000 HeadroomPeak: 0
Egress:
QueueID: 0
Total: 268435456 Used: 0 Threshold(%): 100
Violations: 0 TailDropThres: 268435456 IsDynamic: 1
DeadlockCount: -- DeadlockRecover: --
Used(%): 0 Free: 268435456 UsedPeak: 0
…
QueueID: 7
Total: 268435456 Used: 0 Threshold(%): 100
Violations: 0 TailDropThres: 268435456 IsDynamic: 1
DeadlockCount: -- DeadlockRecover: --
Used(%): 0 Free: 268435456 UsedPeak: 0
Table 2 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 the number of cell resources. |
|
Used |
Data buffer size that has been used by a queue, in the number of cell resources. |
|
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. |
|
Xoff threshold |
This field is not supported in the current software version. 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. |
|
TailDropThreshold |
Tail drop threshold. |
|
IsDynamic |
This field is not supported in the current software version. 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 back pressure threshold. |
|
Used(%) |
Buffer usage in percentage. |
|
Free |
Free buffer in the number of cell resources. |
|
UsedPeak |
Peak used buffer in the number of cell resources. |
|
HeadroomUsed(%) |
Headroom area usage in percentage for the ingress buffer. |
|
HeadroomFree |
Free Headroom area in the number of cell resources for the ingress buffer. |
|
HeadroomPeak |
Peak used Headroom area in the number of cell resources. |
|
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. |
