08-ACL和QoS命令参考

03-数据缓冲区命令

1 数据缓冲区

1.1 数据缓冲区配置命令

1.1.1 buffer packet-drop alarm enable

buffer packet-drop alarm enable命令用来开启数据缓冲区丢包告警功能。

undo buffer packet-drop alarm enable命令用来关闭数据缓冲区丢包告警功能。

【命令】

buffer packet-drop alarm enable

undo buffer packet-drop alarm enable

【缺省情况】

数据缓冲区丢包告警功能处于关闭状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

开启数据缓冲区丢包告警功能后，设备会生成数据缓冲区丢包告警信息，并将告警信息周期性的发送给iMC等网管软件，网管软件会生成相应的告警提示，方便查看设备数据缓冲区的使用情况。

本功能对Headroom数据缓冲区不起作用。

【举例】

# 开启数据缓冲区丢包告警功能。

<Sysname> system-view

[Sysname] buffer packet-drop alarm enable

【相关命令】

· buffer usage threshold queue (interface view)

· buffer packet-drop alarm interval

1.1.2 buffer packet-drop alarm interval

buffer packet-drop alarm interval命令用来配置数据缓冲区丢包告警发送周期。

undo buffer packet-drop alarm interval命令用来恢复缺省情况。

【命令】

buffer packet-drop alarm interval interval

undo buffer packet-drop alarm interval

【缺省情况】

数据缓冲区丢包告警发送周期为5秒。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

interval：数据缓冲区丢包告警发送周期，取值范围为0～60，单位为秒，0表示出现丢包时立即发送告警信息。

【使用指导】

必须开启数据缓冲区丢包告警功能，否则，数据缓冲区丢包告警发送周期的配置不会生效。

【举例】

# 配置数据缓冲区丢包告警发送周期为20秒。

<Sysname> system-view

[Sysname] buffer packet-drop alarm interval 20

【相关命令】

· buffer packet-drop alarm enable

1.1.3 buffer threshold alarm enable

buffer threshold alarm enable命令用来开启数据缓冲区超门限告警功能。

undo buffer threshold alarm enable命令用来关闭数据缓冲区超门限告警功能。

【命令】

buffer threshold alarm { egress | headroom | ingress } enable

undo buffer threshold alarm { egress | headroom | ingress } enable

【缺省情况】

数据缓冲区超门限告警功能处于关闭状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

egress：表示对发送数据缓冲区进行配置。

headroom：表示对Headroom数据缓冲区进行配置。

ingress：表示对接收数据缓冲区进行配置。

【使用指导】

开启数据缓冲区超门限告警功能后，设备会生成数据缓冲区超门限告警信息，并将告警信息周期性的发送给iMC等网管软件，网管软件会生成相应的告警提示，方便查看设备数据缓冲区的使用情况。

【举例】

# 开启接收数据缓冲区超门限告警功能。

<Sysname> system-view

[Sysname] buffer threshold alarm ingress enable

【相关命令】

· buffer usage threshold headroom

· buffer usage threshold queue (interface view)

1.1.4 buffer threshold alarm interval

buffer threshold alarm interval命令用来配置数据缓冲区超门限告警发送周期。

undo buffer threshold alarm interval命令用来恢复缺省情况。

【命令】

buffer threshold alarm { egress | headroom | ingress } interval interval

undo buffer threshold alarm { egress | headroom | ingress } interval

【缺省情况】

数据缓冲区超门限告警发送周期为5秒。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

egress：表示对发送数据缓冲区进行配置。

headroom：表示对Headroom数据缓冲区进行配置。

ingress：表示对接收数据缓冲区进行配置。

interval：数据缓冲区超门限告警发送周期，取值范围为0～60，单位为秒。0表示出现数据缓冲区超门限使用时立即发送告警信息。

【使用指导】

必须开启数据缓冲区超门限告警功能，否则，数据缓冲区超门限告警发送周期的配置不会生效。

【举例】

# 配置接收数据缓冲区超门限告警发送周期为20秒。

<Sysname> system-view

[Sysname] buffer threshold alarm ingress interval 20

【相关命令】

· buffer threshold alarm enable

· buffer usage threshold headroom

· buffer usage threshold queue (interface view)

1.1.5 buffer usage threshold headroom

buffer usage threshold headroom命令用来配置全局Headroom缓冲区使用门限值。

undo buffer usage threshold headroom命令用来恢复缺省情况。

【命令】

buffer usage threshold headroom slot slot-number ratio ratio

undo buffer usage threshold headroom slot slot-number ratio

【缺省情况】

全局所有接口下每个队列的Headroom缓冲区使用门限值均为100%。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

slot slot-number：配置指定成员设备上所有接口每个队列的Headroom缓冲区使用门限值。slot-number表示设备在IRF中的成员编号。

ratio ratio：以百分比形式配置设备Headroom缓冲区使用门限值，ratio的取值范围为1～100。

【使用指导】

仅开启数据缓冲区超门限告警功能后，Headroom缓冲区使用门限值的配置才会生效。超门限使用Headroom缓冲区时，设备会生成告警信息，并将告警信息发送给iMC等网管软件，网管软件会生成相应的告警提示，方便查看设备Headroom缓冲区的使用情况。

【举例】

# 配置slot 1上所有接口下每个队列的Headroom缓冲区使用门限值为50%。

<Sysname> system-view

[Sysname] buffer usage threshold headroom slot 1 ratio 50

【相关命令】

· buffer threshold alarm enable

1.1.6 buffer usage threshold null-queue

buffer usage threshold null-queue命令用来配置全局所有接口的接收或发送数据缓冲区使用门限值。

undo buffer usage threshold null-queue命令用来恢复缺省情况。

【命令】

buffer { egress | ingress } usage threshold slot slot-number null-queue ratio ratio

undo buffer { egress | ingress } usage threshold slot slot-number null-queue ratio

【缺省情况】

全局所有接口的接收或发送数据缓冲区使用门限值均为100%。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

egress：表示对发送数据缓冲区进行配置。

ingress：表示对接收数据缓冲区进行配置。

slot slot-number：配置指定成员设备上所有接口的数据缓冲区使用门限值。slot-number表示设备在IRF中的成员编号。

ratio ratio：以百分比形式配置设备队列的数据缓冲区使用门限值，ratio的取值范围为1～100。

【使用指导】

本命令配置的数据缓冲区不包括Headroom缓冲区。

仅开启数据缓冲区超门限告警功能后，全局队列接收或发送数据缓冲区使用门限值的配置才会生效。超门限使用数据缓冲区时，设备会生成告警信息，并将告警信息发送给iMC等网管软件，网管软件会生成相应的告警提示，方便查看设备数据缓冲区的使用情况。

同时配置本命令和接口缓冲区使用门限值时，接口下配置的门限值优先生效。多次执行本命令，最后一次生效。

【举例】

# 配置slot 1所有接口接收数据缓冲区使用门限值为50%。

<Sysname> system-view

[Sysname] buffer ingress usage threshold slot 1 interface ratio 50

【相关命令】

· buffer threshold alarm enable

· port buffer usage threshold null-queue

1.1.7 buffer usage threshold queue (interface view)

buffer usage threshold queue命令用来配置接口队列数据缓冲区使用门限值。

undo buffer usage threshold queue命令用来恢复缺省情况。

【命令】

buffer egress usage threshold queue queue-id ratio ratio

undo buffer egress usage threshold queue queue-id ratio

【缺省情况】

接口队列发送数据缓冲区使用门限值均为100%。

【视图】

接口视图

【缺省用户角色】

network-admin

【参数】

egress：表示对发送数据缓冲区进行配置。

queue-id：配置接口指定队列的数据缓冲区使用门限值，queue-id的取值范围为0～7。

ratio ratio：以百分比形式配置指定接口队列的数据缓冲区使用门限值，ratio的取值范围为1～100。

【使用指导】

本命令配置的数据缓冲区不包括Headroom缓冲区。

仅开启数据缓冲区超门限告警功能后，接口队列发送数据缓冲区使用门限值的配置才会生效。超门限使用数据缓冲区时，设备会生成告警信息，并将告警信息发送给iMC等网管软件，网管软件会生成相应的告警提示，方便查看设备发送数据缓冲区的使用情况。

【举例】

# 配置接口Ten-GigabitEthernet1/0/1队列1的发送数据缓冲区使用门限值为50%。

<Sysname> system-view

[Sysname] interface ten-gigabitethernet 1/0/1

[Sysname-Ten-GigabitEthernet1/0/1] buffer egress usage threshold queue 1 ratio 50

【相关命令】

· buffer threshold alarm enable

1.1.8 burst-mode enable

burst-mode enable命令用来开启数据缓冲区自动分配功能。

undo burst-mode enable命令用来关闭数据缓冲区自动分配功能。

【命令】

burst-mode enable

undo burst-mode enable

【缺省情况】

数据缓冲区自动分配功能处于关闭状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

在下列情况下，开启数据缓冲区自动分配功能可以提高报文缓存功能和降低报文丢包率：

· 广播或者组播报文流量密集，瞬间突发大流量的网络环境中；

· 报文从高速链路进入设备，由低速链路转发出去；或者报文从相同速率的多个接口同时进入设备，由一个相同速率的接口转发出去。

【举例】

# 开启数据缓冲区自动分配功能。

<Sysname> system-view

[Sysname] burst-mode enable

字段	描述
Type	缓冲区类型
Queue	队列ID，范围为0～7
Eg	Egress，出方向的数据缓冲区配置
(Total-shared )	Total-shared表示所有端口共享区域的大小。如果显示为“--”字符串，则表示设备不支持该缓冲区
(Guaranteed , Shared)	Guaranteed表示每个队列最多可使用的固定区域的大小。如果显示为“--”字符串，则表示设备不支持该数据缓冲区 Shared表示每个队列最多可使用的共享区域的大小。如果显示为“--”字符串，则表示设备不支持该数据缓冲区
Unit	数据缓冲区的单位，为%

字段	描述
Egress total-shared cell buffer usage on slot	表示在指定成员设备上cell缓冲区共享区域的使用率
Unit	芯片编号
XPE	设备支持的缓冲区类型 ‌
Block1	端口所在区域，本设备前面板上的端口所在区域固定为1 ‌
Total	缓冲区容量
Used	已使用的缓冲区容量
Free	可用缓冲区容量
5sec	过去5秒内该端口使用的缓冲区百分比例
1min	过去1分钟内该端口使用的缓冲区百分比例
5min	过去5分钟内该端口使用的缓冲区百分比例

1.1.11 display buffer usage interface

display buffer usage interface命令用来显示接口的数据缓冲区使用统计信息。

【命令】

display buffer usage interface [ interface-type [ interface-number ] ] [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

interface-type interface-number：指定接口，interface-type为接口类型，interface-number为接口编号。未指定interface-type参数时，显示设备上所有以太网接口的数据缓冲区使用统计信息；已指定interface-type但未指定interface-number时，显示设备上所有指定类型的以太网接口的数据缓冲区使用统计信息。

verbose：显示详细信息。如果不指定本参数，则显示简要信息。

【举例】

# 显示接口Ten-GigabitEthernet1/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

表1-3 display buffer usage interface命令显示信息描述表

字段	描述
Interface	接口名称
QueueID	队列编号
Total	队列可用的数据缓冲区大小，单位为Byte
Used	队列已使用的数据缓冲区大小，单位为Byte
Threshold(%)	队列的数据缓冲区使用门限值，该值与队列所在接口的缓冲区使用门限值保持一致
Violations	队列超量使用缓冲区的计数，表示队列使用缓冲区超过设定门限值的次数该字段仅在设备重启时，才会清零后重新计数

‌

# 显示接口Ten-GigabitEthernet1/0/1的数据缓冲区详细使用统计信息。

<Sysname> display buffer usage interface ten-gigabitethernet 1/0/1 verbose

XGE1/0/1

Ingress:

QueueID: 0

Total: 70000 Used: 0 Threshold(%): --

Violations: -- Shared: 70000 Headroom: 0

XoffThres: 70000 IsDynamic: 0