目  录

1 数据缓冲区

1.1 数据缓冲区配置命令

1.1.1 buffer packet-drop alarm enable

1.1.2 buffer packet-drop alarm interval

1.1.3 buffer threshold alarm enable

1.1.4 buffer threshold alarm interval

1.1.5 buffer usage threshold

1.1.6 buffer usage threshold headroom

1.1.7 buffer usage threshold headroom queue

1.1.8 buffer usage threshold queue

1.1.9 buffer usage threshold queue (system view)

1.1.10 burst-mode enable

1.1.11 display buffer usage interface

1 数据缓冲区

1.1  数据缓冲区配置命令

数据缓冲区的配置比较复杂，而且对设备的转发功能有重要的影响，建议用户不要轻易修改数据缓冲区的参数。在需要较大的缓存空间时，建议使用Burst功能来自动分配缓冲区。

burst-mode enable与buffer apply命令互斥，用户在开启Burst功能后，不能应用手工配置数据缓冲区的相应配置，反之亦然。如果已经使用某一种方式进行了配置，则必须先取消该方式的配置之后，才能使用另外一种方式进行配置。

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

·     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表示出现丢包时立即发送告警信息。

【使用指导】

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

使用gRPC上送数据，且传输协议配置为gRPC时，建议将本命令中的interval配置为大于等于10的值。如果确实需要将interval配置为小于10的数值，可以使用gRPC的Dial-out模式上送数据，并且将传输协议配置为UDP。有关gRPC相关功能的详细介绍，请参见“Telemetry配置指导”中的“gRPC”。

【举例】

# 配置数据缓冲区丢包告警发送周期为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等网管软件，网管软件会生成相应的告警提示，方便查看设备数据缓冲区的使用情况。

Headroom缓冲区不支持配置其使用门限值，缺省门限值为100%。

【举例】

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

<Sysname> system-view

[Sysname] buffer threshold alarm ingress enable

【相关命令】

·     buffer usage threshold queue

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表示出现数据缓冲区超门限使用时立即发送告警信息。

【使用指导】

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

对于buffer threshold alarm egress interval interval，使用gRPC上送数据，且传输协议配置为gRPC时，建议将本命令中的interval配置为大于等于10的值。如果确实需要将interval配置为小于10的数值，可以使用gRPC的Dial-out模式上送数据，并且将传输协议配置为UDP。有关gRPC相关功能的详细介绍，请参见“Telemetry配置指导”中的“gRPC”。

【举例】

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

<Sysname> system-view

[Sysname] buffer threshold alarm ingress interval 20

【相关命令】

·     buffer threshold alarm enable

·     buffer usage threshold queue

1.1.5  buffer usage threshold

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

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

【命令】

buffer usage threshold slot slot-number ratio ratio

undo buffer usage threshold slot slot-number

【缺省情况】

设备上接口的数据缓冲区使用门限值为100。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

slot slot-number：指定接口板所在的槽位号。slot-number表示接口板所在的槽位号。

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

【使用指导】

只有将设备的报文统计模式配置为队列模式后（执行statistic mode queue命令），本命令的配置才能生效。关于报文统计模式的介绍，请参见“ACL和QoS命令参考”中的“QoS”。

配置接口的数据缓冲区使用门限后，设备会自动记录接口对缓冲区的使用情况。当接口上某一队列中需要处理的报文增多，造成该接口对数据缓冲区的使用比率超过设定的门限值时，系统会为该队列增加一次超量使用缓冲区的计数。

通过display buffer usage interface命令，可以查看接口的数据缓冲区使用统计信息。

【举例】

# 配置3号槽位接口板上所有接口的数据缓冲区使用门限值为50%。

<Sysname> system-view

[Sysname] buffer usage threshold slot 3 ratio 50

【相关命令】

·     display buffer usage interface

1.1.6  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-number ratio

【缺省情况】

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

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

slot slot-number：配置指定单板上所有接口每个队列的Headroom缓冲区使用门限值。slot-number表示单板所在的槽位号。

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.7  buffer usage threshold headroom queue

buffer usage threshold headroom queue命令用来配置接口Headroom缓冲区使用门限值。

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

【命令】

buffer usage threshold headroom queue queue-id ratio ratio

undo buffer usage threshold headroom queue queue-id ratio

【缺省情况】

接口Headroom缓冲区与全局Headroom缓冲区使用门限值相同。

【视图】

二层以太网接口视图

三层以太网接口视图

【缺省用户角色】

network-admin

【参数】

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

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

【使用指导】

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

【举例】

# 配置接口HundredGigE1/0/1队列1的Headroom缓冲区使用门限值为50%。

<Sysname> system-view

[Sysname] interface hundredgige 1/0/1

[Sysname–HundredGigE1/0/1] buffer usage threshold headroom queue 1 ratio 50

【相关命令】

·     buffer threshold alarm enable

1.1.8  buffer usage threshold queue

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

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

【命令】

buffer { egress | ingress } usage threshold queue queue-id ratio ratio

undo buffer { egress | ingress } usage threshold queue queue-id ratio

【缺省情况】

接口队列接收或发送数据缓冲区与全局队列接收或发送数据缓冲区使用门限值相同。

【视图】

二层以太网接口视图

三层以太网接口视图

【缺省用户角色】

network-admin

【参数】

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

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

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

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

【使用指导】

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

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

【举例】

# 配置接口HundredGigE1/0/1队列1的接收数据缓冲区使用门限值为50%。

<Sysname> system-view

[Sysname] interface hundredgige 1/0/1

[Sysname-HundredGigE1/0/1] buffer ingress usage threshold queue 1 ratio 50

【相关命令】

·     buffer threshold alarm enable

1.1.9  buffer usage threshold queue (system view)

buffer usage threshold queue命令用来配置全局队列接收或发送数据缓冲区使用门限值。

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

【命令】

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

【缺省情况】

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

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

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

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

slot slot-number：配置指定单板上指定队列的数据缓冲区使用门限值。slot-number表示单板所在的槽位号。

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

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

【使用指导】

本命令不支持在主控板上配置，即slot-number取值不能为0或者1。

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

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

【举例】

# 配置slot 1队列1的接收数据缓冲区使用门限值为50%。

<Sysname> system-view

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

【相关命令】

·     buffer threshold alarm enable

1.1.10  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

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：显示详细信息。如果不指定本参数，则显示简要信息。

【举例】

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

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

‌

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

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

‌