• 产品与解决方案
  • 行业解决方案
  • 服务
  • 支持
  • 合作伙伴
  • 关于我们

13-网络管理和监控命令参考

目录

23-一键诊断命令

本章节下载 23-一键诊断命令  (327.91 KB)

23-一键诊断命令


1 一键诊断

仅缺省MDC支持配置一键诊断功能,非缺省MDC不支持执行一键诊断模块的所有命令。关于MDC的详细介绍请参见“虚拟化技术配置指导”中的“MDC”。

1.1  一键诊断开启命令

1.1.1  diagnostic troubleshooting enable

diagnostic troubleshooting enable命令用来开启业务功能的一键诊断功能。

undo diagnostic troubleshooting enable命令用来关闭业务功能的一键诊断功能。

【命令】

diagnostic troubleshooting [ test test-name test-item ] enable

undo diagnostic troubleshooting [ test test-name test-item ] enable

【视图】

系统视图

【缺省情况】

业务功能的一键诊断功能处于开启状态。

【缺省用户角色】

network-admin

【参数】

test test-name:表示测试例的名称,为1~31个字符的字符串,不区分大小写。具体取值可通过执行diagnostic troubleshooting test 命令来获取。不指定该参数时,表示对所有测试项进行配置。

test-item:表示测试项的名称,为1~31字符的字符串,不区分大小写。具体取值可通过执行diagnostic troubleshooting test test-name 命令来获取。

【使用指导】

只有开启业务功能的一键诊断功能后,才允许执行业务功能一键诊断。

缺省情况下,为方便用户随时对设备进行维护,所有业务功能的一键诊断功能都处于开启状态。部分测试例不需要存储运行数据,部分测试例需要存储运行数据并根据存储的历史数据进行一键诊断。对于需要存储运行数据的测试例,开启业务功能的一键诊断功能并完成业务模块的配置后,业务模块会将测试项监控的运行数据记录到GOLD模块,以便GOLD模块对测试项进行一键诊断。记录运行数据会消耗设备资源,影响系统性能。如果用户不关心某业务功能的运行状态,可以关闭对应测试项的一键诊断功能,减少对系统性能的影响。

【举例】

# 开启SNMP报文处理失败测试项的一键诊断功能。

<Sysname> system-view

[Sysname] diagnostic troubleshooting snmp-agent packet-process-failure enable

【相关命令】

·     diagnostic troubleshooting test

1.1.2  diagnostic troubleshooting health enable

diagnostic troubleshooting health enable命令用来开启业务模块健康度一键诊断功能。

undo diagnostic troubleshooting health enable命令用来关闭业务模块健康度一键诊断功能。

【命令】

diagnostic troubleshooting health [ module module-name ] enable

undo diagnostic troubleshooting health [ module module-name ] enable

【视图】

系统视图

【缺省情况】

业务模块健康度一键诊断功能处于开启状态。

【缺省用户角色】

network-admin

【参数】

module module-name:模块名,为1~31个字符的字符串,区分大小写。不指定该参数时,则开启所有设备支持的业务模块的健康度用例。

【使用指导】

只有开启业务模块健康度一键诊断功能后,才允许执行业务模块健康度一键诊断。

开启业务模块健康度一键诊断功能并完成业务模块的配置后,业务模块会将不健康业务信息记录到GOLD模块,以便GOLD模块进行健康度一键诊断。记录业务模块的不健康信息会消耗设备资源,影响系统性能。如果用户不关心某业务模块的健康度,可以关闭该业务模块的健康度监测,减少对系统性能的影响。

【举例】

# 开启MPLS TE业务模块健康度一键诊断功能。

<Sysname> system-view

[Sysname] diagnostic troubleshooting health module te enable

【相关命令】

·     diagnostic troubleshooting health

1.2  Ping一键诊断命令

1.2.1  diagnostic troubleshooting test drvdiag ping

diagnostic troubleshooting test drvdiag ping命令用来对直连ping不通表项异常事件进行一键诊断。

【命令】

(独立运行模式)‌

diagnostic troubleshooting test drvdiag ping [ vpn-instance vpn-instance ][ source-ip ip-address | source-ipv6 ipv6-address] [ dest-ip ip-address | dest-ipv6 ipv6-address] [ interface interface-type interface-number ] [ -t time ] [ -brief ] [ slot slot-number ]

(IRF模式)

diagnostic troubleshooting test drvdiag ping [ vpn-instance vpn-instance ][ source-ip ip-address | source-ipv6 ipv6-address] [ dest-ip ip-address | dest-ipv6 ipv6-address] [ interface interface-type interface-number ] [ -t time ] [ -brief ] [ chassis chassis-number slot slot-number ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

vpn-instance vpn-instance:指定IP地址所属的VPN实例,对指定VPN实例进行直连ping不通一键诊断。

source-ip ip-address:对指定源IPv4地址的直连ping不通异常事件进行一键诊断。ip-address 表示IPv4地址。

dest-ip ip-address:对指定目的IPv4地址的直连ping不通异常事件进行一键诊断。

source-ipv6 ipv6-address:对指定源Ipv6地址的ping不通异常事件进行一键诊断。

dest-ipv6 ipv6-address:对指定目的Ipv6地址的ping不通异常事件进行一键诊断。

interface interface-type interface-number对指定接口的直连ping不通学习异常事件进行一键诊断。interface-type interface-number为接口类型和编号。

-t time:诊断时间,取值范围为10~600,单位为秒(s)。缺省值为60秒。

slot slot-number:对指定单板上直连ping不通异常事件进行一键诊断。slot-number表示单板所在的槽位号。(独立运行模式)

chassis chassis-number slot slot-number:对指定成员设备上指定单板上的直连ping不通异常事件进行一键诊断。chassis-number表示设备在IRF中的成员编号,slot-number表示单板所在的槽位号。如果未指定本参数,则对所有单板上的直连ping不通异常事件进行一键诊断。(IRF模式)‌

-brief:Ping不通异常事件进行一键诊断简要信息输出。

【使用指导】

应用场景

直连ping不通异常事件一键诊断功能处于开启状态的情况下,设备会自动直连ping不通异常的信息记录到GOLD(Generic OnLine Diagnostics,通用在线诊断)模块。执行本命令后,设备会显示GOLD模块内存中记录的直连ping不通诊断信息,其中包括产生此类信息的时间、原因等内容,帮助用户定位直连ping不通异常的原因。

配置准备

请先使用diagnostic troubleshooting test drvdiag ping enable命令,开启直连ping不通学习异常事件一键诊断功能,否则,本命令执行失败。(直连ping不通异常事件一键诊断功能缺省处于开启状态。)

【举例】

# 对直连ping不通异常事件入方向进行一键诊断,诊断时间为60秒。

[H3C]diagnostic troubleshooting test drvdiag ping source-ip 13.1.1.1 dest-ip  

  13.1.1.2 -t 60 slot 2                                                       

Diag start at 2025-12-15 10:18:15                                             

-------------------show param-------------------                             

vpn-instance is None                                                         

source-ipv4  is 13.1.1.1                                                     

dest-ipv4    is 13.1.1.2                                                     

source-ipv6  is None                                                     

dest-ipv6    is None                                                     

interface    is None                                                    

chassis      is 0                                                        

slot         is 2                                                        

time         is 60                                                      

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

Diagnosis report (* means error item):                                  

                                                                        

Information collected during the diagnostic interval:                   

                                                                         

===============public basic check begin===============                  

                                                                        

----------------slot basic check begin----------------                  

                                                                         

slot 2 cpu-usage 8%                                                     

                                                                        

slot 2 free memory 2902632, minor memory 263168                          

                                                                        

************slot 2 l3 resource check begin************                  

total intfid size:8188 used intfid size:9                               

total host route size:32768 used host route size:0                      

total lpm size 393216, use lpm size 11

total nexthop offset size 49143,used nexthop offset size 28             

total external nexthop size 114687,used external nexthop size 12255      

total router mac size 511,used router mac size 0                        

total dsmet size 12255, used dsmet size 27                              

total ecmp group size 4095, used ecmp group size 0                      

total bfd mep size 1024, used bfd mep size 0                            

lchipid 0 total local nexthop size 81920,used local nexthop size 18     

lchipid 0 total edit size 32768, used edit size 27                      

 

*************slot 2 l3 resource check end*************  

-----------------slot basic check end-----------------  

-----------------ip entry check begin-----------------  

13.1.1.1 is peer host address in vpn_instance PUBLIC check pass      

13.1.1.2 is local host address in vpn_instance PUBLIC check pass     

------------------ip entry check end------------------               

---------------other public check begin---------------               

device mac-address has no mac move check pass                        

device mac-address has no ip address exception status(DUPLICATE,TENTATIVE)   

----------------other public check end----------------              

================public basic check end================              

=================capture packet begin=================              

sip 13.1.1.1 is peer host address, perform capture inbound pkt check!  

dip 13.1.1.2 is local host address, perform capture inbound pkt check! 

wait: 4s  capture pkt success!                                          

==================capture packet end==================                  

-------------------show packet info-------------------                   

slot          is  slot 2                                                

chip          is  0                                                      

src-mac       is  0000.1234.5682                                        

dest-mac      is  dc2d.cb6e.5e01                                        

eth-type      is  0x00000800                                            

layer3-type   is  L3TYPE_IPV4                                            

src-ip        is  13.1.1.1                                              

dst-ip        is  13.1.1.2                                              

src-port      is  2048                                                   

dest-port     is  8                                                     

src-gport     is  0x0000022e                                            

vlan-ptr      is  4103                                                  

intfid        is  7                                                      

vpnid         is  0                                                     

routermac     is  YES                                                   

==============inbound packet check begin==============                   

******************diag slot 2 chip 0******************                  

*****************1.1st_parsing check******************                  

sdk arp/nd 13.1.1.1 in vpn_instance PUBLIC check pass                   

*********************2.scl check**********************                   

ping not hit scl0 check pass                                            

ping not hit scl1 check pass                                            

ping not hit tcam2 check pass                                            

***************3.interface_mapper check***************                   

sdk packet vpnname PUBLIC vpn 0 check pass                               

sdk packet routermac YES hit check pass                                  

sdk packet ipe-drop check pass                                           

****************4.layer3_routing check****************                   

sdk packet hit host route 13.1.1.2                                       

*********************5.acl check**********************                   

inbound acl not hit check pass                                          

outbound acl not hit check pass                                          

***********6.show_packet_stats start check************                   

packet send to rxtx packet count 5                                       

*******************7.rxtx_rx check********************                   

rxtx softcar icmp queue check pass                                       

rxtx rx packet count: 5                                                  

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

 0000  dc 2d cb 6e 5e 01 00 00 12 34 56 82 08 00 45 00                   

 0010  00 54 72 47 00 00 ff 01 2d 5d 0d 01 01 01 0d 01                   

 0020  01 02 08 00 c6 d5 7f 16 00 04 4d 2b 4f 7b 00 0b                   

 0030  78 af 00 00 00 00 00 00 00 00 00 00 00 00 14 15                   

 0040  16 17 18 19 1a 1b 1c 1d 1e 1f 20 21 22 23 24 25                   

 0050  26 27 28 29 2a 2b 2c 2d 2e 2f 30 31 32 33 34 35                  

 0060  36 37                                                            

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

rxtx to plat count: 5                                                    

*************8.plat receive packet check**************                    

plat receive request packet count: 5                                      

plat receive reply packet count: 0                                        

===============inbound packet check end===============                   

Diag end at 2025-12-15 10:18:24, Actual time 9 seconds. 

表1-1 diagnostic troubleshooting test drvdiag ping不通命令入方向显示信息描述表

字段

描述

Diag start at

诊断开始时间

Diag end at

诊断结束时间

Diagnosis report

诊断信息

Information collected during the diagnostic interval

诊断期间收集的信息

public basic check

公共基础检查,取值包括:

slot basic check:检查CPU、内存相关信息

l3 resource check:检查单板上相关L3表项资源

ip entry check:IP地址合法性检查

other public check:检查mac地址迁移、ip地址冲突

capture packet begin

根据IP地址参数判断开始抓取入方向报文

capture packet end

结束抓取报文

show packet info

显示抓取报文信息

Slot:槽位信息

Chip: 芯片信息

src-mac:报文源MAC

dest-mac:报文目的MAC

eth-type:报文以太类型

layer3-type:报文L3类型

src-ip:报文源IP地址

dst-ip:报文目的IP地址

src-port:报文源端口号

dest-port:报文目的端口号

src-gport:报文源全局port信息

vlan-ptr:报文vlan信息

intfid:报文入端口对应的intfid

vpnid:vpn信息

routermac:是否命中routermac

inbound packet check begin

报文入方向检查开始

diag slot * chip *

检查槽位号与芯片号信息

1st_parsing check

芯片侧检查是否有命中ARP/ND表项

scl check

芯片侧检查是否有命中SCL表项

interface_mapper check

芯片侧检查

·     VPN信息是否正确

·     是否有命中routermac

·     IPE流程中是否有丢包

layer3_routing check

芯片侧检查报文是否有进入三层转发流程,转发表项是否匹配正确

acl check

报文是否有命中ACL

show_packet_stats start check

报文是否有上送CPU

rxtx_rx check

Rxtx是否有收到报文,并打印出报文内容

plat receive packet check

平台是否有接收到报文

inbound packet check end

入方向检查结束

 

# 对直连ping不通异常事件出方向进行一键诊断,诊断时间为60秒。

[H3C]diagnostic troubleshooting test drvdiag ping source-ip 13.1.1.2 dest-ip 13.1.1.1 -t 60

Diag start at 2025-12-15 10:45:22 

-------------------show param-------------------                               

vpn-instance is None                                                           

source-ipv4  is 13.1.1.2                                                       

dest-ipv4    is 13.1.1.1                                                       

source-ipv6  is None                                                           

dest-ipv6    is None                                                           

interface    is None                                                           

chassis      is None                                                           

slot         is None                                                          

time         is 60                                                             

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

Diagnosis report (* means error item):                                         

                                                                               

Information collected during the diagnostic interval:                          

===============public basic check begin===============                         

-----------------ip entry check begin-----------------                         

13.1.1.2 is local host address in vpn_instance PUBLIC check pass               

13.1.1.1 is peer host address in vpn_instance PUBLIC check pass                

------------------ip entry check end------------------                         

---------------other public check begin---------------                         

device mac-address has no mac move check pass                                  

device mac-address has no ip address exception status(DUPLICATE,TENTATIVE)     

----------------other public check end----------------                         

================public basic check end================                         

=================capture packet begin=================                        

sip 13.1.1.2 is local host address, perform capture outbound pkt check!        

dip 13.1.1.1 is peer host address, perform capture outbound pkt check!        

wait: 2s  capture pkt success!                                                 

==================capture packet end==================                         

=============outbound packet check begin==============                         

*********************diag slot 0 *********************                         

***************1.plat send packet check***************                         

plat send request packet count: 0                                              

plat send reply packet count: 0                                                

*************2.diag rxtx_tx packet check**************                         

plat send packet to rxtx count: 0                                              

*********************diag slot 2 *********************                        

***************1.plat send packet check***************                         

plat send request packet count: 0                                             

plat send reply packet count: 5                                                

                                                                               

*************2.diag rxtx_tx packet check**************                         

plat send packet to rxtx intftrans count: 5                                    

plat send packet to rxtx chiptrans count: 5                                    

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

 0000  00 00 12 34 56 82 dc 2d cb 6e 5e 01 08 00 45 00                         

 0010  00 54 8c a2 00 00 ff 01 13 02 0d 01 01 02 0d 01                         

 0020  01 01 00 00 d7 55 02 56 00 04 4d 2b 55 d5 00 02                         

 0030  e6 9e 00 00 00 00 00 00 00 00 00 00 00 00 14 15                         

 0040  16 17 18 19 1a 1b 1c 1d 1e 1f 20 21 22 23 24 25                         

 0050  26 27 28 29 2a 2b 2c 2d 2e 2f 30 31 32 33 34 35                         

 0060  36 37                                                                   

==============outbound packet check end===============                        

Diag end at 2025-12-15 10:45:29, Actual time 7 seconds.

 

表1-2 diagnostic troubleshooting test drvdiag ping不通命令出方向显示信息描述表

字段

描述

capture packet begin

根据IP地址参数判断开始抓取出方向报文

capture packet end

报文抓取结束

outbound packet check begin

出方向报文检查开始

plat send packet check

平台发送ICMP报文检查

diag rxtx_tx packet check

Rxtx发送ICMP报文检查,并打印报文内容

outbound packet check end

出方向报文检查结束

 

1.3  ARP一键诊断命令

1.3.1  diagnostic troubleshooting test drvdiag arp

diagnostic troubleshooting test drvdiag arp命令用来对ARP表项学习异常事件进行一键诊断。

说明

对于S12500G-AF系列交换机,本功能仅在SF系列接口板和SG系列接口板上生效。

【命令】

(独立运行模式)‌

diagnostic troubleshooting test drvdiag arp [ source-ip ip-address ] [ dest-ip ip-address ] [ source-mac mac-address ] [ dest-mac mac-address ] [ vlan vlan-id ] [ interface interface-type interface-number ] [ -t time ] [ slot slot-number ]

(IRF模式)

diagnostic troubleshooting test drvdiag arp [ source-ip ip-address ] [ dest-ip ip-address ] [ source-mac mac-address ] [ dest-mac mac-address ] [ vlan vlan-id ] [ interface interface-type interface-number ] [ -t time ] [ chassis chassis-number slot slot-number ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

source-ip ip-address:对指定源IPv4地址的ARP表项学习异常事件进行一键诊断。

dest-ip ip-address:对指定目的IPv4地址的ARP表项学习异常事件进行一键诊断。

source-mac mac-address:对指定源MAC地址的ARP表项学习异常事件进行一键诊断。mac-address为ARP报文的源MAC地址,格式为H-H-H。

dest-mac mac-address:对指定目的MAC地址的ARP表项学习异常事件进行一键诊断。mac-address为ARP报文的目的MAC地址,格式为H-H-H。

vlan vlan-id:对指定VLAN内ARP表项学习异常事件进行一键诊断,取值范围为1~4094。

interface interface-type interface-number:对指定接口的ARP表项学习异常事件进行一键诊断。interface-type interface-number为接口类型和编号。

-t time:诊断时间,取值范围为10~600,单位为秒(s)。缺省值为60秒。

slot slot-number:对指定单板上ARP表项学习异常事件进行一键诊断。slot-number表示单板所在的槽位号。(独立运行模式)

chassis chassis-number slot slot-number:对指定单板上的ARP表项学习异常事件进行一键诊断。chassis-number表示设备在IRF中的成员编号,slot-number表示单板所在的槽位号。如果未指定本参数,则对所有单板上的ARP表项学习异常事件进行一键诊断。(IRF模式)

【使用指导】

应用场景

ARP表项学习异常事件一键诊断功能处于开启状态的情况下,设备会自动将ARP表项学习异常的信息记录到GOLD(Generic OnLine Diagnostics,通用在线诊断)模块。执行本命令后,设备会显示GOLD模块内存中记录的ARP表项变化的诊断信息,其中包括产生此类信息的时间、原因等内容,帮助用户定位ARP表项学习异常的原因。

配置准备

请先使用diagnostic troubleshooting test drvdiag arp enable命令,开启ARP表项学习异常事件一键诊断功能,否则,本命令执行失败。(ARP表项学习异常事件一键诊断功能缺省处于开启状态。)

【举例】

# 对ARP表项学习异常事件进行一键诊断,诊断时间为60秒。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test drvdiag arp –t 60

Diag start at 2025-09-24 10:03:14

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

source-mac is None

dest-mac   is None

source-ip  is None

dest-ip    is None

vlan       is None

interface  is None

chassis    is None

slot       is None

time       is 60

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

Please perform arp learning...

wait: 60s 

Diagnosis report (* means error item):

Information collected during the diagnostic interval:

receive info:

1. arp to cpu count:

slot 3 chip 0: 0

 

2. arp to rxtx count:

slot 3 chip 0: 0

 

 

3. arp to plat count:

slot 3 chip 0: 0

 

4. arp rx discard count:

slot 3 chip 0: 0

 

5. arp port rx count:

 

6. chip rx drop info:

slot 3 chip 0:

 

7. rxtx rx drop info:

slot 3 chip 0:

 

send info:

1. plat send arp count:

slot 3: 0

 

 

2. arp send to chip count:

slot 3: 0

 

3. chip tx drop information:

slot 3 chip 0:

 

4. rxtx tx drop information:

slot 3 chip 0:

 

other info:

1. arp resource:

 plat entry limit: 524288

 plat entry count: 58

slot 3 (free/total): 49115/49115

 

2. memory info(free,minor)(KB):

slot 3 : 1025788, 199680

 

3. plat arp error statistics:

slot 3:

 

4. drv adj error info:

slot 3:

 

 

Diag end at 2025-09-24 10:03:14, Actual time 63 seconds.

表1-3 diagnostic troubleshooting test drvdiag arp命令显示信息描述表

字段

描述

Diag start at

诊断开始时间

Diag end at

诊断结束时间

Diagnosis report

诊断信息

Information collected during the diagnostic interval

诊断期间收集的信息

receive info

接受方向信息,取值包括:

·     arp to cpu count:ARP报文上送CPU处理的计数

·     arp to rxtx count:ARP报文转发至RXTX(接收发送模块)的计数

·     arp to plat count:ARP报文提交至平台层的计数

·     arp rx discard count:接收的ARP报文丢弃总数

·     arp port rx count:端口接收的ARP报文数量统计

·     chip rx drop info:芯片层接收方向ARP报文丢弃信息

·     rxtx rx drop info:RXTX(接收发送模块)接收方向ARP报文丢弃信息

send info

取值包括:

·     plat send arp count:平台层发送的ARP报文数

·     arp send to chip count:下发到芯片层的ARP报文数

·     chip tx drop information:芯片层发送方向ARP报文丢弃信息

·     rxtx tx drop information:RXTX(接收发送模块)发送方向ARP报文丢弃信息

other info

其他信息,取值包括:

·     arp resource:ARP表项资源信息

¡     plat entry limit: 设备支持的最大ARP表项数量

¡     plat entry count: 当前设备已使用的ARP表项数量

¡     slot slot-number (free/total): 指定单板上的ARP资源情况(剩余可用量/总容量)(独立运行模式)

¡     chassis chassis-number slot slot-number (free/total): 指定单板上的ARP资源情况(剩余可用量/总容量)(IRF模式)‌

·     memory info(free,minor)(KB):内存信息(剩余可用量,一级告警门限)

·     plat arp error statistics:平台层ARP表项错误统计

·     drv adj error info:驱动层ARP表项下发错误信息

 

1.4  单板一键诊断命令

1.4.1  diagnostic troubleshooting test drvdiag board-startup-failed

diagnostic troubleshooting test drvdiag board-startup-failed用来对指定单板进行无法启动问题诊断。

【命令】

(分布式设备-IRF模式)

diagnostic troubleshooting test drvdiag board-startup-failed chassis chassis-number slot slot-number

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

应用场景

通过下发一键诊断命令,选择无法启动的单板,系统将对单板进行诊断,收集单板相关信息并给出初步无法启动原因。

配置准备

请先使用diagnostic troubleshooting test drvdiag board-startup-failed enable命令,开启单板无法启动一键诊断功能,否则,本命令执行失败。(单板无法启动一键诊断功能缺省处于开启状态。)

不支持多用户或多终端同时执行,否则可能导致日志异常。

【举例】

#针对slot4槽位无法启动进行一键诊断功能。

<Sysname> system-view

diagnostic troubleshooting test drvdiag board-startup-failed slot 4

1.5  IPv6一键诊断命令

1.5.1  diagnostic troubleshooting test drvdiag nd

diagnostic troubleshooting test drvdiag nd命令用来对ND表项学习异常事件进行一键诊断。

说明

对于S12500G-AF系列交换机,本命令仅在SF系列接口板和SG系列接口板上生效。

【命令】

(独立运行模式)‌

diagnostic troubleshooting test drvdiag nd [ source-ip ipv6-address ] [ dest-ip ipv6-address ] [ source-mac mac-address ] [ dest-mac mac-address ] [ vlan vlan-id ] [ interface interface-type interface-number ] [ -t time ] [ slot slot-number ]

(IRF模式)

diagnostic troubleshooting test drvdiag nd [ source-ip ipv6-address ] [ dest-ip ipv6-address ] [ source-mac mac-address ] [ dest-mac mac-address ] [ vlan vlan-id ] [ interface interface-type interface-number ] [ -t time ] [ chassis chassis-number slot slot-number ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

source-ip ipv6-address:对指定源IPv6地址的ND表项学习异常事件进行一键诊断。

dest-ip ipv6-address:对指定目的IPv6地址的ND表项学习异常事件进行一键诊断。

source-mac mac-address:对指定源MAC地址的ND表项学习异常事件进行一键诊断。mac-address为ARP报文的源MAC地址,格式为H-H-H。

dest-mac mac-address:对指定目的MAC地址的ND表项学习异常事件进行一键诊断。mac-address为ND报文的目的MAC地址,格式为H-H-H。

vlan vlan-id:对指定VLAN内ND表项学习异常事件进行一键诊断,取值范围为1~4094。

interface interface-type interface-number:对指定接口的ND表项学习异常事件进行一键诊断。interface-type interface-number为接口类型和编号。

-t time:诊断时间,取值范围为10~600,单位为秒(s)。缺省值为60秒。

slot slot-number:对指定单板上ND表项学习异常事件进行一键诊断。slot-number表示单板所在的槽位号。(独立运行模式)

chassis chassis-number slot slot-number:对指定单板上的ND表项学习异常事件进行一键诊断。chassis-number表示设备在IRF中的成员编号,slot-number表示单板所在的槽位号。如果未指定本参数,则对所有单板上的ND表项学习异常事件进行一键诊断。(IRF模式)‌

【使用指导】

应用场景

ND表项学习异常事件一键诊断功能处于开启状态的情况下,设备会自动将ARP表项学习异常的信息记录到GOLD(Generic OnLine Diagnostics,通用在线诊断)模块。执行本命令后,设备会显示GOLD模块内存中记录的ND表项变化的诊断信息,其中包括产生此类信息的时间、原因等内容,帮助用户定位ND表项学习异常的原因。

配置准备

请先使用diagnostic troubleshooting test drvdiag nd enable命令,开启ARP表项学习异常事件一键诊断功能,否则,本命令执行失败。(ND表项学习异常事件一键诊断功能缺省处于开启状态。)

【举例】

# 对ND表项学习异常事件进行一键诊断,诊断时间为60秒。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test drvdiag nd –t 60

Diag start at 2025-09-24 10:24:32

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

source-mac is None

dest-mac   is None

source-ip  is None

dest-ip    is None

vlan       is None

interface  is None

chassis    is None

slot       is None

time       is 60

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

Please perform nd learning...

wait: 60s 

Diagnosis report (* means error item):

Information collected during the diagnostic interval:

receive info:

1. nd to cpu count:

slot 3 chip 0: 0

 

2. nd to rxtx count:

slot 3 chip 0: 0

 

 

3. nd to plat count:

slot 3 chip 0: 0

 

4. nd rx discard count:

slot 3 chip 0: 0

 

5. nd port rx count:

 

6. chip rx drop info:

slot 3 chip 0:

 

7. rxtx rx drop info:

slot 3 chip 0:

 

send info:

1. plat send nd count:

slot 3: 0

 

 

2. nd send to chip count:

slot 3: 0

 

3. chip tx drop information:

slot 3 chip 0:

 

4. rxtx tx drop information:

slot 3 chip 0:

 

other info:

1. nd resource:

 plat entry limit: 327680

 plat entry count: 0

slot 3 (free/total): 27850/27850

 

2. memory info(free,minor)(KB):

slot 3 : 1022808, 199680

 

3. plat nd error statistics:

slot 3:

 

4. drv adj error info:

slot 3:

 

 

Diag end at 2025-09-24 10:24:32, Actual time 63 seconds.[Sysname]

表1-4 diagnostic troubleshooting test drvdiag nd命令显示信息描述表

字段

描述

Diag start at

诊断开始时间

Diag end at

诊断结束时间

Diagnosis report

诊断信息

Information collected during the diagnostic interval

诊断期间收集的信息

receive info

接受方向信息,取值包括:

·     nd to cpu count:ND报文上送CPU处理的计数

·     nd to rxtx count:ND报文转发至RXTX(接收发送模块)的计数

·     nd to plat count:ND报文提交至平台层的计数

·     nd rx discard count:接收的ND报文丢弃总数

·     nd port rx count:端口接收的ND报文数量统计

·     chip rx drop info:芯片层接收方向ND报文丢弃信息

·     rxtx rx drop info:RXTX(接收发送模块)接收方向ND报文丢弃信息

send info

取值包括:

·     plat send nd count:平台层发送的ND报文数

·     nd send to chip count:下发到芯片层的ND报文数

·     chip tx drop information:芯片层发送方向ND报文丢弃信息

·     rxtx tx drop information:RXTX(接收发送模块)发送方向ND报文丢弃信息

other info

其他信息,取值包括:

·     nd resource:ND表项资源信息

¡     plat entry limit: 设备支持的最大ND表项数量

¡     plat entry count: 当前设备已使用的ND表项数量

¡     slot slot-number (free/total): 指定单板上的ND资源情况(剩余可用量/总容量)(独立运行模式)

¡     chassis chassis-number slot slot-number (free/total): 指定单板上的ND资源情况(剩余可用量/总容量)(IRF模式)‌

·     memory info(free,minor)(KB):内存信息(剩余可用量,一级告警门限)

·     plat nd error statistics:平台层ND表项错误统计

·     drv adj error info:驱动层ND表项下发错误信息

 

1.6  MAC地址一键诊断命令

1.6.1  diagnostic troubleshooting test drvdiag mac

diagnostic troubleshooting test drvdiag mac命令用来MAC地址无法学习事件进行一键诊断。

【命令】

(独立运行模式)‌

diagnostic troubleshooting test drvdiag mac interface interface-type interface-number [ source-mac mac-address ] [ vlan vlan-id ] [ -t time ] [ slot slot-number ]

(IRF模式)

diagnostic troubleshooting test drvdiag mac interface interface-type interface-number [ source-mac mac-address ] [ vlan vlan-id ] [ -t time ] [ chassis chassis-number slot slot-number ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

interface interface-type interface-number:对指定接口的MAC地址无法学习事件进行一键诊断。interface-type interface-number为接口类型和编号。

source-mac mac-address:对指定MAC地址的无法学习事件进行一键诊断。mac-address格式为H-H-H。

vlan vlan-id:对指定VLAN内MAC地址无法学习事件进行一键诊断,取值范围为1~4094。

-t time:每个接口抓包时间,取值范围为10~600,单位为秒(s)。缺省值为60秒。

slot slot-number:对指定单板上MAC地址无法学习事件进行一键诊断。slot-number表示单板所在的槽位号。(独立运行模式)

chassis chassis-number slot slot-number:对指定单板上的MAC地址无法学习事件进行一键诊断。chassis-number表示设备在IRF中的成员编号,slot-number表示单板所在的槽位号。如果未指定本参数,则对所有单板上的MAC地址无法学习事件进行一键诊断。(IRF模式)‌

【使用指导】

应用场景

MAC地址无法学习事件一键诊断功能处于开启状态的情况下,设备会自动将无法学习MAC地址的信息记录到GOLD(Generic OnLine Diagnostics,通用在线诊断)模块。执行本命令后,设备会显示GOLD模块内存中记录的MAC地址变化的诊断信息,其中包括产生此类信息的时间、原因等内容,帮助用户定位MAC地址无法学习的原因。

配置准备

请先使用diagnostic troubleshooting test drvdiag mac enable命令,开启MAC地址无法学习事件一键诊断功能,否则,本命令执行失败。(MAC地址无法学习事件一键诊断功能缺省处于开启状态。)

【举例】

# 对接口Ten-GigabitEthernet3/0/1的MAC地址无法学习事件进行一键诊断,诊断时间为60秒。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test drvdiag mac interface ten-gigabitethernet 3/0/1 –t 60

Diag start at 2025-09-24 10:03:14

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

source-mac is None

vlan       is None

interface  is Ten-GigabitEthernet3/0/1

chassis    is None

slot       is None

time       is 60

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

Please perform mac learning...

wait: 60s 

Diagnosis report (* means error item):

Information collected during the diagnostic interval:

InterfaceTen-GigabitEthernet3/0/1 CHECK

Ten-GigabitEthernet3/0/1 stp forwarding

Ten-GigabitEthernet3/0/1 vlan check:

 Available VLAN for mac learning on the port:

  1

Ten-GigabitEthernet3/0/1 bandwidth inrate 0.00% outrate 0.00%

Ten-GigabitEthernet3/0/1 gport 0xe38 llogicport 1

Ten-GigabitEthernet3/0/1 Unknow Source Action: Do nothing.

Ten-GigabitEthernet3/0/1 mac-learning check: mac-learning enabled.

Ten-GigabitEthernet3/0/1 max learning number setting check: mac-learn max-mac-count not been set.

Ten-GigabitEthernet3/0/1 macsec check: macsec is off.

Ten-GigabitEthernet3/0/1 dot1x check: dot1x is off.

Ten-GigabitEthernet3/0/1 mac-authentication check: mac-authentication is off.

 

SYSTEM CHECK

1. chip rx drop info:

chassis 1 slot 1 chip 0:

 

2. chip tx drop information:

chassis 1 slot 1 chip 0:

 

3. mac resource:

 plat entry limit: 458752

 plat entry count: 3

chassis 1 slot 1 (free/total): 458749/458752

 

4. memory info(free,minor)(KB):

chassis 1 slot 1 : 2705772, 276480

 

5. system unknown source learn set: Do Nothing

 

6. mac-learn aging time: 300

 

7. interface inbound rate :

 Interface            Usage (%)   Total (pps)   Broadcast (pps)   Multicast (pps)

 XGE3/0/1                  0.00             0                 0                 0

 XGE3/0/2                  0.00             0                 0                 0

 XGE3/0/3                  0.00             0                 0                 0

 

8. qacl rule "Deny learning" check:

 chassis 1 slot 1 chip 0: Acl-Type 337

 Please check acl rule setting(*).

 

9. Ten-GigabitEthernet3/0/1 statistics:

 input unicasts: 0

 input broadcasts: 0

 input crc: 0

 input runts: 0

 input giants: 0

 

 

CAPTURE PKT CHECK

Capture pkt failed(*)

  Provide traffic for more accurate diagnostics.

 

Diag end at 2025-09-24 10:03:14, Actual time 117 seconds.

表1-5 diagnostic troubleshooting test drvdiag arp命令显示信息描述表

字段

描述

Diag start at

诊断开始时间

Diag end at

诊断结束时间

Diagnosis report

诊断信息

Information collected during the diagnostic interval

诊断期间收集的信息

Interface Ten-GigabitEthernet3/0/1 CHECK

接口诊断信息

Ten-GigabitEthernet3/0/1 stp forwarding

接口STP转发状态

Ten-GigabitEthernet3/0/1 vlan check

接口VLAN检查

Ten-GigabitEthernet3/0/1 bandwidth inrate 0.00% outrate 0.00%

接口带宽入速率和出速率

Ten-GigabitEthernet3/0/1 gport 0xe38 llogicport 1

全局端口和逻辑端口

Ten-GigabitEthernet3/0/1 Unknow Source Action

接口未知源操作

Ten-GigabitEthernet3/0/1 mac-learning check

接口MAC地址学习检查

Ten-GigabitEthernet3/0/1 max learning number setting check

接口最大学习数量配置检查

Ten-GigabitEthernet3/0/1 macsec check

接口MACsec检查

Ten-GigabitEthernet3/0/1 dot1x check

接口802.1X检查

Ten-GigabitEthernet3/0/1 mac-authentication check

接口MAC认证检查

SYSTEM CHECK

系统诊断信息,取值包括:

·     chip rx drop info:芯片层接收方向报文丢弃信息

·     chip tx drop information:芯片层发送方向报文丢弃信息

·     mac resource:MAC资源信息

¡     plat entry limit: 设备支持的最大MAC地址表项数量

¡     plat entry count: 当前设备已使用的MAC地址表项数量

¡     slot slot-number (free/total): 指定单板上的MAC资源情况(剩余可用量/总容量)(独立运行模式)

¡     chassis chassis-number slot slot-number (free/total): 指定单板上的MAC资源情况(剩余可用量/总容量)(IRF模式)‌

·     memory info(free,minor)(KB):内存信息(剩余可用量,一级告警门限)

·     system unknown source learn set:系统未知来源的学习信息

·     mac-learn aging time:MAC地址学习老化时间

·     interface inbound rate:接口入方向速率

¡     Interface: 接口名称

¡     Usage (%): 接口的带宽利用率(单位为百分比)

¡     Total (pps): 接口接收或发送所有类型报文的平均速率(单位为包/秒)

¡     Broadcast (pps): 接口接收或发送广播报文的平均速率(单位为包/秒)

¡     Multicast (pps): 接口接收或发送组播报文的平均速率(单位为包/秒)

·     qacl rule "Deny learning" check: 对禁止学习的ACL规则检查

·     Gigabitethernet1/0/1 statistics: 接口统计信息

¡     input unicasts: 入方向单播报文的数量

¡     input broadcasts: 入方向组播报文的数量

¡     input crc: 入方向接收到的CRC校验错误、长度正常的帧的数量

¡     input runts: 入方向接收到的超小帧的数量

¡     input giants: 入方向接收到的超大帧的数量

CAPTURE PKT CHECK

抓包诊断信息

 

不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!

新华三官网
联系我们