目  录

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 headroom

1.1.6 buffer usage threshold null-queue

1.1.7 buffer usage threshold queue (interface view)

1.1.8 burst-mode enable

1.1.9 port buffer usage threshold headroom null-queue

1.1.10 port buffer usage threshold null-queue

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

【举例】

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

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-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 slot slot-number

undo burst-mode enable slot slot-number

【缺省情况】

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

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

slot slot-number：开启指定成员设备的数据缓冲区自动分配功能，slot-number表示设备在IRF中的成员编号。

【使用指导】

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

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

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

【举例】

# 开启指定slot 1数据缓冲区自动分配功能。

<Sysname> system-view

[Sysname] burst-mode enable slot 1

1.1.9  port buffer usage threshold headroom null-queue

port buffer usage threshold headroom null-queue命令用来配置端口级Headroom缓冲区使用门限值。

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

【命令】

port buffer usage threshold headroom null-queue ratio ratio

undo port buffer usage threshold headroom null-queue ratio

【缺省情况】

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

【视图】

二层以太网接口视图

三层以太网接口视图

【缺省用户角色】

network-admin

【参数】

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

【使用指导】

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

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

【举例】

# 配置端口级GigabitEthernet1/0/1的Headroom缓冲区使用门限值为50%。

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname–GigabitEthernet1/0/1] port buffer usage threshold headroom null-queue ratio 50

【相关命令】

·     buffer threshold alarm enable

·     buffer usage threshold headroom

1.1.10  port buffer usage threshold null-queue

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

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

【命令】

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

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

【缺省情况】

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

【视图】

二层以太网接口视图

三层以太网接口视图

【缺省用户角色】

network-admin

【参数】

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

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

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

【使用指导】

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

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

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

【举例】

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

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/0/1] port buffer ingress usage threshold null-queue ratio 50

【相关命令】

·     buffer threshold alarm enable

·     buffer usage threshold null-queue

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～400，缺省值为400。

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功能。

只有对TCP或UDP报文本地分析时TCB的显示命令才显示丢包信息。

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

【举例】

# 对slot 1上支持TCB功能的所有接口的发送缓冲区中、命中ACL 3000的报文开启TCB功能，不对抓包数据进行本地分析，进入预触发状态的队列长度门限值为10000字节，退出预触发状态的队列长度门限值为5000字节，抓包数量为1000，抓包时间为500微妙，预触发状态时的采样率为10，触发状态时的采样率为10，数据上报频次为30次/分钟。

<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

# 对接口GigabitEthernet1/0/1的发送缓冲区中、命中ACL 3000的报文开启TCB功能，不对抓包数据进行本地分析，进入预触发状态的队列长度门限值为10000字节，退出预触发状态的队列长度门限值为5000字节，抓包数量为1000，抓包时间为500微妙，预触发状态时的采样率为10，触发状态时的采样率为10，数据上报频次为30次/分钟。

<Sysname> system-view

[Sysname] interface gigabitethernet 1/0/1

[Sysname-GigabitEthernet1/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

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-1 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表示设备支持的缓冲区类型