缺省情况下，为方便用户随时对设备进行维护，所有业务功能的一键诊断功能都处于开启状态。部分测试例不需要存储运行数据，部分测试例需要存储运行数据并根据存储的历史数据进行一键诊断。对于需要存储运行数据的测试例，开启业务功能的一键诊断功能并完成业务模块的配置后，业务模块会将测试项监控的运行数据记录到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 CPU一键诊断命令

1.2.1 diagnostic troubleshooting test cpu high-ratio

diagnostic troubleshooting test cpu high-ratio命令用来对CPU利用率超门限事件进行一键诊断。

【命令】

diagnostic troubleshooting test cpu high-ratio

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

工作机制

系统每隔1分钟对CPU利用率进行一次采样。开启CPU利用率超门限事件一键诊断功能后，如果设备本次CPU利用率的采样值大于CPU利用率低级别告警门限（CPU利用率告警门限可通过monitor cpu-usage threshold命令配置），则设备认为CPU利用率超门限，会在GOLD模块的内存中记录一条CPU利用率超门限事件。

执行本命令后，设备会显示下列信息，以帮助用户定位CPU利用率高的问题。

· 最近CPU利用率的采样值（最多显示7条）。

· 显示最近CPU超门限事件记录（最多显示7条）。

· 显示最近一次CPU利用率超门限事件发生时CPU利用率排名前五的进程的信息。

关于CPU利用率告警功能的详细描述请参见“设备管理配置指导”中的“硬件资源管理”。

注意事项

请先使用diagnostic troubleshooting test cpu high-ratio enable命令，开启CPU利用率超门限事件一键诊断功能，否则，本命令执行失败。（CPU利用率超门限事件一键诊断功能缺省处于开启状态。）

【举例】

# 对CPU利用率超门限事件进行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test cpu high-ratio

Slot 1 CPU 0 usage:

Time Usage

2022-07-25 02:37:52 30%

2022-07-25 02:32:16 28%

2022-07-25 02:22:16 28%

2022-07-25 02:12:16 27%

2022-07-25 02:52:16 29%

2022-07-25 01:32:16 28%

2022-07-25 01:12:16 25%

Slot 1 CPU 0 recent high usage records:

Time Severe threshold Minor threshold Usage

2022-07-25 02:18:52 80% 25% 30%

2022-07-25 02:18:53 80% 25% 28%

2022-07-25 02:22:16 80% 25% 28%

2022-07-25 02:12:16 80% 25% 27%

2022-07-25 02:52:16 80% 25% 29%

2022-07-25 01:32:16 80% 25% 28%

2022-07-25 01:12:16 80% 25% 25%

Top 5 slot 1 CPU 0 usage processes in the last record:

JID PID PRI State FDs HH:MM:SS Usage Name

1026 1026 120 S 1188 00:11:16 12.61% forward

999 999 120 S 190 00:00:37 5.55% ifmond

847 847 120 S 183 00:01:10 5.29% drv_app

983 983 120 S 94 00:01:00 4.76% diagd

1201 1201 120 S 199 00:02:09 4.26% pppd

表1-1 diagnostic troubleshooting test cpu high-ratio命令显示信息描述表

字段	描述
Slot 1 CPU 0 usage	Slot 1 CPU 0最近CPU利用率信息记录，最多可记录7条
Time	CPU利用率采样时间
Usage	CPU利用率取值
Slot 1 CPU 0 recent high usage records	Slot 1 CPU 0最近CPU利用率超门限事件记录，最多可记录7条
Severe threshold	CPU利用率高级别告警门限。CPU利用率采样值大于CPU利用率低级别告警门限或CPU利用率高级别告警门限，GOLD会记CPU利用率超门限事件
Minor threshold	CPU利用率低级别告警门限，CPU利用率采样值大于CPU利用率低级别告警门限或CPU利用率高级别告警门限，GOLD会记CPU利用率超门限事件
Top 5 slot 1 CPU 0 usage processes in the last record	最近一条CPU利用率超门限事件发生时，Slot 1 CPU 0的CPU利用率占前五的进程的信息
JID	任务编号，用于唯一标识一个进程，该编号不会随着进程的重启而改变
PID	进程编号
PRI	进程优先级（优先级在进程调度时发挥作用，优先级高的会优先得到调度）
State	进程状态，可能的取值为： · R：Running，运行状态或处于运行队列 · S：Sleeping，可中断睡眠状态 · T：Traced or stopped，暂停状态 · D：Uninterruptible sleep，不可中断睡眠状态 · Z：Zombie，僵死状态
FDs	进程已使用的FD个数
HH:MM:SS	进程最近一次启动后的运行时间。当进程的持续运行时间大于或等于100小时时，该列仅显示小时数，不再显示分和秒
Name	进程名

【相关命令】

· diagnostic troubleshooting enable

· monitor cpu-usage threshold（设备管理命令参考/硬件资源管理）

1.2.2 diagnostic troubleshooting test cpu overload

diagnostic troubleshooting test cpu overload命令用来对CPU利用率突增事件进行一键诊断。

【命令】

diagnostic troubleshooting test cpu overload

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

工作机制

设备执行一次监控诊断测试例cpu-overload，会对CPU利用率采样一次，该采样值用于CPU利用率突增事件一键诊断。监控诊断测试例cpu-overload缺省处于开启状态，可通过diagnostic monitor enable来配置。

开启CPU利用率突增事件一键诊断功能后，如果设备本次CPU利用率的采样值减去上一次采样值的结果大于10%，则认为CPU利用率突增，会在GOLD模块的内存中记录一条CPU利用率突增事件。

执行本命令后，设备会显示下列信息，以帮助用户定位CPU利用率突增的问题。

· 显示最近CPU利用率突增事件，最多显示7条。

· 显示最近一次CPU利用率突增事件发生时CPU利用率排前五的进程的信息。

注意事项

请先使用diagnostic troubleshooting test cpu overload enable命令，开启CPU利用率突增事件一键诊断功能，否则，本命令执行失败。（CPU利用率突增事件一键诊断功能缺省处于开启状态。）

【举例】

# 对CPU利用率突增事件进行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test cpu overload

Slot 1 CPU 0 recent uasge burst records:

Time Usage(%)

2022-07-25 02:18:52 From 10 to 30

Top 5 slot 1 CPU 0 usage processes in the last record:

Process 1011 (forward)

TID LAST_CPU Stack PRI State HH:MM:SS:MSEC Name

1011 12 136K 120 S 0:8:24:620 forward

Thread (LWP 1011):

Switch counts: 1

User stack:

#0 0x00007fb893904dbd in syscall+0x1d/0x37

#1 0x00007fb896160748 in futex_async+0x48/0x50

#2 0x00007fb896161e98 in call_rcu_wait+0xa8/0xb5

#3 0x00007fb896162646 in call_rcu_thread+0x556/0x6ed

#4 0x00007fb899e742de in start_thread+0xfe/0x3e0

Kernel stack:

[<ffffffff9a1090b4>] futex_wait_queue_me+0xc4/0x120

[<ffffffff9a109d16>] futex_wait+0x116/0x270

[<ffffffff9a10bbf7>] do_futex+0x237/0xb40

[<ffffffff9a10c581>] SyS_futex+0x81/0x180

[<ffffffff9a87f3fb>] entry_SYSCALL_64_fastpath+0x1e/0xad

[<ffffffffffffffff>] 0xffffffffffffffff

Process 1016 (ifmond)

TID LAST_CPU Stack PRI State HH:MM:SS:MSEC Name

1016 5 136K 120 S 0:1:0:0 ifmond

Thread (LWP 1026):

Switch counts: 1

User stack:

#0 0x00007fb893904dbd in syscall+0x1d/0x37

#1 0x00007fb896160748 in futex_async+0x48/0x50

#2 0x00007fb896161e98 in call_rcu_wait+0xa8/0xb5

#3 0x00007fb896162646 in call_rcu_thread+0x556/0x6ed

#4 0x00007fb899e742de in start_thread+0xfe/0x3e0

Kernel stack:

[<ffffffff9a1090b4>] futex_wait_queue_me+0xc4/0x120

[<ffffffff9a109d16>] futex_wait+0x116/0x270

[<ffffffff9a10bbf7>] do_futex+0x237/0xb40

[<ffffffff9a10c581>] SyS_futex+0x81/0x180

[<ffffffff9a87f3fb>] entry_SYSCALL_64_fastpath+0x1e/0xad

[<ffffffffffffffff>] 0xffffffffffffffff

……

表1-2 diagnostic troubleshooting test cpu overload命令显示信息描述表

字段	描述
Slot 1 CPU 0 recent uasge burst records	Slot 1 CPU 0最近的CPU利用率突增事件记录，最多可记录7条
Time	CPU利用率采样时间
Usage(%)	CPU利用率变化情况，用百分比表示
Top 5 slot 1 CPU 0 usage processes in the last record	Slot 1 CPU 0最近一条CPU利用率超门限事件发生时，CPU使用率占前五的进程的信息
Process 1011 (forward)	进程的编号（进程的名称）
TID	线程编号
LAST_CPU	进程最近一次被调度时，所在的CPU
Stack	堆栈大小，单位为KB
PRI	线程使用CPU的优先级
State	线程状态，可能的取值为： · R：Running，运行状态或正在队列中等待调度 · S：Sleeping，可中断睡眠状态 · T：Traced or stopped，暂停状态 · D：Uninterruptible sleep，不可中断睡眠状态 · Z：Zombie，僵死状态
HH:MM:SS:MSEC	线程最近一次启动后的运行时间
Name	线程名称
Thread (LWP 1026)	被跟踪进程的子进程
Switch counts	被调度的次数
User stack	用户态堆栈信息，仅用户态进程显示该信息
Kernel stack	内核态堆栈信息，仅内核态进程显示该信息

【相关命令】

· diagnostic monitor enable（设备管理命令参考/GOLD）

· diagnostic troubleshooting enable

1.3 内存一键诊断命令

1.3.1 diagnostic troubleshooting test memory high-ratio

diagnostic troubleshooting test memory high-ratio命令用来对剩余内存超门限事件进行一键诊断。

【命令】

diagnostic troubleshooting test memory high-ratio

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

工作机制

系统每隔5秒对剩余内存进行一次采样。开启内存超门限事件一键诊断功能后，如果设备当前剩余内存采样值小于等于一级内存告警门限（内存告警门限可通过memory-threshold命令配置），则设备认为剩余内存超门限，会在GOLD模块的内存中记录一条剩余内存超门限事件。

执行本命令后，设备会显示当前内存使用情况以及最近剩余内存超过告警门限的事件，最多显示7条，帮助用户定位系统剩余内存不足的问题。

注意事项

请先使用diagnostic troubleshooting test memory high-ratio enable命令，开启内存超门限事件一键诊断功能，否则，本命令执行失败。（内存超门限事件一键诊断功能缺省处于开启状态。）

【举例】

# 对剩余内存超门限事件进行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting memory high-ratio

Memory statistics are measured in KB:

Slot 1:

Total Used Free Shared Buffers Cached FreeRatio

Mem: 4046200 3571064 475136 0 128408 842768 11.7%

-/+ Buffers/Cache: 2599888 1446312

Swap: 998396 108704 889692

Container memory statistics are measured in KB:

Slot 1:

Total Used Free UsageRatio

Mem: 4046200 1459352 475136 36.1%

Slot 1 recent high memory usage records:

Time Threshold FreeRatio

2022-07-25 02:27:52 10% 6.6%

2022-07-24 02:22:16 10% 6.1%

2022-07-23 02:17:14 10% 6.2%

2022-07-22 02:12:13 10% 6.6%

2022-07-21 02:07:11 10% 6.5%

2022-07-20 02:02:13 10% 5.6%

2022-07-19 01:57:11 10% 6.4%

表1-3 diagnostic troubleshooting test memory high-ratio命令显示信息描述表

字段	描述
Memory statistics are measured in KB:	物理设备中内存使用情况，以下统计信息均以KB为单位
Mem	内存使用信息
Total	系统可分配的物理内存的大小设备总物理内存分为不可分配物理内存和可分配物理内存： · 不可分配物理内存用于内核代码段存储、内核管理开销以及ISSU功能运行等；可分配物理内存用于支撑业务模块的运行、文件存储等操作 · 可分配内存的大小由设备根据系统运行需要自动计算划分 · 可分配物理内存的大小=设备总物理内存-不可分配内存的大小
Used	整个系统已用的物理内存大小
Free	整个系统可用的物理内存大小
Shared	多个进程共享的物理内存总额。取值为“--”时，表示不支持统计该参数的值
Buffers	已使用的文件缓冲区的大小。取值为“--”时，表示不支持统计该参数的值
Cached	高速缓冲寄存器已使用的内存大小。取值为“--”时，表示不支持统计该参数的值
Caches	高速缓冲寄存器已使用的内存大小
FreeRatio	整个系统物理内存的空闲率
-/+ Buffers/Cache	-/+ Buffers/Cache:used = Mem:Used – Mem:Buffers – Mem:Cached，表示应用程序已用的物理内存大小 -/+ Buffers/Cache:free = Mem:Free + Mem:Buffers + Mem:Cached，表示应用程序可用的物理内存大小
Swap	交换分区的使用信息
LowMem	低端内存使用信息
HighMem	高端内存使用信息
Container memory statistics are measured in KB	Comware容器对内存的使用情况，包括： · Total：Comware容器总共可分配的物理内存的大小，单位为KB · Used：Comware容器已使用的物理内存的大小，单位为KB · Free：Comware容器可用的物理内存的大小，单位为KB · UsageRatio：Comware容器对物理内存的使用率
Slot 1 recent high memory usage records	Slot 1最近内存超门限事件的记录，最多可记录7条
Time	内存超门限发生的时间
Threshold	内存门限值

【相关命令】

· diagnostic troubleshooting enable

· memory-threshold（设备管理命令参考/硬件资源管理）

1.3.2 diagnostic troubleshooting test memory overload

diagnostic troubleshooting test memory overload命令用来对内存使用量突增事件进行一键诊断。

【命令】

diagnostic troubleshooting test memory overload

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

工作机制

设备执行一次监控诊断测试例memory-overload，会对内存使用量采样一次，该采样值用于内存使用量突增事件一键诊断。监控诊断测试例memory-overload缺省处于开启状态，可通过diagnostic monitor enable来配置。

开启内存使用量突增事件一键诊断功能后，如果设备本次内存使用量的采样值减去上一次采样值的结果大于50M，则认为内存使用量突增，会在GOLD模块的内存中记录一条内存使用量突增事件。

执行本命令后，设备会显示下列信息，以帮助用户定位系统剩余内存不足的问题。

· 显示最近内存使用量突增事件，最多显示7条。

· 显示最近一次内存使用量突增事件发生时内存使用量排前五的进程的信息。

注意事项

请先使用diagnostic troubleshooting test memory overload enable命令，开启内存使用量突增事件一键诊断功能，否则，本命令执行失败。（内存使用量突增事件一键诊断功能缺省处于开启状态。）

【举例】

# 对内存使用量突增事件进行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting memory overload

Slot 1 recent memory usage burst records:

Time Memory used (MB)

2022-07-25 08:18:52 From 456 to 556

2022-07-25 07:18:52 From 456 to 556

2022-07-25 06:18:52 From 456 to 556

2022-07-25 05:18:52 From 456 to 556

2022-07-25 04:18:52 From 456 to 556

2022-07-25 03:18:52 From 456 to 556

2022-07-25 02:18:52 From 456 to 556

Slot 1 top 5 memory usage processes in the last record:

Process: scmd (jobID 1)

Total allocated memory: 393760 bytes

Total free memory: 144672 bytes

Heap usage of the job:

Tag UsedBlocks UsedBytes FreeBlocks FreeBytes

0x0 1412 362704 24 144304

0x1060000 2 96 0 0

0x1090000 0 0 3 240

0x10b0000 3 96 2 64

0x1120000 7 2496 0 0

0x1150000 1 64 1 64

0x1570000 1 11536 0 0

0x15a0000 26 16768 0 0

Process: aaa (jobID 2)

Total allocated memory: 393760 bytes

Total free memory: 144672 bytes

Heap usage of the job:

Tag UsedBlocks UsedBytes FreeBlocks FreeBytes

0x0 1412 362704 24 144304

0x1060000 2 96 0 0

0x1090000 0 0 3 240

0x10b0000 3 96 2 64

0x1120000 7 2496 0 0

0x1150000 1 64 1 64

0x1570000 1 11536 0 0

0x15a0000 26 16768 0 0

表1-4 diagnostic troubleshooting test memory overload命令显示信息描述表

字段	描述
Slot 1 recent memory usage burst records	Slot 1最近内存使用量突增事件记录，最多可记录7条
Time	内存突增事件发生的时间
Memory used (MB)	上一次采集时内存使用量和当前采集时内存使用量，单位为MB
Slot 1 top 5 memory usage processes in the last record	显示内存使用量增长最多的前5个进程的内存使用量信息
Process: scmd (jobID 1)	进程的名称为scmd（任务ID是1）
Total allocated memory	任务已使用的堆内存大小，单位为字节
Total free memory	任务可使用的堆内存大小，单位为字节
Heap usage of the job	任务对堆内存的使用情况
Tag	系统内部软件模块的编号
UsedBlocks	已使用的内存块个数
UsedBytes	已使用的内存大小，单位为字节
FreeBlocks	剩余的内存块个数
FreeBytes	剩余的内存大小，单位为字节

【命令参考】

· diagnostic monitor enable（设备管理命令参考/GOLD）

· diagnostic troubleshooting enable

1.4 AAA一键诊断命令

1.4.1 diagnostic trouble-shooting health module aaa

diagnostic trouble-shooting health module aaa命令用来为AAA模块执行一次健康度诊断。

【命令】

diagnostic trouble-shooting health module aaa

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

应用场景

本命令用来诊断AAA业务模块当前的运行状态是否健康。执行本命令后，系统会显示当前AAA模块自身的不健康信息，供用户查看。

配置准备

请先使用diagnostic troubleshooting health module aaa enable命令，开启AAA模块健康度一键诊断功能，否则，本命令执行失败。

【举例】

# 对AAA模块执行一次健康度诊断。

<Sysname> system-view

[Sysname] diagnostic trouble-shooting health module aaa

Start diagnose at 2023-03-25 08:53:55

please wait.Done.

End diagnose at 2023-03-25 08:53:56,Actual time:1 seconds.

Last system health for aaa:

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

AAA Health Records

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

PADS Type Detection time Description

AAA_RADIUS_RESOURCE_ERR2023-03-25,08:53:49 Failed to allocate PktID at packet resending.

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

Total number of records: 1

表1-5 diagnostic troubleshooting health module aaa命令显示信息描述表

字段	描述
Start diagnose at	诊断开始时间
End diagnose at	诊断结束时间
Actual time	实际诊断持续时长，单位为秒
Last system health for aaa	最近一次AAA健康度事件诊断
AAA Health Records	AAA健康度事件信息
PADS Type	健康度事件类型，取值包括： · AAA_RADIUS_RESOURCE_ERR：AAA RADIUS模块资源类错误
Detection time	健康度事件发生时间
Description	健康度事件的详细描述
Total number of records	健康度事件总数

【相关命令】

· diagnostic trouble-shooting health enable

1.4.2 diagnostic troubleshooting test aaa-fault abnormal-offline-record

diagnostic troubleshooting test aaa-fault abnormal-offline-record命令用来执行对用户异常下线的AAA错误事件进行一键诊断。

【命令】

diagnostic troubleshooting test aaa-fault online-fail-record [ access-type { ipoe | lan-access | login | portal | ppp } | domain domain-name | interface interface-type interface-number | { ip-address ipv4-address | ipv6-address ipv6-address } | mac-address mac-address | s-vlan svlan-id [ c-vlan cvlan-id ] | slot slot-number | username user-name ] *

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

access-type：显示指定用户接入类型的用户异常下线记录。

ipoe：IPoE接入用户。

lan-access：LAN接入用户。

portal：Portal接入用户。

ppp：PPP接入用户。

domain domain-name：显示指定ISP域的用户异常下线记录。domain-name表示ISP域名，为1～255个字符的字符串，不区分大小写。

interface interface-type interface-number：显示指定接口上的用户异常下线记录。interface-type interface-number表示接口类型和接口编号。

slot slot-number：显示指定单板上用户异常下线记录。slot-number为单板所在的槽位号。

ip-address ipv4-address：显示指定IPv4地址的用户异常下线记录。

ipv6-address ipv6-address：显示指定IPv6地址的用户异常下线记录。

mac-address mac-address：显示指定MAC地址的用户异常下线记录。mac-address为用户的MAC地址，格式为H-H-H。

s-vlan svlan-id：显示通过指定服务提供商VLAN上线的用户的异常下线记录。svlan-id表示VLAN ID，取值范围为1～4094。

c-vlan cvlan-id：显示通过指定用户VLAN上线的用户的异常下线记录。cvlan-id表示VLAN ID，取值范围为1～4094。

username user-name：显示指定用户名的用户异常下线记录。user-name为1～253个字符的字符串，区分大小写。

【使用指导】

应用场景

执行本命令后，设备会立刻执行display aaa abnormal-offline-record命令。管理员可以通过查看显示的接入用户异常下线历史记录，进一步定位用户异常下线的原因。

配置准备

执行本命令前，需要完成以下准备工作：

· 使用aaa abnormal-offline-record enable命令开启用户异常下线记录功能。

· 使用diagnostic troubleshooting test aaa-fault abnormal-offline-record enable命令开启用户异常下线类一键诊断功能。

注意事项

若不指定任何参数，则显示当前系统中所有接入用户的异常下线历史记录。

【举例】

# 对用户abc异常下线的AAA错误事件进行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test aaa-fault abnormal-offline-record username abc

Start diagnose at 2023-03-25 09:44:36

please wait.Done.

End diagnose at 2023-03-25 09:44:37,Actual time:1 seconds.

Username: abc

Domain: system

MAC address: -

Access type: Telnet

Access interface: -

SVLAN/CVLAN: -/-

IP address: 1.1.1.2

IPv6 address: -

Online request time: 2023/03/25 09:41:37

Offline time: 2023/03/25 09:41:43

Offline reason: User disconnected from the server.

以上显示信息的详细解释请查看“用户接入与认证命令参考/AAA”中的display aaa abnormal-offline-record。

【相关命令】

· aaa abnormal-offline-record enable（用户接入与认证命令参考/AAA）

· diagnostic troubleshooting test aaa-fault abnormal-offline-record enable

· display aaa abnormal-offline-record（用户接入与认证命令参考/AAA）

1.4.3 diagnostic troubleshooting test aaa-fault login-exception

diagnostic troubleshooting test aaa-fault login-exception命令用来对用户登录设备异常的AAA错误事件进行一键诊断。

【命令】

diagnostic troubleshooting test aaa-fault login-exception [ domain | line | local-user | role ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

domain：表示一键执行命令display domain。

line：表示一键执行命令display line。

local-user：表示一键执行命令display local-user。

role：表示一键执行命令display role。

【使用指导】

应用场景

设备启动后，如果用户采用AAA认证方式登录设备时出现如下异常现象：

· 无法登录设备。

· 登录设备失败指定次数后，一段时间内被禁止再次登录设备。

· 登录设备后，没有部分命令行的执行权限。

· 登录设备后，无法创建或修改本地用户。

请以network-admin身份登录设备，然后在设备上执行本命令查看相关的配置及显示信息，并配合AAA故障处理手册进行故障排查。

配置准备

执行本命令前，请首先使用diagnostic troubleshooting test aaa-fault login-exception enable命令开启用户登录设备异常类一键诊断功能，否则，本命令执行失败。

注意事项

若不指定任何参数，则执行本命令后，设备会立刻执行display domain、display local-user、display line、display role这四条命令。

【举例】

# 对用户登录设备异常的AAA错误事件进行一键诊断，并一键执行命令display domain。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test aaa-fault login-exception domain

Start diagnose at 2023-03-25 02:23:50

please wait.Done.

End diagnose at 2023-03-25 02:23:51,Actual time:1 seconds.

display domain info:

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

Domain: system

Current state: Active

State configuration: Active

...略...

以上显示信息的详细解释请查看“用户接入与认证命令参考/AAA”中的display domain。

【相关命令】

· diagnostic troubleshooting test aaa-fault login-exception enable

· display domain（用户接入与认证命令参考/AAA）

· display line（基础配置命令参考/登录设备）

· display local-user（用户接入与认证命令参考/AAA）

· display role（基础配置命令参考/RBAC）

1.4.4 diagnostic troubleshooting test aaa-fault online-fail-record

diagnostic troubleshooting test aaa-fault online-fail-record命令用来对用户上线失败的AAA错误事件进行一键诊断。

【命令】

diagnostic troubleshooting test aaa-fault online-fail-record [ access-type { ipoe | lan-access | login | portal | ppp } | domain domain-name

| interface interface-type interface-number | { ip-address ipv4-address | ipv6-address ipv6-address } | mac-address mac-address | s-vlan svlan-id [ c-vlan cvlan-id ] | slot slot-number | username user-name ] *

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

access-type：显示指定用户接入类型的用户上线失败记录。

ipoe：IPoE接入用户。

lan-access：LAN接入用户。

portal：Portal接入用户。

ppp：PPP接入用户。

domain domain-name：显示指定ISP域的用户上线失败记录。domain-name表示ISP域名，为1～255个字符的字符串，不区分大小写。

interface interface-type interface-number：显示指定接口上的用户上线失败记录。interface-type interface-number表示接口类型和接口编号。

slot slot-number：显示指定单板上的用户上线失败记录。slot-number为单板所在的槽位号。

ip-address ipv4-address：显示指定IPv4地址的用户上线失败记录。

ipv6-address ipv6-address：显示指定IPv6地址的用户上线失败记录。

mac-address mac-address：显示指定MAC地址的用户上线失败记录。mac-address为用户的MAC地址，格式为H-H-H。

s-vlan svlan-id：显示通过指定服务提供商VLAN上线的用户的上线失败记录。svlan-id表示VLAN ID，取值范围为1～4094。

c-vlan cvlan-id：显示通过指定用户VLAN上线的用户的上线失败记录。cvlan-id表示VLAN ID，取值范围为1～4094。

username user-name：显示指定用户名的用户上线失败记录。user-name为1～253个字符的字符串，区分大小写。

【使用指导】

应用场景

执行本命令后，设备会立刻执行display aaa online-fail-record命令。管理员可以通过查看显示的接入用户上线失败历史记录，进一步定位用户上线失败的原因。

配置准备

执行本命令前，需要完成以下准备工作：

· 使用aaa online-fail-record enable命令开启用户上线失败记录功能。

· 使用diagnostic troubleshooting test aaa-fault online-fail-record enable命令开启用户上线失败类一键诊断功能。

注意事项

若不指定任何参数，则显示当前系统中所有接入用户的上线失败历史记录。

【举例】

# 对用户telnet上线失败的AAA错误事件进行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test aaa-fault online-fail-record username telnet

Start diagnose at 2023-03-25 02:47:54

please wait.Done.

End diagnose at 2023-03-25 02:47:55,Actual time:1 seconds.

display aaa online-fail-record username telnet

Username: telnet

Domain: system

MAC address: -

Access type: Telnet

Access interface: -

SVLAN/CVLAN: -/-

IP address: 192.168.100.60

IPv6 address: -

Online request time: 2023/03/25 02:44:14

Online failure reason: The local user doesn't exist.

以上显示信息的详细解释请查看“用户接入与认证命令参考/AAA”中的display aaa online-fail-record。

【相关命令】

· aaa online-fail-record enable（用户接入与认证命令参考/AAA）

· diagnostic troubleshooting test aaa-fault online-fail-record enable

· display aaa online-fail-record（用户接入与认证命令参考/AAA）

1.4.5 diagnostic troubleshooting test aaa-fault password-control-exception

diagnostic troubleshooting test aaa-fault password-control-exception命令用来对本地用户密码控制异常的AAA错误事件进行一键诊断。

【命令】

diagnostic troubleshooting test aaa-fault password-control-exception

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

应用场景

设备上开启Password Control功能后，本地用户登录密码的设置、更新等方面将会受到Password Control策略的控制。如果设备的本地用户密码控制功能发生异常，可能会产生如下故障现象：

· 登录用户创建本地用户失败。

· 登录用户配置本地用户密码失败。

· 用户登录设备时系统要求修改密码。

为了定位此类故障现象产生的原因，则请以network-admin身份登录设备，然后在设备上执行本命令查看相关的系统运行信息以及配置信息，并配合Password Control故障处理手册进行故障排查。

执行本命令后，设备会立刻依次执行display memory-threshold、display password-control、display local-user这三条命令。

配置准备

执行本命令前，请首先使用diagnostic troubleshooting test aaa-fault password-control-exception enable命令开启本地用户密码控制异常类一键诊断功能，否则，本命令执行失败。

【举例】

# 对本地用户密码控制异常的AAA错误事件进行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test aaa-fault password-control-exception

Start diagnose at 2023-03-25 03:01:28

please wait.Done.

End diagnose at 2023-03-25 03:01:29,Actual time:1 seconds.

display memory-threshold info:

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

Free memory threshold:

Minor: 80M

Severe: 48M

Critical: 32M

Normal: 128M

Current memory state: Normal

...略...

display password-control info:

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

Password control: Disabled (device management users)

Disabled (network access users)

Password aging: Enabled (90 days)

Password length: Enabled (10 characters)

...略...

display local-user info:

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

Device management user admin:

State: Active

Service type: HTTP

User group: system

...略...

以上显示信息的详细解释请查看“设备管理命令参考/硬件资源管理”中的display memory-threshold、“用户接入与认证命令参考/Password Control”中的display password-control、“用户接入与认证命令参考/AAA”中的display local-user。

【相关命令】

· display local-user（用户接入与认证命令参考/AAA）

· display memory-threshold（设备管理命令参考/硬件资源管理）

· display password-control（用户接入与认证命令参考/Password Control）

1.4.6 diagnostic troubleshooting test aaa-process local

diagnostic troubleshooting test aaa-process local命令用来对本地认证用户上线异常的AAA处理事件执行进行一键诊断。

【命令】

diagnostic troubleshooting test aaa-process local [ interface interface-type interface-number | username user-name ] * [ diagnostic-time diagnostic-time ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

interface interface-type interface-number：指定用户上线的接口。interface-type interface-number表示接口类型和接口编号。

username user-name：指定用户名。user-name为1～253个字符的字符串，区分大小写。

diagnostic-time diagnostic-time：诊断的预计持续时间，取值范围为1～600，单位为秒，缺省值为60。诊断的实际持续时间和预计的持续时间可能不同，请以实际情况为准，但诊断的实际持续时间肯定小于等于2*diagnostic-time。

【使用指导】

应用场景

本命令用于定位AAA本地认证用户上线过程中发生异常现象的原因。执行该命令后，系统会持续采集接入用户在本地认证、本地授权、本地计费过程中发生的异常信息，并在诊断结束后打印出诊断持续时间内发生的故障现象以及详细的故障原因。

配置准备

执行本命令前，请首先使用diagnostic troubleshooting test aaa-process local enable命令开启AAA本地认证用户上线异常类一键诊断功能，否则，本命令执行失败。

注意事项

若不指定任何参数，则显示诊断持续时间内记录的所有本地认证用户上线异常的故障定位信息。

【举例】

# 对本地认证用户上线异常的AAA处理事件执行一键诊断，指定用户名为telnet、诊断预计持续时长为60秒。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test aaa-process local username telnet diagnostic-time 60

Start diagnose at 2023-03-25 03:13:27, Estimated time:60 seconds.

Please wait..............................................................Done.

End diagnose at 2023-03-25 03:14:28, Actual time:61 seconds.

Diagnosis report:

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

Datatime: 2023-03-25 03:13:37:377, Interface: N/A, Access type: telnet

User name: telnet

Reason: User not found.

Datatime: 2023-03-25 03:14:18:896, Interface: N/A, Access type: telnet

User name: telnet

Reason: User not found.

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

表1-6 diagnostic troubleshooting test aaa-process local命令显示信息描述表

字段	描述
Start diagnose at	诊断开始时间
Estimated time	预计诊断持续时长，单位为秒
End diagnose at	诊断结束时间
Actual time	实际诊断持续时长，单位为秒
Diagnosis report	诊断信息
Datatime	故障事件发生的时间
Interface	用户接入接口如果没有获得接口信息，则显示为N/A
Access type	用户接入类型： · portal：Portal用户 · ppp：PPP用户 · ipoe：IPoE普通用户 · l2tp：L2TP用户 · lan-access：LAN access用户 · dvpn：DVPN用户 · ike：IKE用户 · onu：ONU用户 · ftp：FTP用户 · pad：PAD用户 · ssh：SSH用户 · telnet：Telnet用户 · terminal：Terminal用户，例如从Console口登录设备的终端用户 · http：HTTP用户 · https：HTTPS用户 · command：命令行授权用户
User name	用户名
Reason	故障发生的原因

【相关命令】

· diagnostic troubleshooting test aaa-process local enable

1.4.7 diagnostic troubleshooting test aaa-process online-offline-record

diagnostic troubleshooting test aaa-process online-offline-record命令用来对用户上下线异常的AAA处理事件进行一键诊断。

【命令】

diagnostic troubleshooting aaa-process online-offline-record [ access-type { ipoe | lan-access | login | portal | ppp } | interface interface-type interface-number | username user-name ] * [ diagnostic-time diagnostic-time ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

access-type：显示指定用户接入类型的上线失败记录。

ipoe：IPoE接入用户。

lan-access：LAN接入用户。

portal：Portal接入用户。

ppp：PPP接入用户。

interface interface-type interface-number：指定用户上线的接口。interface-type interface-number表示接口类型和接口编号。

username user-name：指定用户名。user-name为1～253个字符的字符串，区分大小写。

【使用指导】

应用场景

本命令用于协助定位AAA认证用户上下线异常的原因。执行该命令后，系统会持续采集接入用户的上下线信息，并在诊断结束后打印出诊断持续时间内记录的用户上线失败信息以及用户下线信息。

配置准备

执行本命令前，请首先使用diagnostic troubleshooting test aaa-process online-offline-record enable命令开启用户上下线异常类一键诊断功能，否则，本命令执行失败。

注意事项

若不指定任何参数，则显示诊断持续时间内记录的所有接入用户的上线失败信息以及用户下线信息。

【举例】

# 对用户上下线异常的AAA处理事件进行一键诊断，指定用户名为telnet、诊断预计持续时长为30秒。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test aaa-process online-offline-record username telnet

Start diagnose at 2023-03-25 05:49:46, Estimated time:30 seconds.

Please wait................................Done.

End diagnose at 2023-03-25 05:50:17, Actual time:31 seconds.

Diagnosis report:

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

Datatime: 2023-03-25 05:50:00:603, Interface: N/A, Access type: login

User name: telnet

Reason: Authentication failed.

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

表1-7 diagnostic troubleshooting test aaa-process online-offline-record命令显示信息描述表

字段	描述
Start diagnose at	诊断开始时间
Estimated time	预计诊断持续时长，单位为秒
End diagnose at	诊断结束时间
Actual time	实际诊断持续时长，单位为秒
Diagnosis report	诊断信息
Datatime	故障事件发生的时间
Interface	用户接入接口如果没有获得接口信息，则显示为N/A
Access type	用户接入类型： · ppp：PPP用户 · lan-access：LAN access用户 · login：Login用户 · portal：Portal用户 · ipoe：IPoE用户
User name	用户名
Reason	故障发生的原因

【相关命令】

· diagnostic troubleshooting test aaa-process online-offline-record enable

1.4.8 diagnostic troubleshooting test aaa-process remote

diagnostic troubleshooting test aaa-process remote命令用来对远程认证用户上线异常的AAA处理事件执行进行一键诊断。

【命令】

diagnostic troubleshooting test aaa-process remote [ interface interface-type interface-number | username user-name ] * [ diagnostic-time diagnostic-time ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

interface interface-type interface-number：指定用户上线的接口。interface-type interface-number表示接口类型和接口编号。

username user-name：指定用户名。user-name为1～253个字符的字符串，区分大小写。

【使用指导】

应用场景

本命令用于定位AAA远程认证用户上线异常的原因。执行该命令后，系统会持续采集接入用户使用远程RADIUS、HWTACACS、LDAP服务器进行认证、授权、计费过程中发生的异常信息，并在诊断结束后打印出诊断持续时间内发生的故障现象以及详细的故障原因。

配置准备

执行本命令前，请首先使用diagnostic troubleshooting test aaa-process remote enable命令开启AAA本地认证用户上线异常类一键诊断功能，否则，本命令执行失败。

注意事项

若不指定任何参数，则显示诊断持续时间内记录的所有远程认证用户上线异常的故障定位信息。

【举例】

# 对远程认证用户上线异常的AAA处理事件执行一键诊断，指定用户名为abc、诊断预计持续时长为120秒。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test aaa-process remote username abc diagnostic-time 120

Start diagnose at 2023-03-25 09:01:10, Estimated time:60 seconds.

Please wait..............................Done.

End diagnose at 2023-03-25 09:01:41, Actual time:31 seconds.

Diagnosis report:

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

Datatime: 2023-03-25 09:01:33:758, Interface: N/A, Access type: TELNET

User name: abc

Reason: [RADIUS] Server unreachable.

表1-8 diagnostic troubleshooting test aaa-process remote命令显示信息描述表

字段	描述
Start diagnose at	诊断开始时间
Estimated time	预计诊断持续时长，单位为秒
End diagnose at	诊断结束时间
Actual time	实际诊断持续时长，单位为秒
Diagnosis report	诊断信息
Datatime	故障事件发生的时间
Interface	用户接入接口如果没有获得接口信息，则显示为N/A
Access tType	用户接入类型： · DVPN：DVPN用户 · FTP：FTP用户 · LAN access：LAN access用户 · PAD：PAD用户 · SSH：SSH用户 · TELNET：Telnet用户 · Terminal：Terminal用户，例如从Console口登录设备的终端用户 · Portal：Portal用户 · PPP：PPP用户 · HTTP：HTTP用户 · HTTPS：HTTPS用户 · IKE：IKE用户 · IPoE：IPoE用户 · ONU：ONU用户 · L2TP：L2TP用户 · ITA：ITA用户 · Command：命令行授权用户 · 5G：5G用户
Username	用户名
Reason	故障发生的原因

【相关命令】

· diagnostic troubleshooting test aaa-process remote enable

1.5 LDP一键诊断命令

1.5.1 diagnostic troubleshooting health module ldp

diagnostic troubleshooting health module ldp命令用来对LDP模块执行一次健康度诊断。

【命令】

diagnostic troubleshooting health module ldp

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

本命令用来诊断LDP模块当前的运行状态是否健康。执行本命令会显示模块的不健康信息，供用户查看。

请先使用diagnostic troubleshooting health module ldp enable命令，开启LDP模块健康度一键诊断功能，否则，本命令执行失败。

【举例】

# 对LDP模块执行一次健康度诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting health module ldp enable

[Sysname] diagnostic troubleshooting health module ldp

Show LDP health events:

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

Health event Detect time Description

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

RES_LABEL_ALLOC_FAIL 2022-4-20 10:01:50 Failed to alloc labels to LDP. (ErrorCode=[1] )

表1-9 diagnostic troubleshooting health module ldp命令显示信息描述表

字段	描述
Health event	健康度事件类型，取值包括： · RES_LABEL_ALLOC_FAIL：LDP申请标签段失败 · RES_LABEL_ALLOC_RESUME：LDP可用标签数量恢复
Detect time	健康度事件发生时间
Description	健康度事件的详细描述

【相关命令】

· diagnostic troubleshooting health enable

1.5.2 diagnostic troubleshooting test neighbor-create-abnormal ldp

diagnostic troubleshooting test neighbor-create-abnormal ldp命令用来对LDP会话建立异常事件进行一键诊断。

【命令】

diagnostic troubleshooting test neighbor-create-abnormal ldp { local [ vpn-instance vpn-instance-name ] peer peer-lsr-id interface interface-type interface number | remote peer peer-lsr-id } [ diagnostic-time diagnostic-time ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

local：表示LDP本地会话。

vpn-instance vpn-instance-name：指定LDP对等体所属的VPN实例。vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。如果未指定本参数，则表示LDP对等体属于公网中。

peer peer-lsr-id：指定LDP对等体的LSR ID。peer-lsr-id为LDP对等体的LSR ID。

interface-type interface-number：指定LDP本地会话的接口。interface-type interface-number为接口类型和接口编号。

remote peer peer-lsr-id：表示LDP远端会话。peer-lsr-id为LDP对等体的LSR ID。

diagnostic-time diagnostic-time：诊断的预计持续时间，取值范围为1～60，单位为秒，缺省值为30。本参数为诊断预计持续的时间，诊断实际需要的时间和该时间可能不同，请以实际情况为准，但诊断实际需要的时间肯定小于等于2*diagnostic-time。

【使用指导】

请先使用diagnostic troubleshooting test neighbor-create-abnormal ldp enable命令，开启LDP会话建立异常事件一键诊断功能，否则，本命令执行失败。

开启一键诊断功能并完成LDP配置后，LDP模块会将LDP会话建立异常的运行数据记录到GOLD模块，以便GOLD模块对LDP会话建立异常进行一键诊断。

记录LDP会话建立异常的运行数据会消耗设备资源，影响系统性能。如果用户不关心LDP模块的运行状态，可以关闭LDP会话建立异常的一键诊断功能，减少对系统性能的影响。

【举例】

# 对LDP会话建立异常事件进行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test neighbor-create-abnormal ldp enable

[Sysname] diagnostic troubleshooting test neighbor-create-abnormal ldp remote peer 2.2.2.2

Start diagnose at 2022-09-29 06:41:20, Estimated time:30 seconds.

Please wait.....................Done.

End diagnose at 2022-09-29 06:41:40, Actual time:30 seconds.

Diagnosis report:

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

PeerID Status Reason

2.2.2.2 NOT_EXISTENT No LSR-ID

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

表1-10 diagnostic troubleshooting test neighbor-create-abnormal ldp命令显示信息描述表

字段	描述
Peer ID	LDP邻居的LSR ID
Status	LDP会话状态，取值包括： · NOT_EXISTENT：会话不存在 · INITIALIZED：会话处于初始化状态 · OPEN_SENT：会话已发送Init消息，等待接收对端的Init消息 · OPEN_RECV：会话已经发送Open消息，等待接收对端的Open消息 · OPER：会话处于Up状态
Reason	LDP会话无法建立的原因，取值包括： · Device in memory-threshold：设备处于内存门限 · No LSR-ID：无可用的LSR ID · Local interface down：本地接口处于down状态 · Local interface has no IPv4 address：本地接口未配置IPv4地址 · Local interface has no MPLS capability：本地接口未开启MPLS能力 · Local interface has no LDP capability：本地接口未开启LDP能力 · No hello packet received：未收到对端发送的Hello报文 · No target peer：未配置target-peer命令

【相关命令】

· diagnostic troubleshooting enable

1.5.3 diagnostic troubleshooting test neighbor-flap ldp

diagnostic troubleshooting test neighbor-flap ldp命令用来对LDP对等体震荡事件进行一键诊断。

【命令】

diagnostic troubleshooting test neighbor-flap ldp [ [ vpn-instance vpn-instance-name ] peer peer-id ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

peer peer-lsr-id：指定LDP对等体的LSR ID。peer-lsr-id为LDP对等体的LSR ID。

【使用指导】

请先使用diagnostic troubleshooting test neighbor-flap ldp enable命令，开启LDP对等体震荡事件一键诊断功能，否则，本命令执行失败。

开启一键诊断功能并完成LDP配置后，LDP模块会将LDP对等体震荡的运行数据记录到GOLD模块，以便GOLD模块对LDP对等体震荡进行一键诊断。记录LDP对等体震荡的运行数据会消耗设备资源，影响系统性能。如果用户不关心LDP模块的运行状态，可以关闭LDP对等体震荡的一键诊断功能，减少对系统性能的影响。

【举例】

# 对地址为2.2.2.2的LDP对等体震荡事件进行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting neighbor-flap ldp enable

[Sysname] diagnostic troubleshooting neighbor-flap ldp peer 2.2.2.2

Started at: 2022-06-29 07:08:38, estimated duration: 30 seconds.

Please wait......................

Ended at: 2022-06-29 07:09:08, actual duration: 30 seconds.

Diagnosis report:

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

PeerID Down time Duration time Reason

2.2.2.2 2022-04-01 10:15:35 1h32m19s Interface not operational

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

表1-11 diagnostic troubleshooting test neighbor-flap ldp命令显示信息描述表

字段	描述
PeerID	对等体的LSR ID
Down time	震荡发生时间
Duration time	Down状态持续时间
Reason	震荡原因，取值包括： · Interface not operational：表示接口不可用 · MPLS disabled on interface：表示接口已关闭MPLS能力 · LDP disabled on interface：表示接口已关闭LDP能力 · LDP auto-configure disabled on interface：表示接口已关闭LDP自动配置功能 · VPN instance changed on interface：表示接口所属的VPN实例已更改 · LDP instance deleted：表示LDP实例已删除 · Targeted peer deleted：表示手动删除targeted peer · L2VPN disabled targeted peer：表示L2VPN注销targeted peer · TE tunnel disabled targeted peer：表示TE隧道注销targeted peer · Session protection disabled targeted peer：表示会话保护注销targeted peer · OSPF Remote LFA disabled targeted peer：表示OSPF Remote LFA注销targeted peer · IS-IS Remote LFA disabled targeted peer：表示IS-IS Remote LFA注销targeted peer · Process deactivated：表示LDP进程降级 · Failed to receive the initialization message：表示未收到初始化信息 · Graceful restart reconnect timer expired：表示GR重连定时器超时 · Failed to recover adjacency by NSR：表示NSR恢复邻接关系失败 · Failed to upgrade session by NSR：表示NSR升级会话失败 · Closed the GR session：表示GR会话关闭 · Keepalive hold timer expired：表示keepalive保持时间超时 · Hello hold timer expired：表示hello保持时间超时 · Session reset：表示重启会话 · TCP connection down：表示TCP连接断开 · Received a fatal notification message：表示收到致命的通知信息 · Internal error：表示内部错误 · Memory in critical state：表示内存达到critical状态 · Transport address changed on interface：表示接口上的传输地址更改 · MD5 password changed：表示会话MD5密码变化

1.6 MPLS TE一键诊断命令

1.6.1 diagnostic troubleshooting health module te

diagnostic troubleshooting health module te命令用来对MPLS TE模块执行一次健康度诊断。

【命令】

diagnostic troubleshooting health module te

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

本命令用来诊断MPLS TE模块当前的运行状态是否健康。执行本命令会显示模块的不健康信息，供用户查看。

请先使用diagnostic troubleshooting health module te enable命令，开启MPLS TE模块健康度一键诊断功能，否则，本命令执行失败。

【举例】

# 对MPLS TE模块执行一次健康度诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting health module te enable

[Sysname] diagnostic troubleshooting health module te

Show TE health events:

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

Health event Detect time Description

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

BSID_ALLOC_FAILED 2022-4-20 10:01:50 Tunnel 1 allocated

binding-sid label

15999 failed.

表1-12 diagnostic troubleshooting health module te命令显示信息描述表

字段	描述
Health event	健康度事件类型，取值为BSID_ALLOC_FAILED，表示MPLS TE隧道申请BSID失败
Detect time	健康度事件发生时间
Description	健康度事件的详细描述

【相关命令】

· diagnostic troubleshooting health module te enable

1.6.2 diagnostic troubleshooting test te-tunnel establish-abnormal

diagnostic troubleshooting test te-tunnel establish-abnormal命令用来执行一次MPLS TE隧道建立异常一键诊断功能。

【命令】

diagnostic troubleshooting test te-tunnel establish-abnormal tunnel tunnel-id [ diagnostic-time diagnostic-time ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

tunnel tunnel-id：对指定MPLS TE隧道执行一次隧道建立异常一键诊断功能。tunnel-id为设备上已创建的Tunnel接口的编号。

diagnostic-time diagnostic-time：诊断的预计持续时间，取值范围为10～300，单位为秒，缺省值为120。本参数为诊断预计持续的时间，诊断实际需要的时间和该时间可能不同，请以实际情况为准，但诊断实际需要的时间肯定小于等于2*diagnostic-time。

【使用指导】

请先使用diagnostic troubleshooting test te-tunnel establish-abnormal enable命令，开启MPLS TE隧道建立异常一键诊断功能，否则，本命令执行失败。

开启一键诊断功能并完成MPLS TE配置后，MPLS TE模块会将MPLS TE隧道建立异常的运行数据记录到GOLD模块，以便GOLD模块对MPLS TE隧道建立异常进行一键诊断。记录MPLS TE隧道建立异常的运行数据会消耗设备资源，影响系统性能。如果用户不关心MPLS TE模块的运行状态，可以关闭MPLS TE隧道建立异常的一键诊断功能，减少对系统性能的影响。

【举例】

# 对Tunnel ID为1的MPLS TE隧道执行一次隧道建立异常一键诊断功能。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test te-tunnel establish-abnormal enable

[Sysname] diagnostic troubleshooting test te-tunnel establish-abnormal tunnel 1

Started at: 2022-06-29 07:08:38, estimated duration: 30 seconds.

Please wait......................

Ended at: 2022-06-29 07:09:08, actual duration: 30 seconds.

Diagnosis report:

(M): Modify LSP

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

Tunnel Name: Tunnel1

Ingress LSR ID: 1.1.1.1 Egress LSR ID: 3.3.3.3

LSP type : Main Detect time: 2022-4-20 10:01:50

Reason: RSVP not configured on interface GE1/0/1 with IP address 10.1.1.1 on LSR 1.1.1.1.

LSP type : Hot-standby Detect time: 2022-4-20 10:01:52

Reason： CSPF computation failed.

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

表1-13 diagnostic troubleshooting te-tunnel establish-abnormal命令显示信息描述表

字段	描述
Tunnel Name	隧道名称
Ingress LSR ID	隧道头结点的LSR ID
Egress LSR ID	隧道尾结点的LSR ID
LSP type	LSP类型，取值包括： · Main：主路径 · Hot-standby：热备份路径 · (M)：表示MBB方式生成的LSP
Detect Time	得出诊断结果的时间
Reason	隧道建立失败原因，取值包括： · Establish success：LSP建立成功,没有异常 · The destination not configured：隧道目的地址未配置 · The MPLS LSR-ID not configured：未配置MPLS LSR ID · The MPLS TE not configured：未全局开启MPLS TE功能 · The tunnel has been shut down：隧道处于shutdown状态 · LSPM isn't running：LSP管理功能未运行 · SRM isn't running：Segment Routing管理功能未运行 · RSVP isn't running：RSVP协议未运行 · PCE isn't running：PCEP协议未运行 · No out segment of the SR label：SR首标签没有出方向 · Segment routing path compute failed：SRLSP路径计算失败 · Segment routing path verification failed：SRLSP路径校验失败 · Equal-cost backup LSP not supported：不支持等价备份路径 · Backup LSP is the same as main LSP：SRLSP主备同路 · SR path compute element not respond：SRLSP路径计算单元无响应 · Backup LSP sharing the same SRLG with the main LSP：SRLSP备份路径与主路径属于同一个SRLG · Main and backup LSPs can't be equal-cost paths：SRLSP主路径等价情况下，备路径不能建立 · SR out segment is tunnel itself：SR路径出接口包含隧道本身 · SR out segment is too deep：SR路径标签栈深度超过限制 · Modify unchanged：Modify LSP与主路径相同 · RSVP path compute failed：RSVP路径计算失败 · RSVP not configured on interface GE1/0/1 of LSR 1.1.1.1：节点上的接口没有开启RSVP能力 · RSVP signaling error(24,1) occurred on the LSR 1.1.1.1：RSVP路径建立过程中产生RSVP协议错误 · RSVP LSP can't be established with nextsid in explicit-path：RSVP信令建立的隧道不能使用显式路径方式指定下一跳标签 · RSVP downstream is not responding：RSVP路径下游设备无响应 · RSVP busy：RSVP协议繁忙，无响应 · Unreferenced to any static CRLSP or SRLSP：Static信令下未配置静态CRLSP名称Static CRLSP is down：静态CRLSP处于Down状态 · Static CRLSP busy：静态CRLSP繁忙，无响应 · LSP or tunnel BFD down：LSP关联的BFD Down · Delegated tunnel without PCE update：隧道托管给PCE，但是PCE未更新 · Minor memory-threshold：设备处于一级内存门限 · Critical memory-threshold：设备处于三级内存门限 · Unknown error：未知错误 · Backup LSP is the same as main LSP：主备同路

【相关命令】

· diagnostic troubleshooting test te-tunnel establish-abnormal enable

1.7 MPLS L2VPN一键诊断命令

1.7.1 diagnostic troubleshooting health module l2vpn

diagnostic troubleshooting health module l2vpn命令用来对MPLS L2VPN模块执行一次健康度诊断。

【命令】

diagnostic troubleshooting health module l2vpn

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

本命令用来诊断MPLS L2VPN模块当前的运行状态是否健康。执行本命令会显示模块的不健康信息，供用户查看。

请先使用diagnostic troubleshooting health module l2vpn enable命令，开启MPLS L2VPN模块健康度一键诊断功能，否则，本命令执行失败。

【举例】

# 对MPLS L2VPN模块执行一次健康度诊断。

<Sysname> system

[Sysname] diagnostic troubleshooting health module l2vpn enable

[Sysname] diagnostic troubleshooting health module l2vpn

Show L2VPN health events:

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

Health event Detect time Description

LABEL_NOT_ALLOCATED 04-15 07:37:06 ESI failed to apply for the label.

(IfName=Vpna)

LABEL_NOT_ALLOCATED 04-15 07:37:06 Upwesi failed to apply for the

label.(VsiName=Vpna,PwId=200)

LABEL_NOT_ALLOCATED 04-15 07:37:06 EVPN VPLS failed to apply for the

label.(VsiName=Vpna)

LABEL_NOT_ALLOCATED 04-15 07:37:06 EVPN VPWS failed to apply for the

label.(XcgName=Xpna)

VN_EXCEED 04-15 07:38:16 Too many VNs.(

VsiName=Vpna,IpAaddr=1.1.1.1,PwId=200)

SRV6SID_NOT_ALLOCATED 04-15 07:38:16 SRv6 SID alloc failed.(VsiName=Vpna)

CONNECT_FAIL 04-15 07:38:16 The connection between l2vpn and l3vpn

failed. (ModeName=L3vpn)

AC_VIBRATE 04-15 07:38:16 AC flapping.(Minute=10,DataNum=20,

OscillationNum=30)

PW_VIBRATE 04-15 07:38:16 PW flapping.(Minute=10,DataNum=20,

OscillationNum=30)

COMMUNICATION_FAIL 04-15 07:38:16 RIB tunnel exception.(IpAddr=

10.1.1.2)

SMOOTH_SUCCESS 04-15 07:38:16 After l2vpn and ldp are smoothed,10 pwm

data are aged.(DataType=Ldp,Uismooth=10)

SMOOTH_EXCEED 04-15 07:38:16 L2vpn timed out for 60 minutes waiting for

ldp smooth end.(DataType=Ldp)

HA_RECOVER_FAIL 04-15 07:38:16 VSI vpna link ID HA recovery failed.

表1-14 diagnostic troubleshooting health module l2vpn命令显示信息描述表

字段	描述
Diag_Type	健康度事件类型，取值包括： · LABEL_NOT_ALLOCATED：标签申请失败 · LINKID_NOT_ALLOCATED：linkid申请失败 · VN_EXCEED：VN超规格 · SRV6SID_NOT_ALLOCATED：SRv6 SID申请失败 · CONNECT_FAIL：建立连接失败 · COMMUNICATION_FAIL：通信失败 · HA_RECOVER_FAIL：从HA恢复失败 · SMOOTH_EXCEED：平滑超过60分钟 · SMOOTH_SUCCESS：平滑成功 · PW_VIBRATE：PW震荡 · AC_VIBRATE：AC震荡
Detect-Time	发现异常的时间
Description	健康度事件的详细描述

【相关命令】

· diagnostic troubleshooting health module l2vpn enable

1.7.2 diagnostic troubleshooting test l2vpn-pw establish-abnormal

diagnostic troubleshooting test l2vpn-pw establish-abnormal命令用来对PW建立失败事件进行一键诊断。

【命令】

diagnostic troubleshooting test l2vpn-pw establish-abnormal { vsi vsi-name | xconnect-group-name group-name connection connection-name } peer ip-address pw-id pw-id

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

vsi vsi-name：对指定VSI内的PW建立失败事件进行一键诊断。vsi-name表示VSI的名称，为1～31个字符的字符串，区分大小写。

xconnect-group-name group-name connection connection-name：对指定交叉连接内的PW建立失败事件进行一键诊断。group-name表示交叉连接组的名称，为1～31个字符的字符串，区分大小写；connection-name表示交叉连接的名称，为1～20个字符的字符串，不能包含字符“-”，区分大小写。

peer ip-address：指定PW远端PE的LSR ID。ip-address表示为远端PE的LSR ID。

pw-id pw-id：指定PW的PW ID。pw-id为PW的PW ID，取值范围为1～4294967295。

【使用指导】

请先使用diagnostic troubleshooting test l2vpn-pw establish-abnormal enable命令，开启PW建立失败事件一键诊断功能，否则，本命令执行失败。

开启一键诊断功能并完成MPLS L2VPN配置后，MPLS L2VPN模块会将PW建立失败的运行数据记录到GOLD模块，以便GOLD模块对PW建立失败进行一键诊断。

记录PW建立失败的运行数据会消耗设备资源，影响系统性能。如果用户不关心MPLS L2VPN模块的运行状态，可以关闭PW建立失败的一键诊断功能，减少对系统性能的影响。

【举例】

# 对VSI名称为vpna内的PW建立失败事件进行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test l2vpn-pw establish-abnormal enable

[Sysname] diagnostic troubleshooting test l2vpn-pw establish-abnormal vsi vpna peer 1.1.1.9 pw-id 1

Started at: 2022-06-29 07:08:38, estimated duration: 30 seconds.

Please wait......................

Ended at: 2022-06-29 07:09:08, actual duration: 30 seconds.

Diagnosis report:

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

Peer IP PW ID PW Type Reason(All need resolved)

1.1.1.9 1 vlan MTU not match

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

表1-15 diagnostic troubleshooting test l2vpn-pw establish-abnormal命令显示信息描述表

字段	描述
Peer IP	远端PE的IP地址
PW ID	PW的标识
PW Type	PW的数据封装类型，取值包括Ethernet、VLAN和“-”。“-”表示未指定PW的数据封装类型
Reason	PW建立失败的原因，取值包括： · BFD session for PW down：用来检测PW的BFD会话状态为down · BGP RD was deleted：BGP的RD被删除 · BGP RD was empty：未配置BGP的RD · Control word not match：PW两端控制字功能配置不一致 · Encapsulation not match：PW两端封装类型不一致 · Label not allocated：标签未分配 · LDP interface parameter not match：PW两端接口LDP协商参数不一致 · Local and remote LDP PWs have different TAIIs：本端携带的SAII与对端携带的TAII不同 · Non-existent remote LDP PW：对端设备已删除LDP PW · Local AC Down：本地AC状态为down · Local AC was non-existent：未配置本地AC · Local LDP PW VN defect：本地LDP PW存在VN缺陷 · Local LDP PW was not sent mapping message：本端未发送LDP mapping消息 · Local VSI Down：本地VSI状态为down · MTU not match：PW两端MTU不一致 · Remote AC Down：对端AC状态down · Remote LDP PW VN defect：远端LDP PW存在VN缺陷 · PW down after created：创建PW后，PW的初始状态为down · Tunnel Down：承载PW的隧道down

【相关命令】

· diagnostic troubleshooting test l2vpn-pw establish-abnormal enable

1.7.3 diagnostic troubleshooting test l2vpn-pw flap

diagnostic troubleshooting test l2vpn-pw flap命令用来对PW震荡事件进行一键诊断。

【命令】

diagnostic troubleshooting test l2vpn-pw flap { vsi vsi-name | xconnect-group-name group-name connection connection-name } peer ip-address pw-id pw-id

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

vsi vsi-name：对指定VSI内的PW震荡事件进行一键诊断。vsi-name表示VSI的名称，为1～31个字符的字符串，区分大小写。

xconnect-group-name group-name connection connection-name：对指定交叉连接内的PW震荡事件进行一键诊断。group-name表示交叉连接组的名称，为1～31个字符的字符串，区分大小写；connection-name表示交叉连接的名称，为1～20个字符的字符串，不能包含字符“-”，区分大小写。

peer ip-address：指定PW远端PE的LSR ID。ip-address表示为远端PE的LSR ID。

pw-id pw-id：指定PW的PW ID。pw-id为PW的PW ID，取值范围为1～4294967295。

【使用指导】

请先使用diagnostic troubleshooting test l2vpn-pw flap enable命令，开启PW震荡事件一键诊断功能，否则，本命令执行失败。

开启一键诊断功能并完成MPLS L2VPN配置后，MPLS L2VPN模块会将PW震荡的运行数据记录到GOLD模块，以便GOLD模块对PW震荡进行一键诊断。

记录PW震荡的运行数据会消耗设备资源，影响系统性能。如果用户不关心MPLS L2VPN模块的运行状态，可以关闭PW震荡的一键诊断功能，减少对系统性能的影响。

【举例】

# 对VSI名称为vpna内的PW震荡事件进行一键诊断。

<Sysname> system

[Sysname] diagnostic troubleshooting test l2vpn-vsi-pw flap vsi vpna peer 1.1.1.9 pw-id 1

Started at: 2022-06-29 07:08:38, estimated duration: 30 seconds.

Please wait......................

Ended at: 2022-06-29 07:09:08, actual duration: 30 seconds.

Diagnosis report:

----------------------------------------------------------------------------------------Peer IP PW ID PW type State Change time Reason

1.1.1.9 1 vlan Down->Up 2018/08/01 07:33:22 Tunnel Up

1.1.1.9 1 vlan Up->Down 2018/08/01 07:29:58 Tunnel Down

表1-16 diagnostic troubleshooting test l2vpn-pw flap命令显示信息描述表

字段	描述
Peer IP	远端PE的IP地址
PW ID	PW的标识
PW type	PW的数据封装类型，取值包括Ethernet、VLAN、Unknown和“-”。“-”表示未指定PW的数据封装类型
State	PW状态切换
Change time	PW状态切换的时间
Reason	PW震荡的原因，取值包括： · BFD session for PW down：用来检测PW的BFD会话状态为down · BGP RD was deleted：BGP的RD被删除 · BGP RD was empty：未配置BGP的RD · Control word not match：PW两端控制字功能配置不一致 · Encapsulation not match：PW两端封装类型不一致 · Label not allocated：标签未分配 · LDP interface parameter not match：PW两端接口LDP协商参数不一致 · Local and remote LDP PWs have different TAIIs：本端携带的SAII与对端携带的TAII不同 · Non-existent remote LDP PW：对端设备已删除LDP PW · Local AC Down：本地AC状态为down · Local AC was non-existent：未配置本地AC · Local LDP PW VN defect：本地LDP PW存在VN缺陷 · Local LDP PW was not sent mapping message：本端未发送LDP mapping消息 · Local VSI Down：本地VSI状态为down · MTU not match：PW两端MTU不一致 · Remote AC Down：对端AC状态down · Remote LDP PW VN defect：远端LDP PW存在VN缺陷 · PW down after created：创建PW后，PW的初始状态为down · Tunnel Down：承载PW的隧道down

【相关命令】

· diagnostic troubleshooting test l2vpn-pw flap enable

1.8 Ping一键诊断命令

1.8.1 diagnostic troubleshooting test ping failed-reason

diagnostic troubleshooting test ping failed-reason命令用来对Ping失败事件进行一键诊断。

【命令】

diagnostic troubleshooting test ping failed-reason [ -a source-ip | -f | -i interface-type interface-number | -s packet-size | -t timeout ] [ vpn-instance vpn-instance-name ] { ip-address ipv4-address | ipv6-address ipv6-address }

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

-a source-ip：指定ICMP回显请求（ECHO-REQUEST）报文的源IP地址。该地址必须是设备上已配置的IP地址。不指定该参数时，ICMP回显请求报文的源IP地址是该报文出接口的主IP地址。

-f：将长度大于出接口MTU的报文直接丢弃，即不允许对发送的ICMP回显请求报文进行分片。

-i interface-type interface-number：指定发送ICMP回显请求报文的接口的类型和编号。不指定该参数时，将根据目的IP查找路由表或者转发表来确定发送ICMP回显请求报文的接口。

-s packet-size：指定发送的ICMP回显请求报文的长度（不包括IP和ICMP报文头），取值范围为20～9600，单位为字节，缺省值为56。

-t timeout：指定ICMP回显应答（ECHO-REPLY）报文的超时时间，发送ICMP回显请求报文timeout时长后还没有收到ICMP回显应答报文，源端则认为ICMP回显应答报文超时。取值范围为0～65535，单位为毫秒，缺省值为2000。

vpn-instance vpn-instance-name：指定IP地址所属的VPN实例。vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。如果未指定本参数，则表示IP地址位于公网中。

ip-address ipv4-address：对目的地址为指定地址的IPv4 Trap报文进行一键诊断。ipv4-address表示IPv4地址。

ipv6-address ipv6-address：对目的地址为指定地址的IPv6 Trap报文进行一键诊断。ipv4-address表示IPv6地址。

【使用指导】

工作机制

执行本命令时，设备会使用命令行中指定的参数，Ping指定的IP地址，并显示Ping结果。如果Ping失败，还会显示失败原因，帮助用户定位Ping失败的问题。

Ping相关介绍请参见“网络管理和监控配置指导”中的“Ping和Tracert”。

注意事项

请先使用diagnostic troubleshooting test ping failed-reason enable命令，开启Ping失败事件一键诊断功能，否则，本命令执行失败。（Ping失败事件一键诊断功能缺省处于开启状态。）

【举例】

# 对目的地址2.1.1.1进行Ping一键诊断，Ping报文出接口为Gigabitethernet1/0/1。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test ping fail-reason –i gigabitethernet 1/0/1 ip 2.1.1.1

Diagnosis report:

Ping failed.

Failure reason: An incorrect outgoing interface was specified.

# 对目的地址1.1.1.1进行Ping一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test ping fail-reason ip-address 1.1.1.1

Diagnosis report:

Ping succeeded.

表1-17 diagnostic troubleshooting test ping fail-reason命令诊断报告描述表

字段	描述
Diagnosis report	诊断报告
Ping succeeded	Ping成功
Ping failed	Ping失败
Failure reason	Ping失败的原因，取值请参见表1-18

表1-18 Ping失败原因描述表

字段	描述
The link transmission delay is too long.	链路传输时延过长
The ping packet is too large and discarded.	Ping报文过大而被丢弃
An incorrect outgoing interface was specified.	指定了错误的出接口，出接口没有到达目的地的链路
No reachable routes exist between the source and destination IPs.	源IP和目的IP之间没有可到达的路由
The specified destination VPN is incorrect.	指定的目的端VPN不正确
No APR entry to the destination exists.	不存在到达目的端的ARP表项
No FIB entry to the destination exists.	不存在到达目的端的FIB表项
ICMP packets are discarded due to ICMP attack defense.	因为ICMP防攻击功能导致ICMP报文被丢弃
Unknown reason.	未知原因

【相关命令】

· diagnostic troubleshooting enable

1.9 SNMP一键诊断命令

1.9.1 diagnostic troubleshooting test snmp-agent packet-process-failure

diagnostic troubleshooting test snmp-agent packet-process-failure命令用来对SNMP报文处理失败事件进行一键诊断。

【命令】

diagnostic troubleshooting test snmp-agent packet-process-failure [ ip-address ipv4-address | ipv6-address ipv6-address ] [ vpn-instance vpn-instance-name ] [ diagnose-time diagnostic-time ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

ip-address ipv4-address：表示IPv4地址。对于设备收到的SNMP报文，该地址用来过滤SNMP报文的源地址；对于设备发送的SNMP报文，该地址用来过滤SNMP报文的目的地址。

ipv6-address ipv6-address：表示IPv6地址。对于设备收到的SNMP报文，该地址用来过滤SNMP报文的源地址；对于设备发送的SNMP报文，该地址用来过滤SNMP报文的目的地址。

diagnostic-time diagnostic-time：诊断的预计持续时间，取值范围为60～1800，单位为秒，缺省值为300。本参数为诊断预计持续的时间，如果业务模块在该时间内未收集到足够多的数据，则诊断实际需要的时间可能比该时间稍长，请以实际情况为准，但诊断实际需要的时间肯定小于等于2*diagnostic-time。

【使用指导】

工作机制

执行本命令后，设备会记录诊断持续时间内，SNMP发送以及接收失败的报文的信息。待诊断持续时间到达时，汇总并显示这些记录信息，帮助用户定位SNMP报文处理失败的问题。

SNMP功能的基本配置请参见“网络管理和监控配置指导”中的“SNMP”。

注意事项

请先使用diagnostic troubleshooting test snmp-agent packet-process-failure enable命令，开启SNMP报文处理失败事件一键诊断功能，否则，本命令执行失败。（SNMP报文处理失败事件一键诊断功能缺省处于开启状态。）

【举例】

# 对SNMP报文处理失败事件进行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test snmp-agent packet-process-failure ip-address 1.1.1.1

Started at: 2022-06-29 07:08:38, estimated duration: 30 seconds.

Please wait.....................

Ended at: 2022-06-29 07:09:08, actual duration: 30 seconds.

Diagnosis report:

SNMP global statistics

SNMP packets received: 4

SNMP packets sent: 4

Receiving failure detailed information:

RecvTime : 2022-06-07, 15:20:38:230

ReqID : 0

SourceIP/VPN : 10.1.1.1/--

Verison/PDU type: v3/--

FailReason : Unknown user name.

Solution : Please check the corresponding configuration.

RecvTime : 2022-06-07, 15:20:38:230

ReqID : 0

SourceIP/VPN : 10.1.1.1/--

Verison/PDU type: v3/--

FailReason : Unknown username.

Solution : Please check the corresponding configuration.

RecvTime : 2022-06-07, 15:20:38:230

ReqID : 0

SourceIP/VPN : 10.1.1.1/--

Verison/PDU type: v3/--

FailReason : Unknown username.

Solution : Please check the corresponding configuration.

Sending failure detailed information:

SendTime : 2022-06-10, 19:30:35:288

ReqID : 1683

DestIP/VPN : 10.1.1.15/vpn1

Verison/PDU type : v3/--

FailReason : SNMP PDUs had OuttooBig error-status.

Solution : Please check the corresponding configuration.

SendTime : 2022-06-10, 19:30:35:288

ReqID : 1683

DestIP/VPN : 10.1.1.15/vpn1

Verison/PDU type : v3/--

FailReason : SNMP PDUs had OuttooBig error-status.

Solution : Please check the corresponding configuration.

表1-19 diagnostic troubleshooting test snmp-agent packet-process-failure命令显示信息描述表

字段	描述
Started at: 2022-06-29 07:08:38, estimated duration: 30 seconds. Please wait..................... Ended at: 2022-06-29 07:09:08, actual duration: 30 seconds.	一键诊断开始的时间，诊断预计需要花费的时间（诊断进行中）请等待…… 一键诊断结束的时间，诊断实际花费的时间
Diagnosis report	诊断报告
SNMP global statistics	SNMP全局统计信息
SNMP packets received	诊断时间内SNMP接收到的报文数量
SNMP packets sent	诊断时间内SNMP发送出去的报文数量
Receiving failure detailed information	SNMP报文接收失败信息记录
Sending failure detailed information	SNMP报文发送失败信息记录
RecvTime	SNMP报文接收时的系统时间
SendTime	SNMP报文发送时的系统时间
ReqID	SNMP报文中携带的Request ID
SourceIP/VPN	设备接收的SNMP报文中的源IP地址/VPN信息
DestIP/VPN	设备发送的SNMP报文中的目的IP地址/VPN信息
FailReason	SNMP报文处理失败原因，取值请参见表1-20
Solution	针对该失败原因，提出的建议解决方案，取值为： Please check the corresponding configuration：请检查对应的配置

表1-20 SNMP报文处理失败原因列表

字段	描述
Unknown securitymodel	未知的安全模式
Invalid messages	无效的消息
Unknown PDU handlers	未知的报文
Unsupported security level	不支持的安全等级
Message is not in the time window	消息不在时间窗口内
Unknown username	未知的用户名
Unknown engine IDs	未知的引擎号
Wrong digests	错误的摘要信息
Decryption error	解密错误
Unsupported version	不支持的版本
ASN.1 or BER errors in the process of decoding	在解码过程中发生ASN.1（Abstract Syntax Notation dot one，抽象记法1）或BER（Basic Encoding Rules，基本编码规则）错误
Unknown SNMP community name	未知的SNMP团体名
Operation not supported by the community	团体不支持的非法操作
SNMP PDUs had an IntooBig error	SNMP报文有IntooBig错误
SNMP PDUs had an InnoSuchName error	SNMP报文有noSuchName错误
SNMP PDUs had an InBadValue error	SNMP报文有InBadValue错误
SNMP PDUs had an IngenErr error	SNMP报文有IngenErr错误
SNMP PDUs had an OuttooBig erro	SNMP报文有OuttooBig错误
SNMP PDUs had an OutnoSuchName error	SNMP报文有OutnoSuchName错误
SNMP PDUs had an OutBadValue error	SNMP报文有OutBadValue错误
SNMP PDUs had an OutgenErr error	SNMP报文有OutgenErr错误
Alternate response class PDUs dropped silently	响应报文被静默丢弃
Forwarded confirmed class PDUs dropped silently	数据转发报文被静默丢弃
Unavailable contexts	不可用的上下文内容
Unknown contexts	未知的上下文内容

【相关命令】

· diagnostic troubleshooting enable

1.9.2 diagnostic troubleshooting test snmp-agent packet-process-time

diagnostic troubleshooting test snmp-agent packet-process-time命令用来对SNMP报文处理耗时事件进行一键诊断。

【命令】

diagnostic troubleshooting test snmp-agent packet-process-time [ ip-address ipv4-address | ipv6-address ipv6-address ] [ vpn-instance vpn-instance-name ] [ diagnose-time diagnostic-time ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

ip-address ipv4-address：表示IPv4地址，收到的IPv4 SNMP报文中的源地址。

ipv6-address ipv6-address：表示IPv6地址，收到的IPv6 SNMP报文中的源地址。

diagnostic-time diagnostic-time：诊断的预计持续时间，取值范围为60～1800，单位为秒，缺省值为300。本参数为诊断预计持续的时间，诊断实际需要的时间和该时间可能不同，请以实际情况为准，但诊断实际需要的时间肯定小于等于2*diagnostic-time。

【使用指导】

工作机制

执行本命令后，设备会记录诊断持续时间内，SNMP处理每个报文需要的时间信息。待诊断持续时间到达时，汇总并显示这些记录信息，帮助用户定位SNMP报文处理耗时过长的问题。

SNMP功能的基本配置请参见“网络管理和监控配置指导”中的“SNMP”。

注意事项

请先使用diagnostic troubleshooting test snmp-agent packet-process-time enable命令，开启SNMP报文处理耗时事件一键诊断功能，否则，本命令执行失败。（SNMP报文处理耗时事件一键诊断功能缺省处于开启状态。）

【举例】

# 对SNMP报文处理耗时事件进行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting snmp-agent packet-process-time

Started at: 2022-06-29 07:08:38, estimated duration: 30 seconds.

Please wait......................

Ended at: 2022-06-29 07:09:08, actual duration: 30 seconds.

Diagnosis report:

SNMP global statistics

SNMP packets received : 2

RecvTime : 2022-06-08, 09:07:20:568

ReqID : 1121

SourceIP/VPN : 10.1.1.1/-

Version/PDU type: v2c/get-next

SNMPTime (ms) : 0

APPTime (ms) : 0

TotalTime (ms) : 0

VBNum : 3

VB : sysUpTime.0(1.3.6.1.2.1.1.3.0)=1008561, sysName.0(1.3.6.1.2.1.1.5.0)=Sysname, sysServices.0(1.3.6.1.2.1.1.7.0)=86

RecvTime : 2022-06-08, 10:25:20:568

ReqID : 1650

SourceIP/VPN : 10.1.1.5/-

Version/PDU type: v1/get-next

SnmpTime(ms) : 0

AppTime(ms) : 0

TotalTime(ms) : 0

VBNum : 3

VB : sysUpTime.0(1.3.6.1.2.1.1.3.0)=100881, sysName.0(1.3.6.1.2.1.1.5.0)=Sysname, sysServices.0(1.3.6.1.2.1.1.7.0)=65

表1-21 diagnostic troubleshooting test snmp-agent packet-process-time命令显示信息描述表

字段	描述
Started at: 2022-06-29 07:08:38, estimated duration: 30 seconds. Please wait...................... Ended at: 2022-06-29 07:09:08, actual duration: 30 seconds.	一键诊断开始的时间，诊断预计需要花费的时间（诊断进行中）请等待…… 一键诊断结束的时间，诊断实际花费的时间
Diagnosis report	诊断报告
SNMP global statistics	SNMP全局统计信息
SNMP packets received	诊断时间内SNMP接收到的报文数量
RecvTime	SNMP报文接收时的系统时间
ReqID	SNMP报文中携带的Request ID
SourceIP/VPN	SNMP报文中的源IP地址/VPN信息
Version/PDU type	SNMP报文中的版本号/操作类型
SNMPTime (ms)	SNMP插件处理耗时，单位是毫秒
APPTime (ms)	SNMP进程处理耗时，单位是毫秒
TotalTime (ms)	SNMP报文处理总耗时时间，单位是毫秒
VBNum	SNMP报文携带的绑定变量个数
VB	SNMP报文携带的绑定变量内容，最多显示8个

【相关命令】

· diagnostic troubleshooting enable

1.9.3 diagnostic troubleshooting test snmp-agent trap-send-failure

diagnostic troubleshooting test snmp-agent trap-send-failure命令用来对SNMP Trap发送失败事件进行一键诊断。

【命令】

diagnostic troubleshooting test snmp-agent trap-send-failure [ ip-address ipv4-address | ipv6-address ipv6-address ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

ip-address ipv4-address：表示IPv4地址，对目的地址为指定地址的IPv4 Trap报文进行一键诊断。

ipv6-address ipv6-address：表示IPv6地址，对目的地址为指定地址的IPv6 Trap报文进行一键诊断。

【使用指导】

工作机制

开启SNMP Trap发送失败事件一键诊断功能后，当SNMP Trap发送失败，SNMP会将Trap发送失败事件的相关信息记录下来。执行本命令时，设备会显示这些记录的信息，帮助用户定位SNMP Trap发送失败的问题。

SNMP Trap相关配置请参见“网络管理和监控配置指导”中的“SNMP”。

注意事项

请先使用diagnostic troubleshooting test snmp-agent trap-send-failure enable命令，开启SNMP Trap发送失败事件一键诊断功能，否则，本命令执行失败。（SNMP Trap发送失败事件一键诊断功能缺省处于开启状态。）

【举例】

# 查看SNMP Trap发送失败的统计信息。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test snmp-agent trap-send-failure

Trap name: coldStart

Target host:

Host 1:

IP address : 192.168.1.1

SendTime : 2022-06-08 15:50:31:296

SecurityName : abc

Version : v3

VBNum : 2

VB : sysUpTime.0=286976,snmpTrapOID.0=1.3.6.1.6.3.1.1.5.1

Host 2:

IP address : 192.168.1.35

SendTime : 2022-06-08 15:55:32:368

SecurityName : def

Version : v2c

VBNum : 2

VB : sysUpTime.0=365898, snmpTrapOID.0=1.3.6.1.6.3.1.1.5.1

Trap name : warmStart

Target host:

Host 1:

IP address : 192.168.1.1

SendTime : 2022-06-08 15:55:36:259

SecurityName : abc

Version : v2c

VBNum : 2

VB : sysUpTime.0=687682, snmpTrapOID.0=1.3.6.1.6.3.1.1.5.2

Host 2:

IP address : 192.168.1.35

SendTime : 2022-06-08 16:15:12:566

SecurityName : def

Version : v3

VBNum : 2

VB : sysUpTime.0=351528, snmpTrapOID.0=1.3.6.1.6.3.1.1.5.2

表1-22 diagnostic troubleshooting test snmp-agent trap-send-failure命令显示信息描述表

字段	描述
Trap Name	Trap的名字
Target host	接受SNMP Trap的设备的信息
Host[n]	接收Trap的目的主机的信息，n表示目的主机信息的编号
IP address	目的主机IP地址
SendTime	发送trap时的系统时间
Securityname	SNMP报文中的安全字
Version	SNMP报文中的版本号
Version/PDU type	SNMP报文中的版本号/操作类型
VBNum	SNMP报文携带的绑定变量个数
VB	SNMP报文携带的绑定变量内容，最多显示8个

【相关命令】

· diagnostic troubleshooting enable

1.10 BGP一键诊断命令

1.10.1 diagnostic troubleshooting health module bgp

diagnostic troubleshooting health module bgp命令用来为BGP模块执行一次健康度诊断。

【命令】

diagnostic troubleshooting health module bgp

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

请先使用diagnostic troubleshooting health module bgp enable命令，开启BGP模块的健康度一键诊断功能，否则，本命令执行失败。（缺省情况下，BGP模块的健康度一键诊断功能处于开启状态）

本命令用来诊断BGP模块当前的运行状态是否健康。执行本命令后，终端会显示BGP模块的不健康信息，包括不健康信息记录的时间、不健康的类型以及造成不健康的原因，供用户查看。

系统正在执行一个模块的健康度诊断时，不允许同时执行其他模块的健康度诊断。

【举例】

# 查看BGP模块的健康度信息。

<Sysname> system-view

[Sysname] diagnostic troubleshooting health module bgp

Start diagnose at 2022-11-21 08:08:44

please wait.Done.

End diagnose at 2022-11-21 08:08:45,Actual time:1 seconds.

PADS_Type Time Reason

OPEN_ERROR 01-27 20:23:30 wrong AS number(Instance=bgp1, peer=1.1.1.1, VPN

instance=vpn1)

HEADER_ERROR 01-27 20:23:30 bad message length(Instance=bgp1, peer=2.1.1.1,

VPN instance=vpn1)

表1-23 diagnostic troubleshooting health module bgp命令显示信息描述表

字段	描述
Start diagnose at 2022-11-21 08:08:44	开始健康度诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒
please wait.Done.	健康度诊断过程中的打印信息，打印该信息时请耐心等待诊断完成
End diagnose at 2022-11-21 08:08:45,Actual time:1 seconds.	结束健康度诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒，以及健康度诊断持续的实际时间
PADS_Type	模块不健康的类型，包括： · HEADER_ERROR：接收的BGP消息头错误 · OPEN_ERROR：接收的Open消息错误 · UPDATE_ERROR：接收的Update消息错误 · FSM_ERROR：BGP状态机错误 · SESSION_CEASE：BGP会话中止
Time	记录BGP模块不健康信息的时间
Reason	BGP模块不健康的原因，以及造成该原因的BGP会话信息。会话信息的格式为（Instance=instance, peer=peer, VPN instance=instance-name）。instance表示BGP会话所属BGP实例；peer表示BGP会话的对等体IP地址；instance-name表示BGP会话所属VPN实例，BGP会话处于公网时，instance-name显示为空；reason包括： · HEADER_ERROR类型对应的不健康原因： ¡ invalid Marker field：BGP消息头中的Marker字段不为全f ¡ bad message length：BGP消息头长度过长或过短 ¡ bad message type：BGP消息头的类型错误 · OPEN_ERROR类型对应的不健康原因： ¡ version unsupported：BGP版本不支持 ¡ wrong AS number：BGP对等体的AS号错误 ¡ BGP identifier conflicted：对端的Router ID与本端的Router ID相同导致冲突 ¡ unsupported optional parameter：不支持的可选参数 ¡ authentication failure：BGP会话的安全认证失败 ¡ unacceptable hold time：Open消息中携带的会话保持时间不是协商后的时间 ¡ unsupported capability type：可选参数中的capability类型不支持 · UPDATE_ERROR类型对应的不健康原因： ¡ malformed attribute list：属性列表格式错误 ¡ unrecognized well known attribute：对等体发送的Update消息中携带不支持的公认属性 ¡ well known attribute missing：对等体发送的Update消息中缺少必须的公认属性 ¡ attribute flags error：对等体发送的Update消息中携带的路由属性标志错误 ¡ attribute length error：对等体发送的Update消息中携带的路由属性长度错误 ¡ invalid NEXT HOP Attribute：对等体发送的Update消息中携带无效的下一跳属性 ¡ optional attribute error：对等体发送的Update消息中携带的可选属性错误 ¡ invalid destination network：对等体发送的Update消息中携带错误的目的网络地址 ¡ malformed AS path attribute：对等体发送的Update消息中AS路径属性的形式错误 · FSM_ERROR类型对应的不健康原因： ¡ receive unexpected message in OpenSent state：BGP会话处于OpenSent状态时，本端设备收到了不应收到的消息类型 ¡ receive unexpected message in OpenConfirm state：BGP会话处于OpenConfirm状态时，本端设备收到了不应收到的消息类型 ¡ receive unexpected message in Established state：BGP会话处于Established状态时，本端设备收到了不应收到的消息类型 · SESSION_CEASE类型对应的不健康原因： ¡ maximum number of prefixes reached：从对等体接收到的路由数量超过了可以接收的最大数量 ¡ administrative shutdown：手工复位了本端设备与BGP对等体的会话 ¡ address family deleted：BGP会话所在的地址族被删除 ¡ administrative reset：手工复位了本端设备与所有BGP对等体的会话 ¡ connection rejected：BGP会话连接被拒绝 ¡ other configuration change：其他配置变化 ¡ connection collision resolution：BGP会话连接冲突 ¡ insufficient of resources：系统资源不足

【相关命令】

· diagnostic troubleshooting health enable

1.10.2 diagnostic troubleshooting test establish-abnormal bgp

diagnostic troubleshooting test establish-abnormal bgp命令用来对指定实例下所有BGP会话建立失败事件进行一键诊断。

【命令】

diagnostic troubleshooting test establish-abnormal bgp [ instance instance-name ] [ vpn-instance vpn-instance-name ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

instance instance-name：指定的BGP实例。instance-name表示BGP实例的名称，为1～31个字符的字符串，区分大小写。如果未指定本参数，则对default实例下的BGP会话建立失败事件进行一键诊断。

vpn-instance vpn-instance-name：指定的VPN实例。vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。如果未指定本参数，则表示对公网中的BGP会话建立失败事件进行一键诊断。

【使用指导】

请先使用diagnostic troubleshooting test establish-abnormal bgp enable命令，开启BGP会话建立失败事件一键诊断功能，否则，本命令执行失败。（BGP会话建立失败事件一键诊断功能缺省处于开启状态）

BGP会话建立失败事件一键诊断功能处于开启状态时，设备会自动将BGP会话建立失败的信息记录到GOLD（Generic OnLine Diagnostics，通用在线诊断）模块的内存中。执行本命令后，设备会显示GOLD模块内存中记录的BGP会话建立失败诊断信息。诊断信息包括产生诊断信息的时间、产生诊断信息的原因等，帮助用户定位BGP会话建立失败的原因。

有关GOLD的详细介绍，请参见“网络管理和监控配置指导”中的“GOLD”。

系统正在对某一事件进行一键诊断时，不允许同时对其他事件进行一键诊断。

【举例】

# 对default实例下的所有公网对等体进行BGP会话建立失败事件一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test peer-establish-abnormal bgp

Start diagnose at 2022-11-21 08:08:44

please wait.Done.

End diagnose at 2022-11-21 08:08:45,Actual time:1 seconds.

BGP local router ID: 10.1.1.1

IPv4-family for VPN instance vpn1:

Peer Time State Reason

1.1.1.1 01-27 20:23:30 OpenConfirm memory threshold was reached

2.1.1.1 01-27 20:23:30 OpenConfirm bad message head

表1-24 diagnostic troubleshooting test peer-establish-abnormal bgp命令显示信息描述表

字段	描述
Start diagnose at 2022-11-21 08:08:44	开始一键诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒
please wait.Done.	一键诊断过程中的打印信息，打印该信息时请耐心等待诊断完成
End diagnose at 2022-11-21 08:08:45,Actual time:1 seconds.	结束一键诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒，以及一键诊断持续的实际时间
BGP local router ID	本地的路由器ID
IPv4-family for public	公网IPv4地址族下指定BGP对等体的BGP会话建立失败诊断信息
IPv6-family for public	公网IPv6地址族下指定BGP对等体的BGP会话建立失败诊断信息
IPv4-family for VPN instance vpn-instance-name	VPN实例IPv4地址族下指定BGP对等体的BGP会话建立失败诊断信息，vpn-instance-name表示VPN实例的名称
IPv6-family for VPN instance vpn-instance-name	VPN实例IPv6地址族下指定BGP对等体的BGP会话建立失败诊断信息，vpn-instance-name表示VPN实例的名称
Peer	对等体的IP地址
Time	BGP会话建立失败的时间。格式为MM-DD hh:mm:ss，其中MM为月、DD为日、hh为小时、mm为分钟、ss为秒
State	发生BGP会话建立失败事件时，BGP会话所处的状态
Reason	BGP会话建立失败的原因，包括： · router ID missing：Router ID缺失 · memory threshold was reached：系统内存达到门限 · peer limit was reached：BGP对等体的数量超过限制 · peer not exist：指定的对等体不存在 · direct EBGP session source interface check failed：不存在与直连EBGP对等体建立连接的UP状态物理接口 · source interface update failed upon TCP reconnection：重新建立TCP连接时，TCP连接的源接口更新失败 · TCP connection-socket bind failed：TCP连接绑定套接字失败 · TCP connection failed：TCP连接失败 · TCP connection info not exist：BGP会话的TCP连接信息不存在 · send buffer full：BGP会话发送缓冲区已满 · bad message head：本地设备收到无效的BGP消息头 · bad message length：本地设备接收的BGP消息长度无效 · bad message type：本地设备接收的BGP消息类型无效 · received messages not matching the FSM state：收到了与当前BGP会话状态不对应的报文 · inconsistent BGP version or holdtime：对等体的BGP版本或者会话保持时间与本端不一致 · failed to parse optional parameters in open message：BGP Open消息中的可选参数解析失败 · not enabled peer in correct address family：对等体没有在正确的地址族下使能 · inconsistent AS number：对端设备的AS号与本端指定的对等体AS号不一致 · conflicting router id：对等体的Router ID与本端设备发送冲突 · keepalive message sending failed：Keepalive消息发送失败 · failed to obtain TCP connection info in openconfirm state：在Openconfim状态下获取TCP连接的信息失败 · failed to create keepalive timer：Keepalive消息定时器创建失败

【相关命令】

· diagnostic troubleshooting enable

1.10.3 diagnostic troubleshooting test flap bgp

diagnostic troubleshooting test flap bgp命令用来对指定实例下所有BGP对等体的会话断开事件进行一键诊断。

【命令】

diagnostic troubleshooting test flap bgp [ instance instance-name ] [ vpn-instance vpn-instance-name ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

instance instance-name：指定的BGP实例。instance-name表示BGP实例的名称，为1～31个字符的字符串，区分大小写。如果未指定本参数，则对default实例下的BGP会话断开事件进行一键诊断。

vpn-instance vpn-instance-name：指定的VPN实例。vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。如果未指定本参数，则表示对公网中的BGP会话断开事件进行一键诊断。

【使用指导】

请先使用diagnostic troubleshooting test flap bgp enable命令，开启BGP会话断开事件一键诊断功能，否则，本命令执行失败。（BGP会话断开事件一键诊断功能缺省处于开启状态）

BGP会话断开事件一键诊断功能处于开启状态时，设备会自动将BGP会话断开的信息记录到GOLD（Generic OnLine Diagnostics，通用在线诊断）模块的内存中。执行本命令后，设备会显示GOLD模块内存中记录的BGP会话断开诊断信息。诊断信息包括产生诊断信息的时间、产生诊断信息的原因等，帮助用户定位BGP会话断开的原因。

有关GOLD的详细介绍，请参见“网络管理和监控配置指导”中的“GOLD”。

系统正在对某一事件进行一键诊断时，不允许同时对其他事件进行一键诊断。

【举例】

# 对default实例下所有公网BGP对等体的断开事件进行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test flap bgp

Start diagnose at 2022-11-21 08:08:44

please wait.Done.

End diagnose at 2022-11-21 08:08:45,Actual time:1 seconds.

BGP local router ID: 10.1.1.1

IPv4-family for VPN instance vpn1:

Peer Time State Reason

1.1.1.1 01-27 20:23:30 Established->Idle address family deleted

表1-25 diagnostic troubleshooting test peer-flap bgp命令显示信息描述表

字段	描述
Start diagnose at 2022-11-21 08:08:44	开始一键诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒
please wait.Done.	一键诊断过程中的打印信息，打印该信息时请耐心等待诊断完成
End diagnose at 2022-11-21 08:08:45,Actual time:1 seconds.	结束一键诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒，以及一键诊断持续的实际时间
BGP local router ID	本地的路由器ID
IPv4-family for public	公网IPv4地址族下指定BGP对等体的BGP会话建立失败诊断信息
IPv6-family for public	公网IPv6地址族下指定BGP对等体的BGP会话建立失败诊断信息
IPv4-family for VPN instance vpn-instance-name	VPN实例IPv4地址族下指定BGP对等体的BGP会话建立失败诊断信息，vpn-instance-name表示VPN实例的名称
IPv6-family for VPN instance vpn-instance-name	VPN实例IPv6地址族下指定BGP对等体的BGP会话建立失败诊断信息，vpn-instance-name表示VPN实例的名称
Peer	对等体的IP地址
Time	BGP会话断开的时间。格式为MM-DD hh:mm:ss，其中MM为月、DD为日、hh为小时、mm为分钟、ss为秒
State	BGP会话断开后，BGP会话的状态变化
Reason	BGP会话断开的原因，包括： · connection not synchronized：连接不同步，目前实现为收到的BGP消息头前16字节不全为F · bad message length：本地设备接收到的BGP消息长度无效 · bad message type：本地设备接收到的BGP消息类型无效 · withdrawn message too long：Update撤销消息的长度过长 · route attribute length too long：Update消息中携带的路由属性长度过长 · route attribute appears multiple times：同一路由属性在同一Update消息中出现了多次 · route attribute length field shorter than 2 bytes：在Update消息中，描述路由属性长度的字段不足2字节 · extended attribute length field shorter than 2 bytes：在Update消息中，路由属性的长度可扩展，但描述路由属性长度的字段不足2字节 · attribute length field shorter than 1 byte：在Update消息中，路由属性的长度为正常长度，但描述路由属性长度的字段不足1字节 · link-state attribute error：Update消息中的链路状态属性形式错误 · unrecognized well-known attribute：Update消息中携带本端不支持的公认属性 · attribute-type attribute missed：Update消息中必须携带的路由属性丢失，attribute-type表示丢失的路由属性，取值包括： ¡ ORIGIN：源属性 ¡ AS_PATH：AS路径属性 ¡ LOCAL_PREF：本地优先级属性 ¡ NEXT_HOP：下一跳属性 · attribute flags error：Update消息中携带的路由属性标志位错误 · attribute-type attribute length error：Update消息中携带的路由属性长度错误，attribute-type表示长度错误的路由属性，取值包括： ¡ AS_PATH：包含2字节AS号的AS路径属性 ¡ AS4_PATH：包含4字节AS号的AS路径属性 ¡ CLUSTER_LIST：集群ID列表属性 ¡ AGGREGATOR：包含2字节AS号的聚合者属性 ¡ AS4_AGGREGATOR：包含4字节AS号的聚合者属性 ¡ ORIGIN：源属性 ¡ NEXT_HOP：下一跳属性 ¡ MED：多出口区分属性 ¡ LOCAL_PREF：本地优先级属性 ¡ ATOMIC_AGGREGATE：原子聚合属性 ¡ ORIGINATOR_ID：起源者ID属性 ¡ MP_REACH_NLRI：多协议可达NLRI属性 ¡ COMMUNITY：团体属性 ¡ EXT-COMMUNITY：扩展团体属性 · attribute length exceeded the limit：Update消息中携带的路由属性长度超出限制 · invalid ORIGIN attribute：Update消息中携带的源属性无效 · invalid NEXT_HOP attribute：Update消息中携带的下一跳属性无效 · invalid next hop length in MP_REACH_NLRI (address-family)：在Update消息中，MP_REACH_NLRI属性的下一跳长度错误，address-family为发生下一跳长度错误的MP_REACH_NLRI属性所属的地址族，取值包括： ¡ 4u：IPv4单播地址族 ¡ MPLS：MPLS地址族 ¡ VPNv4：VPNv4地址族 ¡ 6u：IPv6单播地址族 ¡ VPNv6：VPNv6地址族 ¡ L2VPN：L2VPN地址族 · the length of MP_UNREACH_NLRI attribute is less than 3 bytes：Update消息中携带的MP_UNREACH_NLRI属性长度小于3字节 · the length of MP_REACH_NLRI or MP_UNREACH_NLRI attribute exceeds the limit：Update消息中携带的MP_REACH_NLRI 或MP_UNREACH_NLRI属性长度超过限制 · erroneous MP_REACH_NLRI or MP_UNREACH_NLRI attribute end position：Update消息中携带的MP_REACH_NLRI或MP_UNREACH_NLRI属性结束位置错误 · invalid network field：目的网络地址字段无效 · malformed AS_PATH：AS路径属性形式错误 · hold timer expiration caused by local device：由本端设备造成的会话保持定时器超时 · hold timer expiration caused by peer device：由对端设备造成的会话保持定时器超时 · connect retry timer expired：会话重建定时器超时 · TCP_CR_Acked event received：收到了TCP_CR_Acked事件 · TCP_Connection_Confirmed event received：收到了TCP_Connection_Confirmed事件 · open message received：收到Open消息 · manualstop event received：收到manualstop事件 · physical interface configuration changed：物理接口配置改变 · BFD session down event received：收到BFD会话DOWN事件，BGP也断开相应的BGP会话 · physical interface configuration changed：物理接口配置改变 · maximum number of prefixes reached：从对等体收到的路由数量超过peer route-limit命令配置的最大数量 · maximum number of prefixes reached in address-family：在指定地址族内，从对等提接收到的路由数量超过peer route-limit命令配置的最大数量，address-family为地址族名称，取值包括： ¡ IPv4 unicast：BGP IPv4单播地址族 ¡ IPv6 unicast：BGP IPv6单播地址族 ¡ VPNv4：BGP VPNv4地址族 ¡ VPNv6：BGP VPNv6地址族 ¡ The peer is configured with the peer ignore command：指定对等体配置了peer ignore命令来禁止与该对等体建立会话 · address family deleted：建立BGP会话的地址族被删除 · peer disabled：禁止本端设备与对等体交换路由信息 · administrative reset：复位BGP会话或者BGP会话相关的配置改变导致BGP会话重新建立 · connection rejected：TCP连接被对端拒绝 · other configuration change：其他对等体的配置变化导致本端设备与当前对等体的会话断开 · connection collision resolution：连接冲突 · two connections exist and one uses MD5：存在两个连接，且其中一个配置了MD5认证 · no memory to parse the attribute：解析路由属性时系统内存不足 · no memory for the route：生成路由或者标签块信息时，获取不到内存 · no memory to generate unreachable NLRI：封装不可达NLRI属性时申请不到内存 · no memory for message encapsulation：封装BGP消息时申请不到内存 · can’t get the VPN RD：解析前缀时获取不到RD · can’t get the VPN routing table：解析前缀时获取不到VPN路由表 · can’t get the attributes：解析前缀时获取不到路由属性 · entered severe memory state：进入二级门限告警 · entered critical memory state：进入三级门限告警

【相关命令】

· diagnostic troubleshooting enable

1.10.4 diagnostic troubleshooting test peer-establish-abnormal bgp

diagnostic troubleshooting test peer-establish-abnormal bgp命令用来对指定对等体的BGP会话建立失败事件进行一键诊断。

【命令】

diagnostic troubleshooting test peer-establish-abnormal bgp [ instance instance-name ] [ vpn-instance vpn-instance-name ] peer { ip-address ipv4-address | ipv6-address ipv6-address } [ diagnostic-time diagnostic-time ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

peer ip-address ipv4-address：对指定对等体的BGP会话建立失败事件进行一键诊断，ipv4-address为对等体的IPv4地址。

peer ipv6-address ipv6-address：对指定对等体的BGP会话建立失败事件进行一键诊断，ipv6-address为对等体的IPv6地址。

diagnostic-time diagnostic-time：诊断的预计持续时间，取值范围为1～60，单位为秒，缺省值为30。本参数为诊断预计持续的时间，诊断实际需要的时间和该时间可能不同，请以实际情况为准，但诊断实际需要的时间肯定小于等于2×diagnostic-time。

【使用指导】

请先使用diagnostic troubleshooting test peer-establish-abnormal bgp enable命令，开启BGP会话建立失败事件一键诊断功能，否则，本命令执行失败。（BGP会话建立失败事件一键诊断功能缺省处于开启状态）

执行本命令后，设备会在指定的诊断持续时间内，重新尝试与未能成功建立BGP会话的对等体建立连接，并记录和显示在持续时间内BGP会话建立失败的诊断信息。诊断信息包括产生诊断信息的时间、产生诊断信息的原因等，帮助用户定位BGP会话建立失败的原因。

系统正在对某一事件进行一键诊断时，不允许同时对其他事件进行一键诊断。

【举例】

# 对default实例下的公网对等体1.1.1.1进行BGP会话建立失败事件一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test peer-establish-abnormal bgp peer ip-address 1.1.1.1 diagnostic-time 20

Start diagnose at 2022-11-21 08:08:44, Estimated time:20 seconds.

please wait.....................Done.

End diagnose at 2022-11-21 08:09:05,Actual time:21 seconds.

Diagnosis report:

BGP local router ID: 10.1.1.1

IPv4-family for VPN instance vpn1:

Peer Time State Reason

1.1.1.1 01-27 20:23:30 OpenConfirm memory threshold was reached

表1-26 diagnostic troubleshooting test peer-establish-abnormal bgp peer命令显示信息描述表

字段	描述
Start diagnose at 2022-11-21 08:08:44, Estimated time:20 seconds.	开始一键诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒。以及一键诊断预计的持续时间
please wait.....Done.	一键诊断过程中的打印信息，打印该信息时请耐心等待诊断完成
End diagnose at 2022-11-21 08:08:45,Actual time:1 seconds.	结束一键诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒。以及一键诊断持续的实际时间
Diagnosis report	诊断报告
BGP local router ID	本地的路由器ID
IPv4-family for public	公网IPv4地址族下指定BGP对等体的BGP会话建立失败诊断信息
IPv6-family for public	公网IPv6地址族下指定BGP对等体的BGP会话建立失败诊断信息
IPv4-family for VPN instance vpn-instance-name	VPN实例IPv4地址族下指定BGP对等体的BGP会话建立失败诊断信息，vpn-instance-name表示VPN实例的名称
IPv6-family for VPN instance vpn-instance-name	VPN实例IPv6地址族下指定BGP对等体的BGP会话建立失败诊断信息，vpn-instance-name表示VPN实例的名称
Peer	对等体的IP地址
Time	BGP会话建立失败的时间。格式为MM-DD hh:mm:ss，其中MM为月，DD为日，hh为小时，mm为分钟，ss为秒
State	发生BGP会话建立失败事件时，BGP会话所处的状态
Reason	BGP会话建立失败的原因，包括： · router ID missing：Router ID缺失 · memory threshold was reached：系统内存达到门限 · peer limit was reached：BGP对等体的数量超过限制 · session not exist：指定的对等体不存在 · direct EBGP session source interface check failed：不存在与直连EBGP对等体建立连接的UP状态物理接口 · source interface update failed upon TCP reconnection：重新建立TCP连接时，TCP连接的源接口更新失败 · TCP connection-socket bind failed：TCP连接绑定套接字失败 · TCP connection failed：TCP连接失败 · TCP connection info not exist：BGP会话的TCP连接信息不存在 · send buffer full：BGP会话发送缓冲区已满 · bad message head：本地设备收到无效的BGP消息头 · bad message length：本地设备接收的BGP消息长度无效 · bad message type：本地设备接收的BGP消息类型无效 · received messages not matching the FSM state：收到了与当前BGP会话状态不对应的报文 · inconsistent BGP version or holdtime：对等体的BGP版本或者会话保持时间与本端不一致 · failed to parse optional parameters in open message：BGP Open消息中的可选参数解析失败 · not enabled peer in correct address family：对等体没有在正确的地址族下使能 · inconsistent AS number：对端设备的AS号与本端指定的对等体AS号不一致 · conflicting router id：对等体的Router ID与本端设备发送冲突 · keepalive message sending failed：Keepalive消息发送失败 · failed to obtain TCP connection info in openconfirm state：在Openconfim状态下获取TCP连接的信息失败 · failed to create keepalive timer：Keepalive消息定时器创建失败

【相关命令】

· diagnostic troubleshooting enable

1.10.5 diagnostic troubleshooting test peer-flap bgp

diagnostic troubleshooting test peer-flap bgp命令用来对指定BGP对等体的会话断开事件进行一键诊断。

【命令】

diagnostic troubleshooting test peer-flap bgp [ instance instance-name ] [ vpn-instance vpn-instance-name ] peer { ip-address ipv4-address | ipv6-address ipv6-address }

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

peer ip-address ipv4-address：对指定对等体的BGP会话断开事件进行一键诊断，ipv4-address为对等体的IPv4地址。

peer ipv6-address ipv6-address：对指定对等体的BGP会话断开事件进行一键诊断，ipv6-address为对等体的IPv6地址。

【使用指导】

请先使用diagnostic troubleshooting test peer-flap bgp enable命令，开启BGP会话断开事件一键诊断功能，否则，本命令执行失败。（BGP会话断开事件一键诊断功能缺省处于开启状态）

有关GOLD的详细介绍，请参见“网络管理和监控配置指导”中的“GOLD”。

系统正在对某一事件进行一键诊断时，不允许同时对其他事件进行一键诊断。

【举例】

# 对default实例下公网BGP对等体1.1.1.1进行断开事件的一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test peer-flap bgp peer ip-address 1.1.1.1

Start diagnose at 2022-11-21 08:08:44

please wait.Done.

End diagnose at 2022-11-21 08:08:45,Actual time:1 seconds.

BGP local router ID: 10.1.1.1

IPv4-family for VPN instance vpn1:

Peer Time State Reason

1.1.1.1 01-27 20:23:30 Established->Idle address family deleted

表1-27 diagnostic troubleshooting test peer-flap bgp命令显示信息描述表

字段	描述
Start diagnose at 2022-11-21 08:08:44	开始一键诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒
please wait.Done.	一键诊断过程中的打印信息，打印该信息时请耐心等待诊断完成
End diagnose at 2022-11-21 08:08:45,Actual time:1 seconds.	结束一键诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒，以及一键诊断持续的实际时间
BGP local router ID	本地的路由器ID
IPv4-family for public	公网IPv4地址族下指定BGP对等体的BGP会话建立失败诊断信息
IPv6-family for public	公网IPv6地址族下指定BGP对等体的BGP会话建立失败诊断信息
IPv4-family for VPN instance vpn-instance-name	VPN实例IPv4地址族下指定BGP对等体的BGP会话建立失败诊断信息，vpn-instance-name表示VPN实例的名称
IPv6-family for VPN instance vpn-instance-name	VPN实例IPv6地址族下指定BGP对等体的BGP会话建立失败诊断信息，vpn-instance-name表示VPN实例的名称
Peer	对等体的IP地址
Time	BGP会话断开的时间。格式为MM-DD hh:mm:ss，其中MM为月，DD为日，hh为小时，mm为分钟，ss为秒
State	BGP会话断开后，BGP会话的状态变化
Reason	BGP会话断开的原因，包括： · connection not synchronized：连接不同步，目前实现为收到的BGP消息头前16字节不全为F · bad message length：本地设备接收到的BGP消息长度无效 · bad message type：本地设备接收到的BGP消息类型无效 · withdrawn message too long：Update撤销消息的长度过长 · route attribute length too long：Update消息中携带的路由属性长度过长 · route attribute appears multiple times：同一路由属性在同一Update消息中出现了多次 · route attribute length field shorter than 2 bytes：在Update消息中，描述路由属性长度的字段不足2字节 · extended attribute length field shorter than 2 bytes：在Update消息中，路由属性的长度可扩展，但描述路由属性长度的字段不足2字节 · attribute length field shorter than 1 byte：在Update消息中，路由属性的长度为正常长度，但描述路由属性长度的字段不足1字节 · link-state attribute error：Update消息中的链路状态属性形式错误 · unrecognized well-known attribute：Update消息中携带本端不支持的公认属性 · attribute-type attribute missed：Update消息中必须携带的路由属性丢失，attribute-type表示丢失的路由属性，取值包括： ¡ ORIGIN：源属性 ¡ AS_PATH：AS路径属性 ¡ LOCAL_PREF：本地优先级属性 ¡ NEXT_HOP：下一跳属性 · attribute flags error：Update消息中携带的路由属性标志位错误 · attribute-type attribute length error：Update消息中携带的路由属性长度错误，attribute-type表示长度错误的路由属性，取值包括： ¡ AS_PATH：包含2字节AS号的AS路径属性 ¡ AS4_PATH：包含4字节AS号的AS路径属性 ¡ CLUSTER_LIST：集群ID列表属性 ¡ AGGREGATOR：包含2字节AS号的聚合者属性 ¡ AS4_AGGREGATOR：包含4字节AS号的聚合者属性 ¡ ORIGIN：源属性 ¡ NEXT_HOP：下一跳属性 ¡ MED：多出口区分属性 ¡ LOCAL_PREF：本地优先级属性 ¡ ATOMIC_AGGREGATE：原子聚合属性 ¡ ORIGINATOR_ID：起源者ID属性 ¡ MP_REACH_NLRI：多协议可达NLRI属性 ¡ COMMUNITY：团体属性 ¡ EXT-COMMUNITY：扩展团体属性 · attribute length exceeded the limit：Update消息中携带的路由属性长度超出限制 · invalid ORIGIN attribute：Update消息中携带的源属性无效 · invalid NEXT_HOP attribute：Update消息中携带的下一跳属性无效 · invalid next hop length in MP_REACH_NLRI (address-family)：在Update消息中，MP_REACH_NLRI属性的下一跳长度错误，address-family为发生下一跳长度错误的MP_REACH_NLRI属性所属的地址族，取值包括： ¡ 4u：IPv4单播地址族 ¡ MPLS：MPLS地址族 ¡ VPNv4：VPNv4地址族 ¡ 6u：IPv6单播地址族 ¡ VPNv6：VPNv6地址族 ¡ L2VPN：L2VPN地址族 · the length of MP_UNREACH_NLRI attribute is less than 3 bytes：Update消息中携带的MP_UNREACH_NLRI属性长度小于3字节 · the length of MP_REACH_NLRI or MP_UNREACH_NLRI attribute exceeds the limit：Update消息中携带的MP_REACH_NLRI 或MP_UNREACH_NLRI属性长度超过限制 · erroneous MP_REACH_NLRI or MP_UNREACH_NLRI attribute end position：Update消息中携带的MP_REACH_NLRI或MP_UNREACH_NLRI属性结束位置错误 · invalid network field：目的网络地址字段无效 · malformed AS_PATH：AS路径属性形式错误 · hold timer expiration caused by local device：由本端设备造成的会话保持定时器超时 · hold timer expiration caused by peer device：由对端设备造成的会话保持定时器超时 · connect retry timer expired：会话重建定时器超时 · TCP_CR_Acked event received：收到了TCP_CR_Acked事件 · TCP_Connection_Confirmed event received：收到了TCP_Connection_Confirmed事件 · open message received：收到Open消息 · manualstop event received：收到manualstop事件 · physical interface configuration changed：物理接口配置改变 · BFD session down event received：收到BFD会话DOWN事件，BGP也断开相应的BGP会话 · physical interface configuration changed：物理接口配置改变 · maximum number of prefixes reached：从对等体收到的路由数量超过peer route-limit命令配置的最大数量 · maximum number of prefixes reached in address-family：在指定地址族内，从对等提接收到的路由数量超过peer route-limit命令配置的最大数量，address-family为地址族名称，取值包括： ¡ IPv4 unicast：BGP IPv4单播地址族 ¡ IPv6 unicast：BGP IPv6单播地址族 ¡ VPNv4：BGP VPNv4地址族 ¡ VPNv6：BGP VPNv6地址族 ¡ The peer is configured with the peer ignore command：指定对等体配置了peer ignore命令来禁止与该对等体建立会话 · address family deleted：建立BGP会话的地址族被删除 · peer disabled：禁止本端设备与对等体交换路由信息 · administrative reset：复位BGP会话或者BGP会话相关的配置改变导致BGP会话重新建立 · connection rejected：TCP连接被对端拒绝 · other configuration change：其他对等体的配置变化导致本端设备与当前对等体的会话断开 · connection collision resolution：连接冲突 · two connections exist and one uses MD5：存在两个连接，且其中一个配置了MD5认证 · no memory to parse the attribute：解析路由属性时系统内存不足 · no memory for the route：生成路由或者标签块信息时，获取不到内存 · no memory to generate unreachable NLRI：封装不可达NLRI属性时申请不到内存 · no memory for message encapsulation：封装BGP消息时申请不到内存 · can’t get the VPN RD：解析前缀时获取不到RD · can’t get the VPN routing table：解析前缀时获取不到VPN路由表 · can’t get the attributes：解析前缀时获取不到路由属性 · entered severe memory state：进入二级门限告警 · entered critical memory state：进入三级门限告警

【相关命令】

· diagnostic troubleshooting enable

1.11 DHCP一键诊断命令

1.11.1 diagnostic troubleshooting health module dhcp

diagnostic troubleshooting health module dhcp命令用来对DHCP模块执行一次健康度诊断。

【命令】

diagnostic troubleshooting health module dhcp

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

应用场景

本命令用来诊断DHCP模块当前的运行状态是否健康。执行本命令会显示模块的不健康信息，供用户查看。

配置准备

请先使用diagnostic troubleshooting health module dhcp enable命令开启DHCP模块的健康度一键诊断功能，否则，本命令将执行失败。（DHCP模块一键诊断功能缺省处于开启状态。）

【举例】

# 对DHCP模块执行一次健康度诊断。

<Sysname> system

[Sysname] diagnostic troubleshooting health module dhcp enable

[Sysname] diagnostic troubleshooting health module dhcp

Start diagnose at 2022-12-08 10:34:40

please wait.Done.

End diagnose at 2022-12-08 10:34:41,Actual time:1 seconds.

Last system health for dhcp:

DHCP Health Records

PADS Type Detection Time Description

DHCP_CFG_ERR 11-12 06:40:56 No server configured for the relay.

表1-28 diagnostic troubleshooting health module dhcp命令输出信息描述

字段	描述
Last system health for dhcp	DHCP最近一次健康度检查
DHCP Health Records	DHCP健康度检查记录
PADS Type	健康度类型，取值包括： · DHCP_CFG_ERR · DHCP_PKT_DROP · DHCP_TBL_EXCEED · DHCP_IP_CONFLICT · DHCP_CONN_ERR
Detection Time	检测时间
Description	检测事件的详细描述： · 健康度类型为DHCP_CFG_ERR时，取值包括： ¡ No server configured for the relay：DHCP中继未配置DHCP服务器地址 ¡ No trusted ports configured for DHCP snooping：使能后未配置信任端口 ¡ No assignable network：DHCP服务器找不到对应的network ¡ No free IP address：没有可分配的地址 ¡ DHCP disabled.(AccType=access-type)：DHCP未使能 ¡ Discarded access message because of VPN mismatch.( module=access-module, pool's name=pool-name, pool's vpn=pool-vpn)：接入模块消息VPN与地址池不匹配。 ¡ Discarded access message because of invalid VPN name.( module=access-module, pool's name=pool-name, pool's vpn=pool-vpn)：接入模块消息VPN与地址池不匹配。 · 健康度类型为DHCP_PKT_DROP时，取值包括： ¡ DHCP device discarded DHCP packets because no interface was found.( Client MAC=mac-address )：找不到处理接口，设备丢弃DHCP报文 ¡ DHCP relay discarded DHCP packets because of VPN mismatch.( InterfaceVPN=vpn, PoolVPN=vpn, PoolName=pool-name ) ：DHCP中继丢弃报文因为VPN不匹配 ¡ DHCP server discarded DHCP packets because of VPN mismatch.( InterfaceVPN=vpn, PoolVPN=vpn, PoolName =pool-name )：DHCP服务器丢弃报文因为VPN匹配不上 ¡ DHCP relay discarded DHCP packets because of option acquisition failure：DHCP中继丢弃报文因为Option获取失败 ¡ DHCP relay discarded DHCP packets because VSRP state was not UP：DHCP Relay：DHCP中继丢弃报文，因为VSRP状态没有UP ¡ DHCP relay discarded DHCP packets because of invalid message type.：DHCP中继丢弃报文，因为收到不合法的消息类型 ¡ DHCP relay discarded DHCP packets because of invalid MAC.：DHCP中继丢弃报文，因为mac检查不过 ¡ DHCP relay discarded DHCP packets because of hop limit exceeding.( Hops=hops, MaxHops=max-hops )：跳数超过最大值，DHCP中继丢弃报文 ¡ DHCP relay discarded DHCP packets because the authorized address pool does not exist：指定的授权池不存在，DHCP中继丢弃报文 ¡ DHCP relay discarded DHCP packets because no server IP is configured( PoolName=pool-name, PoolVPN=pool-vpn)：DHCP中继丢弃报文，因为没有指定远端DHCP服务器 ¡ DHCP relay discarded DHCP packets because no giaddr is configured( PoolName=pool-name, PoolVPN=pool-vpn)：DHCP中继丢弃报文因为没有配置中继网关地址 ¡ DHCP relay discarded a DHCP packet because the packet was sent by itself：DHCP中继丢弃报文该报文是本中继设备发送的 ¡ DHCP relay discarded DHCP packets according to the Option 82 policy：DHCP中继根据option82策略丢弃DHCP报文 ¡ DHCP client discarded DHCP packets because of invalid FSM.( ClientMode=mode, FSM-State=FiniteStateMachine-state)：DHCP客户端丢弃报文因为状态机不对 ¡ DHCP client discarded DHCP packets because of XID mismatch.( ClientMode=mode, ClientXID=client-xid, PacketXID=packet-xid )：DHCP客户端丢弃报文，因为XID不匹配 ¡ DHCP client discarded DHCP packets because of incorrect MAC.( ClientMode=mode, HardwareAddrType=hardware-address-type, HardwareAddrLen=hardware-address-length )：DHCP客户端丢弃报文因为硬件地址类型不对 ¡ DHCP client discarded DHCP packets because of too short lease time.( ClientMode=mode, LeaseTime=lease-time, LeaseTimeMIN=lease-time-minimum )：DHCP客户端丢弃报文，因为租约时间太短 ¡ DHCP client discarded DHCP packets because of invalid server IP.( Client's server ip=client-serverip, packet's server ip=packet-serverip )：DHCP客户端丢弃报文，因为客户端保存的服务器地址和报文携带的服务器地址不一致 ¡ DHCP client discarded DHCP packets because of destination MAC mismatch.( ClientMode=mode, IfMAC ieemimetion继网关地址。 =interface-mac-address )：客户端丢弃报文因为不是自己的MAC ¡ DHCP client discarded DHCP packets because of invalid message type.：DHCP客户端收到非法类型报文丢弃。 ¡ DHCP snooping discarded DHCP packets because of MAC mismatch：DHCP Snooping报文因MAC检查丢弃 ¡ DHCP snooping discarded DHCP packets because of giaddr mismatch：DHCP Snooping报文因giaddr检查丢弃 ¡ DHCP snooping discarded DHCP packets because DHCP-REQUEST check failed：DHCP Snooping请求报文因检查不合法丢弃 ¡ DHCP snooping discarded DHCP packets because of mismatch between the port and VLAN：DHCP snooping报文因处理接口和vlan不匹配丢弃 ¡ DHCP snooping discarded DHCP packets because the input and output ports are the same：DHCP snooping报文因处理入接口和出接口相同丢弃 ¡ DHCP snooping discarded DHCP packet because the input port is not trusted.：DHCP Snooping报文因入接口不是信任口丢弃 ¡ DHCP snooping discarded DHCP packets because the input and output ports are same：DHCP Snooping报文因出入接口一致丢包 ¡ DHCP snooping discarded reply packet because of VLAN mismatch between the port and packets.：DHCP Snooping丢弃应答方向报文，因为端口VLAN和报文VLAN不匹配 ¡ DHCP server discarded BOOTP packets because of dhcp server bootp ignore is configured.( OP=operation )：DHCP 服务器丢弃Bootp报文，因为配置了bootp ignore功能 ¡ DHCP server discarded DHCP packets because of invalid message type.( MessageType=message-type )：DHCP服务器丢弃报文，因为报文类型非法 ¡ DHCP server discarded DHCP packets because of no matching network：DHCP服务器丢弃报文因为没有匹配的network ¡ DHCP server discarded DHCP packets because of mismatch between lease interface and input interface.( IP=ip-address, PoolName=pool-name, LeaseIf=lease-interface )：DHCP服务器丢弃报文因为租约接口和收包接口不一致 ¡ DHCP server discarded DHCP packets because allocate-new-ip is configured and user is online.( IP=ip-address, PoolName=pool-name, LeaseIf=lease-interface )：DHCP服务器丢弃报文，配置allocate-new-ip的情况，存在用户正在上线 ¡ DHCP server discarded DHCP packets because of option acquisition failure：DHCP server丢弃报文因为Option获取失败 ¡ DHCP server discarded DHCP packets because the address pool does not exist.：DHCP服务器因地址池不存在丢弃报文 ¡ DHCP server discarded DHCP packets because of invalid user class.：DHCP服务器因class配置不正确丢弃报文 ¡ DHCP server discarded DHCP packets because lease initialization failed：DHCP服务器租约初始化失败 ¡ DHCP server discarded DHCP packets because it failed to find a matching lease.( RequestType=request-type, IP=ip-address ).：DHCP服务器找不到对应租约 ¡ DHCP server discarded DHCP packets because of mismatch between lease interface and source interface.( IP=ip-address, PoolName=pool-name, LeaseIf=lease-interface )：DHCP服务器丢弃报文因为接口不匹配 ¡ DHCP server discarded DHCP packets because of SID mismatch.：DHCP服务器丢弃报文因为SID不匹配 ¡ DHCP server received invalid DHCP packets because of invalid request-ip option.：DHCP服务器收到非法携带了request-ip选项内容的报文 ¡ DHCP server discarded DHCP packets because of invalid request-ip option.：DHCP服务器丢弃非法携带了request-ip选项内容的报文 ¡ DHCP server discarded DHCP packets because of memory alert：DHCP服务器达到内存门限告警。 ¡ DHCP server discarded DHCP packets because lease info recovery from backup file.：DHCP服务器固化文件恢复期间不处理报文 ¡ DHCP server discarded DHCP packets because MAC check failed.：DHCP服务器检查到报文源mac和chaddr不一致。 ¡ DHCP server discarded DHCP packets because of incorrect policy configuration.( DHCPPolicy=policy-name ).：DHCP server策略配置错误。 ¡ Discarded access module message because of invalid address pool info.( PoolName=pool-name, AccType=access-type )：丢弃接入模块消息，因为地址池不合法 ¡ Discarded access module message because of VPN mismatch.( PoolName=pool-name, AccType=access-type, PoolVPN=pool-vpn )：丢弃接入模块消息，因为VPN不匹配 ¡ Discarded access module message because lease initialization failed.( AccType=access-type, PoolName=pool-name, PoolVPN=pool-vpn )：租约初始化失败 ¡ Discarded access module message because of no free ip. ( AccType=access-type, PoolName=pool-name, PoolVPN=pool-vpn )：DHCP服务器没有空闲IP地址了 ¡ DHCP server discarded access module message because of incorrect gateway configuration. ( AccType=access-type, PoolName=pool-name, PoolVPN=pool-vpn )：DHCP server丢弃接入模块消息，因为gateway配置错误 ¡ DHCP server discarded access module message because of unknown user type：DHCP服务器丢弃接入模块消息，因为收到未知的用户类型 · 健康度类型为DHCP_TBL_EXCEED时，取值包括： ¡ The number of DHCP snooping entries exceeded the threshold：DHCP Snooping保存的绑定表项数超出阈值 ¡ The number of DHCP relay entries exceeded the threshold：DHCP中继保存的Cinfo超出阈值 · 健康度类型为DHCP_IP_CONFLICT时，取值包括： ¡ The DHCP client detected an IP conflict：DHCP客户端检测到IP地址冲突 ¡ The DHCP server detected an IP conflict.( AccType=access-type, PoolName=pool-name, PoolVPN=pool-vpn, IP=ip-addres s)：DHCP服务器检测到IP地址冲突 ¡ DHCP snooping deleted the old user entry because another MAC has the same IP.( OldUserMAC=mac-address )：DHCP Snooping表项与旧表项MAC冲突 · 健康度类型为DHCP_CONN_ERR时，取值包括： ¡ DHCP client failed to allocate memory for new lease：DHCP 客户端申请租约内存失败 ¡ DHCP client failed to allocate memory for new packet received：DHCP客户端收包时，申请内存失败 ¡ DHCP client failed to send packets.( ClientMode=mode )：DHCP客户端发送报文失败 ¡ DHCP client failed to create packet resend timer.( ClientMode=mode )：DHCP客户端创建重传定时器失败。 ¡ DHCP client failed to make option：DHCP客户端构建Option失败 ¡ DHCP relay failed to create client entry.：DHCP中继创建用户表项失败 ¡ DHCP relay failed to strip option 82 from the packet：DHCP 中继剥离option82失败 ¡ DHCP relay failed to insert option 82 into the packet：DHCP中继添加Option 82失败 ¡ DHCP relay failed to allocate memory for packet sending.：DHCP中继发包申请内存失败 ¡ DHCP relay failed to allocate memory for reply packets：DHCP中继应答方向报文内存申请失败 ¡ DHCP relay failed to forward packets to server.：DHCP中继向DHCP服务器发送报文失败 ¡ DHCP relay failed to forward packets to client.：DHCP中继向DHCP客户端转发报文失败 ¡ The memory usage of the DHCP server or relay reached the threshold：DHCP服务器或中继达到内存门限阈值 ¡ The memory usage of the DHCP relay reached the threshold：DHCP中继达到内存门限阈值 ¡ The memory usage of the DHCP snooping reached the threshold：DHCP中继达到内存门限阈值 ¡ DHCP snooping discarded packets because the option 82 policy is drop：DHCP Snooping因报文携带option82丢包 ¡ DHCP snooping failed to process option 61：DHCP Snooping处理Option61失败 ¡ DHCP snooping failed to forward request packets to server：DHCP Snooping向服务器转发请求报文失败 ¡ DHCP snooping failed to send reply packets to client：DHCP Snooping发送应答方向报文失败 ¡ DHCP server failed to send packets to client：DHCP服务器向客户端发送报文失败 ¡ The memory usage of DHCP snooping reached the threshold：DHCP Snooping达到内存门限阈值 ¡ DHCP snooping received replies from untrusted port：DHCP Snooping从非信任口接收到回包 ¡ DHCP snooping failed to create and pull MBUF：创建mbuf失败 ¡ VSRP configuration changed：VSRP配置修改导致用户下线 ¡ Failed to release IP because the lease was not found: IP=ip-address：DHCP服务器未查询到相应租约，释放租约失败

【相关命令】

· diagnostic troubleshooting health enable

1.11.2 diagnostic troubleshooting test dhcp-client offline-record

diagnostic troubleshooting test dhcp-client offline-record命令用来在DHCP客户端上对DHCP用户下线事件进行一键诊断。

【命令】

diagnostic troubleshooting test dhcp-client offline-record

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

工作机制

设备作为DHCP客户端时，执行本命令后，设备会显示下线用户信息以及下线原因，帮助用户定位异常下线问题。

配置准备

请先使用diagnostic troubleshooting test dhcp-client offline-record enable命令开启DHCP客户端下线事件一键诊断功能，否则，本命令执行失败。（DHCP客户端下线事件一键诊断功能缺省处于开启状态。）

【举例】

# 在DHCP客户端上对DHCP用户下线事件进行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test dhcp-client offline-record enable

[Sysname] diagnostic troubleshooting test dhcp-client offline-record

Start diagnose at 2022-12-08 10:34:40

please wait.Done.

End diagnose at 2022-12-08 10:34:41,Actual time:1 seconds.

User offline time : 2018-11-19 11:53:26

Client identifier : 0138a8e7110302

MAC address : 38a8-e711-0302

IP address : 192.168.1.115

Interface : GigabitEthernet1/0/1

Offline reason : Interface offline

表1-29 diagnostic troubleshooting test dhcp-client offline-record命令输出信息描述

字段	描述
User offline time	用户下线时间
Client identifier	客户端ID
MAC address	DHCP客户端的MAC地址
IP address	DHCP客户端的IP地址
Interface	用户上线口。如果用户地址表项中未记录接口，则显示为“N/A”
Offline reason	DHCP客户端用户下线原因： · Lease expiration：租约到期 · ARP conflict：ARP探测冲突 · Address release：用户下线（包括接口手工配置地址） · Server decline：续约时收到NAK · Interface offline：接口离线 · Interface MAC change：接口MAC变更 · Option 61 change：Option 61配置修改 · Option 60 change：Option 60厂商标识信息被修改 · Autocfg notify to release：Autocfg通知释放

【相关命令】

· diagnostic troubleshooting enable

1.11.3 diagnostic troubleshooting test dhcp-relay online-fail-capture

diagnostic troubleshooting test dhcp-relay online-fail-capture命令在DHCP中继上对指定DHCP用户上线失败事件进行实时诊断。

【命令】

diagnostic troubleshooting test dhcp-relay online-fail-capture mac-address mac-address [ diagnostic-time diagnostic-time ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

mac-address：指定DHCP用户的MAC地址，格式为H-H-H。

diagnostic-time diagnostic-time：指定诊断时间，从配置本功能后开始计时，只会显示诊断时间内的上线失败记录。diagnostic-time表示诊断时间，整数形式，取值范围是1～600，单位为秒，缺省值为60。本参数为诊断预计持续的时间，诊断实际需要的时间和该时间可能不同，请以实际情况为准，但诊断实际需要的时间肯定小于等于2*diagnostic-time。

【使用指导】

工作机制

设备作为DHCP中继时，从执行本命令开始，设备会在诊断时间内持续收集指定DHCP用户的运行数据，显示用户上线失败原因，帮助用户定位上线失败问题。

配置准备

请先使用diagnostic troubleshooting test dhcp-relay online-fail-capture enable命令在DHCP中继上开启指定DHCP用户上线失败事件实时诊断功能，否则，本命令执行失败。（DHCP中继用户上线失败事件实时诊断功能缺省处于开启状态。）

【举例】

# 在DHCP中继上对MAC地址为00e0-fc12-3456的DHCP用户上线失败事件进行实时诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test dhcp-relay online-fail-capture enable

[Sysname] diagnostic troubleshooting test dhcp-relay online-fail-capture mac-address 0800-0485-a474

Start diagnose at 2022-12-08 11:55:49, Estimated time:60 seconds.

Please wait.............................................................Done.

End diagnose at 2022-12-08 11:56:49, Actual time:60 seconds.

User online failure time: 2022-12-08 11:57:51

MAC address : 00e0-fc12-3456

Client Identifier : 0100e0fc123456

SVLAN : 100

CVLAN : N/A

Interface : GigabitEthernet1/0/1

Online fail reason : No trust port

表1-30 diagnostic troubleshooting dhcp-relay online-fail-record命令输出信息描述

字段	描述
User online failure time	用户上线失败的时间
MAC address	用户的MAC地址
Client identifier	用户的ID
SVLAN	DHCP报文的外层VLAN，如果报文不属于某个VLAN，则显示为“N/A”
CVLAN	DHCP报文的内层VLAN，如果报文不属于某个VLAN，则显示为“N/A”
Interface	与DHCP客户端相连的三层接口。如果用户地址表项中未记录接口，则显示为“N/A”
Online fail reason	DHCP中继用户上线失败原因： · Invalid hop limit：hop-limit错误 · Failed to get DHCP server address：获取DHCP服务器地址失败 · Failed to get giaddr：获取网关失败 · Invalid MAC address：非法的MAC地址。 · The policy of Option 82 was drop：收包带有option 82且策略为drop · Option memory allocation error：选项内存申请失败。 · Option parse error：选项解析失败 · Failed to find online interface：查找上线口失败 · Receivd no DHCP-REQUEST packets：中继未收到客户端的Request报文 · Receive no DHCP-OFFER or DHCP-ACK packets：中继未收到服务器的Offer、Ack报文 · Not a VSRP master：非VSRP主 · Invalid message type：消息类型错误 · Invalid VPN：VPN不匹配 · Invalid address pool：地址池信息不对 · Failed to get remote server：获取remote server失败 · Failed to get gateway of pool：获取地址池gateway失败 · Failed to get giaddr：获取giaddr失败 · Received NAK from server.：Server应答NAK · Failed to replace server-id in proxy mode：开启代理的情况下替换ServerID失败 · Lease time too short：租约时间太短 · IP conflict：IP冲突 · Failed to send DISCOVER to server：转发DHCP-DISCOVER报文给服务器失败 · Failed to send REQUEST to server：转发DHCP-REQUEST报文给服务器失败 · Failed to send OFFER to client：转发DHCP-OFFER报文给客户端失败 · Failed to send ACK to client：转发DHCP-ACK报文给客户端失败

【相关命令】

· diagnostic troubleshooting enable

1.11.4 diagnostic troubleshooting test dhcp-relay online-fail-record

diagnostic troubleshooting test dhcp-relay online-fail-record命令用来在DHCP中继上对DHCP用户上线失败历史事件进行一键诊断。

【命令】

diagnostic troubleshooting test dhcp-relay online-fail-record

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

工作机制

设备作为DHCP中继时，执行本命令后，设备将基于历史数据进行诊断，显示所有上线失败的DHCP用户信息以及上线失败原因，帮助用户定位上线失败问题。

配置准备

请先使用diagnostic troubleshooting test dhcp-relay online-fail-record enable命令在DHCP中继上开启DHCP用户上线失败历史事件一键诊断功能，否则，本命令执行失败。（DHCP中继用户上线失败历史事件一键诊断功能缺省处于开启状态。）

【举例】

# 在DHCP中继上对DHCP用户上线失败历史事件进行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test dhcp-server online-fail-record enable

[Sysname] diagnostic troubleshooting test dhcp-relay online-fail-record

Start diagnose at 2022-12-09 07:12:26

please wait.Done.

End diagnose at 2022-12-09 07:12:27,Actual time:1 seconds.

User online failure time: 2022-09-19 10:27:51

MAC address : 00e0-fc12-3456

Client Identifier : 0100e0fc123456

SVLAN : 100

CVLAN : N/A

Interface : GigabitEthernet1/0/1

Online fail reason : Failed to get giaddr

Total number of records: 1

表1-31 diagnostic troubleshooting dhcp-relay online-fail-record命令输出信息描述

字段	描述
User online failure time	用户上线失败的时间
MAC address	用户的MAC地址
Client identifier	用户的ID
SVLAN	DHCP报文的外层VLAN，如果报文不属于某个VLAN，则显示为“N/A”
CVLAN	DHCP报文的内层VLAN，如果报文不属于某个VLAN，则显示为“N/A”
Interface	与DHCP客户端相连的三层接口。如果用户地址表项中未记录接口，则显示为“N/A”
Online fail reason	DHCP中继用户上线失败原因： · Invalid hop limit：hop-limit错误 · Failed to get DHCP server address：获取DHCP服务器地址失败 · Failed to get giaddr：获取网关失败 · Invalid MAC address：非法的MAC地址。 · The policy of Option 82 was drop：收包带有option 82且策略为drop · Option memory allocation error：选项内存申请失败。 · Option parse error：选项解析失败 · Failed to find online interface：查找上线口失败 · Receivd no DHCP-REQUEST packets：中继未收到客户端的Request报文 · Receive no DHCP-OFFER or DHCP-ACK packets：中继未收到服务器的Offer、Ack报文 · Not a VSRP master：非VSRP主 · Invalid message type：消息类型错误 · Invalid VPN：VPN不匹配 · Invalid address pool：地址池信息不对 · Failed to get remote server：获取remote server失败 · Failed to get gateway of pool：获取地址池gateway失败 · Failed to get giaddr：获取giaddr失败 · Received NAK from server.：Server应答NAK · Failed to replace server-id in proxy mode：开启代理的情况下替换ServerID失败 · Lease time too short：租约时间太短 · IP conflict：IP冲突 · Failed to send DISCOVER to server：转发DHCP-DISCOVER报文给服务器失败 · Failed to send REQUEST to server：转发DHCP-REQUEST报文给服务器失败 · Failed to send OFFER to client：转发DHCP-OFFER报文给客户端失败 · Failed to send ACK to client：转发DHCP-ACK报文给客户端失败
Total number of records	用户上线失败记录总条数

【相关命令】

· diagnostic troubleshooting enable

1.11.5 diagnostic troubleshooting test dhcp-server offline-record

diagnostic troubleshooting test dhcp-server offline-record命令用来在DHCP服务器上对DHCP用户下线事件进行一键诊断。

【命令】

diagnostic troubleshooting test dhcp-server offline-record [ abnormal | normal ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

abnormal：对DHCP用户异常下线事件进行一键诊断。

normal：对DHCP用户正常下线事件进行一键诊断。

【使用指导】

工作机制

设备作为DHCP服务器时，执行本命令后，设备会显示DHCP下线用户信息以及下线原因，帮助用户定位下线问题。

配置准备

请先使用diagnostic troubleshooting test dhcp-server offline-record enable命令在DHCP服务器上开启DHCP用户下线事件一键诊断功能，否则，本命令执行失败。（DHCP服务器用户下线事件一键诊断功能缺省处于开启状态。）

【举例】

# 在DHCP服务器上对DHCP用户下线事件进行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test dhcp-server offline-record enable

[Sysname] diagnostic troubleshooting test dhcp-server offline-record

Start diagnose at 2022-12-09 06:55:19

please wait.Done.

End diagnose at 2022-12-09 06:55:20,Actual time:1 seconds.

User offline time : 2022-09-19 10:27:51

MAC address : 00e0-fc12-3456

Client Identifier : 0100e0fc123456

SVLAN : 100

CVLAN : N/A

Interface : GigabitEthernet1/0/1

Offline reason : Lease expired

Total number of records: 1

表1-32 diagnostic troubleshooting dhcp-server offline-record命令输出信息描述

字段	描述
User offline time	用户下线的时间
MAC address	用户的MAC地址
Client identifier	用户的ID
SVLAN	DHCP报文的外层VLAN，如果报文不属于某个VLAN，则显示为“N/A”
CVLAN	DHCP报文的内层VLAN，如果报文不属于某个VLAN，则显示为“N/A”
Interface	与DHCP客户端相连的三层接口。如果用户地址表项中未记录接口，则显示为“N/A”
Offline reason	DHCP服务器用户下线原因： · The user sent DHCP-RELEASE packet actively：收到用户Release报文后删除表项（正常下线） · The user sent DHCP-DECLINE packet：收到用户Decline报文后删除表项（异常下线） · Cleared user info with the reset command：用户reset（正常下线） · Server failed to send packets to client.：发包给客户端失败 · Lease expired：租约过期 · Cleared user info after VPN deletion：VPN删除，用户下线 · Cleared user info after DHCP disabled：DHCP 去使能删除用户表项 · Cleared user info after VSRP modification：修改地址池vsrp配置删除用户 · VSRP state changed from master to down：VSRP状态从Master变成down删除用户 · VSRP state changed from backup to down：Vsrp状态从Backup变成down删除用户 · Access module notified to offline：接入模块通知用户下线 · VSRP backup received a conflicting lease：VSRP备收到冲突租约 · Force to offline the user because allow-new-ip is configured：因allow-new-ip功能踢老用户下线 · Force to offline the user because of conflict with static binding：静态绑定配置踢老用户下线 · MIB notified to release：MIB通知删除表项 · PPPOE notified to release：PPPOE通知用户下线 · The user’s ARP entry expired：响应ARP老化删除
Total number of records	用户下线记录条数

【相关命令】

· diagnostic troubleshooting enable

1.11.6 diagnostic troubleshooting test dhcp-server online-fail-capture

diagnostic troubleshooting test dhcp-server online-fail-capture命令用来在DHCP服务器上对指定DHCP用户上线失败事件进行实时诊断。

【命令】

diagnostic troubleshooting test dhcp-server online-fail-capture mac-address mac-address [ diagnostic-time diagnostic-time ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

mac-address：指定DHCP用户的MAC地址，格式为H-H-H。

【使用指导】

工作机制

设备作为DHCP服务器时，从执行本命令开始，设备会在诊断时间内持续收集指定DHCP用户的运行数据，显示用户上线失败原因，帮助用户定位上线失败问题。

配置准备

请先使用diagnostic troubleshooting test dhcp-server online-fail-capture enable命令在DHCP服务器上开启指定DHCP用户上线失败事件实时诊断功能，否则，本命令执行失败。（DHCP服务器用户上线失败事件实时诊断功能缺省处于开启状态。）

【举例】

# 在DHCP服务器上对MAC地址为00e0-fc12-3456的DHCP用户上线失败事件进行实时诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test dhcp-server online-fail-capture enable

[Sysname] diagnostic troubleshooting test dhcp-server online-fail-capture mac-address 00e0-fc12-3456

Start diagnose at 2022-12-08 11:55:49, Estimated time:60 seconds.

Please wait.............................................................Done.

End diagnose at 2022-12-08 11:56:49, Actual time:60 seconds.

User online failure time: 2022-12-08 11:57:51

MAC address : 00e0-fc12-3456

Client Identifier : 0100e0fc123456

SVLAN : 100

CVLAN : N/A

Interface : GigabitEthernet1/0/1

Online fail reason : No assignable network

表1-33 diagnostic troubleshooting test dhcp-server online-fail-capture命令输出信息描述

字段	描述
User online failure time	用户上线失败的时间
MAC address	用户的MAC地址
Client identifier	用户的ID
SVLAN	DHCP报文的外层VLAN，如果报文不属于某个VLAN，则显示为“N/A”
CVLAN	DHCP报文的内层VLAN，如果报文不属于某个VLAN，则显示为“N/A”
Interface	与DHCP客户端相连的三层接口。如果用户地址表项中未记录接口，则显示为“N/A”
Online fail reason	DHCP服务器用户上线失败原因： · No assignable network：找不到network · No free IP address：无可分配地址 · Failed to send packets：Socket发包失败 · Option memory allocation error：选项内存申请失败 · Option parse error：选项解析失败 · VPN mismatch：VPN不匹配 · Ignore BOOTP packets：配置bootp ignore功能，不处理bootp报文 · Interface mismatch：与原有用户信息接口不匹配 · Failed to obtain address pool info：获取地址池信息失败 · User class info mismatch：未匹配用户类信息 · Lease initialization failed：租约初始化失败 · Lease not found for request message：收到请求报文时没找到租约 · Insufficient memory：内存不足 · Memory threshold alert：设备进入内存门限 · Restoring lease info from backup file：正在从文件恢复租约，无法上线 · Invalid MAC address：非法MAC地址 · Failed to get server IP：获取服务器IP地址失败 · IP conflict：IP地址冲突 · Authorized user initialization failed：授权用户初始化失败 · DHCP disabled：DHCP未使能 · Invalid authorized ip：非法授权IP · Not a VSRP master：非VSRP主 · Unknown access type：未知接入类型 · Ignore dynamic lease： · Invalid address pool：地址池信息不对

【相关命令】

· diagnostic troubleshooting enable

1.11.7 diagnostic troubleshooting test dhcp-server online-fail-record

diagnostic troubleshooting test dhcp-server online-fail-record命令用来在DHCP服务器上对DHCP用户上线失败历史事件进行一键诊断。

【命令】

diagnostic troubleshooting test dhcp-server online-fail-record

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

工作机制

设备作为DHCP服务器时，执行本命令后，设备将基于历史数据进行诊断，显示所有上线失败的DHCP用户信息以及上线失败原因，帮助用户定位上线失败问题。

配置准备

请先使用diagnostic troubleshooting test dhcp-server online-fail-record enable命令在DHCP服务器上开启DHCP用户上线失败历史事件一键诊断功能，否则，本命令执行失败。（DHCP服务器用户上线失败历史事件一键诊断功能缺省处于开启状态。）

【举例】

# 在DHCP服务器上对DHCP用户上线失败历史事件进行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test dhcp-server online-fail-record enable

[Sysname] diagnostic troubleshooting test dhcp-server online-fail-record

Start diagnose at 2022-12-09 07:12:26

please wait.Done.

End diagnose at 2022-12-09 07:12:27,Actual time:1 seconds.

User online failure time: 2022-09-19 10:27:51

MAC address : 00e0-fc12-3456

Client Identifier : 0100e0fc123456

SVLAN : 100

CVLAN : N/A

Interface : GigabitEthernet1/0/1

Online fail reason : No assignable network

Total number of records: 1

表1-34 diagnostic troubleshooting test dhcp-client offline-record命令输出信息描述

字段	描述
User online failure time	用户上线失败的时间
MAC address	用户的MAC地址
Client identifier	用户的ID
SVLAN	DHCP报文的外层VLAN，如果报文不属于某个VLAN，则显示为“N/A”
CVLAN	DHCP报文的内层VLAN，如果报文不属于某个VLAN，则显示为“N/A”
Interface	与DHCP客户端相连的三层接口。如果用户地址表项中未记录接口，则显示为“N/A”
Online fail reason	DHCP服务器用户上线失败原因： · No assignable network：找不到network · No free IP address：无可分配地址 · Failed to send packets：Socket发包失败 · Option memory allocation error：选项内存申请失败。 · Option parse error：选项解析失败 · VPN mismatch：VPN不匹配 · Ignore BOOTP packets：配置bootp ignore功能，不处理bootp报文 · Interface mismatch：与原有用户信息接口不匹配 · User class info mismatch：未匹配用户类信息 · Lease initialization failed：租约初始化失败 · Lease not found for request message：收到请求报文时没找到租约 · Insufficient memory：内存不足 · Memory threshold alert：设备进入内存门限 · Restoring lease info from backup file：正在从文件恢复租约，无法上线 · Invalid MAC address：非法Mac地址 · Failed to get server IP：获取ServerIP失败 · IP conflict：IP地址冲突 · DHCP disabled：DHCP未使能 · Invalid authorized ip：非法授权IP · Not a VSRP master：非VSRP主 · Unknown access type：未知接入类型 · Invalid address pool：地址池信息不对 · Received no DHCP-REQUEST packets：未收到DHCP客户端的DHCP-REQUEST报文
Total number of records	用户上线失败记录条数

【相关命令】

· diagnostic troubleshooting enable

1.12 OSPF一键诊断命令

1.12.1 diagnostic troubleshooting test neighbor-establish-abnormal ospf

diagnostic troubleshooting test neighbor-establish-abnormal ospf命令用来对OSPF邻居关系建立异常事件进行一键诊断。

【命令】

diagnostic troubleshooting test neighbor-establish-abnormal ospf [ process-id ] [ interface interface-type interface-number ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

process-id：对指定OSPF进程邻居关系建立异常事件进行一键诊断。process-id表示OSPF进程号，取值范围为1～65535。如果未指定本参数，将对所有OSPF进程邻居关系建立异常事件进行一键诊断。

interface interface-type interface-number：对指定OSPF接口邻居关系建立异常事件进行一键诊断。interface-type interface-number为接口类型和编号。如果未指定本参数，将对所有OSPF接口邻居关系建立异常事件进行一键诊断。

【使用指导】

应用场景

OSPF邻居关系建立异常事件一键诊断功能处于开启状态的情况下，设备会自动将OSPF邻居关系建立异常的信息记录到GOLD（Generic OnLine Diagnostics，通用在线诊断）模块的内存中。执行本命令后，设备会显示GOLD模块内存中记录的邻居关系建立异常的诊断信息，其中包括产生此类信息的时间、原因等内容，帮助用户定位OSPF邻居关系建立异常的原因。

配置准备

请先使用diagnostic troubleshooting test neighbor-establish-abnormal ospf enable命令，开启OSPF邻居关系建立异常事件一键诊断功能，否则，本命令执行失败。（OSPF邻居关系建立异常事件一键诊断功能缺省处于开启状态。）

【举例】

# 对OSPF进程1的邻居关系建立异常事件进行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test neighbor-establish-abnormal ospf 1

Start diagnose at 2023-03-15 18:23:57

please wait.Done.

End diagnose at 2023-03-15 18:23:58,Actual time:1 seconds.

Diagnose report:

OSPF Process 1 with Router ID 10.1.1.1

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

Interface NBR-IP Time State

Reason

GigabitEthernet1/0/1 192.168.100.60 2023-03-15,09:28:30:511 --

Router ID conflict.

表1-35 diagnostic troubleshooting test neighbor-establish-abnormal ospf命令显示信息描述表

字段	描述
Start diagnose at 2023-03-15 18:23:57	开始健康度诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒
please wait.Done.	健康度诊断过程中的打印信息，打印该信息时请耐心等待诊断完成
End diagnose at 2023-03-15 18:23:58,Actual time:1 seconds.	结束健康度诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒，以及健康度诊断持续的实际时间
Interface	建立OSPF邻居关系的接口名称
NBR-IP	邻居的IP地址。显示为“--”表示所有运行OSPF的设备，或者所有DR
Time	检测到邻居状态发生变化的时间。格式为MM-DD hh:mm:ss，其中MM为月，DD为日，hh为小时，mm为分钟，ss为秒
State	邻居当前的状态，取值包括： · Down：表示邻居关系的初始状态 · Init：表示在邻居失效时间内收到来自邻居路由器的Hello报文，但该Hello数据包内没有包含自己的Router ID，双向通信还没有建立起来 · 2-way：表示双向通信已经建立，在从邻居路由器收到的Hello报文中看到了自己的Router ID · Exstart：表示路由器和邻居建立主/从关系、确定初始DD报文的序列号，为交换DD报文做好准备 · Exchange：表示路由器向其邻居发送描述自己LSDB的DD报文 · Loading：表示路由器向邻居发送链路状态请求报文，请求最新的LSA · Full：表示路由器与邻居路由器之间建立起完全邻接关系
Reason	建立邻居异常的原因，取值包括： · Area under reset：区域正在重启 · Router ID conflict：Hello报文Router ID与本设备冲突 · Area mismatch：Hello报文区域与本设备不一致 · Unknown virtual link：Hello报文来自未知的vlink-peer · Authentication failure：Hello报文认证检查失败 · Peer address check failure：Hello报文的邻居地址检查失败 · Not DR or BDR：Hello报文目的地址与接口DR/BDR状态不一致 · Unknown unicast peer：Hello报文来自未知的单播邻居 · Option mismatch：Hello报文Option字段不匹配 · Subnet mask mismatch：Hello报文的网络掩码不匹配 · Address mismatch：Hello报文的地址段不匹配 · Hello timer mismatch：Hello报文的Hello定时器不匹配 · Dead timer mismatch：Hello报文的Dead定时器不匹配 · Peer change：Hello报文的地址或Router ID发生变化 · FilterLSA：对发送给指定邻居的LSA进行过滤的配置发生变化，或者该配置引用的ACL规则改变导致邻居关系断开

【相关命令】

· diagnostic troubleshooting enable

1.12.2 diagnostic troubleshooting test neighbor-flap ospf

diagnostic troubleshooting test neighbor-flap ospf命令用来对OSPF邻居关系震荡事件进行一键诊断。

【命令】

diagnostic troubleshooting test neighbor-flap ospf [ process-id ] [ interface interface-type interface-number ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

process-id：对指定OSPF进程邻居关系震荡事件进行一键诊断。process-id表示OSPF进程号，取值范围为1～65535。如果未指定本参数，将对所有OSPF进程邻居关系震荡事件进行一键诊断。

interface interface-type interface-number：对指定OSPF接口邻居关系震荡事件进行一键诊断。interface-type interface-number为接口类型和编号。如果未指定本参数，将对所有OSPF接口邻居关系震荡事件进行一键诊断。

【使用指导】

应用场景

OSPF邻居关系震荡事件一键诊断功能处于开启状态的情况下，设备会自动将OSPF邻居关系震荡的信息记录到GOLD（Generic OnLine Diagnostics，通用在线诊断）模块的内存中。执行本命令后，设备会显示GOLD模块内存中记录的邻居关系震荡的诊断信息，其中包括产生此类信息的时间、原因等内容，帮助用户定位OSPF邻居关系震荡的原因。

配置准备

请先使用diagnostic troubleshooting test neighbor-flap ospf enable命令，开启OSPF邻居关系震荡事件一键诊断功能，否则，本命令执行失败。（OSPF邻居关系震荡事件一键诊断功能缺省处于开启状态。）

【举例】

# 对OSPF进程1的邻居关系震荡事件进行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test neighbor-fallback ospf 1

Start diagnose at 2023-03-15 18:34:30

please waitDone.

End diagnose at 2023-03-15 18:34:30,Actual time:0 seconds.

Diagnose report:

OSPF Process 1 with Router ID 10.1.1.1

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

Interface NBR-IP Time State

Reason

GigabitEthernet1/0/1 192.168.100.188 2023-03-15,18:23:47:869 FULL ->

INIT INIT because a 1-way hello packet was received.

GigabitEthernet1/0/1 192.168.100.61 2023-03-15,10:31:51:196 FULL ->

DOWN DOWN because the BFD session went down.

GigabitEthernet1/0/1 192.168.100.61 2023-03-15,09:38:30:511 FULL ->

EXSTART EXSTART because a SeqNumberMismatch event was triggered by the mast

er - standby relationship change .

表1-36 diagnostic troubleshooting test neighbor-fallback ospf命令显示信息描述表

字段	描述
Start diagnose at 2023-03-15 18:34:30	开始健康度诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒
please wait.Done.	健康度诊断过程中的打印信息，打印该信息时请耐心等待诊断完成
End diagnose at 2023-03-15 18:34:30,Actual time:0 seconds.	结束健康度诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒，以及健康度诊断持续的实际时间
Interface	建立邻居的接口名称
NBR-IP	邻居的Router ID
Time	检测到邻居关系震荡的时间。格式为MM-DD hh:mm:ss，其中MM为月，DD为日，hh为小时，mm为分钟，ss为秒
State	邻居关系的状态变化，取值包括： · Full->Init：Full状态回退到Init状态 · Full->Exstart：Full状态回退到Exstart状态 · Full->Down：Full状态回退到Down状态
Reason	邻居状态回退的原因，取值包括： · ResetConnect：内存不足断连接 · VlinkChange：虚连接参数改变 · ShamChange：伪连接参数改变 · AuthChange：认证类型变化 · Retrans：重传过多 · GRChange：GR能力变化 · SeqMismatch：收到SeqNumberMismatch事件 · BadLSReq：收到BadLSReq事件 · LLSChange：Link-Local Signaling能力发生变化 · DOWN because OSPF interface parameters changed：OSPF接口参数改变导致邻居关系断开 · DOWN because the OSPF process was reset：重启OSPF进程导致邻居关系断开 · DOWN because the OSPF process was deleted：删除OSPF进程导致邻居关系断开 · DOWN because the OSPF area was deleted：删除OSPF区域导致邻居关系断开 · DOWN because OSPF was disabled：关闭指定网段接口上的OSPF功能导致邻居关系断开 · DOWN because OSPF packet receiving and sending are disabled：接口禁止收发OSPF报文导致邻居关系断开 · DOWN because the interface address was deleted or OSPF was disabled on interface：删除接口地址或者在接口上关闭OSPF导致邻居关系断开 · DOWN because the interface went down or MTU changed：接口down或者接口MTU改变导致邻居关系断开 · DOWN because the virtual link was deleted or the route it relies on was deleted.：虚连接删除或者其依赖的路由删除导致邻居关系断开 · DOWN because the virtual link interface went down or the virtual link settingswere deleted：虚连接接口down或者删除虚连接配置导致邻居关系断开 · DOWN because the sham link was deleted or the route it relies on was deleted：删除伪连接或者其依赖的路由删除导致邻居关系断开 · DOWN because the dead timer expired：Dead定时器超时导致OSPF邻居关系断开 · DOWN because the stub configuration changed：Stub区域配置变化导致邻居关系断开 · DOWN because the NSSA configuration changed：NSSA区域配置变化导致邻居关系断开 · DOWN because the Opaque LSA capability configuration changed：Opaque LSA发布接收能力配置改变导致邻居关系断开 · DOWN because the out-of-band resynchronization capability configuration changed：OSPF带外同步能力配置改变导致邻居关系断开 · DOWN because the BFD session went down：BFD会话Down导致OSPF邻居关系断开。请检查BFD会话信息 · INIT because a 1-way hello packet was received：接收到1-way的Hello报文导致邻居状态变为Init · DOWN because database-filter configuration changed or database-filter ACL configuration changed：对发送给指定邻居的LSA进行过滤的配置发生变化或者该配置引用的ACL规则改变导致邻居关系断开 · EXSTART because a BadLSReq event was triggered upon the request for a nonexistent LSA：由于收到的LSR报文请求的是本地并不存在的LSA，触发了BadLSReq事件导致邻居状态变为Exstart · EXSTART because the LSA requested and then learned is the same as that in local：本端向对端请求更新一条LSA，对端回复的LSA与本端LSDB中已有的LSA相同，导致邻居状态变为Exstart · EXSTART because the LSA requested and then learned is older than that in local：本端向对端请求更新一条LSA，对端回复的LSA比本端LSDB中已有的LSA旧，导致邻居状态变为Exstart · EXSTART because a SeqNumberMismatch event was triggered upon the receipt of a non-retransmitted DD packet from the Loading or Full peer during the DD retransmit interval：邻居状态到达Loading或Full，但在DD重传时间间隔内收到了非请求重传的DD报文，触发了SeqNumberMismatch事件导致邻居状态变为Exstart · EXSTART because a SeqNumberMismatch event was triggered by the change of the OSPF peer's capability to external attribute：External Attribute位发生变化，触发了SeqNumberMismatch事件导致邻居状态变为Exstart · EXSTART because a SeqNumberMismatch event was triggered by the master-slave relationship change：与邻居交互的主从关系发生改变，触发了SeqNumberMismatch事件导致邻居关系变为Exstart · EXSTART because a SeqNumberMismatch event was triggered by the OSPF peer’s multi-topology attribute change：邻居支持多拓扑属性发生变化，触发了SeqNumberMismatch事件导致邻居状态变为Exstart · EXSTART because a SeqNumberMismatch event was triggered upon the receipt of a retransmitted DD packet from the Loading or Full peer after the DD retransmit interval expired：邻居状态到达Loading或Full，在DD重传时间间隔超时后又收到了重传的DD报文，触发了SeqNumberMismatch事件导致邻居状态改为Exstart · EXSTART because a SeqNumberMismatch event was triggered by the change of the OSPF peer’s capability to receive AS external LSA：接收到邻居发送的DD报文中的E位发生变化，触发了SeqNumberMismatch事件导致邻居状态改为Exstart · EXSTART because a SeqNumberMismatch event was triggered upon the receipt of an unexpected initial DD packet after DD transmission started：开始通过DD报文交互DB摘要的时候，收到了初始DD包，触发了SeqNumberMismatch事件导致邻居关系变为Exstart · EXSTART because a SeqNumberMismatch event was triggered upon the receipt of a DD packet with a wrong sequence number from the slave：Master收到Slave发送的序列号错误的DD报文，触发了SeqNumberMismatch事件导致邻居状态变为Exstart · EXSTART because a SeqNumberMismatch event was triggered upon the receipt of a DD packet with a wrong sequence number from the master：Slave接收到Master发送的序列号错误的DD报文中，触发了SeqNumberMismatch事件导致邻居状态变为Exstart · EXSTART because a SeqNumberMismatch event was triggered upon the receipt of a DD packet containing local opaque LSA without enabling the opaque capability：接收到的DD报文包含了Type-9 LSA，但本地未使能Opaque LSA发布接收能力，触发了SeqNumberMismatch事件导致邻居状态变为Exstart · EXSTART because a SeqNumberMismatch event was triggered upon the receipt of a DD packet containing area opaque LSA without enabling the opaque capability：接收到的DD报文包含了Type-10 LSA，但本地未使能Opaque LSA发布接收能力，触发了SeqNumberMismatch事件导致邻居关系变为Exstart · EXSTART because a SeqNumberMismatch event was triggered upon the receipt of a DD packet containing AS opaque LSA without enabling the opaque capability.：接收到的DD报文包含了Type-11 LSA，但本地未使能Opaque LSA发布接收能力，触发了SeqNumberMismatch事件导致邻居状态变为Exstart · EXSTART because a SeqNumberMismatch event was triggered upon the receipt of a DD packet containing NSSA external LSA in a non-NSSA area：在非NSSA区域收到了含有Type-7 LSA的DD报文，触发了SeqNumberMismatch事件导致邻居状态变为Exstart · EXSTART because a SeqNumberMismatch event was triggered upon the receipt of a DD packet containing invalid LSA：接收到的DD报文中含有无效LSA，触发了SeqNumberMismatch事件导致邻居状态变为Exstart · EXSTART because a SeqNumberMismatch event was triggered upon the receipt of a DD packet containing AS external LSA in the stub area or on the virtual link.：在Stub区域或虚连接上接收到了包含Type-5 LSA的DD报文，触发了SeqNumberMismatch事件导致邻居状态变为Exstart · shutdown：执行shutdown process命令关闭OSPF进程，导致OSPF邻居关系断开

【相关命令】

· diagnostic troubleshooting enable

1.13 IS-IS一键诊断命令

1.13.1 diagnostic troubleshooting test isis route

diagnostic troubleshooting test isis route命令用来对IS-IS路由变化事件进行一键诊断。

【命令】

diagnostic troubleshooting test isis route { ipv4 { add | delete | modify } [ ipv4-address mask-length ] | ipv6 { add | delete | modify } [ ipv6-address prefix-length ] } [ level-1 | level-2 ] [ process-id ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

ipv4：对IS-IS修改IPv4路由表中路由信息的事件进行一键诊断。

ipv6：对IS-IS修改IPv6路由表中路由信息的事件进行一键诊断。

add：对IS-IS向IP路由表中添加路由信息的事件进行一键诊断。

delete：对IS-IS删除IP路由表中路由信息的事件进行一键诊断。

modify：对IS-IS更新IP路由表中路由信息的事件进行一键诊断。

ipv4-address mask-length：对IS-IS修改指定IPv4地址和掩码长度的路由信息的事件进行一键诊断。mask-length取值范围为0～32。

ipv6-address prefix-length：对IS-IS修改指定IPv6地址和前缀长度的路由信息的事件进行一键诊断。prefix-length取值范围为0～128。

level-1：对IS-IS修改IP路由表中Level-1路由信息的事件进行一键诊断。

level-2：对IS-IS修改IP路由表中Level-2路由信息的事件进行一键诊断。

process-id：对指定IS-IS进程修改IP路由表中路由信息的事件进行一键诊断。process-id表示IS-IS进程号，取值范围为1～65535。如果未指定本参数，将对所有IS-IS进程修改IP路由表中路由的事件进行一键诊断。

【使用指导】

应用场景

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

配置准备

请先使用diagnostic troubleshooting test isis route enable命令，开启IS-IS路由变化事件一键诊断功能，否则，本命令执行失败。（IS-IS路由变化事件一键诊断功能缺省处于开启状态。）

【举例】

# 对所有IS-IS进程向IP路由表中添加路由信息的事件进行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test isis route ipv4 delete

Start diagnose at 2023-03-15 18:09:23

please waitDone.

End diagnose at 2023-03-15 18:09:23,Actual time:0 seconds.

Diagnose Last Routes Action for ISIS

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

DestAddr : 8.8.8.8/32 ProcessId : 1

Level : LEVEL-1 RecordTime : 2023-03-15 18:09:18:280

RouteType : Learnt Src count : 1

Nexthop : 192.168.100.188 IfName : GigabitEthernet1/0/1

NexthopType : LAN NibID : 0x14000001

Reason : LSP updated

DestAddr : 192.168.100.0/24 ProcessId : 1

Level : LEVEL-1 RecordTime : 2023-03-15 17:16:30:20

RouteType : Direct Src count : 1

Nexthop : N/A IfName : N/A

NexthopType : N/A NibID : N/A

Reason : Direct route changed

表1-37 diagnostic troubleshooting test isis route显示信息描述表

字段	描述
Start diagnose at 2023-03-15 18:09:23	开始健康度诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒
please wait.Done.	健康度诊断过程中的打印信息，打印该信息时请耐心等待诊断完成
End diagnose at 2023-03-15 18:09:23,Actual time:0 seconds.	束健康度诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒，以及健康度诊断持续的实际时间
DestAddr	路由的目的地址
ProcessId	IS-IS进程号
Level	Level类型，取值包括： · LEVEL-1 · LEVEL-2
RecordTime	路由变化的时间，格式为YYYY-MM-DD hh:mm:ss:xxx，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒、xxx为毫秒
RouteType	路由类型，取值包括： · Direct：直连路由 · Learnt：学到的路由 · Redist：引入的路由 · Summary：聚合路由 · Attached：附加路由 · Invalid：无效路由
Src count	发布源个数
Nexthop	下一跳地址
IfName	下一跳出接口
NexthopType	下一跳路由类型，取值包括： · LAN：广播网络 · P2P：点到点网络 · TETNL：TE隧道下一跳 · SRTETNL：SR-TE隧道下一跳 · ADVERTISE：转发邻接下一跳 · SRPOLICY：SRPOLICY下一跳
NibID	路由管理分配的ID，即下一跳索引
Reason	路由变化的原因，取值包括： · NextHop changed：下一跳发生变化 · DIS changed：DIS发生变化 · Interface metric changed：接口链路开销发生变化 · Interface MTR information changed：接口MTR相关信息发生变化 · SPF link changed：SPF link发送变化 · Default route changed：缺省路由发生变化 · Summary route changed：聚合路由发生变化 · TE tunnel updated：TE隧道更新 · TE tunnel metirc changed：TE隧道链路开销变化 · IPv6 mode changed：IPv6分拓扑模式发生变化 · FRR configuration changed：FRR配置变化 · Prefix priority configuration changed：前缀优先级配置变化 · Route preference changed：路由优先级配置发生变化 · ISPF configuration changed：ISPF配置发生变化 · Import filter policy changed：接收路由信息过滤策略变化 · ECMP configuration changed：等价路由条数规格配置变化 · PIC configuration changed：PIC配置发生变化 · Interface LFA exclude changed：接口不参与LFA计算配置发生变化 · ATT configuration changed：ATT配置发生变化 · GR/NSR first SPF：GR/NSR过程中第一次路由计算 · GR over：GR过程结束 · T3 timeout：T3定时器超时 · Direct route changed：直连路由变化 · Logic interface changed：逻辑接口变化 · Route leakage configuration changed：路由渗透配置变化 · NSR over：NSR过程结束 · Entered overload state：协议进入过载状态 · Exited overload state：协议退出过载状态 · Area address changed：区域地址变化 · Route policy changed：路由策略变化 · Redistributed route updated：引入路由更新 · LSP updated：LSP更新 · MT disabled：关闭IPv4和IPv6分拓扑功能 · MT enabled：开启IPv4和IPv6分拓扑功能 · TE tunnel configuration changed：TE隧道配置变化 · TE tunnel destination changed：TE隧道目的地址变化 · RIB smooth：RIB平滑 · Local SRGB changed：本地SRGB配置变化 · Neighbor's SRGB changed：邻居SRGP配置变化 · Segment Routing enalbe changed：Segment Routing功能的开启/关闭状态发生变化 · Segment Routing prefer changed：是否优先使用SRLSP转发流量的状态发生变化 · Segment Routing TI-LFA changed：SR TI-LFA快速重路由功能的开启/关闭状态发生变化 · Microloop-advoidance Rib-update-delay：防微环延时下刷路由给RIB · SRMS active policy changed：SRMS通告的SID标签映射信息发生变化 · 变化 · Remote LFA configuration changed：Remote LFA配置变化 · LDP label changed：LDP标签变化 · Remote LFA loopback address changed：Remote LFA环回地址变化 · Tiebreaker configuration changed：Tiebreaker配置发生变化 · Microloop-advoidance Sr-update-delay：SR防微环延时下刷路由 · Microloop-advoidance configuration changed：防微环配置发生变化 · Local SRLG changed：本地SRLG变化 · Segment Routing Mirror Protect changed：Mirror FRR功能的开启/关闭状态发生变化 · SRv6 Policy changed：增加、更新或删除SRv6 TE Policy · Link tag updated：链路标记继承功能配置变化 · Flex algo changed：灵活算法快速重路由功能或TI-LFA的开启/关闭状态发生变化

【相关命令】

· diagnostic troubleshooting enable

1.13.2 diagnostic troubleshooting test neighbor-establish-abnormal isis

diagnostic troubleshooting test neighbor-establish-abnormal isis命令用来对IS-IS邻居关系建立异常事件进行一键诊断。

【命令】

diagnostic troubleshooting test neighbor-establish-abnormal isis [ process-id ] [ interface interface-type interface-number ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

process-id：对指定IS-IS进程邻居关系建立异常事件进行一键诊断。process-id表示IS-IS进程号，取值范围为1～65535。如果未指定本参数，将对所有IS-IS进程邻居关系建立异常事件进行一键诊断。

interface interface-type interface-number：对指定IS-IS接口邻居关系建立异常事件进行一键诊断。interface-type interface-number为接口类型和编号。如果未指定本参数，将对所有IS-IS接口邻居关系建立异常事件进行一键诊断。

【使用指导】

应用场景

IS-IS邻居关系建立异常事件一键诊断功能处于开启状态的情况下，设备会自动将IS-IS邻居建立异常的信息记录到GOLD（Generic OnLine Diagnostics，通用在线诊断）模块的内存中。执行本命令后，设备会显示GOLD模块内存中记录的邻居建立异常的诊断信息，其中包括产生此类信息的时间、原因等内容，帮助用户定位IS-IS邻居建立异常的原因。

配置准备

请先使用diagnostic troubleshooting test neighbor-establish-abnormal isis enable命令，开启IS-IS邻居关系建立异常事件一键诊断功能，否则，本命令执行失败。（IS-IS邻居关系建立异常事件一键诊断功能缺省处于开启状态。）

【举例】

# 对所有IS-IS进程邻居关系建立异常事件进行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test neighbor-establish-abnormal isis

Start diagnose at 2023-03-15 17:23:16

please wait.Done.

End diagnose at 2023-03-15 17:23:17,Actual time:1 seconds.

Diagnose information for IS-IS(1)

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

Interface NbrSystemID type Nbr-Change-Time State Reason

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

GigabitEthernet1/0/1 0000.0000.0088 L2 03-15 17:23:30 Up->Init A hello pack

et without S

NPA address

was received

表1-38 diagnostic troubleshooting test neighbor-establish-abnormal isis显示信息描述表

字段	描述
Start diagnose at 2023-03-15 17:23:16	开始健康度诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒
please wait.Done.	健康度诊断过程中的打印信息，打印该信息时请耐心等待诊断完成
End diagnose at 2023-03-15 17:23:17,Actual time:1 seconds.	束健康度诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒，以及健康度诊断持续的实际时间
Interface	接口类型和接口编号
NbrSystemID	邻居SystemID
type	Level类型，取值包括： · L1：表示Level-1拓扑 · L2：表示Level-2拓扑 · P2P：表示P2P链路
Nbr-Change-Time	邻居建立不起来记录的时间
State	邻居状态，取值包括： · Down：表示邻居Down状态 · Init：表示邻居Init状态
Reason	邻居关系建立异常的原因，取值包括： · Bad packet length：报文长度错误 · Bad header length：报文头长度错误 · Jumbo packet：报文长度过长，即Hello报文大于接口MTU，或大于报文接收缓冲区 · Bad protocol description：协议描述符错误 · Bad protocol ID：协议ID错误 · Bad protocol version：协议版本号错误 · Unknown packet type：未识别的报文类型 · Mismatched network type：网络类型不匹配 · Duplicate system ID：System ID冲突 · Bad circuit type：接口类型错误 · Bad auth TLV：认证TLV错误 · Excessive auth TLVs：过多的认证TLV · Auth failure：认证失败 · Excessive area addresses：过多的区域地址 · Bad area address TLV：区域地址TLV数据错误 · Bad NBR TLV：邻居TLV错误 · Excessive IF Addr TLVs：过多的接口地址TLV · Excessive IF addresses：过多的接口地址 · Bad IF address TLV：接口地址TLV错误 · Bad system ID length：System ID长度错误 · Bad TLV length：TLV长度错误 · Bad IP address：IP地址不可用，即与本接口地址不在同一网段 · Duplicate IP address：IP地址不可用，即与本接口地址不在同一网段 · Mismatched area address：区域地址不匹配 · Mismatched protocol：协议不匹配 · Bad max area count：最大区域地址数错误 · Bad IPv6 address TLV：IPv6地址TLV错误 · Bad IPv6 address：IPv6地址错误 · Duplicate IPv6 address：IPv6地址冲突 · Bad MT ID TLV：拓扑ID TLV错误 · SNPA conflict (LAN)：广播网中，SNPA地址冲突 · Excessive NBR SNPAs (LAN)：广播网中，邻居SNPA地址过多 · Mismatched level (LAN)：广播网中，Level不匹配 · Bad 3-Way option TLV (P2P)：点到点网络中，三次握手信息错误 · No common MT ID (P2P)：点到点网络中，无公共拓扑ID · Bad circuit ID (P2P)：点到点网络中，接口链路ID错误 · Bad BFD TLV：BFD TLV错误 · Bad global IPv6 address TLV：全局IPv6地址TLV错误 · Bad IID TLV：多实例TLV长度小于协议规定的最小长度

【相关命令】

· diagnostic troubleshooting enable

1.13.3 diagnostic troubleshooting test neighbor-flap isis

diagnostic troubleshooting test neighbor-flap isis命令用来对IS-IS邻居关系震荡事件进行一键诊断。

【命令】

diagnostic troubleshooting test neighbor-flap isis [ process-id ] [ interface interface-type interface-number ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

process-id：对指定IS-IS进程邻居关系震荡事件进行一键诊断。process-id表示IS-IS进程号，取值范围为1～65535。如果未指定本参数，将对所有IS-IS进程邻居关系震荡事件进行一键诊断。

interface interface-type interface-number：对指定IS-IS接口邻居关系震荡事件进行一键诊断。interface-type interface-number为接口类型和编号。如果未指定本参数，将对所有IS-IS接口邻居关系震荡事件进行一键诊断。

【使用指导】

应用场景

IS-IS邻居关系震荡事件一键诊断功能处于开启状态的情况下，设备会自动将IS-IS邻居关系震荡的信息记录到GOLD（Generic OnLine Diagnostics，通用在线诊断）模块的内存中。执行本命令后，设备会显示GOLD模块内存中记录的邻居关系震荡的诊断信息，其中包括产生此类信息的时间、原因等内容，帮助用户定位IS-IS邻居关系震荡的原因。

配置准备

请先使用diagnostic troubleshooting test neighbor-flap isis enable命令，开启IS-IS邻居关系震荡事件一键诊断功能，否则，本命令执行失败。（IS-IS邻居关系震荡事件一键诊断功能缺省处于开启状态。）

【举例】

# 对所有IS-IS进程的邻居关系震荡事件进行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test neighbor-flap isis

Start diagnose at 2023-03-15 17:17:28

please wait.Done.

End diagnose at 2023-03-15 17:17:29,Actual time:1 seconds.

Diagnose information for IS-IS(1)

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

Interface NbrSystemID type Nbr-Change-Time State Reason

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

GigabitEthernet1/0/1 00000.0000.0088 L2 03-15 17:17:50 Up->Init A hello pack

et without S

NPA address

was received

表1-39 diagnostic troubleshooting test neighbor-flap isis显示信息描述表

字段	描述
Start diagnose at 2023-03-15 17:23:16	开始健康度诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒
please wait.Done.	健康度诊断过程中的打印信息，打印该信息时请耐心等待诊断完成
End diagnose at 2023-03-15 17:23:17,Actual time:1 seconds.	束健康度诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒，以及健康度诊断持续的实际时间
Interface	接口类型和接口编号
NbrSystemID	邻居SystemID
type	Level类型，取值包括： · L1：表示Level-1拓扑 · L2：表示Level-2拓扑 · P2P：表示P2P链路
Nbr-Change-Time	邻居震荡记录的时间
State	邻居状态变化，取值包括： · Up->Down：表示邻居从Up状态到Down状态 · Up->Init：表示邻居从Up状态到Init状态
Reason	邻居震荡的原因，取值包括： · UnknownReason：未知原因 · The IS-IS level was changed. Please check IS-IS configuration：IS-IS level改变导致邻居关系断开。请检查IS-IS配置 · The IS-IS process was reset：重启IS-IS进程导致邻居关系断开 · The IS-IS process was gracefully restarted：GR方式重启IS-IS进程导致邻居关系断开 · The LSP sequence number exceeds the maximum sequence number：LSP序列号反转导致邻居关系断开 · The IS-IS process was deleted：删除IS-IS进程导致邻居关系断开 · The IS-IS area was deleted. Please check IS-IS configuration：删除IS-IS区域导致邻居关系断开。请检查IS-IS配置 · The IS-IS process was stopped. Please check IS-IS process state：IS-IS进程停止服务导致邻居关系断开。请检查IS-IS进程状态 · The reset isis peer command was executed：执行reset isis peer命令导致邻居关系断开 · No hello packets were received within the hold time. Please check the connection to the neighbor：Hold time定时器超时并且在Hold time时间间隔内未收到Hello报文导致IS-IS邻居关系断开。请检查与邻居的连接情况 · The hold timer expired：Holdtime定时器超时导致IS-IS邻居关系断开 · The BFD session went down. Please check the BFD session state：BFD会话Down导致IS-IS邻居关系断开。请检查BFD会话状态 · The BFD session was administratively down. Please check the BFD session state：BFD会话Admin Down导致IS-IS邻居关系断开。请检查BFD会话状态 · The local BFD configuration changed. Please check the BFD session information：本地BFD配置改变导致IS-IS邻居关系断开。请检查BFD会话信息 · The remote BFD configuration changed. Please check the BFD session information on remote end：对端BFD配置改变导致IS-IS邻居关系断开。请检查对端BFD会话信息 · The IPv6 topology mode changed. Please check the IPv6 topology mode settings：IPv6拓扑模式改变导致IS-IS邻居关系断开。请检查IPv6拓扑配置 · The wait-to-delete BFD TLV timed out. Please check the BFD session information：等待删除BFD TLV超时导致IS-IS邻居关系断开。请检查对端BFD会话信息 · The interface went down. Please check the interface state：接口DOWN导致邻居关系断开。请检查接口状态 · The interface was deleted or the bound VPN instance was changed. Please check the interface state and settings：接口删除或者更改接口绑定的VPN实例导致邻居关系断开。请检查接口状态和配置 · The circuit level changed on the interface. Please check the interface settings：接口的Level改变导致邻居关系断开。请检查接口配置 · The circuit type changed on the interface. Please check the interface settings：接口网络类型改变导致邻居关系断开。请检查接口配置 · IS-IS packet receiving and sending were disabled. Please check the interface settings：禁止接口收发IS-IS报文导致邻居关系断开。请检查接口配置 · IS-IS interface parameters changed. Please check the interface parameters：IS-IS接口参数改变导致邻居关系断开。请检查接口参数 · IPv4 IS-IS was disabled on interface. Please check the interface settings：关闭接口的IS-IS IPv4能力导致邻居关系断开。请检查接口配置 · IPv6 IS-IS was disabled on interface. Please check the interface settings：关闭接口的IS-IS IPv6能力导致邻居关系断开。请检查接口配置 · The interface address was deleted or IS-IS was disabled on interface. Please check the interface settings：删除接口地址或者在接口上关闭IS-IS功能导致邻居关系断开。请检查接口配置 · The interface IPv6 address was deleted or IPv6 IS-IS was disabled on interface. Please check the interface settings：删除接口IPv6地址或者在关闭接口的IS-IS IPv6能力导致邻居关系断开。请检查接口配置 · A hello packet with mismatched protocol was received：接收到Hello报文支持的协议类型不匹配导致IS-IS邻居关系回退到INIT状态 · A hello packet with mismatched area was received：接收到Hello报文的区域不匹配导致IS-IS邻居关系回退到INIT状态 · A P2P hello packet with mismatched area was received：接收到P2P Hello报文的区域不匹配导致IS-IS邻居关系断开 · A hello packet with mismatched circuit type was received：接收到Hello报文中的circuit type不匹配导致IS-IS邻居关系断开 · A hello packet without SNPA address was received：接收到的Hello报文没有SNPA地址导致IS-IS邻居关系回退到INIT状态 · A hello packet without local SNPA address was received：接收到的Hello报文没有本地SNPA地址导致IS-IS邻居关系回退到INIT状态 · A P2P hello packet with mismatched circuit type was received：接收到P2P Hello报文中的circuit type不匹配导致IS-IS邻居关系断开 · The neighbor system ID corresponding to the SNPA address in the received hello packet is different from the neighbor system ID carried in the hello packet：根据接收到Hello报文中SNPA地址查找到的邻居的System ID与报文中的System ID不同，导致IS-IS邻居关系断开 · The P2P neighbor was gracefully down. Please check the GR configuration of GR helper：P2P邻居GR down导致IS-IS邻居关系断开，请检查GR Helper设备的GR配置 · A P2P hello packet with incorrect system ID was received：接收到P2P Hello报文中的System ID有误导致IS-IS邻居关系断开 · A P2P hello packet with incorrect circuit ID was received：接收到P2P Hello报文中的circuit ID有误导致IS-IS邻居关系断开 · PeerIPv4Disabled：邻居关闭了IPv4 IS-IS功能 · PeerIPv6Disabled：邻居关闭了IPv6 IS-IS功能 · CircuitIPv4Down：接口IPv4 IS-IS协议Down · CircuitIPv6Down：接口IPv6 IS-IS协议Down · A P2P hello packet with incorrect extended circuit ID was received：接收到P2P Hello报文中的扩展circuit ID有误导致IS-IS邻居关系断开 · A P2P hello packet with adjacency three-way state down was received：接收到P2P Hello报文中的adjacency three-way state为down导致IS-IS邻居关系回退到INIT状态 · Shutdown process：执行shutdown process命令关闭IS-IS进程，导致IS-IS邻居关系断开

【相关命令】

· diagnostic troubleshooting enable

1.14 gRPC一键诊断命令

1.14.1 diagnostic troubleshooting test grpc-server failed-operation

diagnostic troubleshooting test grpc-server failed-operation命令用来对gRPC请求失败执行一键诊断。

【命令】

diagnostic troubleshooting test grpc-server failed-operation

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

应用场景

本功能用于分析设备收到来自gRPC客户端（采集器）的请求报文后，对该报文处理失败的原因。

注意事项

仅gRPC Dial-in模式支持本功能。

请先使用diagnostic troubleshooting test netconf-server failed-operation enable命令开启gRPC请求失败的一键诊断功能，否则，本命令执行失败。

【举例】

# 对gRPC请求失败执行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test grpc-server failed-operation

Start diagnose at 2023-03-15 08:50:35

please wait.Done.

End diagnose at 2023-03-15 08:50:36,Actual time:1 seconds.

Diagnose report:

Failed at Session ID Username Client IP Operation

Stage Error Message

2023-03-15,08:50:00 3 admin 192.168.69.2:45650 get-all

RPC-parse Prefix or Path parsing failed

表1-40 diagnostic troubleshooting test grpc-server failed-operation显示信息描述表

字段	描述
Failed at	故障发生的时间
Session ID	gRPC会话ID
Username	用户名
Client IP	gRPC客户端IP地址
Operation	gRPC操作类型，例如get-config操作
Stage	故障产生的阶段： · RPC-parse：请求报文解析阶段 · RPC-process：请求报文处理阶段 · Config-process：业务处理阶段 · RPC-reply-process：响应报文处理阶段
Error Message	错误信息

【相关命令】

· diagnostic troubleshooting enable

1.14.2 diagnostic troubleshooting test grpc-server login

diagnostic troubleshooting test grpc-server login命令用来对gRPC登录事件执行一键诊断。

【命令】

diagnostic troubleshooting test grpc-server login

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

应用场景

本功能可以分析gRPC客户端（采集器）与设备建立gRPC会话失败的原因。

注意事项

仅gRPC Dial-in模式支持本功能。

请先使用diagnostic troubleshooting test grpc-server login enable命令开启gRPC登录事件的一键诊断功能，否则，本命令执行失败。

【举例】

# 对gRPC登录事件执行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test grpc-server login

Start diagnose at 2023-03-15 08:50:35

please wait.Done.

End diagnose at 2023-03-15 08:50:36,Actual time:1 seconds.

Diagnose report:

Info: Operating, please wait for a moment.

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

LoginTime Client-Address UserName Login-Result Fail-Reason

2023-03-15, 08:50:00 192.168.1.97:50051 client001 failed Authentication failed

表1-41 diagnostic troubleshooting test grpc-server login显示信息描述表

字段	描述
LoginTime	gRPC客户端（采集器）登录设备的时间
Client-Address	gRPC客户端的IP地址
UserName	用户名
Login-Result	gRPC客户端登录设备是否成功，取值包括： · successful：成功 · failed：失败
Fail-Reason	错误信息

【相关命令】

· diagnostic troubleshooting enable

1.14.3 diagnostic troubleshooting test telemetry sample-interval

diagnostic troubleshooting test telemetry sample-interval命令用来对gRPC采样周期信息执行一键诊断。

【命令】

diagnostic troubleshooting test telemetry sample-interval [ diagnostic-time diagnostic-time ]

【视图】

系统视图。

【缺省用户角色】

network-admin

【参数】

diagnostic-time:表示根据当前数据进行一键诊断。不指定该参数时，表示根据当前数据进行60秒的一键诊断。

diagnostic-time: 一键诊断时间，取值范围1～86400，单位为秒。

【使用指导】

应用场景

本功能用于分析gRPC Dial-out模式的Telemetry功能向采集器上送订阅报文时，采样路径的采样周期与用户配置的采样周期是否一致。

注意事项

请先使用diagnostic troubleshooting test telemetry sample-interval enable命令开启gRPC采样周期信息的一键诊断功能，否则，本命令执行失败。

【举例】

# 对gRPC采样周期信息执行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test telemetry sample-interval

Start diagnose at 2023-03-15 09:15:18, Estimated time:60 seconds.

Please wait..............................................................Done.

End diagnose at 2023-03-15 09:16:19, Actual time:61 seconds.

--------------------Subscription 5--------------------

Sensor group 1

Configured sampling interval : 5000 ms

Sensor path device/base

Sampling type: Periodic

Minimum sampling interval : 1000 ms

Effective sampling interval : 5000 ms

Actual sampling intercal : 4999 ms

Sampling period statue: Correct

Sensor group 4

Sensor path arp/arptableevent

Sampling type: Event-triggered

表1-42 diagnostic troubleshooting test telemetry sample-interval命令显示信息描述表

字段	描述
Subscription name	订阅名称
Sensor group name	传感器组的名称
Configured sampling interval	配置的采样周期
Sensor path name	采样路径的名称
Sampling type	采样路径的类型： · Periodic：周期采样类型 · Event-triggered：事件触发类型，该类型采样路径没有采样周期
Minimum sampling interval	当前采样路径的最小采样周期
Effective sampling interval	业务模块中生效的采样周期配置的采样周期如果低于最小采样周期，则本字段等于最小采样周期
Actual sampling interval	诊断时实际的采样周期，受CPU繁忙程度和采样数据量影响
Sampling period status	采样周期状态： · Correct：采样周期正确，诊断时实际的采样周期等于业务模块中生效的采样周期 · Incorrect：采样周期不正确，诊断时实际的采样周期大于业务模块中生效的采样周期
Reason for incorrect sampling period	采样周期不正确的原因： · CPU繁忙，或者采样数据量过于庞大

【相关命令】

· diagnostic troubleshooting enable

1.15 NETCONF一键诊断命令

1.15.1 diagnostic troubleshooting test netconf-server failed-operation

diagnostic troubleshooting test netconf-server failed-operation命令用来对NETCONF请求失败执行一键诊断。

【命令】

diagnostic troubleshooting test netconf-server failed-operation

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

应用场景

本功能用于分析设备（NETCONF服务器）收到来自NETCONF客户端的<rpc>请求报文后，对该报文处理失败的原因。

注意事项

请先使用diagnostic troubleshooting test netconf-server failed-operation enable命令开启NETCONF请求失败的一键诊断功能，否则，本命令执行失败。

【举例】

# 对NETCONF请求失败执行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test netconf-server failed-operation

Start diagnose at 2023-03-15 08:49:18

please wait.Done.

End diagnose at 2023-03-15 08:49:19,Actual time:1 seconds.

Diagnosis report:

Failed at Session ID Username Client IP Operation

Stage Error Message

2023-03-15,08:49:00 3 admin 192.168.69.2:45650 get-config

RPC-parse Prefix or Path parsing failed

表1-43 diagnostic troubleshooting test netconf-server failed-operation命令显示信息描述表

字段	描述
Failed at	故障发生的时间
Session ID	NETCONF会话ID
Username	用户名
Client IP	NETCONF客户端IP地址
Operation	NETCONF操作类型，例如get-config操作
Stage	故障产生的阶段： · RPC-parse：请求报文解析阶段 · RPC-process：请求报文处理阶段 · Config-process：业务处理阶段 · RPC-reply-process：响应报文处理阶段
Error Message	错误信息

【相关命令】

· diagnostic troubleshooting enable

1.15.2 diagnostic troubleshooting test netconf-server netconf-over-soap

diagnostic troubleshooting test netconf-server netconf-over-soap命令用来对NETCONF over SOAP登录信息执行一键诊断。

【命令】

diagnostic troubleshooting test netconf-server netconf-over-soap

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

应用场景

本功能可以分析NETCONF客户端与设备（NETCONF服务器）建立NETCONF over SOAP会话失败的原因。

注意事项

请先使用diagnostic troubleshooting test netconf-server netconf-over-soap enable命令开启NETCONF over SOAP登录信息的一键诊断功能，否则，本命令执行失败。

【举例】

# 对NETCONF over SOAP登录信息执行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test netconf-server netconf-over-soap

Start diagnose at 2023-03-15 08:50:35

please wait.Done.

End diagnose at 2023-03-15 08:50:36,Actual time:1 seconds.

Diagnose report:

Info: Operating, please wait for a moment.

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

LoginTime Client-Address UserName Login-Result Fail-Reason

2023-03-15, 08:50:00 192.168.1.97 client001 failed Authentication failed

表1-44 diagnostic troubleshooting test netconf-server netconf-over-soap命令显示信息描述表

字段	描述
LoginTime	NETCONF客户端登录设备的时间
Client-Address	NETCONF客户端的IP地址
UserName	用户名
Login-Result	NETCONF客户端登录设备是否成功，取值包括： · successful：成功 · failed：失败
Fail-Reason	错误原因

【相关命令】

· diagnostic troubleshooting enable

1.16 组播路由与转发一键诊断命令

1.16.1 diagnostic troubleshooting test multicast-route creation-abnormal

diagnostic troubleshooting test multicast-route creation-abnormal命令用来对组播路由表项创建异常执行一键诊断。

【命令】

diagnostic troubleshooting test multicast-route creation-abnormal [ vpn-instance vpn-instance-name ] { ipv4-source-address ipv4-group-address | ipv6-source-address ipv6-group-address } outgoing-interface interface-type interface-number [ diagnostic-time diagnostic-time ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

vpn-instance vpn-instance-name：指定VPN实例，vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。如果未指定本参数，表示公网实例。

ipv4-source-address：IPv4组播源地址，（*，G）表项的IPv4组播源地址用0.0.0.0表示。

ipv4-group-address：IPv4组播组地址，取值范围为224.0.0.0～239.255.255.255。

ipv6-source-address：IPv6组播源地址，（*，G）表项的组播源地址用0::0表示。

ipv6-group-address：IPv6组播组地址，取值范围为FFxy::/16，其中x和y均代表0～F的任意一个十六进制数。

outgoing-interface interface-type interface-number：组播路由表项出接口的类型和编号。

diagnostic-time diagnostic-time：本次一键诊断的预计持续时间，取值范围为15～3600，单位为秒，缺省值为135。本参数为诊断预计持续的时间，诊断实际需要的时间和该时间可能不同，请以实际情况为准，但诊断实际需要的时间肯定小于等于2*diagnostic-time。

【使用指导】

工作机制

执行本命令后，设备会记录诊断持续时间内，组播路由表项创建异常的信息。待诊断持续时间到达时，汇总并显示这些记录信息，帮助用户定位处理组播路由表项创建异常的原因。

注意事项

配置的诊断预计持续时间应大于下游发送PIM加入报文的周期。如果接口上同时开启了IGMP或MLD功能，那么诊断预计持续时间还应大于IGMP/MLD通用查询报文周期（缺省值为125秒）和最大响应时间（缺省值为10秒）之和。若配置的诊断预计持续时间过短，可能会导致诊断结果不够全面。

同一时间段，系统只支持对一个组播路由表项进行一键诊断。

【举例】

# 对公网实例下的组播路由表项（1.2.3.4, 225.0.0.1）创建异常执行一键诊断，组播路由表项的出接口为GigabitEthernet1/0/1，预计诊断时间为100秒。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test multicast-route creation-abnormal 1.2.3.4 225.0.0.1 outgoing-interface gigabitethernet 1/0/1 diagnostic-time 100

Start diagnose at 2023-03-23 08:10:04, Estimated time:135 seconds.

Please wait..........................................Done.

End diagnose at 2023-03-23 08:12:20, Actual time:136 seconds.

Vpn-instance: public net

In-interface Oif ProblemDsc

GigabitEthernet1/0/2 Y 1. The multicast protocol entry is in the normal state.

表1-45 diagnostic troubleshooting test multicast-route creation-abnormal命令显示信息描述表

字段	描述
Start diagnose at	组播路由创建异常一键诊断开始时间
Estimated time	组播路由创建异常一键诊断预计持续时间
End diagnose at	组播路由创建异常一键诊断结束的时间
Actual time	组播路由创建异常一键诊断实际花费的时间
Diagnosis report	诊断报告
VPN-instance	VPN实例名称（公网显示为public net）
Incoming interface	组播路由表项入接口
Outgoing interface exsits	组播路由表项是否存在出接口： · Yes：存在 · No：不存在
Description	组播路由表项执行一键诊断结果，取值包括： · The multicast routing entry is in the normal state：表项状态正常 · Multicast diagnostics does not support the current interface type：不支持诊断当前接口类型 · Multicast diagnostic does not support PIM-DM：不支持诊断PIM DM模式 · Multicast diagnostics does not support BIDIR-PIM：不支持诊断双向PIM模式 · The PIM entry does not exist：PIM表项不存在 · A multicast source filtering policy is configured：指定的表项被组播数据过滤器过滤 · The PIM register packet has been filtered out by the register policy：PIM注册报文被注册报文的过滤策略过滤 · The local device is an RP but does not receive any PIM register packet：当前设备是RP，但是没有收到PIM注册报文 · Multicast does not receive the Nocache event (no data packet is received)：组播模块没有收到未知组播报文上送事件 · The PIM outgoing interface is not the DR.：PIM表项出接口不是PIM DR接口 · The interface is down：接口处于down状态 · PIM or IGMP/MLD is disabled on the interface.：接口上未开启三层组播功能 · PIM passive is enabled on the interface, and IGMP/MLD is disabled.：接口上开启了PIM消极模式，但未开启IGMP/MLD功能 · A multicast boundary policy is configured on the interface.：接口上配置了组播边界功能 · The device does not receive PIM join packets：设备没有收到PIM加入报文 · The device fails to receive the PIM packet：设备接收PIM报文失败 · The PIM packet from an unknown neighbor might be discarded：收到了来自非PIM邻居的PIM报文，该报文可能被丢弃 · The PIM packet might be discarded, because the upstream neighbor address in the packet is incorrect：PIM报文可能被丢弃，因为PIM报文中的上游邻居地址不对 · The PIM join packet is discarded, because the RP address in the packet is incorrect. The expected RP address is 1.2.3.4, and the address in the packet is 1.2.3.3：PIM报文中的RP地址不对导致PIM加入报文被丢弃 · The PIM entry is created, but the multicast source address is a local address. As a result, multicast services might be interrupted：PIM表项源地址是本设备地址，组播转发可能会中断 · The incoming interface of the PIM entry does not exist (the possible cause is that there is no route to the multicast source or RP)：PIM表项没有入接口 · PIM does not find the corresponding RP：PIM表项没有映射到RP · The PIM entry is in the SWT state, but no Wrongif event is received：PIM表项处于SWT状态，没有收到数据报文RPF检查失败事件 · The outgoing interface specified in the PIM entry does not exist：PIM表项指定的出接口不存在 · The PIM outbound interface is not in the outgoing interface state：不存在PIM表项出接口的状态机 · The PIM outgoing interface is in Exclude mode：PIM表项的指定出接口是exclude模式 · The PIM outgoing interface is in the Assert Loser state：PIM表项出接口的状态机处于Assert Loser状态 · The PIM outgoing interface is in the RPT Prune state：PIM表项出接口的状态机处于RPT Prune状态 · An IGMP/MLD group filtering policy is configured on the interface：IGMP/MLD组播组被接口上配置的组播组过滤器过滤 · The device does not receive IGMP/MLD join packets：设备没有收到IGMP/MLD成员关系加入报文 · The device fails to receive the IGMP/MLD packet：设备无法收到IGMP/MLD报文 · The IGMP/MLD version set on the interface is inconsistent with the version in the received packet. The version set on the interface is 1, and the version in the received packet is 2：接口上配置的IGMP/MLD报文版本号与收到的IGMP/MLD报文的版本号不兼容 · The group address is in the SSM range, and no SSM mapping policy is configured, (, G) join is not supported：IGMP加入报文中指定的组播组地址属于SSM范围但未指定组播源，且设备上未配置SSM Mapping策略，所以不支持（，G）加入 · The SSM mapping policy does not contain rules with the specified source：SSM Mapping规则配置错误，无法匹配指定组播源

【相关命令】

· diagnostic troubleshooting enable

1.16.2 diagnostic troubleshooting health module multicast

diagnostic troubleshooting health module multicast命令用来为组播模块执行一次健康度诊断。

【命令】

diagnostic troubleshooting health module multicast

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

本命令用来诊断组播业务模块当前的运行状态是否健康。执行本命令会显示该业务模块的不健康信息，供用户查看。

【举例】

# 为组播模块执行一次健康度诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting health module multicast

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

PADS_Type Detect-Time Description

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

PIM_NBR_TIMESOUT 2023-03-14 09:47:44 The neighbor aging timer expired. (VPNName:

public net, NbrAddr: 5.5.5.1, IfName:

GigabitEthernet1/0/1)

PIM_NBR_TIMESOUT 2023-03-14 09:47:49 The neighbor aging timer expired. (VPNName:

public net, NbrAddr: 5.5.5.2, IfName:

GigabitEthernet1/0/2)

表1-46 diagnostic troubleshooting health module multicast命令显示信息描述表

字段	描述
PADS_Type	组播模块不健康的类型，包括： · GROUP_TIMESOUT：组播组超时老化 · PIM_OIF_TIMESOUT：PIM出接口超时老化 · PIM_NBR_TIMESOUT：PIM邻居超时老化
Detect-Time	健康度检测时间
Description	组播模块健康度检测详细描述： · The group aging timer expired. (VPNName: VPNName, GrpAddr: GrpAddr, IfName: IfNname) · The outgoing interface aging timer expired. (VPNName: VPNName, SrcAddr: SrcAddr, GrpAddr: GrpAddr, IfName: IfNname) · The neighbor aging timer expired. (VPNName: VPNName, NbrAddr: NbrAddr, IfName: IfNname)

【相关命令】

· diagnostic troubleshooting health enable

1.17 ARP一键诊断命令

1.17.1 diagnostic troubleshooting health module arp

diagnostic troubleshooting health module arp命令用来为ARP模块执行一次健康度诊断。

【命令】

diagnostic troubleshooting health module arp

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

应用场景

本命令用来诊断ARP模块当前的运行状态是否健康。执行本命令会显示模块的不健康信息，供用户查看。

配置准备

请先使用diagnostic troubleshooting health module arp enable命令，开启ARP模块健康度一键诊断功能，否则，本命令执行失败。

【举例】

# 对ARP模块执行一次健康度诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting health module arp

Start diagnose at 2022-12-15 07:12:10

please wait.Done.

End diagnose at 2022-12-15 07:12:11,Actual time:1 seconds.

last system health for arp:

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

Show ARP Health Record

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

PADS_Type Detect-Time Description

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

ARP_EXCEED 12-15 07:11:52 The number of ARP entries exceeded the thres

hold. (IfName=GigabitEthernet1/0/1, Slot=3, Thre

shold=10, Number of dynamic ARP entries=

10, Number of static ARP entries=0)

ARP_EXCEED 12-15 07:11:50 The number of ARP entries exceeded the thres

hold. (IfName=GigabitEthernet1/0/1, Slot=3, Thre

shold=10, Number of dynamic ARP entries=

10, Number of static ARP entries=0)

IP_CONFLICT 12-15 07:11:48 Received an ARP packet with a duplicate

IP address from the interface. (VRF=0, I

fName=GigabitEthernet1/0/1, IpAddress=1.

1.1.2, MacAddress=005e-a312-ea9f, PE-VLA

N=65535, CE-VLAN=65535)

IP_CONFLICT 12-15 07:11:43 Received an ARP packet with a duplicate

IP address from the interface. (VRF=0, I

fName=GigabitEthernet1/0/1, IpAddress=1.

1.1.2, MacAddress=005e-a312-ea9f, PE-VLA

N=65535, CE-VLAN=65535)

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

表1-47 diagnostic troubleshooting health module arp命令显示信息描述表

字段	描述
Start diagnose at 2022-12-15 07:12:10	开始一键诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒。
End diagnose at 2022-12-15 07:12:11,Actual time:1 seconds.	结束一键诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒。以及一键诊断持续的实际时间
last system health for arp	最近一次的ARP健康度
Show ARP Health Record	显示ARP健康度记录
PADS_Type	模块不健康的类型，取值包括： · ARP_EXCEED：ARP表项数量超过了阈值 · IP_CONFLICT：从接口上接收到IP地址冲突的ARP报文
Detect-Time	发现异常的时间
Description	健康度事件的详细描述，包括： · IfName：接口名称 · Slot：单板号 · Threshold：ARP表项阈值 · Number of dynamic ARP entries：当前动态ARP表项数量 · Number of static ARP entries：当前静态ARP表项数量 · VRF：VPN索引 · IPAddress：IPv4地址 · MacAddress：MAC地址 · PE-VLAN：外层VLAN · CE-VLAN：内层VLAN

【相关命令】

· diagnostic troubleshooting health enable

1.17.2 diagnostic troubleshooting test arp-learn packet-trace

diagnostic troubleshooting test arp-learn packet-trace命令用来对发送和接收ARP报文事件进行一键诊断。

【命令】

diagnostic troubleshooting test arp-learn packet-trace ip-address ip-address interface interface-type interface-number [ diagnostic-time diagnostic-time ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

ip-address ip-address：指定发送ARP报文的目的IP地址或接收ARP报文的源IP地址。ip-address表示IPv4地址，为点分十进制格式。

interface interface-type interface-number：指定发送和接收ARP报文的接口。interface-type interface-number表示接口类型和接口编号。

diagnostic-time diagnostic-time：诊断的预计持续时间，取值范围为5～60，单位为秒，缺省值为10。本参数为诊断预计持续的时间，诊断实际需要的时间和该时间可能不同，请以实际情况为准，但诊断实际需要的时间肯定小于等于2*diagnostic-time。

【使用指导】

应用场景

当需要检查设备与目的网络或目的主机之间是否可达时，可通过执行本命令对设备发送和接收ARP报文事件进行一键诊断。如果ARP报文发送失败，则通过系统输出的失败原因，可进一步定位故障。

工作机制

执行本命令后，设备不会立即显示诊断信息，仅在指定接口发送了指定目的IP地址的ARP报文或接收了指定源IP地址的ARP报文后才开始显示诊断信息。受消息长度限制，每执行一次本命令最多显示5个ARP报文的诊断信息。

· 在诊断的预计持续时间内，只要发送指定目的IP地址的ARP报文个数或者接收指定源IP地址的ARP报文个数达到5个，则立即显示检测到的5个ARP报文的诊断信息，后续诊断持续时间内检测到的ARP报文不再显示。

· 如果诊断的预计持续时间到达后，检测到的指定ARP报文个数不足5个，或者使用组合键<Ctrl+C>中止执行本命令后，则显示当前已检测到的ARP报文诊断信息。

配置准备

请先使用diagnostic troubleshooting test arp-learn packet-trace enable命令，开启发送和接收ARP报文事件一键诊断功能，否则，本命令执行失败。（发送和接收ARP报文事件一键诊断功能缺省处于开启状态。）

注意事项

每执行一次本命令，仅显示一次ARP报文诊断信息。若有对后续发送和接收ARP报文事件进行一键诊断的需求，需要再次执行本命令。

如果在本命令执行过程出现异常，可以使用组合键<Ctrl+C>中止执行命令。

【举例】

# 对发送和接收ARP报文事件进行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test arp-learn packet-trace ip-address 1.1.1.2 interface gigabitethernet 1/0/1

Start diagnose at 2022-08-01 10:00:14, Estimated time:10 seconds.

Please wait.....................Done.

End diagnose at 2022-08-01 10:00:29, Actual time:15 seconds.

Diagnose report:

Diagnose ARP Learning With IPAddress: 1.1.1.2 Interface: GigabitEthernet1/0/1

Simple Description: ARP entry learning failed. Check detailed information displayed in the ARP Inner field of the command output!

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

Description

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

ETH-->ARP:

ETH success to recevice arp packet(SrcMac=0000-0000-0001, DstMac=4c11-317c-0100). (Time=2022-08-01 10:00:23)

ETH success to recevice arp packet(SrcMac=0000-0000-0001, DstMac=4c11-317c-0100). (Time=2022-08-01 10:00:21)

ETH success to recevice arp packet(SrcMac=0000-0000-0001, DstMac=4c11-317c-0100). (Time=2022-08-01 10:00:19)

ETH success to recevice arp packet(SrcMac=0000-0000-0001, DstMac=4c11-317c-0100). (Time=2022-08-01 10:00:17)

no data

ARP Inner:

ARP fail to recevice arp packet(SrcMac=0000-0000-0001, DstMac=4c11-317c-0100). (ErrReason:Failed to write ARP message queue, Time=2022-08-01 10:00:23)

ARP fail to recevice arp packet(SrcMac=0000-0000-0001, DstMac=4c11-317c-0100). (ErrReason:Failed to write ARP message queue, Time=2022-08-01 10:00:21)

ARP fail to recevice arp packet(SrcMac=0000-0000-0001, DstMac=4c11-317c-0100). (ErrReason:Failed to write ARP message queue, Time=2022-08-01 10:00:19)

ARP fail to recevice arp packet(SrcMac=0000-0000-0001, DstMac=4c11-317c-0100). (ErrReason:Failed to write ARP message queue, Time=2022-08-01 10:00:17)

no data

ARP-->ETH:

ARP success to send arp packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to ETH.(Time=2022-08-01 10:00:23)

ARP success to send arp packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to ETH.(Time=2022-08-01 10:00:21)

ARP success to send arp packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to ETH.(Time=2022-08-01 10:00:19)

ARP success to send arp packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to ETH.(Time=2022-08-01 10:00:17)

ARP success to send arp packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to ETH.(Time=2022-08-01 10:00:15)

ETH-->QOS:

ETH success to send arp packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to QOS.(Time=2022-08-01 10:00:23)

ETH success to send arp packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to QOS.(Time=2022-08-01 10:00:21)

ETH success to send arp packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to QOS.(Time=2022-08-01 10:00:19)

ETH success to send arp packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to QOS.(Time=2022-08-01 10:00:17)

ETH success to send arp packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to QOS.(Time=2022-08-01 10:00:15)

QOS-->DRV:

QOS success to send arp packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to DRV.(Time=10:00:23)

QOS success to send arp packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to DRV.(Time=10:00:21)

QOS success to send arp packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to DRV.(Time=10:00:19)

QOS success to send arp packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to DRV.(Time=10:00:17)

QOS success to send arp packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to DRV.(Time=10:00:15)

表1-48 diagnostic troubleshooting test arp-learn packet-trace命令显示信息描述表

字段	描述
Start diagnose at 2022-08-01 10:00:14, Estimated time:10 seconds.	开始一键诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒。以及一键诊断预计的持续时间
End diagnose at 2022-08-01 10:00:29, Actual time:15 seconds.	结束一键诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒。以及一键诊断持续的实际时间
Diagnose report	诊断报告
Description	描述信息
ETH-->ARP	接口模块发送报文给ARP模块，诊断信息包括： · SrcMac：源MAC地址 · DstMac：目的MAC地址 · ErrReason：失败原因，取值包括： ¡ Wrong source mac address：错误的源MAC地址 ¡ Failed to analyse packet：分析报文失败 ¡ Packet discarded for lagg block：链路聚合阻塞丢包 ¡ No sub interface：无子接口 ¡ Interface link status is down：接口链路状态为DOWN · Time：诊断时间
ARP Inner	ARP模块内部处理报文，诊断信息包括： · SrcMac：源MAC地址 · DstMac：目的MAC地址 · ErrReason：失败原因，取值包括： ¡ Taken over by copp：ARP报文被COPP业务接管 ¡ Failed to write ARP message queue：ARP消息队列写入失败 ¡ Issu limit：ISSU期间报文限速处理 ¡ Failed to pull up MBUF：报文数据处理失败 ¡ ARP packet is invalid：ARP报文不合法 ¡ ARP packet is taken over by authenticator：ARP报文被认证者接管 · Time：诊断时间
ARP-->ETH	ARP模块发送报文给接口模块，诊断信息包括： · SrcMac：源MAC地址 · DstMac：目的MAC地址 · ErrReason：失败原因，取值为Failed to request memory，表示申请内存失败 · Time：诊断时间
ETH-->QOS	接口模块发送报文给QoS模块，诊断信息包括： · SrcMac：源MAC地址 · DstMac：目的MAC地址 · ErrReason：失败原因，取值包括： ¡ Invalid if index：索引失效 ¡ Failed to encapsulate link header：封装链路头失败 ¡ Failed to package vlan tag：封装VLAN TAG失败 ¡ Taken over by eth vlan：报文被ETH VLAN接管 ¡ Failed to pad packet：报文最短长度填充出错 ¡ Port blocked：端口堵塞 ¡ Successfully sent on super vlan：报文由SuperVlan发送成功 ¡ Failed to send on super vlan：报文由SuperVlan发送失败 · Time：诊断时间
QOS-->DRV	QoS模块发送报文给驱动模块，诊断信息包括： · SrcMac：源MAC地址 · DstMac：目的MAC地址 · ErrReason：失败原因，取值为QoS sending failed，表示QoS模块发送报文失败 · Time：诊断时间

【相关命令】

· diagnostic troubleshooting enable

1.18 ND一键诊断命令

1.18.1 diagnostic troubleshooting health module nd

diagnostic troubleshooting health module nd命令用来为ND模块执行一次健康度诊断。

【命令】

diagnostic troubleshooting health module nd

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

应用场景

本命令用来诊断ND模块当前的运行状态是否健康。执行本命令会显示模块的不健康信息，供用户查看。

配置准备

请先使用diagnostic troubleshooting health module nd enable命令，开启ND模块健康度一键诊断功能，否则，本命令执行失败。

【举例】

# 对ND模块执行一次健康度诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting health module nd

Start diagnose at 2022-12-15 02:22:47

please wait.Done.

End diagnose at 2022-12-15 02:22:48,Actual time:1 seconds.

last system health for nd:

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

Show ND Health Record

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

PADS_Type Detect-Time Description

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

ND_EXCEED 12-15 02:21:52 The number of ND entries exceeded the th

reshold. (IfName=GigabitEthernet2/0/1, s

lot=2, Threshold=1, Number of dynamic ND

entries=1, Number of static ND entries=

ND_EXCEED 12-15 02:21:50 The number of ND entries exceeded the th

reshold. (IfName=GigabitEthernet2/0/1, s

lot=2, Threshold=1, Number of dynamic ND

entries=1, Number of static ND entries=

ND_IP_CONFLICT 12-15 02:21:48 Received an ND packet with a duplicate I

Pv6 address from the interface. (VRF=0,

IfName=GigabitEthernet2/0/1, Ipv6Address

=1000::2, MacAddress=005e-a312-ea9f, PE-

VLAN=65535, CE-VLAN=65535)

ND_IP_CONFLICT 12-15 02:21:43 Received an ND packet with a duplicate I

Pv6 address from the interface. (VRF=0,

IfName=GigabitEthernet2/0/1, Ipv6Address

=1000::2, MacAddress=005e-a312-ea9f, PE-

VLAN=65535, CE-VLAN=65535)

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

表1-49 diagnostic troubleshooting health module nd命令显示信息描述表

字段	描述
Start diagnose at 2022-12-15 02:22:47	开始一键诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒。
End diagnose at 2022-12-15 02:22:48,Actual time:1 seconds.	结束一键诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒。以及一键诊断持续的实际时间
last system health for nd	最近一次的ND健康度
Show ND Health Record	显示ND健康度记录
PADS_Type	模块不健康的类型，取值包括： · ND_EXCEED：ND表项数量超过了阈值 · ND_IP_CONFLICT：从接口上接收到IPv6地址冲突的ND报文
Detect-Time	发现异常的时间
Description	健康度事件的详细描述，包括： · IfName：接口名称 · Slot：单板号 · Threshold：ND表项阈值 · Number of dynamic ND entries：当前动态ND表项数量 · Number of static ND entries：当前静态ND表项数量 · VRF：VPN索引 · IPv6Address：IPv6地址 · MacAddress：MAC地址 · PE-VLAN：外层VLAN · CE-VLAN：内层VLAN

【相关命令】

· diagnostic troubleshooting health enable

1.18.2 diagnostic troubleshooting test nd-learn packet-trace

diagnostic troubleshooting test nd-learn packet-trace命令用来对发送和接收ND报文事件进行一键诊断。

【命令】

diagnostic troubleshooting test nd-learn packet-trace ipv6-address ipv6-address interface interface-type interface-number [ diagnostic-time diagnostic-time ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

ipv6-address ipv6-address：指定发送ND报文的目的IPv6地址或接收ND报文的源IPv6地址。

interface interface-type interface-number：指定发送和接收ND报文的接口。interface-type interface-number表示接口类型和接口编号。

【使用指导】

应用场景

当需要检查设备与目的网络或目的主机之间是否可达时，可通过执行本命令对设备发送和接收ND报文事件进行一键诊断。如果ND报文发送失败，则通过系统输出的失败原因，可进一步定位故障。

工作机制

执行本命令后，设备不会立即显示诊断信息，仅在指定接口发送了指定目的IPv6地址的ND报文或接收了指定源IPv6地址的ND报文后才开始显示诊断信息。受消息长度限制，每执行一次本命令最多显示5个ND报文的诊断信息。

· 在诊断的预计持续时间内，只要发送指定目的IPv6地址的ND报文个数或接收指定源IPv6地址的ND报文个数达到5个，则立即显示检测到的5个ND报文的诊断信息，后续诊断持续时间内检测到的ND报文不再显示。

· 如果诊断的预计持续时间到达后，检测到的指定ND报文个数不足5个，或者使用组合键<Ctrl+C>中止执行本命令后，则显示当前已检测到的ND报文诊断信息。

配置准备

请先使用diagnostic troubleshooting test nd-learn packet-trace enable命令，开启发送和接收ND报文事件一键诊断功能，否则，本命令执行失败。（发送和接收ND报文事件一键诊断功能缺省处于开启状态。）

注意事项

每执行一次本命令，仅显示一次ND报文诊断信息。若有对后续发送和接收ND报文事件进行一键诊断的需求，需要再次执行本命令。

如果在本命令的执行过程中出现异常，可以使用组合键<Ctrl+C>中止执行本命令。

【举例】

# 对发送和接收ND报文事件进行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test nd-learn packet-trace ipv6-address 1000::1 interface gigabitEthernet 1/0/1

Start diagnose at 2022-08-01 10:00:14, Estimated time:10 seconds.

Please wait.....................Done.

End diagnose at 2022-08-01 10:00:29, Actual time:15 seconds.

Diagnose report:

Diagnose ND Learning With IPv6Address: 1000::1 Interface: GigabitEthernet 1/0/1

Simple Description: ND entry learning failed. Check detailed information displayed in the IPv6-->ICMPv6 field of the command output!

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

Description

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

ETH-->IPv6:

ETH success to recevice nd packet(SrcMac=0000-0000-0001, DstMac=4c11-317c-0100). (Time=2022-08-01 10:00:23)

ETH success to recevice nd packet(SrcMac=0000-0000-0001, DstMac=4c11-317c-0100). (Time=2022-08-01 10:00:21)

ETH success to recevice nd packet(SrcMac=0000-0000-0001, DstMac=4c11-317c-0100). (Time=2022-08-01 10:00:19)

ETH success to recevice nd packet(SrcMac=0000-0000-0001, DstMac=4c11-317c-0100). (Time=2022-08-01 10:00:17)

ETH success to recevice nd packet(SrcMac=0000-0000-0001, DstMac=4c11-317c-0100). (Time=2022-08-01 10:00:15)

IPv6-->ICMPv6:

IPv6 fail to recevice nd packet(SrcMac=0000-0000-0001, DstMac=4c11-317c-0100). (ErrReason:Invalid IPv6 packet, Time=2022-08-01 10:00:23)

IPv6 fail to recevice nd packet(SrcMac=0000-0000-0001, DstMac=4c11-317c-0100). (ErrReason:Invalid IPv6 packet, Time=2022-08-01 10:00:21)

IPv6 fail to recevice nd packet(SrcMac=0000-0000-0001, DstMac=4c11-317c-0100). (ErrReason:Invalid IPv6 packet, Time=2022-08-01 10:00:19)

IPv6 fail to recevice nd packet(SrcMac=0000-0000-0001, DstMac=4c11-317c-0100). (ErrReason:Invalid IPv6 packet, Time=2022-08-01 10:00:17)

IPv6 fail to recevice nd packet(SrcMac=0000-0000-0001, DstMac=4c11-317c-0100). (ErrReason:Invalid IPv6 packet, Time=2022-08-01 10:00:15)

ICMPv6-->ND:

no data

ND Inner:

no data

ND-->IPv6:

ND success to send nd packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to IPv6.(Time=2022-08-01 10:00:23)

ND success to send nd packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to IPv6.(Time=2022-08-01 10:00:21)

ND success to send nd packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to IPv6.(Time=2022-08-01 10:00:19)

ND success to send nd packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to IPv6.(Time=2022-08-01 10:00:17)

ND success to send nd packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to IPv6.(Time=2022-08-01 10:00:15)

IPv6-->ADJ6:

IPv6 success to send nd packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to ADJ6.(Time=2022-08-01 10:00:23)

IPv6 success to send nd packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to ADJ6.(Time=2022-08-01 10:00:21)

IPv6 success to send nd packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to ADJ6.(Time=2022-08-01 10:00:19)

IPv6 success to send nd packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to ADJ6.(Time=2022-08-01 10:00:17)

IPv6 success to send nd packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to ADJ6.(Time=2022-08-01 10:00:15)

ADJ6-->ETH:

ADJ6 success to send nd packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to ETH.(Time=2022-08-01 10:00:23)

ADJ6 success to send nd packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to ETH.(Time=2022-08-01 10:00:21)

ADJ6 success to send nd packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to ETH.(Time=2022-08-01 10:00:19)

ADJ6 success to send nd packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to ETH.(Time=2022-08-01 10:00:17)

ADJ6 success to send nd packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to ETH.(Time=2022-08-01 10:00:15)

ETH-->QOS:

ETH success to send nd packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to QOS.(Time=2022-08-01 10:00:23)

ETH success to send nd packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to QOS.(Time=2022-08-01 10:00:21)

ETH success to send nd packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to QOS.(Time=2022-08-01 10:00:19)

ETH success to send nd packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to QOS.(Time=2022-08-01 10:00:17)

ETH success to send nd packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to QOS.(Time=2022-08-01 10:00:15)

QOS-->DRV:

QOS success to send nd packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to DRV.(Time=2022-08-01 10:00:23)

QOS success to send nd packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to DRV.(Time=2022-08-01 10:00:21)

QOS success to send nd packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to DRV.(Time=2022-08-01 10:00:19)

QOS success to send nd packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to DRV.(Time=2022-08-01 10:00:17)

QOS success to send nd packet(SrcMac=4c11-317c-0100, DstMac=0000-0000-0001) to DRV.(Time=2022-08-01 10:00:15)

表1-50 diagnostic troubleshooting test nd-learn packet-trace命令显示信息描述表

字段	描述
Start diagnose at 2022-08-01 10:00:14, Estimated time:10 seconds.	开始一键诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒。以及一键诊断预计的持续时间
End diagnose at 2022-08-01 10:00:29, Actual time:15 seconds.	结束一键诊断的时间，格式为YYYY-MM-DD hh:mm:ss，其中YYYY为年、MM为月、DD为日、hh为时、mm为分、ss为秒。以及一键诊断持续的实际时间
Diagnosis report	诊断报告
Description	描述信息
ETH-->IPv6	接口模块发送报文给IPv6基础模块，诊断信息包括： · SrcMac：源MAC地址 · DstMac：目的MAC地址 · ErrReason：失败原因，取值包括： ¡ Failed to get Ethernet control block：获取接口控制块信息失败 ¡ Failed to pull up MBUF：报文数据处理失败 ¡ Wrong source mac address：错误的源MAC地址 ¡ Failed to analyse packet：分析报文失败 ¡ Packet discarded for lagg block：链路聚合阻塞丢包 ¡ Invalid if index：索引失效 ¡ Interface link status is down：接口链路状态为DOWN ¡ Port blocked：端口堵塞 · Time：诊断时间
IPv6-->ICMPv6	IPv6基础模块发送报文给ICMPv6模块，内容包括： · SrcMac：源MAC地址 · DstMac：目的MAC地址 · ErrReason：失败原因，取值包括： ¡ Packet was discarded by services：报文被业务处理丢弃 ¡ Invalid IPv6 packet：IPv6报文不合法 ¡ Failed to process the sr extension header：处理路由扩展头失败 ¡ Failed to process the hop-by-hop extension header：处理逐跳扩展头失败 ¡ IPv6 drop：丢弃包含无法处理的IPv6扩展头的报文 ¡ Failed to get vsys data：获取VSYS数据失败 ¡ Packet discarded for copy to cpu：丢弃拷贝上送的报文 ¡ Invalid next header：报文IPv6头的下一个报文头无效 ¡ The packet is added to the reorganization queue：报文被加入重组队列 ¡ Failed to process the extension header：处理扩展头失败 · Time：诊断时间
ICMPv6-->ND	ICMPv6模块发送报文给ND模块，内容包括： · SrcMac：源MAC地址 · DstMac：目的MAC地址 · ErrReason：失败原因，取值包括： ¡ Failed to pull up MBUF：处理报文数据失败 ¡ ICMPv6 packet too short：报文ICMPv6部分长度错误 ¡ Packet discarded for icmpv6 defend：报文因ICMPv6 攻击防御而丢弃 ¡ Packet discarded for checksum error：报文因校验和出错而丢弃 · Time：诊断时间
ND Inner	ND内部处理报文，内容包括： · SrcMac：源MAC地址 · DstMac：目的MAC地址 · ErrReason：失败原因，取值包括： ¡ ND main thread stopped：ND主线程已停止，该报文不处理 ¡ Packet discarded for icmpv6 defend：报文因ICMPv6 攻击防御而丢弃 ¡ Failed to write ND message queue：报文写入ND报文队列失败 ¡ Failed to request memory：申请内存失败 ¡ Packet discarded for memory alarm notification：内存达到门限 ¡ Packet discarded for target address is tentative：报文的目标地址和接口暂定地址冲突 ¡ No DAD：双活网关地址冲突 · Time：诊断时间
ND-->IPv6	ND模块发送报文给IPv6基础模块，内容包括： · SrcMac：源MAC地址 · DstMac：目的MAC地址 · ErrReason：失败原因，取值为Packet discarded for icmpv6 defend，表示报文因ICMPv6 攻击防御而丢弃 · Time：诊断时间
IPv6-->ADJ6	IPv6基础模块发送报文给ADJ6模块，内容包括： · SrcMac：源MAC地址 · DstMac：目的MAC地址 · ErrReason：失败原因，取值包括： ¡ Failed to get vsys data：获取VSYS数据失败 ¡ Out Discards：发包处理时出错 ¡ The packet was bigger than the MTU：报文长度大于MTU值 · Time：诊断时间
ADJ6-->ETH	ADJ6模块发送报文给接口模块，内容包括： · SrcMac：源MAC地址 · DstMac：目的MAC地址 · ErrReason：失败原因，取值为ADJ6 output error，表示ADJ6模块输出错误 · Time：诊断时间
ETH-->QOS	接口模块发送报文给QoS模块，内容包括： · SrcMac：源MAC地址 · DstMac：目的MAC地址 · ErrReason：失败原因，取值包括： ¡ Failed to get Ethernet control block：获取接口控制块信息失败 ¡ Failed to pad packet：报文最短长度填充出错 ¡ Port blocked：端口堵塞 ¡ Failed to encapsulate link header：封装链路头失败 ¡ Failed to package vlan tag：封装VLAN TAG失败 · Time：诊断时间
QOS-->DRV	QoS模块发送报文给驱动模块，内容包括： · SrcMac：源MAC地址 · DstMac：目的MAC地址 · ErrReason：失败原因，取值为QoS sending failed，表示QoS模块发送报文失败 · Time：诊断时间

【相关命令】

· diagnostic troubleshooting enable

1.19 SSH一键诊断命令

1.19.1 diagnostic troubleshooting test ssh-server client-login

diagnostic troubleshooting test ssh-server client-login命令用来对SSH客户端登录执行一键诊断。

【命令】

diagnostic troubleshooting test ssh-server client-login { client-ipv4 ipv4-address | client-ipv6 ipv6-address } [ vpn-instance vpn-instance-name ] [ diagnostic-time diagnostic-time ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

client-ipv4 ipv4-address：指定SSH客户端的IPv4地址。

client-ipv6 ipv6-address：指定SSH客户端的IPv6地址。

diagnostic-time diagnostic-time：一键诊断的预计持续时间，取值范围为60～600，单位为秒，缺省值为60。本参数为诊断预计持续的时间，诊断实际需要的时间和该时间可能不同，请以实际情况为准，但诊断实际需要的时间肯定小于等于2*diagnostic-time。

【使用指导】

执行本命令后，设备会记录并显示诊断持续时间内，SSH客户端登录的信息，可方便用户定位客户端登录失败原因。

【举例】

# 对IP地址为192.168.169.1的IPv4 SSH客户端登录执行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test ssh-server client-login client-ipv4 192.168.169.1

Started at: 2022-04-01 11:19:35, estimated duration: 60 seconds.

Please wait...........................................................

Ended at: 2022-04-01 11:20:35, actual duration: 60 seconds.

Diagnosis report:

Connection setup state:

Init-->Ver-exchange-->Algorithm-

negotiation-->Keys-exchange-->Auth-request-->Serv-request-->Established

SSH login list:

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

ID : 1

Local IP : 192.168.169.2

Remote IP : 192.168.169.1

Service type : Stelnet

Username : root123

Failure reason : N/A

State : N/A

Suggestion : N/A

Local version : SSH-2.0

Remote version : SSH-2.0

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

表1-51 diagnostic troubleshooting ssh-server client-login命令信息描述表

字段	描述
Started at	SSH客户端登录一键诊断开始时间
Estimated duration	SSH客户端登录一键诊断预计持续时间
Ended at	SSH客户端登录一键诊断结束的时间
Actual duration	SSH客户端登录一键诊断实际花费的时间
Diagnosis report	诊断报告
Connection setup state	SSH登录的详细过程
ID	SSH登录索引
Login time	SSH客户端登录时间
Local IP	本端IP地址，即SSH服务器IP地址
Remote IP	远端IP地址，即SSH客户端IP地址
Service type	SSH服务类型，包括SCP、SFTP、Stelnet和NETCONF
Username	客户端登录服务器时采用的用户名
Login result	SSH客户端登录服务器状态，取值包括： · Succeeded：登录成功 · Failed：登录失败 · Logging In：登录中
Failure reason	SSH客户端登录失败原因： · N/A：无失败原因 · User logout：用户主动退出 · Unknown mistake：未知错误 · Denied according to ACL rules：客户端的IP地址不在ACL定义的permit规则范围内 · The number of SSH users reached the upper limit：SSH用户登录数量已达到上限 · Version mismatch：服务器端的SSH版本与客户端不兼容 · Encryption algorithm mismatch：服务器端的加密算法与客户端不匹配 · Host public key algorithm mismatch：服务器主机公钥算法与客户端支持的主机公钥算法不匹配 · MAC algorithm mismatch：服务器端的MAC算法与客户端支持的MAC算法不匹配 · Key exchange algorithm mismatch：服务器端的密钥交换算法与客户端支持的密钥交换算法不匹配 · Failed to load the DSA host key pair：加载DSA主机密钥对失败 · Failed to load the RSA host key pair：加载RSA主机密钥对失败 · Failed to load the ecdsa-sha2-nistp256 host key pair：加载ecdsa-sha2-nistp256主机密钥对失败 · Failed to load the ecdsa-sha2-nistp384 host key pair：加载ecdsa-sha2-nistp384主机密钥对失败 · Failed to load the x509v3-ecdsa-sha2-nistp256 host key pair：加载x509v3-ecdsa-sha2-nistp256主机密钥对失败 · Failed to load the x509v3-ecdsa-sha2-nistp384 host key pair：加载x509v3-ecdsa-sha2-nistp384主机密钥对失败 · DSA host key length is invalid：DSA主机密钥长度不符合长度规范 · Encryption key generation failed：加密密钥生成失败 · Authentication timed out：认证超时 · Password authentication failed：密码认证失败 · Public key authentication failed：公钥认证失败 · CA authentication failed：CA认证失败 · Authentication failed：授权失败 · No free user line：没有空闲用户线 · No user line available：没有可用的SSH类型的用户线 · SFTP service is disabled：SFTP服务未开启 · Stelnet service is disabled：Stelnet服务未开启 · NETCONF service is disabled：NETCONF over SSH服务未开启 · SCP service is disabled：SCP服务未开启 · Billing failed：计费失败
State	SSH登录阶段，取值包括： · Init：初始化状态 · Ver-exchange：版本协商 · Algorithm-negotiation：算法协商阶段 · Keys-exchange：密钥交换 · Auth-request：用户认证 · Serv-request：服务请求 · Established：会话已经建立
Suggestion	SSH客户端登录失败的处理建议： · N/A：无处理建议 · Do not log out during login：请勿在登录过程中退出 · Please contact the technical support：请联系专业人员 · Please add the corresponding acl rules or check client source legitimacy：请配置ACL规则，或检查客户端来源合法性 · Please release idle SSH logins first or increase the maximum number of concurrent SSH users by executing the aaa session-limit command：请先释放SSH空闲登录或通过aaa session-limit命令增加可登录的SSH用户数 · Please enable the SSH server to support SSH1 clients or login to a SSH server with version 2.0：请在服务端使能执行ssh server compatible-ssh1x enable命令设置设备兼容SSH1版本的客户端，或者使用SSH2版本登录 · Use the display ssh2 algorithm command to view the list of currently supported algorithms and use the ssh2 algorithm cipher command to make configuration changes：通过display ssh2 algorithm命令查看当前支持算法列表，如果与客户端使用的算法不匹配，可以使用ssh2 algorithm cipher命令进行配置更改 · Use the display ssh2 algorithm command to view the list of currently supported algorithms. If mismatch exists, use the ssh2 algorithm public-key command to make configuration changes for generating corresponding key pairs：使用display ssh2 algorithm命令查看当前支持算法列表，如果与客户端使用的算法不匹配，可以使用ssh2 algorithm public-key进行配置更改以及生成对应密钥对 · Use the display ssh2 algorithm command to view the list of currently supported algorithms. If mismatch exists, use the ssh2 algorithm mac command to make configuration changes for generating corresponding key pairs：使用display ssh2 algorithm命令查看当前支持算法列表，如果与客户端使用的算法不匹配，可以使用ssh2 algorithm mac命令进行配置更改以及生成对应密钥对 · Use the display ssh2 algorithm command to view the list of currently supported algorithms. If mismatch exists, use the ssh2 algorithm key exchange command to make configuration changes for generating corresponding key pairs：使用display ssh2 algorithm命令查看当前支持算法列表，如果与客户端使用的算法不匹配，可以使用ssh2 algorithm key exchange命令进行配置更改以及生成对应密钥对 · Please generate a DSA key：请生成DSA密钥 · Please generate an RSA key：请生成RSA密钥 · Please generate an ecdsa-sha2-nistp256 key：请生成ecdsa-sha2-nistp256密钥 · Please generate an ecdsa-sha2-nistp384 key：请生成ecdsa-sha2-nistp384密钥 · Please generate an x509v3-ecdsa-sha2-nistp256 key：请生成x509v3-ecdsa-sha2-nistp256密钥 · Please generate an x509v3-ecdsa-sha2-nistp384 key：请生成x509v3-ecdsa-sha2-nistp384密钥 · Please generate a DSA key with length less than 2048 bits：请生成长度小于2048比特的DSA密钥 · Please try to log in again：请重新登录尝试 · Please enter the authentication information in time：请及时输入认证信息 · Please make sure the username and password are entered correctly：请检查用户名以及密码是否输入正确 · Please check whether the client public key is imported and assigned to the corresponding user：请检查客户端公钥是否导入并分配给对应用户 · Please check if the certificate authentication is correct：请检查证书验证是否正确 · Please check the authorization configuration：请检查授权配置 · Please release idle connections：请释放空闲连接 · Please check the user line configuration：请检查用户线配置 · In system view, use the sftp server enable command to enable the SFTP service：在系统视图下，使用sftp server enable命令开启SFTP服务 · In system view, use the ssh server enable command to enable the Stelnet service：在系统视图下，使用ssh server enable命令开启Stelnet服务 · In system view, use the netconf ssh server enable command to enable the NETCONF service：在系统视图下，使用netconf ssh server enable命令开启NETCONF over SSH的接入方式 · In system view, use the scp server enable command to enable the SCP service：在系统视图下，使用scp server enable命令开启SCP服务 · Please check the billing configuration：请检查计费配置
Local version	服务器端SSH版本信息
Remote version	客户端SSH版本信息

‌

【相关命令】

· diagnostic troubleshooting enable

1.20 登录设备一键诊断命令

1.20.1 diagnostic troubleshooting test telnet-server client-login

diagnostic troubleshooting test telnet-server client-login命令用来对Telnet客户端的登录事件进行一键诊断。

【命令】

diagnostic troubleshooting test telnet-server client-login { client-ipv4 ipv4-address | client-ipv6 ipv6-address } [ vpn-instance vpn-instance-name ] [ diagnostic-time diagnostic-time ]

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

client-ipv4 ipv4-address：指定客户端IPv4地址。

client-ipv6 ipv6-address ：指定客户端IPv6地址。

vpn-instance vpn-instance-name：指定客户端IP地址所属的VPN实例。vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。如果未指定本参数，则表示IP地址位于公网中。

diagnostic-time diagnostic-time：指定诊断时长，整数形式，取值范围是60～600，单位是秒，缺省值为60。本参数为诊断预计持续的时间，诊断实际需要的时间和该时间可能不同，请以实际情况为准，但诊断实际需要的时间肯定小于等于2*diagnostic-time。

【使用指导】

请先使用diagnostic troubleshooting test telnet-server client-login enable命令，开启Telnet客户端登录事件的一键诊断功能，否则，本命令执行失败。Telnet客户端登录事件的一键诊断功能缺省处于开启状态。

执行本命令后，设备会记录并显示指定时长内，Telnet客户端的登录信息，帮助用户定位客户端登录失败原因。

【举例】

# 对IPv4地址为192.168.169.1的Telnet客户端登录执行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test telnet-server client-login client-ipv4 192.168.169.1

Start diagnose at 2023-07-18 02:03:59, Estimated time:60 seconds.

Please wait..............................................................Done.

End diagnose at 2023-07-18 02:05:01, Actual time:62 seconds.

Diagnosis report:

Connection setup:

Connection init--> Resources application-->Authentication -->Login

Telnet login list:

ID : 1

Logged at : 2022-06-09, 15:58:02:584

Local IP : 192.168.169.2

Client IP : 192.168.169.1

UserName : root123

Failure reason : N/A

Failure stage : N/A

Suggestion : N/A

表1-52 diagnostic troubleshooting telnet-server client-login 命令信息描述表

字段	描述
ID	TELNET客户端索引
LoginTime	登录时间
Local-ip	服务器IP地址
remote-ip	客户端IP地址
UserName	登录用户名，N/A表示无用户名
Login-Result	登录结果： · Succeeded：登录成功 · Failed：登录失败 · Logging：登录中
Fail-Reason	失败原因： · N/A：无错误原因 · User logged out：用户主动退出 · Unknown mistake：未知错误 · Denied by ACL：ACL拒绝 · Maximum number of Telnet users already reached：TELNET用户登录数量已满 · No free user line：没有空闲用户线 · No available user line：没有可用用户线 · Password authentication failed：密码认证失败 · Authorization failed：授权失败 · Accounting failed：计费失败 · Authentication timed out：认证超时
Fail-State	登录阶段： · Connection init：包括ACL处理和用户登录数量处理 · Resources application：用户线资源申请 · Authentication：认证
Suggestion	处理建议： · N/A：无处理建议 · Do not log out during login：请勿在登录过程中退出 · Please contact professionals：请联系专业人员 · Please add the corresponding ACL rules or check client validity：请补充对应ACL规则，或检查客户端来源合法性 · Please release idle Telnet logins first or increase the maximum number of AAA users session-limit：请先释放TELNET空闲会话或者连接或通过aaa session-limit增加用户数量 · Please release idle connections：请释放空闲连接 · Please check the user line configuration first：请检查用户线配置 · Please verify that the username and password are entered correctly：请检查用户名以及密码是否输入正确 · Please check the authorization configuration：请检查授权配置 · Please check the accounting configuration：请检查计费配置 · Please enter authentication information in time：请及时输入认证信息

1.21 IP路由基础一键诊断命令

1.21.1 diagnostic troubleshooting test rib ipv4-unicast

diagnostic troubleshooting test rib ipv4-unicast命令用来对IPv4单播路由变化事件进行一键诊断。

【命令】

diagnostic troubleshooting test rib ipv4-unicast

【视图】

系统视图

【缺省用户角色】

network-admin

network-operator

【使用指导】

应用场景

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

配置准备

请先使用diagnostic troubleshooting test rib ipv4-unicast enable命令，开启IPv4单播路由变化事件一键诊断功能，否则，本命令执行失败。（IPv4单播路由变化事件一键诊断功能缺省处于开启状态）

【举例】

# 对IPv4单播路由变化事件进行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test rib ipv4-unicast

Start diagnose at 2023-11-14 07:22:15

please wait.Done.

End diagnose at 2023-11-14 07:22:16,Actual time:1 seconds.

Diagnose report:

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

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

Route change history information:

DateTime DataType ChgeType Protocol Destination/Mask Prefe

rence Cost NibID Flag VrfName

(NBR)NextHop (NBR)

Interface

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

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

2023-11-09,02:53:22:891 NBR Add USR 192.168.1.60

0x11000000 0x00000000

2023-11-09,02:53:22:965 NBR Add IFM 192.168.1.101 Gigab

itEthernet1/0/1 0x10000003 0x00000000

2023-11-09,02:53:22:965 Prefix Add DIRECT 192.168.1.101/32 0

0 0x10000000 0x00000004

2023-11-09,02:53:22:965 Prefix Add DIRECT 192.168.1.0/24 0

0 0x10000003 0x00000080

2023-11-09,02:53:22:965 Prefix Add DIRECT 192.168.1.255/32 0

0 0x10000003 0x0000008C

2023-11-09,02:53:22:965 Prefix Add DIRECT 192.168.1.0/32 0

0 0x10000003 0x0000008C

2023-11-09,02:53:23:67 NBR Modify USR 192.168.1.60

0x11000000 0x00000080

2023-11-09,02:53:23:67 Prefix Add STATIC 0.0.0.0/0 60

0 0x11000000 0x00000060

表1-53 diagnostic troubleshooting test rib ipv4-unicast命令显示信息描述表

字段	描述
DateTime	检测时间
DataType	数据类型，取值包括： · Prefix：路由前缀 · NBR：路由下一跳
ChangeType	路由变化的类型，取值包括： · Add：路由被添加到IPv4单播路由表 · Modify：路由被修改 · Delete：路由从IPv4单播路由表中删除
Protocol	路由协议
Destination/Mask	目的IPv4地址和掩码
Preference	路由的优先级
Cost	路由的度量值
(NBR)Nexthop	下一跳IPv4地址
(NBR)Interface	出接口
NbrID	下一跳ID
Flag	路由标记
VrfName	VPN实例名称，公网路由不显示本字段

1.21.2 diagnostic troubleshooting test rib ipv6-unicast

diagnostic troubleshooting test rib ipv6-unicast命令用来对IPv6单播路由变化事件进行一键诊断。

【命令】

diagnostic troubleshooting test rib ipv6-unicast

【视图】

系统视图

【缺省用户角色】

network-admin

network-operator

【使用指导】

应用场景

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

配置准备

请先使用diagnostic troubleshooting test rib ipv6-unicast enable命令，开启IPv4单播路由变化事件一键诊断功能，否则，本命令执行失败。（IPv6单播路由变化事件一键诊断功能缺省处于开启状态）

【举例】

# 对IPv6单播路由变化事件进行一键诊断。

<Sysname> system-view

[Sysname] diagnostic troubleshooting test rib ipv6-unicast

Start diagnose at 2023-11-14 07:24:07

please wait.Done.

End diagnose at 2023-11-14 07:24:08,Actual time:1 seconds.

Diagnose report:

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

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

Route change history information:

DateTime DataType ChgeType Protocol Prefix/PrefixLen

Preference Cost NibID

Flag VrfName

(NBR)NextHop

(NBR)Interface

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

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

2023-11-14,07:04:06:632 NBR Add IFM ::

InLoopBack0 0x20000000

0x00000000

2023-11-14,07:04:06:632 Prefix Add DIRECT FE80/10

0 0 0x20000000

0x00000084

2023-11-14,07:04:07:357 Prefix Add DIRECT 10/64

0 0 0x20000001

0x00000080

2023-11-14,07:04:07:926 NBR Add IFM 1

InLoopBack0 0x20000002

0x00000000

2023-11-14,07:04:07:928 NBR Add IFM ::

InLoopBack0 0x20000003

0x00000000

2023-11-14,07:04:07:928 Prefix Add DIRECT 1/128

0 0 0x20000002

0x00000004

2023-11-14,07:04:07:928 Prefix Modify DIRECT 10/64

0 0 0x20000001

0x00000080

2023-11-14,07:04:07:928 Prefix Modify DIRECT 1/128

0 0 0x20000002

0x00000004

2023-11-14,07:04:07:928 Prefix Modify DIRECT FE80/10

0 0 0x20000000

0x00000084

2023-11-14,07:04:08:548 NBR Modify IFM ::

GigabitEthernet1/0/1 0x20000001

0x00000084

2023-11-14,16:53:29:903 NBR Add OSPFv3 FE80::21A:5EFF:FE58:30A4

GigabitEthernet1/0/1 0x23000002

0x00000005

表1-54 diagnostic troubleshooting test rib ipv6-unicast命令显示信息描述表

字段	描述
DateTime	检测时间
DataType	数据类型，取值包括： · Prefix：路由前缀 · NBR：路由下一跳
ChangeType	路由变化的类型，取值包括： · Add：路由被添加到IPv6单播路由表 · Modify：路由被修改 · Delete：路由从IPv6单播路由表中删除
Protocol	路由协议
Destination/Mask	目的地址和掩码
Preference	路由的优先级
Cost	路由的度量值
(NBR)Nexthop	下一跳IPv4地址
(NBR)Interface	出接口
NbrID	下一跳ID
Flag	路由标记
VrfName	VPN实例名称，公网路由不显示本字段

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

热门推荐

热门推荐

H3C服务器

HPE服务器

热门推荐

H3C存储

HPE存储

热门推荐

商用台式机

商用笔记本

商用显示器

配件

热门推荐

热门推荐

智能终端

技术解决方案

热门推荐

热门推荐

热门推荐

热门推荐

热门推荐

热门推荐

热门推荐

专业安全服务

安全运营服务

热门推荐

热门推荐

热门推荐

热门推荐

热门推荐

技术支持

自助服务

热门推荐

热门推荐

热门推荐

热门推荐

合作伙伴培训与认证

热门推荐

热门推荐

公司刊物

加入我们

国家/地区

28-智能运维命令参考

目录

03-一键诊断命令

1 一键诊断

1.2 CPU一键诊断命令

工作机制

注意事项

工作机制

注意事项

工作机制

注意事项

工作机制

注意事项

1.4 AAA一键诊断命令

1.4.1 diagnostic trouble-shooting health module aaa

应用场景

配置准备

应用场景

配置准备

注意事项

应用场景

配置准备

注意事项

应用场景

配置准备

注意事项

应用场景

配置准备

应用场景

配置准备

注意事项

应用场景

配置准备

注意事项

应用场景

配置准备

注意事项

1.5 LDP一键诊断命令