目  录

1 数据缓冲区

1.1 数据缓冲区配置命令

1.1.1 buffer packet-drop alarm enable

1.1.2 buffer packet-drop alarm interval

1.1.3 burst-mode enable

1.1.4 display buffer usage

1.1.5 display buffer usage interface

1.2 TCB

1.2.1 buffer transient-capture enable

1.2.2 display buffer transient-capture packet-drop

 

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 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  burst-mode enable

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

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

【命令】

burst-mode enable slot slot-number

undo burst-mode enable slot slot-number

【缺省情况】

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

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

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

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

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

【举例】

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

<Sysname> system-view

[Sysname] burst-mode enable slot 1

1.1.4  display buffer usage

display buffer usage命令用来显示数据缓冲区的使用率。

【命令】

display buffer usage [ slot slot-number ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

slot slot-number：表示设备在IRF中的成员编号。不指定该参数时，表示所有成员设备。

【举例】

# 显示数据缓冲区的使用率。

<Sysname> display buffer usage

Total cell resource usage on slot 1 :

Total:    2826 KB

Used :       0 KB

Free :    2826 KB

                         5sec    1min    5min

------------------------------------------------------------------

 GE1/0/1                   0%      0%      0%

 GE1/0/2                   0%      0%      0%

 GE1/0/3                   0%      0%      0%

 GE1/0/4                   0%      0%      0%

 GE1/0/5                   0%      0%      0%

 GE1/0/6                   0%      0%      0%

 GE1/0/7                   0%      0%      0%

 GE1/0/8                   0%      0%      0%

 GE1/0/9                   0%      0%      0%

 GE1/0/10                  0%      0%      0%

 GE1/0/11                  0%      0%      0%

 GE1/0/12                  0%      0%      0%

 GE1/0/13                  0%      0%      0%

 GE1/0/14                  0%      0%      0%

 GE1/0/15                  0%      0%      0%

 GE1/0/16                  0%      0%      0%

 GE1/0/17                  0%      0%      0%

 GE1/0/18                  0%      0%      0%

 GE1/0/19                  0%      0%      0%

 GE1/0/20                  0%      0%      0%

 GE1/0/21                  0%      0%      0%

 GE1/0/22                  0%      0%      0%

 GE1/0/23                  0%      0%      0%

 GE1/0/24                  0%      0%      0%

 XGE1/0/25                 0%      0%      0%

 XGE1/0/26                 0%      0%      0%

 XGE1/0/27                 0%      0%      0%

 XGE1/0/28                 0%      0%      0%

 XGE1/0/29                 0%      0%      0%

 XGE1/0/30                 0%      0%      0%

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

字段	描述
Total	缓冲区容量
Used	已使用的缓冲区容量
Free	可用缓冲区容量
5sec	过去5秒内该端口使用的缓冲区百分比例
1min	过去1分钟内该端口使用的缓冲区百分比例
5min	过去5分钟内该端口使用的缓冲区百分比例

‌

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

【举例】

# 显示接口GigabitEthernet1/0/1的数据缓冲区简要使用统计信息。

<Sysname> display buffer usage interface gigabitethernet 1/0/1

Interface    QueueID Total                Used            Threshold(%)     Violations

--------------------------------------------------------------------------------

GE1/0/1      0       40 cell 800 bytes    1 cell 20 bytes  30              0

             1       40 cell 800 bytes    1 cell 20 bytes  30              0

             2       40 cell 800 bytes    1 cell 20 bytes  30              0

             3       40 cell 800 bytes    1 cell 20 bytes  30              0

             4       40 cell 800 bytes    1 cell 20 bytes  30              0

             5       40 cell 800 bytes    1 cell 20 bytes  30              0

             6       40 cell 800 bytes    1 cell 20 bytes  30              0

             7       40 cell 800 bytes    1 cell 20 bytes  30              0

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

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

‌

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

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

GE1/0/1

  Ingress:

    QueueID: 0

      Total: 36 cell 55000 bytes                 Used: 0 cell 0 bytes

      Threshold(%): 3                            Violations: 4

      Shared: 1 cell 5 bytes                     Headroom: 6 cell 30 bytes

      Xoff threshold: 36 cell 55000 bytes        Is dynamic: 0

      Used(%): 0                                 Free: 36 cell 55000 bytes

      UsedPeak: 0 cell 0 bytes                   HeadroomUsed(%): 0

      HeadroomFree: 0 cell 0 bytes               HeadroomPeak: 0 cell 0 bytes

      UsedPeakTime: 2022-04-19 20:20:43          HeadroomPeakTime: 2022-04-19 20:20:43

…省略

    QueueID: 7

      Total: 36 cell 55000 bytes                 Used: 0 cell 0 bytes

      Threshold(%): 3                            Violations: 4

      Shared: 1 cell 5 bytes                     Headroom: 6 cell 30 bytes

      Xoff threshold: 36 cell 55000 bytes        Is dynamic: 0

      Used(%): 0                                 Free: 36 cell 55000 bytes

      UsedPeak: 0 cell 0 bytes                   HeadroomUsed(%): 0

      HeadroomFree: 0 cell 0 bytes               HeadroomPeak: 0 cell 0 bytes

      UsedPeakTime: 2022-04-19 21:20:43          HeadroomPeakTime: 2022-04-19 21:20:43

  Egress:

    QueueID: 0

      Total: 36 cell 55000 bytes                 Used: 0 cell 0 bytes

      Threshold(%): 22                           Violations: 12

      TailDropThreshold: 1 cell 13 bytes         Is dynamic: 0

      DeadlockCount: 0                           DeadlockRecover: 0

      Used(%): 0                                 Free: 36 cell 55000 bytes

      UsedPeak: 0 cell 0 bytes                   UsedPeakTime: -

…省略

    QueueID: 7

      Total: 36 cell 55000 bytes                 Used: 0 cell 0 bytes

      Threshold(%): 22                           Violations: 12

      TailDropThreshold: 1 cell 13 bytes         Is dynamic: 0

      DeadlockCount: 0                           DeadlockRecover: 0

      Used(%): 0                                 Free: 36 cell 55000 bytes

      UsedPeak: 0 cell 0 bytes                   UsedPeakTime: -

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

字段	描述
Ingress	接收数据缓冲区的统计数据
Egress	发送数据缓冲区的统计数据
QueueID	显示指定队列对数据缓冲区的使用统计信息
Total	队列可用的数据缓冲区大小，单位为字节
Used	队列已使用的数据缓冲区大小，单位为字节
Threshold(%)	队列的数据缓冲区使用门限值，该值与队列所在接口的缓冲区使用门限值保持一致
Violations	队列超量使用缓冲区的计数，表示队列使用缓冲区超过设定门限值的次数 该字段在设备重启时，会清零重新计数
Shared	队列已使用共享数据缓冲区的cell资源个数
Xoffthres	反压帧触发门限值： ·     当用户配置为动态时显示的数值为具体配置的百分比 ·     当用户配置为静态门限时显示的数值为具体配置的cell资源个数 配置命令的详细介绍请参见“二层技术-以太网交换命令参考”中的“PFC命令”
TailDropThres	尾丢弃门限值，该值由buffer queue shared命令配置的占用比计算得到，命令的详细介绍请参见“ACL和QoS命令参考”中的“数据缓冲区”
Is dynamic	对于入方向，该字段取值如下： ·     0：表示反压帧触发门限为静态 ·     1：表示反压帧触发门限为动态 对于出方向，该字段取值为1，表示尾丢弃门限为动态
Used(%)	队列已使用的数据缓冲区大小，单位为%
Free	队列剩余可使用的数据缓冲区大小，单位为字节
UsedPeak	队列曾使用的数据缓冲区峰值大小，单位为字节
UsedPeakTime	队列曾使用的数据缓冲区峰值出现的时间，未使用数据缓冲区时显示为-
DeadlockCount	PFC死锁次数
DeadlockRecover	PFC死锁恢复次数

‌

1.2  TCB

1.2.1  buffer transient-capture enable

buffer transient-capture enable命令用来开启并配置TCB功能。

undo buffer transient-capture enable命令用来关闭TCB功能。

【命令】

系统视图：

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

接口视图：

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

【缺省情况】

TCB功能处于关闭状态。

【视图】

系统视图

二层以太网接口视图

三层以太网接口视图

【缺省用户角色】

network-admin

【参数】

global：表示开启并配置全局TCB功能。仅系统视图下支持指定本参数。

slot slot-number：指定成员设备。slot-number为设备在IRF中的成员编号。如果不指定本参数，则表示指定Master设备。

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

queue-id：表示队列编号，取值范围为0～7。仅接口视图下支持指定本参数。如果未指定本参数，表示开启并配置本接口下发送缓冲区中所有队列的TCB功能。

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

no-local-analysis：表示不对抓包数据进行本地分析，直接上报原始数据和丢包原因。缺省情况下，会对抓包数据进行本地分析，然后上报。

acl：表示TCB功能引用IPv4高级ACL，仅对命中规则的流量开启TCB功能。如果未指定本参数，表示不引用ACL，即对所有流量开启TCB功能。

·     ipv4-acl-number：通过编号引用IPv4高级ACL，取值范围为3000～3999。

·     name ipv4-acl-name：通过名称引用IPv4高级ACL。ipv4-acl-name表示ACL的名称，为1～63个字符的字符串，不区分大小写，必须以英文字母a～z或A～Z开头。

start-threshold-value：表示开始抓包的队列长度门限值，单位为字节。取值范围为1～67108352，缺省值为2500。配置值需大于stop-threshold-value。

stop-threshold-value：表示停止抓包的队列长度门限值，单位为字节。取值范围为1～67108352，缺省值为1500。配置值需小于start-threshold-value。

frozen-number：表示抓包数量，达到本门限值时进入冻结状态。取值范围为3～1024，缺省值为256。

timer-value：表示抓包时间，达到本门限值时进入冻结状态。取值范围为1～500，缺省值为500。

pre-sample-rate：表示TCB功能处于预触发状态时的采样率。取值范围为1～16，缺省值为16。例如取值范围为1～16，配置值表示每16个报文中采样报文的个数，配置为16则表示全部采样。

post-sample-rate：表示TCB功能处于触发状态时的采样率。取值范围为1～16，缺省值为16。例如取值范围为1～16，配置值表示每16个报文中采样报文的个数，配置为16则表示全部采样。

frequency-value：表示数据上报频次，单位为次/分钟。取值范围为1～600，缺省值为20。

【使用指导】

在系统视图下开启并配置全局TCB功能对指定slot上所有支持TCB功能的接口生效，设备将持续监控接口下的队列，当队列发生丢包时，可通过gRPC方式将接口、队列、丢包原因等信息上报网管。

在接口视图下开启并配置TCB功能后，设备将持续监控该接口下的队列，当队列发生丢包时，可通过gRPC方式将接口、队列、丢包原因等信息上报网管。

使用接口视图下的命令开启TCB功能时，设备仅支持在一个接口下开启TCB功能。

系统视图和接口视图下均可开启并配置TCB功能，但两种配置方式互斥。如果当前已经使用一种方式开启了TCB功能，需要在该方式下关闭TCB功能后，才能使用另一种方式配置。

 

【举例】

# 对slot 1上支持TCB功能的所有接口的发送缓冲区中、命中ACL 3000的报文开启TCB功能，不对抓包数据进行本地分析。

<Sysname> system-view

[Sysname] buffer transient-capture global slot 1 egress enable no-local-analysis acl 3000

# 对接口GigabitEthernet1/0/1的发送缓冲区中、命中ACL 3000的报文开启TCB功能，不对抓包数据进行本地分析。

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] buffer transient-capture egress enable no-local-analysis acl 3000

1.2.2  display buffer transient-capture packet-drop

display buffer transient-capture packet-drop命令用来显示TCB捕获的丢包信息。

【命令】

display buffer transient-capture packet-drop slot slot-number { ethernet | ipv4 | ipv6 }

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

ethernet：显示TCB捕获的以太网报文的丢包信息。

ipv4：显示TCB捕获的IPv4报文的丢包信息。

ipv6：显示TCB捕获的IPv6报文的丢包信息。

slot slot-number：指定成员设备。slot-number为设备在IRF中的成员编号。

【使用指导】

执行本命令后，设备将按照发生丢包事件的时间由近及远罗列所有丢包事件，其中包含丢包数量、丢包发生时间、被丢弃报文特征、所属队列和接口，以及丢包原因。

【举例】

# 显示slot 1上TCB捕获的IPv4报文的丢包信息。

<Sysname> display buffer transient-capture packet-drop slot 1 ipv4

TCB STATUS: EgressPort GE1/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  GE1/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  GE1/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  GE1/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  GE1/0/1  2

表1-4 display buffer transient-capture packet-drop命令显示信息描述表

字段	描述
TCB STATUS	TCB状态 ·     EgressPort GE1/0/1：表示当前开启的是接口TCB功能，以及功能开启的方向和接口编号 ·     Global：表示当前开启的是全局TCB功能
No.	编号
Time	丢包发生时间，为UNIX时间戳格式，即1970年1月1日0点0时0秒的相对时间。例如： ·     1970年1月1日0点0时0秒实际显示为0 ·     1970年1月1日1点0时0秒实际显示为E10
SMAC	源MAC地址
DMAC	目的MAC地址
VLAN	VLAN ID
SIP	源IP地址
DIP	目的IP地址
SPort	源端口号
DPort	目的端口号
Queue	队列编号
IfName	接口名称
Reason	丢包原因（多个原因时，为以下数字的或运算组合）： ·     1：入队列丢弃 ·     2：出队列丢弃 ·     4：加权随机丢弃 ·     8：CELL资源不足丢弃
Total packets dropped on XPE0	XPE0上的总丢报数，XPE表示设备支持的缓冲区类型