23-一键诊断命令
本章节下载: 23-一键诊断命令 (327.91 KB)
目 录
1.1.1 diagnostic troubleshooting enable
1.1.2 diagnostic troubleshooting health enable
1.2.1 diagnostic troubleshooting test drvdiag ping
1.3.1 diagnostic troubleshooting test drvdiag arp
1.4.1 diagnostic troubleshooting test drvdiag board-startup-failed
1.5.1 diagnostic troubleshooting test drvdiag nd
1.6.1 diagnostic troubleshooting test drvdiag mac
仅缺省MDC支持配置一键诊断功能,非缺省MDC不支持执行一键诊断模块的所有命令。关于MDC的详细介绍请参见“虚拟化技术配置指导”中的“MDC”。
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
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
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 |
出方向报文检查结束 |
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表项下发错误信息 |
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
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表项下发错误信息 |
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保留在没有任何通知或提示的情况下对资料内容进行修改的权利!
