用户对语音质量的评价具有一定的主观性，不同用户对语音质量的容忍程度不同，因此，衡量语音质量时，需要考虑用户的主观因素。对语音质量容忍程度较强的用户，可以通过advantage-factor命令配置补偿因子，在计算ICPIF值时将减去该补偿因子，修正ICPIF和MOS值，以便在比较语音质量时综合考虑客观和主观因素。

工作机制

在语音测试中的补偿因子是一种用于评估SDH/PDH数字化电路质量的参数。补偿因子的主要目的是校正数字语音信号在网络中传输时引起的失真，是用户对被测网络语音传输质量损耗的预期补偿。测试人员可以根据被测传输网络距离和介质的不同来指定不同的补偿因子值。越是预期损耗大的网络，该值则越大。

1.1.3 agent-type

agent-type命令用来配置SNMP-DCA测试的SNMP Agent类型。

undo agent-type命令用来恢复缺省情况。

【命令】

agent-type { net-snmp | user-defined | windows }

undo agent-type

【缺省情况】

SNMP-DCA测试的SNMP Agent类型为Net-SNMP。

【视图】

SNMP-DCA类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

net-snmp：表示SNMP Agent的类型为Net-SNMP。

user-defined：表示SNMP Agent的类型为User-defined。

windows：表示SNMP Agent的类型为Windows。

【使用指导】

SNMP-DCA测试用于监测SNMP Agent的状态。设备通常以SNMP Agent的CPU/内存/硬盘的使用率作为参数，和用户配置的阈值、权重计算后得到的结果来判断SNMP Agent的状态。

不同类型的SNMP Agent，其CPU/内存/硬盘使用率MIB节点的OID不同。建议设备上配置的类型和需要监测的SNMP Agent的类型一致。

对于Net-SNMP和Windows类型，开启SNMP-DCA测试后，设备会自动获取SNMP Agent的CPU/内存/硬盘使用率来判断SNMP Agent的状态。用户可通过cpu、memory和disk命令修改相应的阈值和权重，也可以使用oid命令增加关注的节点。

对于User-defined类型，因为设备不能自动获取到SNMP Agent上MIB节点的OID，所以，需要用户使用oid命令配置每个需要关注的MIB节点，包括CPU/内存/硬盘使用率对应的MIB节点。

【举例】

# 在SNMP-DCA类型的NQA模板视图下配置SNMP-DCA测试的SNMP Agent类型为Windows。

<Sysname> system-view

[Sysname] nqa template snmpdca test

[Sysname-nqatplt-snmpdca-test] agent-type windows

【相关命令】

· cpu

· disk

· memory

· oid

1.1.4 auth-app-id

auth-app-id命令用来配置Diameter探测报文中认证和授权应用ID字段的值。

undo auth-app-id命令用来恢复缺省情况。

【命令】

auth-app-id application-id

undo auth-app-id

【缺省情况】

未配置Diameter探测报文中认证和授权应用ID字段的值。

【视图】

Diameter类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

application-id：表示Diameter探测报文中认证和授权应用ID字段的值，取值范围为1～4294967295。

【使用指导】

本命令用于配置Diamater探测请求报文中Auth-Application-Id键值对的值，表示本端Diameter节点支持的应用ID。

【举例】

# 配置Diameter探测报文中认证和授权应用ID字段的值为1000。

<Sysname> system-view

[Sysname] nqa template diameter diametertplt

[Sysname-nqatplt-diameter-diametertplt] auth-app-id 1000

1.1.5 codec-type

codec-type命令用来配置语音测试的编码格式。

undo codec-type命令用来恢复缺省情况。

【命令】

codec-type { g711a | g711u | g729a }

undo codec-type

【缺省情况】

语音编码格式为G.711 A律。

【视图】

Voice测试类型视图

【缺省用户角色】

network-admin

【参数】

g711a：G.711A律语音编码格式。

g711u：G.711µ律语音编码格式。

g729a：G.729A律语音编码格式。

【使用指导】

应用场景

本命令用于模拟指定编码格式的语音流进行语音测试。

工作机制

G.711A、G.711µ和G.729A是VoIP中常见的编解码器类型，它们用于将模拟语音信号转换为数字语音信号，并进行传输和解码。

· G.711A：G.711A是ITU-T规定的一种音频编码规范，其采样频率为8 kHz，位深度为8位，针对声音的即时传输而设计，具有较高的音质和容错性。

· G.711µ：G.711µ是ITU-T规定的另一种音频编码规范，其与G.711A的区别主要在于量化的方式不同，采用的是对称量化方式，它也采样频率为8 kHz，位深度为8位。

· G.729A：G.729A是一种高压缩比的音频编码规范，采样频率为8 kHz，位深度为8位，它将语音信号压缩到仅需8 kbit/s的数据率，适合用于带宽较小的网络传输。它的音质相对于G.711会有所降低，但是对网络的带宽的要求也相应减少。

配置本命令后，设备会生成对应编码格式的语音流，来进行语音测试。

【举例】

# 在Voice测试类型下配置语音测试的编码格式为G.729A律。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type voice

[Sysname-nqa-admin-test-voice] codec-type g729a

1.1.6 community read

community read命令用来配置用于SNMP测试使用的团体名。

undo community read命令用来恢复缺省情况。

【命令】

community read { cipher | simple } community-name

undo community read

【缺省情况】

SNMP测试使用的团体名为public。

【视图】

SNMP测试类型视图

SNMP/SNMP-DCA类型的模板视图

【缺省用户角色】

network-admin

【参数】

cipher：以密文方式配置团体名。

simple：以明文方式配置团体名，该密码将以密文形式存储。

community-name：测试使用的团体名，区分大小写。当以明文形式配置时，团体名为1～32个字符的字符串；当以密文形式配置时，团体名为33～73个字符的字符串。

【使用指导】

当被测试的SNMP Agent的版本为SNMPv1或者SNMPv2c时，若SNMP Agent配置了团体名，则SNMP测试组必须配置本命令，且配置的团体名必须与SNMP Agent上已配置的只读或读写权限团体名保持一致，才能通过SNMP Agent的认证，并进行探测。当SNMP Agent的版本为SNMPv3时，由于SNMPv3没有团体名概念，不需要配置团体名，直接进行探测。有关团体名及SNMP认证的具体介绍请参见“网络管理和监控”中的“SNMP”。

【举例】

# 配置SNMP探测报文使用的团体名称为readaccess。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type snmp

[Sysname-nqa-admin-test-snmp] community read simple readaccess

1.1.7 cpu

cpu命令用来配置SNMP-DCA测试的SNMP Agent的CPU的阈值和权重。

undo cpu命令用来恢复缺省情况。

【命令】

cpu { threshold threshold-value | weight weight-value } *

undo cpu

【缺省情况】

SNMP-DCA测试的SNMP Agent的CPU阈值为80，权重为3。

【视图】

SNMP-DCA类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

threshold threshold-value：阈值，表示CPU使用率可达到的上限。取值范围为0～100，取值为0时表示CPU不作为判断SNMP Agent是否繁忙的参考。不指定该参数时，表示使用缺省值。

weight weight-value：权重，表示CPU在用于计算SNMP Agent状态时应占有的比重。取值范围为0～100，取值为0时表示CPU不参与SNMP Agent状态的计算。不指定该参数时，表示使用缺省值。

【使用指导】

本命令仅对Net-SNMP或Windows类型的SNMP Agent生效。

NQA客户端对Net-SNMP或Windows类型的SNMP Agent进行SNMP-DCA测试时，会自动获取SNMP Agent当前的CPU利用率。

【举例】

# 在SNMP-DCA类型的NQA模板视图下配置测试的SNMP Agent的CPU阈值为90、权重为90。

<Sysname> system-view

[Sysname] nqa template snmpdca test

[Sysname-nqatplt-snmpdca-test] cpu threshold 90 weight 90

【相关命令】

· agent-type

1.1.8 data-fill

data-fill命令用来配置探测报文的填充字符串。

undo data-fill命令用来恢复缺省情况。

【命令】

data-fill string

undo data-fill

【缺省情况】

探测报文的填充内容为十六进制00010203040506070809。

【视图】

ICMP-echo/UDP-echo测试类型视图

Path-jitter/UDP-jitter/Voice测试类型视图

TWAMP-light-client-session视图

ICMP/TCP/UDP类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

string：探测报文的填充内容，为1～200个字符的字符串，区分大小写。

【使用指导】

应用场景

当需要测量大数据包在网络中的传输性能时，可以配置data-fill和data-size命令。设备将使用指定的字符串将测试报文填充到指定的长度，用于模拟指定内容的业务报文。

工作机制

对于不同的测试类型，填充字符串的情况有所不同：

· 在ICMP-echo测试中，配置的字符串用来填充ICMP Echo消息的数据字段。

· 在UDP-echo测试中，由于UDP报文数据字段的前5个字节具有特定用途，所以只用所配置的字符串填充报文中剩余的字节。

· 在UDP-jitter测试中，UDP报文数据字段的前68个字节具有特定用途，所以只用所配置的字符串填充报文中剩余的字节。

· 在Voice测试中，UDP报文数据字段的前16个字节具有特定用途，所以只用所配置的字符串填充报文中剩余的字节。

· 在Path-jitter测试中，由于ICMP探测阶段ICMP报文数据字段的前4个字节具有特定用途，所以只用所配置的字符串填充ICMP报文中剩余的字节。

实际填充的字符与填充数据长度有关：

· 如果探测报文的数据段长度比配置的填充数据长度小，系统在报文封装时以报文的数据段长度为界截取该字符串的前一部分；

· 如果探测报文的数据段长度比配置的填充数据长度大，系统在报文封装时用该字符串进行循环填充，直到填满。

例如，配置填充数据为“abcd”，当探测报文数据段长度为3字节时，则取“abc”作为填充数据；当探测报文数据段长度为6字节时，则使用“adcdab”作为填充数据。

注意事项

本命令与hex-data-fill命令作用相同，多次执行这两条命令时，最后一次执行的命令生效。

【举例】

# 在ICMP-echo测试类型下配置探测报文的填充字符串为abcd。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] data-fill abcd

# 在TWAMP-light-client-session视图下配置探测报文的填充字符串为abcd。

<Sysname> system-view

[Sysname] nqa twamp-light client

[Sysname-nqa-twamp-light-client] test-session 1

[Sysname-nqa-twamp-light-client-session1] data-fill abcd

1.1.9 data-size

data-size命令用来配置探测报文中的填充内容的大小。

undo data-size命令用来恢复缺省情况。

【命令】

data-size size

undo data-size

【缺省情况】

缺省情况如表1-1所示。

表1-1 探测报文中的填充内容大小的缺省值

测试类型	编码类型	缺省值（字节）
ICMP-echo	-	100
UDP-echo	-	100
UDP-jitter	-	100
UDP-tracert	-	100
Path-jitter	-	100
Voice	G.711 A律	172
Voice	G.711 µ律	172
Voice	G.729 A律	32
TWAMP-light	-	142

【视图】

ICMP-echo/UDP-echo 测试类型视图

UDP-tracert测试类型视图

Path-jitter/UDP-jitter/Voice测试类型视图

TWAMP-light-client-session视图

ICMP/UDP/Tracert类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

size：探测报文中的填充内容的大小，单位为字节，取值范围为：

· ICMP-echo、UDP-echo和UDP-tracert测试类型取值范围为20～65507。

· UDP-jitter和Path-jitter测试类型取值范围为68～65507。

· Voice测试类型取值范围为16～65507。

· NQA TWAMP-light测试：44～1518。

【使用指导】

应用场景

注意事项

对于ICMP-echo和Path-jitter测试，探测报文中填充内容的大小为ICMP Echo消息中数据字段的长度。

在path-jitter测试中，发送的ICMP报文长度为：size+IP报文头部（20字节）+ICMP报文头部（通常为8字节），总长度不能超过最大值65535字节。在测试前，如果配置了lsr-path命令，会使ICMP报文头部变长，此时size参数不宜设置过大，以免超过65535字节的最大负载，导致探测失败。

对于UDP-echo、UDP-jitter、和UDP-tracert和Voice测试，探测报文中填充内容的大小为UDP报文中数据字段的长度。

TWAMP-light测试的探测报文中填充内容的大小不能大于测试链路上所有接口的MTU值。

【举例】

# 在ICMP-echo测试类型下配置探测报文中的填充内容的大小为80字节。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] data-size 80

# 在TWAMP-light-client-session视图下配置探测报文中的填充内容的大小为80字节。

<Sysname> system-view

[Sysname] nqa twamp-light client

[Sysname-nqa-twamp-light-client] test-session 1

[Sysname-nqa-twamp-light-client-session1] data-size 80

【相关命令】

· lsr-path

1.1.10 description

description命令用来配置测试组的描述信息，通常用于描述一个测试组的测试类型或测试目的。undo description命令用来恢复缺省情况。

【命令】

description text

undo description

【缺省情况】

未配置描述信息。

【视图】

ICMP-echo/UDP-echo/TCP测试类型视图

ARP/DHCP/DLSw/DNS/FTP/HTTP/HTTP2/SNMP测试类型视图

UDP-tracert测试类型视图

ICMP-jitter/UDP-jitter/Path-jitter/Voice测试类型视图

TWAMP-light-client-session视图

任意类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

text：测试组的描述，为1～200个字符的字符串，区分大小写。

【举例】

# 在ICMP-echo测试类型下配置测试组的描述信息为icmp-probe。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] description icmp-probe

# 在TWAMP-light-client-session视图下配置测试组的描述信息为twamp-probe。

<Sysname> system-view

[Sysname] nqa twamp-light client

[Sysname-nqa-twamp-light-client] test-session 1

[Sysname-nqa-twamp-light-client-session1] description twamp-probe

1.1.11 destination host

destination host命令用来配置探测报文的目的主机名。

undo destination host命令用来恢复缺省情况。

【命令】

destination host host-name

undo destination host

【缺省情况】

未配置探测报文的目的主机名。

【视图】

UDP-tracert测试类型视图

【缺省用户角色】

network-admin

【参数】

host-name：探测报文的目的主机名，为1～254个字符的字符串，区分大小写，字符串中可以包含字母、数字、“-”、“_”和“.”，不能出现连续的“.”。如果目的主机名由“.”分隔成多个段，则每段不能超过63个字符。

【使用指导】

如果要配置探测报文的目的IP地址，请使用destination ip或destination ipv6命令。

【举例】

# 在UDP-Tracert测试类型下配置探测报文的目的主机名为www.test.com。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type udp-tracert

[Sysname-nqa-admin-test-udp-tracert] destination host www.test.com

1.1.12 destination ip

destination ip命令用来配置探测报文的目的IPv4地址。

undo destination ip命令用来恢复缺省情况。

【命令】

destination ip ip-address

undo destination ip

【缺省情况】

未配置探测报文的目的IPv4地址。

【视图】

ICMP-echo/TCP/UDP-echo测试类型视图

ARP/DHCP/DLSw/DNS/SNMP测试类型视图

UDP-tracert测试类型视图

ICMP-jitter/Path-jitter/UDP-jitter/Voice测试类型视图

TWAMP-light-client-session视图

ARP/Diameter/DNS/ICMP/IMAP/POP3/RADIUS认证探测/RADIUS-ACCOUNT计费探测/SMTP/SNMP/SNMP-DCA/SSL/TCP/TCPHalf Open/UDP/WAP/Tracert类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

ip-address：探测报文的目的IPv4地址。

【使用指导】

对于TWAMP-light测试,不管在二层网络还是三层网络执行测试，源IP地址、目的IP地址、源端口号、目的端口号必须配置。并且，对于三层网络，需确保本机有到达目的IP地址的路由，源IP地址和目的IP地址之间路由可达。

【举例】

# 在ICMP-echo测试类型下配置探测报文的目的IPv4地址为10.1.1.1。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] destination ip 10.1.1.1

# 在TWAMP-light-client-session视图下配置探测报文的目的IPv4地址为10.1.1.2。

<Sysname> system-view

[Sysname] nqa twamp-light client

[Sysname-nqa-twamp-light-client] test-session 1

[Sysname-nqa-twamp-light-client-session1] destination ip 10.1.1.2

1.1.13 destination ipv6

destination ipv6命令用来配置探测报文的目的IPv6地址。

undo destination ipv6命令用来恢复缺省情况。

【命令】

destination ipv6 ipv6-address

undo destination ipv6

【缺省情况】

未配置探测报文的目的IPv6地址。

【视图】

ICMP-echo/TCP/UDP-echo/UDP-jitter测试类型视图

TWAMP-light-client-session视图

Diameter/DNS/ICMP/IMAP/POP3/RADIUS认证探测/RADIUS-ACCOUNT计费探测/SMTP/SIP/SNMP/SNMP-DCA/SSL/TCP/TCP Half Open/UDP/WAP类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

ipv6-address：探测报文的目的IPv6地址，不支持IPv6链路本地地址。

【使用指导】

UDP-jitter测试的MPLS模拟测试功能暂不支持使用IPv6地址作为探测报文的目的地址。

【举例】

# 在ICMP-echo测试类型下配置探测报文的目的IPv6地址为1::1。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] destination ipv6 1::1

# 在TWAMP-light-client-session视图下配置探测报文的目的IPv6地址为1::2。

<Sysname> system-view

[Sysname] nqa twamp-light client

[Sysname-nqa-twamp-light-client] test-session 1

[Sysname-nqa-twamp-light-client-session1] destination ipv6 1::2

1.1.14 destination mac

destination mac命令配置探测报文的目的MAC地址。

undo destination mac命令用来恢复缺省情况。

【命令】

destination mac mac-address

undo destination mac

【缺省情况】

未配置探测报文的目的MAC地址。

【视图】

TWAMP-light-client-session视图

【缺省用户角色】

network-admin

【参数】

mac-address：探测报文的目的MAC地址，格式为H-H-H。在配置时，可以省去MAC地址中每段开头的“0”，例如：输入“f-e2-1”即表示输入的MAC地址为“000f-00e2-0001”。

【使用指导】

在二层网络执行测试TWAMP-light时，必须配置源MAC地址和目的MAC地址，并确保目的MAC地址是本机MAC地址表中的地址，源MAC地址和目的MAC地址之间二层可达。否则，测试可能失败。

【举例】

# 在TWAMP-light-client-session视图下配置探测报文的目的MAC地址为0001-0001-0002。

<Sysname> system-view

[Sysname] nqa twamp-light client

[Sysname-nqa-twamp-light-client] test-session 1

[Sysname-nqa-twamp-light-client-session1] destination mac 1-1-2

1.1.15 destination port

destination port命令用来配置测试操作的目的端口号。

undo destination port命令用来恢复缺省情况。

【命令】

destination port port-number

undo destination port

【缺省情况】

对于UDP-tracert测试，目的端口号缺省为33434；对于SNMP测试，目的端口号缺省为161；对于其他类型测试，未配置测试操作的目的端口号。

对于NQA模板，缺省目的端口号分别为：DNS（53）、IMAP（143）、POP3（110）、RADIUS认证探测（1812）、RADIUS-ACCOUNT计费探测（1813）、SIP（5060）、SMTP（25）、SNMP（161）、SNMP-DCA（161）、WAP（9201）、Tracert（33434）、Diameter（不使用TLS时为3868，使用TLS时为5658），其他类型模板未配置测试操作的目的端口号。

【视图】

TCP/UDP-echo测试类型视图

SNMP测试类型视图

UDP-tracert测试类型视图

UDP-jitter/Voice测试类型视图

TWAMP-light-client-session视图

Diameter/DNS/IMAP/POP3/RADIUS认证探测/RADIUS-ACCOUNT计费探测/SIP/SMTP/SNMP/SNMP-DCA/SSL/TCP/TCP Half Open/UDP/WAP/Tracert类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

port-number：测试操作的目的端口号，取值范围为1～65535。

【使用指导】

【举例】

# 在UDP-echo测试类型视图下配置测试操作的目的端口号为9000。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type udp-echo

[Sysname-nqa-admin-test-udp-echo] destination port 9000

# 在TWAMP-light-client-session视图下配置测试操作的目的端口号为9000。

<Sysname> system-view

[Sysname] nqa twamp-light client

[Sysname-nqa-twamp-light-client] test-session 1

[Sysname-nqa-twamp-light-client-session1] destination port 9000

1.1.16 disconnect-mode

disconnect-mode命令用来设置TCP测试的TCP连接断开方式。

undo disconnect-mode命令用来恢复缺省情况。

【命令】

disconnect-mode { fin | rst }

undo disconnect-mode

【缺省情况】

TCP测试的TCP连接断开方式为RST。

【视图】

TCP类型的模板视图

【缺省用户角色】

network-admin

【参数】

fin：TCP测试的TCP连接断开方式为FIN。

rst：TCP测试的TCP连接断开方式为RST。

【使用指导】

一次TCP测试包括三次握手建立TCP连接和断开TCP连接，完成该过程表示NQA的TCP测试成功，本命令可以设置断开TCP连接的方式：

· RST：通过发送RST报文，快速释放TCP连接。收到RST报文后，另一端就终止连接，不需要发送任何响应。

· FIN：四次握手断开TCP连接，不支持RST方式情况下可以设置为该方式。被断开的一方收到FIN报文后需要发送ACK。

【举例】

# 在TCP类型的NQA模板视图下设置TCP测试的TCP连接断开方式为FIN。

<Sysname> system-view

[Sysname] nqa template tcp test

[Sysname-nqatplt-tcp-test] disconnect-mode fin

1.1.17 disk

disk命令用来配置SNMP-DCA测试的SNMP Agent硬盘的阈值和权重。

undo disk命令用来恢复缺省情况。

【命令】

disk { threshold threshold-value | weight weight-value } *

undo disk

【缺省情况】

SNMP-DCA测试的SNMP Agent硬盘的阈值为90，权重为4。

【视图】

SNMP-DCA类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

threshold threshold-value：阈值，表示硬盘使用率可达到的上限。取值范围为0～100，取值为0时表示硬盘不作为判断SNMP Agent是否繁忙的参考。不指定该参数时，表示使用缺省值。

weight weight-value：权重，表示硬盘在用于计算SNMP Agent状态时应占有的比重，取值范围为0～100，取值为0时表示硬盘不参与SNMP Agent状态的计算。不指定该参数时，表示使用缺省值。

【使用指导】

本命令仅对Net-SNMP或Windows类型的SNMP Agent生效。

NQA客户端对Net-SNMP或Windows类型的SNMP Agent进行SNMP-DCA测试时，会自动获取SNMP Agent当前的硬盘使用率

【举例】

# 在SNMP-DCA类型的NQA模板视图下配置测试的SNMP Agent硬盘阈值为90、权重为90。

<Sysname> system-view

[Sysname] nqa template snmpdca test

[Sysname-nqatplt-snmpdca-test] disk threshold 90 weight 90

【相关命令】

· agent-type

1.1.18 display nqa history

display nqa history命令用来显示NQA测试组的历史记录。

【命令】

display nqa history [ admin-name operation-tag ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

admin-name：创建NQA测试组的管理员名称，为1～32个字符的字符串，字符串中不能包括“-”，不区分大小写。

operation-tag：测试操作的标签，为1～32个字符的字符串，字符串中不能包括“-”，不区分大小写。

【使用指导】

配置前提

配置本命令前，请先执行history-record enable命令开启NQA测试组的历史记录保存功能，否则，执行本命令将无显示信息。缺省情况下，UDP-tracert测试类型的历史记录保存功能处于开启状态，其他类型的NQA测试组的历史记录保存功能处于关闭状态。

注意事项

display nqa history命令的显示信息无法反映ICMP-jitter、Path-jitter、UDP-jitter和Voice测试的结果。如果想了解ICMP-jitter、Path-jitter、UDP-jitter和Voice测试的结果，建议通过display nqa result命令查看最近一次NQA测试的结果，或通过display nqa statistics命令查看NQA测试的统计信息。

不指定任何参数，则表示显示所有测试组的历史记录。

【举例】

# 显示管理员名称为administrator、测试类型标签为tracert的UDP-tracert测试项的历史记录。

<Sysname> display nqa history administrator tracert

NQA entry (admin administrator, tag tracert) history records:

Index TTL Response Hop IP Status Time

1 2 328 4.1.1.1 Succeeded 2019-09-09 14:46:06.2

1 2 328 4.1.1.1 Succeeded 2019-09-09 14:46:05.2

1 2 328 4.1.1.1 Succeeded 2019-09-09 14:46:04.2

1 1 328 3.1.1.2 Succeeded 2019-09-09 14:46:03.2

1 1 328 3.1.1.1 Succeeded 2019-09-09 14:46:02.2

1 1 328 3.1.1.1 Succeeded 2019-09-09 14:46:01.2

# 查看管理员名称为administrator、测试操作标签为test的NQA测试组的历史记录。

<Sysname> display nqa history administrator test

NQA entry (admin administrator, tag test) history records:

Index Response Status Time

10 329 Succeeded 2019-04-29 20:54:26.5

9 344 Succeeded 2019-04-29 20:54:26.2

8 328 Succeeded 2019-04-29 20:54:25.8

7 328 Succeeded 2019-04-29 20:54:25.5

6 328 Succeeded 2019-04-29 20:54:25.1

5 328 Succeeded 2019-04-29 20:54:24.8

4 328 Succeeded 2019-04-29 20:54:24.5

3 328 Succeeded 2019-04-29 20:54:24.1

2 328 Succeeded 2019-04-29 20:54:23.8

1 328 Succeeded 2019-04-29 20:54:23.4

表1-2 display nqa history命令显示信息描述表

字段	描述
Index	历史记录的编号，一次UDP-tracert测试中的所有记录此编号一致
TTL	本次探测发送的探测报文的TTL值。如果设备配置了路由旁路功能，则TTL显示值与init-ttl命令配置相关，实际发送的TTL值固定为
Response	测试成功时，为探测报文的往返时延；如果测试超时，则为超时时间；不能完成测试时，则为0。单位为毫秒
Hop IP	回复应答的节点IP地址
Status	测试结果的状态值，具体如下： · Succeeded：测试成功，接收到响应报文 · Unknown error：未知错误导致NQA测试失败（如果配置了NQA与Track联动，则该状态会触发Track状态切换） · Internal error：内部错误导致NQA测试失败（如果配置了NQA与Track联动，则该状态不会触发Track状态切换） · Timeout：请求超时导致NQA测试失败（如果配置了NQA与Track联动，则该状态会触发Track状态切换）
Time	测试完成时间

【相关命令】

· history-record enable

1.1.19 display nqa reaction counters

display nqa reaction counters命令用来显示阈值告警组的当前监测结果。

【命令】

display nqa reaction counters [ admin-name operation-tag [ item-number ] ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

admin-name：创建NQA测试组的管理员名称，为1～32个字符的字符串，字符串中不能包括“-”，不区分大小写。

operation-tag：测试操作的标签，为1～32个字符的字符串，字符串中不能包括“-”，不区分大小写。

item-number：显示指定阈值告警组的当前监测结果。如果不指定该参数，将显示所有阈值告警组的当前监测结果。item-number为阈值告警组的编号，取值范围为1～10。

【使用指导】

如果NQA阈值告警组的阈值类型为平均值，或监测对象为Voice测试的ICPIF或MOS值，则显示的监测结果为“-”（表示无效值）。

测试结束后，不会清除监测结果，即测试组启动后，监测结果会不断累加。

不指定任何参数，则表示显示所有测试组中所有阈值告警组的当前监测结果。

【举例】

# 显示NQA测试组管理员名称为admin、测试操作标签为test的ICMP-echo测试组的所有阈值告警组的当前监测结果。

<Sysname> display nqa reaction counters admin test

NQA entry (admin admin, tag test) reaction counters:

Index Checked Element Threshold Type Checked Num Over-threshold Num

1 probe-duration accumulate 12 4

2 probe-duration average - -

3 probe-duration consecutive 160 56

表1-3 display nqa reaction counters命令显示信息描述

字段	描述
Index	阈值告警组的编号
Checked Element	监测的对象（不同的NQA测试类型支持的监测对象不同，具体请参见表1-4）
Threshold Type	阈值类型
Checked Num	已监测的样本个数
Over-threshold Num	超出阈值的样本个数

表1-4 display nqa reaction counters命令显示字段取值描述（ARP/DHCP/DLSw/DNS/FTP/HTTP/HTTP2/SNMP/ICMP-echo/TCP/UDP-echo测试类型）

监测对象	阈值类型	监测的样本范围	Checked Num取值	Over-threshold Num取值
probe-duration	accumulate	启动NQA测试组后进行的探测	启动NQA测试组后已完成的探测次数	启动NQA测试组后累计的探测持续时间不在阈值范围内的探测次数
	average	-	-	-
	consecutive	启动NQA测试组后进行的探测	启动NQA测试组后已完成的探测次数	启动NQA测试组后连续的探测持续时间不在阈值范围内的探测次数
probe-fail	accumulate	启动NQA测试组后进行的探测	启动NQA测试组后已完成的探测次数	启动NQA测试组后累计的探测失败次数
probe-fail	consecutive	启动NQA测试组后进行的探测	启动NQA测试组后已完成的探测次数	启动NQA测试组后连续的探测失败次数
test-fail（HTTP2测试不支持）	consecutive	启动NQA测试组后进行的测试	启动NQA测试组后已完成的测试次数	启动NQA测试组后连续的测试失败次数
test-result-change（仅ICMP-echo测试支持）	-	启动NQA测试组后进行的探测	启动NQA测试组后已完成的测试次数	启动NQA测试组后连续的探测失败次数

表1-5 display nqa reaction counters命令显示字段取值描述（ICMP-jitter/UDP-jitter/Voice测试类型）

监测对象	阈值类型	监测的样本范围	Checked Num取值	Over-threshold Num取值
RTT	accumulate	启动NQA测试组后发送的报文	启动NQA测试组后已发送的报文个数	启动NQA测试组后累计的往返时间不在阈值范围内的报文个数
RTT	average	-	-	-
jitter-DS/jitter-SD	accumulate	启动NQA测试组后发送的报文	启动NQA测试组后已发送的报文个数	启动NQA测试组后累计的单向抖动时间不在阈值范围内的报文个数
jitter-DS/jitter-SD	average	-	-	-
OWD-DS/OWD-SD	-	启动NQA测试组后发送的报文	启动NQA测试组后已发送的报文个数	启动NQA测试组后单向时延不在阈值范围内的报文个数
packet-loss	accumulate	启动NQA测试组后发送的报文	启动NQA测试组后已发送的报文个数	启动NQA测试组后累计的丢包数
ICPIF/MOS（仅Voice测试支持）	-	-	-	-

1.1.20 display nqa result

display nqa result命令用来显示最近一次NQA测试的结果。

【命令】

display nqa result [ admin-name operation-tag ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

admin-name：创建NQA测试组的管理员名称，为1～32个字符的字符串，字符串中不能包括“-”，不区分大小写。

operation-tag：为测试操作的标签，为1～32个字符的字符串，字符串中不能包括“-”，不区分大小写。

【使用指导】

不指定任何参数，则表示显示所有测试组的最近一次测试的结果。

【举例】

# 显示NQA测试组管理员名称为admin、测试操作标签为test的TCP测试的最近一次测试结果。

<Sysname> display nqa result admin test

NQA entry (admin admin, tag test) test results:

Send operation times: 1 Receive response times: 1

Min/Max/Average round trip time: 35/35/35

Square-Sum of round trip time: 1225

Last succeeded probe time: 2019-05-29 10:50:33.2

Extended results:

Packet loss ratio: 0%

Failures due to timeout: 0

Failures due to disconnect: 0

Failures due to no connection: 0

Failures due to internal error: 0

Failures due to other errors: 0

# 显示NQA测试组管理员名称为admin、测试操作标签为test的ICMP-jitter测试的最近一次测试结果。

<Sysname> display nqa result admin test

NQA entry (admin admin, tag test) test results:

Send operation times: 10 Receive response times: 10

Min/Max/Average round trip time: 1/2/1

Square-Sum of round trip time: 13

Last packet received time: 2015-03-09 17:40:29.8

Extended results:

Packet loss ratio: 0.0%

Failures due to timeout: 0

Failures due to internal error: 0

Failures due to other errors: 0

Packets out of sequence: 0

Packets arrived late: 0

ICMP-jitter results:

RTT number: 10

Min positive SD: 0 Min positive DS: 0

Max positive SD: 0 Max positive DS: 0

Positive SD number: 0 Positive DS number: 0

Positive SD sum: 0 Positive DS sum: 0

Positive SD average: 0 Positive DS average: 0

Positive SD square-sum: 0 Positive DS square-sum: 0

Min negative SD: 1 Min negative DS: 2

Max negative SD: 1 Max negative DS: 2

Negative SD number: 1 Negative DS number: 1

Negative SD sum: 1 Negative DS sum: 2

Negative SD average: 1 Negative DS average: 2

Negative SD square-sum: 1 Negative DS square-sum: 4

SD average: 1 DS average: 2

One way results:

Max SD delay: 1 Max DS delay: 2

Min SD delay: 1 Min DS delay: 2

Number of SD delay: 1 Number of DS delay: 1

Sum of SD delay: 1 Sum of DS delay: 2

Square-Sum of SD delay: 1 Square-Sum of DS delay: 4

Lost packets for unknown reason: 0

# 显示NQA测试组管理员名称为admin、测试操作标签为test的UDP-jitter测试的最近一次测试结果。

<Sysname> display nqa result admin test

NQA entry (admin admin, tag test) test results:

Send operation times: 10 Receive response times: 10

Min/Max/Average round trip time: 15/46/26

Square-Sum of round trip time: 8103

Last packet received time: 2011-05-29 10:56:38.7

Extended results:

Packet loss ratio: 0.0%

Failures due to timeout: 0

Failures due to internal error: 0

Failures due to other errors: 0

Packets out of sequence: 0

Packets arrived late: 0

UDP-jitter results:

RTT number: 10

Min positive SD: 8 Min positive DS: 8

Max positive SD: 18 Max positive DS: 8

Positive SD number: 5 Positive DS number: 2

Positive SD sum: 75 Positive DS sum: 32

Positive SD average: 15 Positive DS average: 16

Positive SD square-sum: 1189 Positive DS square-sum: 640

Min negative SD: 8 Min negative DS: 1

Max negative SD: 24 Max negative DS: 30

Negative SD number: 4 Negative DS number: 7

Negative SD sum: 56 Negative DS sum: 99

Negative SD average: 14 Negative DS average: 14

Negative SD square-sum: 946 Negative DS square-sum: 1495

SD average: 14 DS average: 14

One way results:

Max SD delay: 22 Max DS delay: 23

Min SD delay: 7 Min DS delay: 7

Number of SD delay: 10 Number of DS delay: 10

Sum of SD delay: 125 Sum of DS delay: 132

Square-Sum of SD delay: 1805 Square-Sum of DS delay: 1988

SD lost packets: 0 DS lost packets: 0

Lost packets for unknown reason: 0

# 显示NQA测试组管理员名称为admin、测试操作标签为test的Voice测试的最近一次测试结果。

<Sysname> display nqa result admin test

NQA entry (admin admin, tag test) test results:

Send operation times: 1000 Receive response times: 0

Min/Max/Average round trip time: 0/0/0

Square-Sum of round trip time: 0

Last packet received time: 0-00-00 00:00:00.0

Extended results:

Packet loss ratio: 100.0%

Failures due to timeout: 1000

Failures due to internal error: 0

Failures due to other errors: 0

Packets out of sequence: 0

Packets arrived late: 0

Voice results:

RTT number: 0

Min positive SD: 0 Min positive DS: 0

Max positive SD: 0 Max positive DS: 0

Positive SD number: 0 Positive DS number: 0

Positive SD sum: 0 Positive DS sum: 0

Positive SD average: 0 Positive DS average: 0

Positive SD square-sum: 0 Positive DS square-sum: 0

Min negative SD: 0 Min negative DS: 0

Max negative SD: 0 Max negative DS: 0

Negative SD number: 0 Negative DS number: 0

Negative SD sum: 0 Negative DS sum: 0

Negative SD average: 0 Negative DS average: 0

Negative SD square-sum: 0 Negative DS square-sum: 0

SD average: 0 DS average: 0

One way results:

Max SD delay: 0 Max DS delay: 0

Min SD delay: 0 Min DS delay: 0

Number of SD delay: 0 Number of DS delay: 0

Sum of SD delay: 0 Sum of DS delay: 0

Square-Sum of SD delay: 0 Square-Sum of DS delay: 0

SD lost packets: 0 DS lost packets: 0

Lost packets for unknown reason: 1000

Voice scores:

MOS value: 0.99 ICPIF value: 87

# 显示NQA测试组管理员名称为admin、测试操作标签为test的Path-jitter测试的最近一次测试结果。

<Sysname> display nqa result admin test

NQA entry (admin admin, tag test) test results:

Hop IP 192.168.40.210

Basic Results:

Send operation times: 10

Receive response times: 10

Min/Max/Average round trip time: 1/1/1

Square-Sum of round trip time: 10

Extended Results:

Packet loss ratio: 0%

Failures due to timeout: 0

Failures due to internal error: 0

Failures due to other errors: 0

Packets out of sequence: 0

Packets arrived late: 0

Path-Jitter Results:

Jitter number: 9

Min/Max/Average jitter: 0/0/0

Positive jitter number: 0

Min/Max/Average positive jitter: 0/0/0

Sum/Square-Sum positive jitter: 0/0

Negative jitter number: 0

Min/Max/Average negative jitter: 0/0/0

Sum/Square-Sum negative jitter: 0/0

Hop IP 192.168.50.209

Basic Results:

Send operation times: 10

Receive response times: 10

Min/Max/Average round trip time: 1/1/1

Square-Sum of round trip time: 10

Extended Results:

Packet loss ratio: 0%

Failures due to timeout: 0

Failures due to internal error: 0

Failures due to other errors: 0

Packets out of sequence: 0

Packets arrived late: 0

Path-Jitter Results:

Jitter number: 9

Min/Max/Average jitter: 0/0/0

Positive jitter number: 0

Min/Max/Average positive jitter: 0/0/0

Sum/Square-Sum positive jitter: 0/0

Negative jitter number: 0

Min/Max/Average negative jitter: 0/0/0

Sum/Square-Sum negative jitter: 0/0

# 显示NQA测试组管理员名称为admin、测试操作标签为test的UDP-tracert测试的最近一次测试结果。

<Sysname> display nqa result admin test

NQA entry (admin admin, tag test) test results:

Send operation times: 6 Receive response times: 6

Min/Max/Average round trip time: 35/35/35

Square-Sum of round trip time: 1225

Last succeeded probe time: 2019-09-09 14:23:24.5

Extended results:

Packet loss ratio: 0%

Failures due to timeout: 0

Failures due to internal error: 0

Failures due to other errors: 0

UDP-tracert results:

TTL Hop IP Time

1 3.1.1.1 2019-09-09 14:23:24.5

2 4.1.1.1 2019-09-09 14:23:24.5

表1-6 display nqa result命令显示信息描述

字段	描述
Data collecting in progress	测试正在进行中
Send operation times	发送的探测报文数
Receive response times	收到的响应报文数
Min/Max/Average round trip time	最小/最大/平均往返时间，单位为毫秒
Square-Sum of round trip time	往返时间平方和
Last succeeded probe time	一次测试中最后一次成功探测的完成时间，如果一次测试中的探测均失败，则该时间显示为全0，UDP-jitter、Path-jitter和Voice测试中无此信息
Last packet received time	一次探测中最后一次成功收到正确响应报文的时间，如果一次探测中没有收到过正确的响应报文，则该时间显示为全0，只在UDP-jitter和Voice测试中存在此信息
Packet loss ratio	平均丢包率
Failures due to timeout	测试过程中超时的次数
Failures due to disconnect	对方强制断开连接的次数
Failures due to no connection	和对方建立连接失败的次数
Failures due to internal error	因内部错误失败的次数
Failures due to other errors	因其它错误失败的次数
Packets out of sequence	报文失序的次数
ICMP-jitter results	ICMP-jitter测试的结果，只在ICMP-jitter测试中存在此信息
Packets arrived late	探测超时后，收到的响应报文个数
UDP-jitter results	UDP-jitter测试的结果，只在UDP-jitter测试中存在此信息
Voice results	Voice测试的结果，只在Voice测试中存在此信息
RTT number	收到的响应报文数
Min positive SD	源到目的方向正抖动时延的最小值
Min positive DS	目的到源方向正抖动时延的最小值
Max positive SD	源到目的方向正抖动时延的最大值
Max positive DS	目的到源方向正抖动时延的最大值
Positive SD number	源到目的方向正抖动时延的数目
Positive DS number	目的到源方向正抖动时延的数目
Positive SD sum	源到目的方向正抖动时延之和
Positive DS sum	目的到源方向正抖动时延之和
Positive SD average	源到目的方向正抖动时延的平均值
Positive DS average	目的到源方向正抖动时延的平均值
Positive SD square-sum	源到目的方向正抖动时延的平方和
Positive DS square-sum	目的到源方向正抖动时延的平方和
Min negative SD	源到目的方向负抖动时延的绝对值的最小值
Min negative DS	目的到源方向负抖动时延的绝对值的最小值
Max negative SD	源到目的方向负抖动时延的绝对值的最大值
Max negative DS	目的到源方向负抖动时延的绝对值的最大值
Negative SD number	源到目的方向负抖动时延的数目
Negative DS number	目的到源方向负抖动时延的数目
Negative SD sum	源到目的方向负抖动时延的绝对值之和
Negative DS sum	目的到源方向负抖动时延的绝对值之和
Negative SD average	源到目的方向负抖动时延的绝对值的平均值
Negative DS average	目的到源方向负抖动时延的绝对值的平均值
Negative SD square-sum	源到目的方向负抖动时延的平方和
Negative DS square-sum	目的到源方向负抖动时延的平方和
SD average	源到目的方向抖动时延的平均值
DS average	目的到源方向抖动时延的平均值
One way results	单向延迟测试结果，单位为毫秒。只有ICMP-jitter‘、UDP-jitter和Voice类型测试有单项延迟测试结果
Max SD delay	源到目的的最大时延
Max DS delay	目的到源的最大时延
Min SD delay	源到目的的最小时延
Min DS delay	目的到源的最小时延
Number of SD delay	源到目的计算的时延数
Number of DS delay	目的到源计算的时延数
Sum of SD delay	源到目的的时延和
Sum of DS delay	目的到源的时延和
Square-Sum of SD delay	源到目的的时延的平方和
Square-Sum of DS delay	目的到源的时延的平方和
SD lost packets	源到目的方向丢失的报文个数
DS lost packets	目的到源方向丢失的报文个数
Lost packets for unknown reason	不能确定原因丢失的报文个数
Voice scores	语音参数，只在Voice类型测试有此信息
MOS value	为语音计算的MOS值
ICPIF value	为语音计算的ICPIF值
Hop IP	本跳IP地址，只在Path-jitter测试中存在此信息
Path-jitter results	Path-jitter测试的结果，只在Path-jitter测试中存在此信息
Jitter number	计算抖动次数，只在Path-jitter测试中存在此信息
Min/Max/Average jitter	最小/最大/平均抖动时延，单位为毫秒，只在Path-jitter测试中存在此信息
Positive jitter number	正抖动时延的数目，只在Path-jitter测试中存在此信息
Min/Max/Average positive jitter	最小/最大/平均正抖动时延，单位为毫秒，只在Path-jitter测试中存在此信息
Sum/Square-Sum positive jitter	正抖动时延之和/平方和，只在Path-jitter测试中存在此信息
Negative jitter number	负抖动时延的数目，只在Path-jitter测试中存在此信息
Min/Max/Average negative jitter	最小/最大/平均负抖动时延，单位为毫秒，只在Path-jitter测试中存在此信息
Sum/Square-Sum negative jitter	负抖动时延之和/平方和，只在Path-jitter测试中存在此信息
TTL	本次探测发送的探测报文的TTL值。如果设备配置了路由旁路功能，则TTL显示值与init-ttl命令配置相关，实际发送的TTL值固定为1
Hop IP	回复应答的节点IP地址
Time	收到应答报文的时间

1.1.21 display nqa statistics

display nqa statistics命令用来显示NQA测试的统计信息。

【命令】

display nqa statistics [ admin-name operation-tag ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

admin-name ：创建NQA测试组的管理员名称，为1～32个字符的字符串，字符串中不能包括“-”，不区分大小写。

operation-tag：测试操作的标签，为1～32个字符的字符串，字符串中不能包括“-”，不区分大小写。

【使用指导】

工作机制

测试开始后，如果第一次测试中的所有探测尚未完成，则无法生成统计信息。若此时通过该命令查看统计信息，则显示信息为全0。

如果配置了阈值告警组，将显示在statistics interval命令指定的统计周期内的监测结果。若阈值告警组的阈值类型为平均值，或监测对象为Voice测试的ICPIF或MOS值，则显示的监测结果为“-”（表示无效值）。

注意事项

UDP-tracert测试类型不支持用该命令显示统计信息。

不指定任何参数，则表示显示所有测试组的统计信息。

【举例】

# 显示NQA测试组管理员名称为admin、测试操作标签为test的TCP测试的统计信息。

<Sysname> display nqa statistics admin test

NQA entry (admin admin, tag test) test statistics:

NO. : 1

Start time: 2019-01-01 09:30:20.0

Life time: 2 seconds

Send operation times: 1 Receive response times: 1

Min/Max/Average round trip time: 13/13/13

Square-Sum of round trip time: 169

Extended results:

Packet loss ratio: 0%

Failures due to timeout: 0

Failures due to disconnect: 0

Failures due to no connection: 0

Failures due to internal error: 0

Failures due to other errors: 0

# 显示NQA测试组管理员名称为admin、测试操作标签为test的ICMP-jitter测试的统计信息。

<Sysname> display nqa statistics admin test

NQA entry (admin admin, tag test) test statistics:

NO. : 1

Start time: 2015-03-09 17:42:10.7

Life time: 156 seconds

Send operation times: 1560 Receive response times: 1560

Min/Max/Average round trip time: 1/2/1

Square-Sum of round trip time: 1563

Extended results:

Packet loss ratio: 0.0%

Failures due to timeout: 0

Failures due to internal error: 0

Failures due to other errors: 0

Packets out of sequence: 0

Packets arrived late: 0

ICMP-jitter results:

RTT number: 1560

Min positive SD: 1 Min positive DS: 1

Max positive SD: 1 Max positive DS: 2

Positive SD number: 18 Positive DS number: 46

Positive SD sum: 18 Positive DS sum: 49

Positive SD average: 1 Positive DS average: 1

Positive SD square-sum: 18 Positive DS square-sum: 55

Min negative SD: 1 Min negative DS: 1

Max negative SD: 1 Max negative DS: 2

Negative SD number: 24 Negative DS number: 57

Negative SD sum: 24 Negative DS sum: 58

Negative SD average: 1 Negative DS average: 1

Negative SD square-sum: 24 Negative DS square-sum: 60

SD average: 1 DS average: 1

One way results:

Max SD delay: 1 Max DS delay: 2

Min SD delay: 1 Min DS delay: 1

Number of SD delay: 4 Number of DS delay: 4

Sum of SD delay: 4 Sum of DS delay: 5

Square-Sum of SD delay: 4 Square-Sum of DS delay: 7

Lost packets for unknown reason: 0

Reaction statistics:

Index Checked Element Threshold Type Checked Num Over-threshold Num

1 jitter-DS accumulate 1500 10

2 jitter-SD average - -

3 OWD-DS - 1560 2

4 OWD-SD - 1560 0

5 packet-loss accumulate 0 0

6 RTT accumulate 1560 0

# 显示NQA测试组管理员名称为admin、测试操作标签为test的UDP-jitter测试的统计信息。

<Sysname> display nqa statistics admin test

NQA entry (admin admin, tag test) test statistics:

NO. : 1

Start time: 2007-01-01 09:33:22.3

Life time: 23 seconds

Send operation times: 100 Receive response times: 100

Min/Max/Average round trip time: 1/11/5

Square-Sum of round trip time: 24360

Extended results:

Packet loss ratio: 0.0%

Failures due to timeout: 0

Failures due to internal error: 0

Failures due to other errors: 0

Packets out of sequence: 0

Packets arrived late: 0

UDP-jitter results:

RTT number: 550

Min positive SD: 1 Min positive DS: 1

Max positive SD: 7 Max positive DS: 1

Positive SD number: 220 Positive DS number: 97

Positive SD sum: 283 Positive DS sum: 287

Positive SD average: 1 Positive DS average: 2

Positive SD square-sum: 709 Positive DS square-sum: 1937

Min negative SD: 2 Min negative DS: 1

Max negative SD: 10 Max negative DS: 1

Negative SD number: 81 Negative DS number: 94

Negative SD sum: 556 Negative DS sum: 191

Negative SD average: 6 Negative DS average: 2

Negative SD square-sum: 4292 Negative DS square-sum: 967

SD average: 2 DS average: 2

One way results:

Max SD delay: 5 Max DS delay: 5

Min SD delay: 1 Min DS delay: 1

Number of SD delay: 550 Number of DS delay: 550

Sum of SD delay: 1475 Sum of DS delay: 1201

Square-Sum of SD delay: 5407 Square-Sum of DS delay: 3959

SD lost packets: 0 DS lost packets: 0

Lost packets for unknown reason: 0

Reaction statistics:

Index Checked Element Threshold Type Checked Num Over-threshold Num

1 jitter-DS accumulate 90 25

2 jitter-SD average - -

3 OWD-DS - 100 24

4 OWD-SD - 100 13

5 packet-loss accumulate 0 0

6 RTT accumulate 100 52

# 显示NQA测试组管理员名称为admin、测试操作标签为test的Voice测试的统计信息。

<Sysname> display nqa statistics admin test

NQA entry (admin admin, tag test) test statistics:

NO. : 1

Start time: 2007-01-01 09:33:45.3

Life time: 120 seconds

Send operation times: 10 Receive response times: 10

Min/Max/Average round trip time: 1/12/7

Square-Sum of round trip time: 620

Extended results:

Packet loss ratio: 0.0%

Failures due to timeout: 0

Failures due to internal error: 0

Failures due to other errors: 0

Packets out of sequence: 0

Packets arrived late: 0

Voice results:

RTT number: 10

Min positive SD: 3 Min positive DS: 1

Max positive SD: 10 Max positive DS: 1

Positive SD number: 3 Positive DS number: 2

Positive SD sum: 18 Positive DS sum: 2

Positive SD average: 6 Positive DS average: 1

Positive SD square-sum: 134 Positive DS square-sum: 2

Min negative SD: 3 Min negative DS: 1

Max negative SD: 9 Max negative DS: 1

Negative SD number: 4 Negative DS number: 2

Negative SD sum: 25 Negative DS sum: 2

Negative SD average: 6 Negative DS average: 1

Negative SD square-sum: 187 Negative DS square-sum: 2

SD average: 6 DS average: 1

One way results:

Max SD delay: 0 Max DS delay: 0

Min SD delay: 0 Min DS delay: 0

Number of SD delay: 0 Number of DS delay: 0

Sum of SD delay: 0 Sum of DS delay: 0

Square-Sum of SD delay: 0 Square-Sum of DS delay: 0

SD lost packets: 0 DS lost packets: 0

Lost packets for unknown reason: 0

Voice scores:

Max MOS value: 4.40 Min MOS value: 4.40

Max ICPIF value: 0 Min ICPIF value: 0

Reaction statistics:

Index Checked Element Threshold Type Checked Num Over-threshold Num

1 ICPIF - - -

2 MOS - - -

# 显示NQA测试组管理员名称为admin、测试操作标签为test的Path-jitter测试的统计信息。

<Sysname> display nqa statistics admin test

NQA entry (admin admin, tag test) test statistics:

NO. : 1

Path 1:

Hop IP 192.168.40.210

Basic Results:

Send operation times: 10

Receive response times: 10

Min/Max/Average round trip time: 1/1/1

Square-Sum of round trip time: 10

Extended Results:

Packet loss ratio: 0%

Failures due to timeout: 0

Failures due to internal error: 0

Failures due to other errors: 0

Packets out of sequence: 0

Packets arrived late: 0

Path-Jitter Results:

Jitter number: 9

Min/Max/Average jitter: 0/0/0

Positive jitter number: 0

Min/Max/Average positive jitter: 0/0/0

Sum/Square-Sum positive jitter: 0/0

Negative jitter number: 0

Min/Max/Average negative jitter: 0/0/0

Sum/Square-Sum negative jitter: 0/0

Hop IP 192.168.50.209

Basic Results:

Send operation times: 10

Receive response times: 10

Min/Max/Average round trip time: 1/1/1

Square-Sum of round trip time: 10

Extended Results:

Packet loss ratio: 0%

Failures due to timeout: 0

Failures due to internal error: 0

Failures due to other errors: 0

Packets out of sequence: 0

Packets arrived late: 0

Path-Jitter Results:

Jitter number: 9

Min/Max/Average jitter: 0/0/0

Positive jitter number: 0

Min/Max/Average positive jitter: 0/0/0

Sum/Square-Sum positive jitter: 0/0

Negative jitter number: 0

Min/Max/Average negative jitter: 0/0/0

Sum/Square-Sum negative jitter: 0/0

# 显示NQA测试组管理员名称为admin、测试操作标签为test的无线探测模式的统计信息。

<Sysname> display nqa statistics admin test

NQA entry (admin admin, tag test) test statistics:

NO. : 1

Start time: 2019-01-01 09:30:20.0

Life time: 2 seconds

Send operation times: 1 Receive response times: 1

Min/Max/Average round trip time: 19/25/19

Square-Sum of round trip time: 169

Extended results:

Packet loss ratio: 0%

Failures due to timeout: 0

Failures due to disconnect: 0

Failures due to no connection: 0

Failures due to internal error: 0

Failures due to other errors: 0

UPF-UE delay probe results (us):

Min/Max/Average round trip time: 19286/25424/20141

Min/Max/Average UPF to station two-way delay: 113/257/127

Min/Max/Average downlink GTPU delay: 0/8/1

Min/Max/Average uplink GTPU delay: 0/0/0

Min/Max/Average downlink PDCP delay: 3/17/5

Min/Max/Average uplink PDCP delay: 2/6/2

Min/Max/Average downlink RLC delay: 50/272/221

Min/Max/Average uplink RLC delay: 456/469/465

Min/Max/Average downlink MAC delay: 530/551/534

Min/Max/Average uplink MAC delay: 17948/23938/18781

Reaction statistics:

Index Checked Element Threshold Type Checked Num Over-threshold Num

1 upf-ue-rtt - 3 0

表1-7 display nqa statistics命令显示信息描述

字段	描述
No.	统计组的组号
Start time	测试组启动时间
Life time	测试的持续时间，单位为秒
Send operation times	发送的探测报文数
Receive response times	收到的响应报文数
Min/Max/Average round trip time	最小/最大/平均往返时间，单位为毫秒
Square-Sum of round trip time	往返时间平方和
Packet loss ratio	平均丢包率，ICMP-jitter、UDP-jitter和Voice类型时，精度为0.1%
Failures due to timeout	测试过程中超时的次数
Failures due to disconnect	对方强制断开连接的次数
Failures due to no connection	和对方建立连接失败的次数
Failures due to internal error	因内部错误失败的次数
Failures due to other errors	因其它错误失败的次数
Packets out of sequence	报文失序的次数
Packets arrived late	迟到报文个数
ICMP-jitter results	ICMP-jitter测试的结果，只在ICMP-jitter测试中存在此信息
UDP-jitter results	UDP-jitter测试的结果，只在UDP-jitter测试中存在此信息
Voice results	Voice测试的结果，只在Voice测试中存在此信息
RTT number	收到的响应报文数
Min positive SD	源到目的方向抖动时延为正值的最小值
Min positive DS	目的到源方向抖动时延为正值的最小值
Max positive SD	源到目的方向抖动时延为正值的最大值
Max positive DS	目的到源方向抖动时延为正值的最大值
Positive SD number	源到目的方向抖动时延为正值的数目
Positive DS number	目的到源方向抖动时延为正值的数目
Positive SD sum	源到目的方向抖动时延为正值的和
Positive DS sum	目的到源方向抖动时延为正值的和
Positive SD average	源到目的方向抖动时延为正值的平均值
Positive DS average	目的到源方向抖动时延为正值的平均值
Positive SD square-sum	源到目的方向抖动时延为正值的平方和
Positive DS square-sum	目的到源方向抖动时延为正值的平方和
Min negative SD	源到目的方向抖动时延为负值的最小绝对值
Min negative DS	目的到源方向抖动时延为负值的最小绝对值
Max negative SD	源到目的方向抖动时延为负值的最大绝对值
Max negative DS	目的到源方向抖动时延为负值的最大绝对值
Negative SD number	源到目的方向抖动时延为负值的数目
Negative DS number	目的到源方向抖动时延为负值的数目
Negative SD sum	源到目的方向抖动时延为负值的绝对值和
Negative DS sum	目的到源方向抖动时延为负值的绝对值和
Negative SD average	源到目的方向抖动时延为负值的绝对值的平均值
Negative DS average	目的到源方向抖动时延为负值的绝对值的平均值
Negative SD square-sum	源到目的方向抖动时延为负值的平方和
Negative DS square-sum	目的到源方向抖动时延为负值的平方和
SD average	源到目的方向抖动时延的平均值
DS average	目的到源方向抖动时延的平均值
One way results	单向延迟测试结果，单位为毫秒。只有ICMP-jitter、UDP-jitter和Voice类型测试有单项延迟测试结果
Max SD delay	源到目的的最大时延
Max DS delay	目的到源的最大时延
Min SD delay	源到目的的最小时延
Min DS delay	目的到源的最小时延
Number of SD delay	源到目的计算的时延数
Number of DS delay	目的到源计算的时延数
Sum of SD delay	源到目的的时延和
Sum of DS delay	目的到源的时延和
Square-Sum of SD delay	源到目的的时延的平方和
Square-Sum of DS delay	目的到源的时延的平方和
SD lost packets	源到目的方向丢失的报文个数
DS lost packets	目的到源方向丢失的报文个数
Lost packets for unknown reason	不能确定原因丢失的报文个数
Voice scores	语音参数，只在voice类型测试有此信息
Max MOS value	最大MOS值
Min MOS value	最小MOS值
Max ICPIF value	最大ICPIF值
Min ICPIF value	最小ICPIF值
Reaction statistics	阈值告警组在统计周期内的监测结果
Index	阈值告警组的编号
Checked Element	监测对象
Threshold Type	阈值类型
Checked Num	已监测的样本个数
Over-threshold Num	超出阈值的样本个数
Path	Path-jitter测试结果的路径序号，只在Path-jitter测试中存在此信息
Hop IP	本跳IP地址，只在Path-jitter测试中存在此信息
Path-jitter results	Path-jitter测试的结果，只在Path-jitter测试中存在此信息
Jitter number	计算抖动次数，只在Path-jitter测试中存在此信息
Min/Max/Average jitter	最小/最大/平均抖动时延，单位为毫秒，只在Path-jitter测试中存在此信息
Positive jitter number	正抖动时延的数目，只在Path-jitter测试中存在此信息
Min/Max/Average positive jitter	最小/最大/平均正抖动时延，单位为毫秒，只在Path-jitter测试中存在此信息
Sum/Square-Sum positive jitter	正抖动时延之和/平方和，只在Path-jitter测试中存在此信息
Negative jitter number	负抖动时延的数目，只在Path-jitter测试中存在此信息
Min/Max/Average negative jitter	最小/最大/平均负抖动时延，单位为毫秒，只在Path-jitter测试中存在此信息
Sum/Square-Sum negative jitter	负抖动时延之和/平方和，只在Path-jitter测试中存在此信息

表1-8 display nqa statistics命令显示阈值告警功能相关字段取值描述（DHCP/DLSw/DNS/FTP/HTTP/HTTP2/ICMP-echo/SNMP/TCP/UDP-echo测试类型）

监测对象	阈值类型	监测的样本范围	Checked Num取值	Over-threshold Num取值
probe-duration	accumulate	统计周期内，进行的探测	统计周期内，已完成的探测次数	统计周期内，累计的探测持续时间不在阈值范围内的探测次数
	average	-	-	-
	consecutive	统计周期内，进行的探测	统计周期内，已完成的探测次数	统计周期内，连续的探测持续时间不在阈值范围内的探测次数

表1-9 display nqa statistics命令显示阈值告警功能相关字段取值描述（ICMP-jitter/UDP-jitter/Voice测试类型）

监测对象	阈值类型	监测的样本范围	Checked Num取值	Over-threshold Num取值
RTT	accumulate	统计周期内，发送的报文	统计周期内，已发送的报文个数	统计周期内，累计的往返时间不在阈值范围内的报文个数
RTT	average	-	-	-
jitter-DS/jitter-SD	accumulate	统计周期内，发送的报文	统计周期内，已发送的报文个数	统计周期内，累计的单向抖动时间不在阈值范围内的报文个数
jitter-DS/jitter-SD	average	-	-	-
OWD-DS/OWD-SD	-	统计周期内，发送的报文	统计周期内，已发送的报文个数	统计周期内，单向时延不在阈值范围内的报文个数
packet-loss	accumulate	统计周期内，发送的报文	统计周期内，已发送的报文个数	统计周期内累计的丢包数
ICPIF/MOS（仅Voice测试支持）	-	-	-	-

【相关命令】

· statistics interval

1.1.22 display nqa twamp-light client

display nqa twamp-light client命令用来查看TWAMP-light Client会话的信息。

【命令】

display nqa twamp-light client [ test-session session-id | verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

test-session session-id：显示指定会话的详细信息。session-id表示会话ID，取值范围为1～128。

verbose：表示显示所有会话的详细信息。

【使用指导】

本命令未指定任何参数时，表示显示所有会话的简要信息。

【举例】

# 查看所有会话的简要信息。

<Sysname> display nqa twamp-light client

Brief information about all test sessions:

Total sessions: 2

Active sessions: 1

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

ID Status Source IP/Port Destination IP/Port

1 Active 1.1.1.1/2001 2.2.2.2/2010

2 Active 2001::1/2001 2001::2/2010

# 查看所有会话的详细信息。

<Sysname> display nqa twamp-light client verbose

Session ID : 1

Status : Active

Session type : Permanent

Source interface : GigabitEthernet0/0/1

Service instance : -

Source IP : 1.1.1.1

Source IPv6 : -

Destination IP : 2.2.2.2

Destination IPv6 : -

Source port : 2001

Destination port : 2010

Source MAC : -

Destination MAC : -

VLAN ID : -

Service VLAN ID : -

Customer VLAN ID : -

ToS : 0

Padding length : 128

Timestamp format : NTP

VPN instance : -

Priority 802.1p : 0

Last start time : 2018-08-05 16:41:05

Last stop time : Never

Packet sending interval(ms) : 100

Timeout(sec) : 5

Duration(sec) : -

Packets sent : -

Statistics interval(ms) : 3

Monitor time(ms) : 3

Delay monitor time(ms) : 3

Jitter monitor time(ms) : 3

Loss monitor time(ms) : 3

Session ID : 2

Status : Inactive

Session type : On-demand

Source interface : GigabitEthernet0/0/1

Service instance : -

Source IP : 1.1.1.1

Source IPv6 : -

Destination IP : 3.3.3.3

Destination IPv6 : -

Source port : 2001

Destination port : 2020

Source MAC : -

Destination MAC : -

VLAN ID : -

Service VLAN ID : -

Customer VLAN ID : -

ToS : 0

Padding length : 128

Timestamp format : PTP

VPN instance : -

Priority 802.1p : 0

Last start time : Never

Last stop time : Never

Packet sending interval(ms) : 100

Timeout(sec) : 8

Duration(sec) : 300

Packets sent : -

Statistics interval(ms) : 3

Monitor time(ms) : 3

Delay monitor time(ms) : 3

Jitter monitor time(ms) : 3

Loss monitor time(ms) : 3

表1-10 display nqa twamp-light client命令显示信息描述表

字段	描述
Total sessions	会话总数
Active sessions	正在运行的会话个数
Session ID	会话ID
Status	会话的状态： · Active：表示测试会话的测试功能处于激活状态 · Inactive：表示测试会话的测试功能处于未激活状态
Session type	会话类型： · On-demand：按需统计 · Permanent：连续统计
Source interface	测试会话的源AC口
Service instance	关联的以太网服务实例
Source IP	测试会话的源IP地址
Source IPv6	测试会话的源IPv6地址
Destination IP	测试会话的目的IP地址
Destination IPv6	测试会话的目的IPv6地址
Source port	测试会话的源端口号
Destination port	测试会话的目的端口号
Source MAC	测试会话源MAC地址
Destination MAC	测试会话目的MAC地址
VLAN ID	测试会话的VLAN ID
Service VLAN ID	测试会话的外层VLAN ID
Customer VLAN ID	测试会话的内层VLAN ID
ToS	测试会话的ToS（Type of Service，服务类型）信息
Padding length	测试会话的填充长度信息
Timestamp format	时间戳格式，取值包括： · NTP：NTP格式 · PTP：PTP格式
VPN instance	MPLS L3VPN实例名称
Priority 802.1p	802.1p优先级
Last start time	TWAMP-light测试最近一次测试的最新开始时间，取值为Never时表示测试未开始
Last stop time	TWAMP-light测试最近一次测试的停止时间，取值为Never时表示测试未结束
Packet sending interval(ms)	TWAMP-light测试的发送报文周期，单位为毫秒
Timeout(sec)	TWAMP-light测试的统计周期内反射报文超时时间，单位为秒
Duration(sec)	TWAMP-light测试的持续时间，只有按需统计且配置了测试持续时间时会显示计数，单位为秒
Packets sent	TWAMP-light测试的发送报文个数，只有按需统计且配置了测试发送报文个数时会显示计数
Statistics interval(ms)	TWAMP-light测试的统计周期，单位为毫秒
Monitor time(ms)	TWAMP-light测试的报文监控时间，单位为毫秒；仅显示用户通过start（TWAMP-light-sender view）命令配置的值
Delay monitor time(ms)	TWAMP-light测试的双向时延监控时间，单位为毫秒；当未启动测试时，显示为“-”
Jitter monitor time(ms)	TWAMP-light测试的双向抖动监控时间，单位为毫秒；当未启动测试时，显示为“-”
Loss monitor time(ms)	TWAMP-light测试的双向丢包监控时间，单位为毫秒；当未启动测试时，显示为“-”

【相关命令】

· test-session (TWAMP-light-client view)

1.1.23 display nqa twamp-light client statistics

display nqa twamp-light client statistics命令用来查看TWAMP-light Client会话的统计信息。

【命令】

display nqa twamp-light client statistics { two-way-delay | two-way-loss } test-session session-id

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

two-way-delay：显示双向时延和抖动的统计信息。

two-way-loss：显示双向丢包的统计信息。

session-id：显示指定会话的统计信息；整数形式，取值范围为1～128。

【举例】

# 查看指定会话的双向时延和抖动的统计信息。

<Sysname> display nqa twamp-light client statistics two-way-delay test-session 1

Latest two-way delay statistics(μs):

Index Delay(avg) Jitter(avg) SD jitter(avg) DS jitter(avg)

11027 0 0 0 0

11028 0 0 0 0

11029 4 4 4 4

11030 1 1 1 1

11031 1 1 1 1

11032 1 1 1 1

11033 0 0 0 0

11034 1 1 1 1

11035 2 2 2 2

11036 2 2 2 2

11037 0 0 0 0

11038 2 2 2 2

11039 1 1 1 1

11040 0 0 0 0

11041 0 0 0 0

11042 0 0 0 0

11043 0 0 0 0

11044 1 1 1 1

11045 3 3 3 3

11046 0 0 0 0

11047 1 1 1 1

11048 0 0 0 0

11049 0 0 0 0

11050 0 0 0 0

11051 1 1 1 1

11052 0 0 0 0

11053 5 5 5 5

11054 7 7 7 7

11055 0 0 0 0

11056 1 1 1 1

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

Average delay : 1 Average jitter : 1

Maximum delay : 7 Maximum jitter : 7

Minimum Delay : 0 Minimum jitter : 0

Average SD jitter : 1 Average DS jitter : 1

Maximum SD jitter : 7 Maximum DS jitter : 7

Minimum SD jitter : 0 Minimum DS jitter : 0

表1-11 display nqa twamp-light client statistic two-way-delay命令显示信息描述表

字段	描述
Latest two-way delay statistics(μs)	最近一次测试最新的双向时延统计信息，单位为微秒
Index	统计数据的序列号
Delay(avg)	平均时延值
Jitter(avg)	平均抖动值
SD jitter(avg)	源到目的方向平均抖动值
DS jitter(avg)	目的到源方向平均抖动值
Average delay	平均时延值
Average jitter	平均抖动值
Maximum delay	最大时延值
Maximum jitter	最大抖动值
Minimum delay	最小时延值
Minimum jitter	最小抖动值
Average SD jitter	源到目的方向平均抖动值
Average DS jitter	目的到源方向平均抖动值
Maximum SD jitter	源到目的方向最大抖动值
Maximum DS jitter	目的到源方向最大抖动值
Minimum SD jitter	源到目的方向最小抖动值
Minimum DS jitter	目的到源方向最小抖动值

# 查看指定会话的双向丢包统计信息。

<Sysname> display nqa twamp-light client statistics two-way-loss test-session 1

Latest two-way loss statistics:

Index Loss count Loss ratio Error count Error ratio

11006 5 50.0000% 0 0.0000%

11007 3 30.0000% 0 0.0000%

11008 4 40.0000% 0 0.0000%

11009 8 80.0000% 0 0.0000%

11010 10 100.0000% 0 0.0000%

11011 1 10.0000% 0 0.0000%

11012 10 100.0000% 0 0.0000%

11013 2 20.0000% 0 0.0000%

11014 10 100.0000% 0 0.0000%

11015 9 90.0000% 0 0.0000%

11016 6 60.0000% 0 0.0000%

11017 2 20.0000% 0 0.0000%

11018 8 80.0000% 0 0.0000%

11019 2 20.0000% 0 0.0000%

11020 8 80.0000% 0 0.0000%

11021 2 20.0000% 0 0.0000%

11022 2 20.0000% 0 0.0000%

11023 7 70.0000% 0 0.0000%

11024 4 40.0000% 0 0.0000%

11025 4 40.0000% 0 0.0000%

11026 7 70.0000% 0 0.0000%

11027 7 70.0000% 0 0.0000%

11028 8 80.0000% 0 0.0000%

11029 1 10.0000% 0 0.0000%

11030 2 20.0000% 0 0.0000%

11031 8 80.0000% 0 0.0000%

11032 7 70.0000% 0 0.0000%

11033 7 70.0000% 0 0.0000%

11034 8 80.0000% 0 0.0000%

11035 4 40.0000% 0 0.0000%

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

Average loss count : 5 Average loss ratio : 55.3333%

Maximum loss count : 10 Maximum loss ratio : 100.0000%

Minimum loss count : 1 Minimum loss ratio : 10.0000%

Average error count: 0 Average error ratio: 0.0000%

Maximum error count: 0 Maximum error ratio: 0.0000%

Minimum error count: 0 Minimum error ratio: 0.0000%

表1-12 display nqa twamp-light client statistic two-way-loss命令显示信息描述表

字段	描述
Latest two-way loss statistics	双向丢包统计信息
Index	统计数据的序列号
Loss count	丢包个数
Loss ratio	丢包率
Error count	错包个数
Error ratio	错包率
Average loss count	平均丢包个数
Average loss ratio	平均丢包率
Maximum loss count	最大丢包个数
Maximum loss ratio	最大丢包率
Minimum loss count	最小丢包个数
Minimum loss ratio	最小丢包率
Average error count	平均错包个数
Average error ratio	平均错包率
Maximum error count	最大错包个数
Maximum error ratio	最大错包率
Minimum error count	最小错包个数
Minimum error ratio	最小错包率

【相关命令】

· reset nqa twamp-light statistics

· test-session (TWAMP-light-client view)

1.1.24 display nqa twamp-light client test-session reaction counters

display nqa twamp-light client test-session reaction counters命令用来显示TWAMP-light测试会话阈值告警组的监测结果。

【命令】

display nqa twamp-light client test-session reaction counters [ session-id [ item-number ] ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

session-id：会话ID，取值范围为1～128。

【使用指导】

不指定任何参数，则表示显示TWAMP-light所有测试会话中所有阈值告警组的当前监测结果。

【举例】

# 显示TWAMP-light测试会话1阈值告警组的当前监测结果。

<Sysname> display nqa twamp-light client test-session reaction counters 1

Reaction counters for session 1:

Index：1

Checked element: Two-way delay

Lower threshold: 20

Upper threshold: 200

Action type: None

Checked objects: 12

Threshold violations: 4

Index：2

Checked element: Two-way jitter

Lower threshold: 20

Upper threshold: 200

Action type: None

Checked objects: 12

Threshold violations: 4

Index：3

Checked element: Two-way loss

Lower threshold: 20

Upper threshold: 200

Action type：None

Checked objects: 12

Threshold violations: 4

表1-13 display nqa twamp-light client test-session reaction counters命令显示信息描述表

字段	描述
Reaction counters for session	TWAMP-light测试会话阈值告警组的监测结果
Index	统计数据的序列号
Checked element	监测的对象
Lower threshold	阈值告警范围的最低阈值
Upper threshold	阈值告警范围的最高阈值
Action type	告警类型
Checked objects	已监测的样本个数
Threshold violations	超出阈值的样本个数

【相关命令】

· reaction checked-element two-way-delay

· reaction checked-element two-way-loss

· reaction checked-element two-way-jitter

1.1.25 expect { data | hex-data }

expect { data | hex-data }命令用来配置期望测试成功的应答内容。

undo expect { data | hex-data }命令用来恢复缺省情况。

【命令】

expect { data | hex-data } string [ { offset | strict-offset } number ]

undo expect { data | hex-data }

【缺省情况】

未配置期望测试成功的应答内容。

【视图】

HTTP/HTTP2/HTTPS/TCP/UDP/WAP类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

data:表示使用文本格式的字符串来填充探测报文。

hex-data：表示使用十六进制字符串来填充探测报文。该参数仅在TCP/UDP/WAP类型的NQA模板视图下支持。

string：期望测试成功的应答内容。和data关键字配合使用时，为1～200个字符的字符串，区分大小写；和hex-data关键字配合使用时，为2～200个字符的字符串，字符串长度必须是偶数且不区分大小写。

offset number：所期望的内容在返回报文中的偏移量，取值范围为0～1000，缺省值为0。

strict-offset number：所期望的内容在返回报文中的严格偏移量，取值范围为0～1000，缺省值为0。

【使用指导】

NQA客户端对于返回报文中期望成功的应答内容匹配方式如下：

· 如果未配置offset参数和strict-offset参数，则设备直接从返回报文对应字段的第一个字节开始匹配，若不匹配，继续从第二个字节开始匹配，以此类推，直到匹配成功，则认为测试成功，否则认为测试失败。

· 如果配置了offset参数，则设备从返回报文对应字段偏移量之后的第一个字节开始匹配，若匹配失败，则忽略该偏移量，从返回报文的第一个字节开始匹配，若不匹配，继续从第二个字节开始匹配，以此类推，直到匹配成功，则认为测试成功，否则认为测试失败。

· 如果配置了strict-offset参数，则设备从返回报文对应字段偏移量之后的第一个字节开始匹配，若匹配失败，继续从第二个字节开始匹配，以此类推，直到匹配成功，则认为测试成功，否则认为测试失败。

对于HTTP/HTTP2/HTTPS类型的NQA模板，仅当回应报文的BODY类型为CONTENT和CHUNK类型时，进行期望应答内容的检查，否则不做检查。

对于TCP类型的NQA模板，仅当data-fill和expect { data | hex-data }命令都配置时，进行期望应答内容的检查，否则不做检查。

对于UDP类型的NQA模板：

· 仅当data-fill和expect { data | hex-data }命令都配置时，进行期望应答内容的检查，否则不做检查。

· 偏移检查和data-fill是否指定raw关键字命令有关，当指定raw关键字时，从收到报文的第一个字节开始检查；当未指定raw关键字时， UDP报文数据字段的前五个字节具有特定用途，从第六个字节开始进行偏移检查。

对于WAP类型的NQA模板，从WSP reply报文的headers字段开始进行期望应答内容的检查。当配置url命令时，WAP测试需要通过配置本命令进行期望应答内容的检查来判断测试是否成功。

测试过程中若未配置期望应答状态码，且收到的NQA应答报文中的内容匹配上本命令配置的期望应答内容，则判断本次测试为成功测试；若配置了期望应答状态码，则只有在匹配上期望的、测试成功应答状态码或者未匹配上期望的、测试失败应答状态码之后，才以本命令的匹配结果判断本次测试的成功与否。

对于HTTP/HTTP2/HTTPS类型的NQA模板，本命令不能与expect { failed-data | hex-failed-data }命令同时配置。

对于TCP/UDP类型的NQA模板，当同时配置了本命令和expect { failed-data | hex-failed-data }时，如果两条命令同时匹配上，则以expect { failed-data | hex-failed-data }的匹配结果为准，认为测试失败。

【举例】

# 在HTTP类型的NQA模板视图下配置期望的应答内容为welcome!。

<Sysname> system-view

[Sysname] nqa template http httptplt

[Sysname-nqatplt-http-httptplt] expect data welcome!

1.1.26 expect { failed-data | hex-failed-data }

expect { failed-data | hex-failed-data }命令用来配置期望测试失败的应答内容。

undo expect { failed-data | hex-failed-data }命令用来恢复缺省情况。

【命令】

expect { failed-data | hex-failed-data } string [ { offset | strict-offset } number ]

undo expect { failed-data | hex-failed-data }

【缺省情况】

未配置期望测试失败的应答内容。

【视图】

HTTP/HTTP2/HTTPS/TCP/UDP类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

failed-data：表示使用文本格式的字符串来填充探测报文。

hex-failed-data：表示使用十六进制字符串来填充探测报文。

string：期望测试失败的应答内容。和failed-data关键字配合使用时，为1～200个字符的字符串，区分大小写；和hex-failed-data关键字配合使用时，为2～200个字符的字符串，字符串长度必须是偶数且不区分大小写。

offset number：所期望的内容在返回报文中的偏移量，取值范围为0～1000，缺省值为0。

strict-offset number：所期望的内容在返回报文中的严格偏移量，取值范围为0～1000，缺省值为0。

【使用指导】

NQA客户端对于返回报文中期望失败的应答字符串匹配方式如下：

· 如果未配置offset参数和strict-offset参数，则设备直接从返回报文对应字段的第一个字节开始匹配，若不匹配，继续从第二个字节开始匹配，以此类推，如果剩余的字符串中包含期望的应答字符串，或者剩余字符串的长度小于期望应答字符串的长度，则认为测试失败，否则认为测试成功。

· 如果配置了offset参数，则设备从返回报文对应字段偏移量之后的第一个字节开始匹配，如果剩余的字符串中包含期望的应答字符串，或者剩余字符串的长度小于期望应答字符串的长度，则认为测试失败，否则忽略该偏移量，从返回报文的第一个字节开始匹配，如果剩余的字符串中包含期望的应答字符串，或者剩余字符串的长度小于期望应答字符串的长度，则认为测试失败，否则认为测试成功。

· 如果配置了strict-offset参数，则设备从返回报文对应字段偏移量之后的第一个字节开始匹配，如果剩余的字符串中包含期望的应答字符串，或者剩余字符串的长度小于期望应答字符串的长度，则认为测试失败，否则认为测试成功。

对于TCP类型的NQA模板，仅当data-fill和expect { failed-data | hex-failed-data }命令都配置时，进行期望失败应答内容的检查，否则不做检查。

对于UDP类型的NQA模板：

· 仅当data-fill和expect { failed-data | hex-failed-data }命令都配置时，进行期望失败应答内容的检查，否则不做检查。

· 偏移检查和data-fill是否指定raw关键字命令有关，当指定raw关键字时，从收到报文的第一个字节开始检查；当未指定raw关键字时，UDP报文数据字段的前五个字节具有特定用途，从第六个字节开始进行偏移检查。

· 测试过程中若未配置期望应答状态码，且收到的NQA应答报文中的内容匹配上本命令配置的期望应答内容，则判断本次测试为失败测试；若配置了期望应答状态码，则只有在匹配上期望的、测试成功应答状态码或者未匹配上期望的、测试失败应答状态码之后，才以本命令的匹配结果判断本次测试的成功与否。

对于HTTP/HTTP2/HTTPS类型的NQA模板，本命令不能与expect { data | hex-data }命令同时配置。

对于TCP/UDP类型的NQA模板，当同时配置了本命令和expect { data | hex-data }时，如果两条命令同时匹配上，则以本命令的匹配结果为准。

【举例】

# 在TCP类型的NQA模板视图下配置期望失败的应答内容为error。

<Sysname> system-view

[Sysname] nqa template tcp tcptplt

[Sysname-nqatplt-tcp-tcptplt] expect failed-data error

1.1.27 expect failed-status

expect failed-status命令用来配置期望的、测试失败应答状态码。

undo expect failed-status命令用来恢复缺省情况。

【命令】

expect failed-status status-list

undo expect failed-status [ status-list ]

【缺省情况】

未配置期望的、测试失败应答状态码。

【视图】

HTTP/HTTP2/HTTPS类型的模板视图

【缺省用户角色】

network-admin

【参数】

status-list：状态码列表，即类型期望收到的测试失败状态码范围。表示方式为status-list = { status-number1 [ to status-number2 ] }&<1-10>，status-number取值范围为0～999，status-number2的值要大于或等于status-number1的值，&<1-10>表示前面的参数最多可以重复输入10次。

【使用指导】

HTTP/HTTP2/HTTPS类型的NQA模板支持配置期望的、测试失败应答状态码。报文的状态码是由3位十进制数组成的字段，它包含服务器的状态信息，用户可以根据该状态码了解服务器的状态。状态码的第一位规定状态码的类型。

测试过程中若收到的NQA应答报文中的状态码匹配上本命令配置的应答状态码，则判断本次测试为失败测试；若未匹配上本命令配置的应答状态码，且未配置期望应答内容，则判断本次测试为成功测试，若配置了期望应答内容，以能否匹配期望应答内容判断本次测试的成功与否。

本命令不能与expect status命令同时配置。

【举例】

# 在HTTP类型的NQA模板视图下配置期望的、测试失败应答状态码为300、400～500。

<Sysname> system-view

[Sysname] nqa template http tplt

[Sysname-nqatplt-http-tplt] expect failed-status 300 400 to 500

【相关命令】

· expect status

1.1.28 expect ip

expect ip命令用来配置期望返回的IP地址。

undo expect ip命令用来恢复缺省情况。

【命令】

expect ip ip-address

undo expect ip

【缺省情况】

未配置期望返回的IP地址。

【视图】

DNS类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

ip-address：DNS探测期望返回的IP地址。

【使用指导】

在DNS测试中，NQA客户端通过该命令配置的IP地址与DNS服务器通过域名解析出的IP地址进行比较，若相同，则证明目前测试的DNS服务器合法，否则为非法DNS服务器。

【举例】

# 在DNS类型的NQA模板视图下配置期望返回的IP地址为1.1.1.1。

<Sysname> system-view

[Sysname] nqa template dns dnstplt

[Sysname-nqatplt-dns-dnstplt] expect ip 1.1.1.1

1.1.29 expect ipv6

expect ipv6命令用来配置期望返回的IPv6地址。

undo expect ipv6命令用来恢复缺省情况。

【命令】

expect ipv6 ipv6-address

undo expect ipv6

【缺省情况】

未配置期望返回的IPv6地址。

【视图】

DNS类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

ipv6-address：DNS探测期望返回的IPv6地址。

【使用指导】

在DNS测试中，NQA客户端通过该命令配置的IPv6地址与DNS服务器通过域名解析出的IPv6地址进行比较，若相同，则证明目前测试的DNS服务器合法，否则为非法DNS服务器。

【举例】

# 在DNS类型的NQA模板视图下配置期望返回的IPv6地址为1::1。

<Sysname> system-view

[Sysname] nqa template dns dnstplt

[Sysname-nqatplt-dns-dnstplt] expect ipv6 1::1

1.1.30 expect status

expect status命令用来配置期望的应答状态码。

undo expect status命令用来恢复缺省情况。

【命令】

expect status status-list

undo expect status [ status-list ]

【缺省情况】

未配置期望的应答状态码。

【视图】

Diameter/HTTP/HTTP2/HTTPS/RTSP/SIP类型的模板视图

【缺省用户角色】

network-admin

【参数】

status-list：状态码列表，即测试期望收到的状态码范围。表示方式为status-list = { status-num1 [ to status-num2 ] }&<1-10>，对于HTTP/HTTP2/HTTPS/RTSP/SIP模板类型，status-num取值范围为0～999；对于Diameter模板类型，status-num取值范围为0～5999。status-num2的值要大于或等于status-num1的值，&<1-10>表示前面的参数最多可以重复输入10次。

【使用指导】

HTTP/HTTP2/HTTPS/RTSP/SIP类型的NQA模板支持配置状态码。报文的状态码是由3位十进制数组成的字段，它包含服务器的状态信息，用户可以根据该状态码了解服务器的状态。状态码的第一位规定状态码的类型。

Diameter类型的NQA模板支持配置状态码。报文的状态码是由4位十进制数表示，指示服务请求是否成功完成或发生错误，用户可以根据该状态码了解服务器的状态。状态码的第一位规定状态码的类型。

测试过程中若收到的NQA应答报文中的状态码匹配上本命令配置的应答状态码，且未配置期望应答内容，则判断本次测试为成功测试，若配置了期望应答内容，以能否匹配期望应答内容判断本次测试的成功与否；若收到的NQA应答报文中的状态码未匹配上本命令配置的应答状态码，则判断本次测试为失败测试。

对于HTTP/HTTP2/HTTPS类型的NQA模板，本命令不能与expect failed-status命令同时配置。

【举例】

# 在HTTP类型的NQA模板视图下配置期望的应答状态码，允许状态码为200、300、400～500。

<Sysname> system-view

[Sysname] nqa template http httptplt

[Sysname-nqatplt-http-httptplt] expect status 200 300 400 to 500

1.1.31 filename

filename命令用来配置FTP服务器和客户端之间传送文件的文件名。

undo filename命令用来恢复缺省情况。

【命令】

filename filename

undo filename

【缺省情况】

未配置FTP服务器和客户端之间传送文件的文件名。

【视图】

FTP测试类型视图

FTP类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

filename：FTP服务器和客户端之间传送文件的文件名，为1～200个字符的字符串，字符串中不能包括“/”，不区分大小写。

【使用指导】

在FTP测试类型中，执行Get操作时，必须使用url命令配置服务器上测试文件的路径，只有成功获取该文件，测试才被视为成功；执行Put操作时，必须使用filename命令配置本地测试文件的路径，只有成功上传该文件，测试才被视为成功。

【举例】

# 在FTP测试类型下配置FTP服务器和客户端之间要传送文件的文件名为config.txt。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type ftp

[Sysname-nqa-admin-test-ftp] filename config.txt

【相关命令】

· operation

· url

1.1.32 frequency

frequency命令用来配置测试组连续两次测试开始时间的时间间隔。

undo frequency命令用来恢复缺省情况。

【命令】

frequency interval

undo frequency

【缺省情况】

在NQA测试类型视图下，Voice、Path-jitter测试中连续两次测试开始时间的时间间隔为60000毫秒；其他类型的测试中连续两次测试开始时间的时间间隔为0毫秒，即只进行一次测试。

在NQA模板视图下，测试中连续两次测试开始时间的时间间隔为5000毫秒。

【视图】

ICMP-echo/TCP/UDP-echo 测试类型视图

ARP/DHCP/DLSw/DNS/FTP/HTTP/HTTP2/SNMP测试类型视图

UDP-tracert测试类型视图

ICMP-jitter/Path-jitter/UDP-jitter/Voice测试类型视图

任意类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

interval：连续两次测试开始时间的时间间隔，取值范围为0～604800000，单位为毫秒。时间间隔为0，表示两次测试的时间间隔为无穷，即只进行一次测试，此时不会生成统计结果。

【使用指导】

通过nqa schedule命令启动NQA测试组后，每隔interval时间启动一次测试。

到达本命令指定的时间间隔时，将开始下一个间隔的计时，但如果此时测试尚未完成或者测试未超时，则不启动新一轮测试，直到测试完成或者测试超时，才开始新一轮测试。

【举例】

# 在ICMP-echo测试类型下配置连续两次测试开始时间的时间间隔为1000毫秒。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] frequency 1000

【相关命令】

· probe timeout

1.1.33 frequency-adjustment

frequency-adjustment命令用来配置测试失败时，测试组连续两次测试开始时间的时间间隔。

undo frequency-adjustment命令用来恢复缺省情况。

【命令】

frequency-adjustment adj-interval

undo frequency-adjustment

【缺省情况】

未配置测试失败时，测试组连续两次测试开始时间的时间间隔。

【视图】

任意类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

adj-interval：测试组连续两次测试开始时间的时间间隔，取值范围0～604800000，单位为毫秒。

【使用指导】

NQA测试失败时，为了设备能够快速感知服务器的状态，尽快恢复应用，需要配置本命令，使NQA启动更高频率的测试。

缺省情况下，不管本次测试成功还是失败，下次探测报文发送的时间间隔不会发生改变，始终为frequency命令配置的时间。

配置本命令后，如果测试结果为失败，则使用本命令配置的时间为后两次测试开始的时间间隔。如果测试结果为成功，则使用frequency命令配置的时间作为后两次测试开始的时间间隔。

到达本命令指定的时间间隔时，将开始下一个间隔的计时，此时如果上次测试尚未完成，则不启动新一轮测试，直到上次测试完成后并等待时间间隔超时，才开始新一轮测试。

【举例】

# 在HTTP类型的NQA模板视图下配置测试失败时，测试组连续两次测试开始时间的时间间隔为1000毫秒。

<Sysname> system-view

[Sysname] nqa template http tplt

[Sysname-nqatplt-http-tplt] frequency-adjustment 1000

1.1.34 hex-data-fill

hex-data-fill命令用来配置探测报文十六进制的填充字符串。

undo hex-data-fill命令用来恢复缺省情况。

【命令】

hex-data-fill hex [ raw ]

undo hex-data-fill

【缺省情况】

探测报文的填充内容为十六进制数值00010203040506070809。

【视图】

TCP/UDP类型的NQA模板视图

TWAMP-light-client-session视图

【缺省用户角色】

network-admin

【参数】

hex：探测报文的填充内容，为2～200个字符的十六进制字符串，字符串长度必须是偶数位，不区分大小写。

raw：表示仅使用hex来填充探测报文，该参数仅在UDP类型的NQA模板视图下支持。

【使用指导】

工作机制

若指定raw参数，表示hex参数位置的填充字符串在探测时将被直接发送。由于NQA发送的数据字段存在特殊字节，如果目的端是H3C设备，那么目的端能够直接识别NQA填充后的探测报文，不建议配置该参数；如果目的端不是H3C设备，则无法识别NQA填充后的探测报文，那么必须指定该参数，填充字符串需要是目的端服务器所开启的UDP服务类型并从该类型要求的填充报文类型确定填充字符串。

未指定raw参数，填充时，实际填充的字符与填充数据长度有关：

· 如果探测报文的数据段长度比配置的填充数据长度小，系统在报文封装时以报文的数据段长度为界截取该字符串的前一部分；

· 如果探测报文的数据段长度比配置的填充数据长度大，系统在报文封装时用该字符串进行循环填充，直到填满。

例如，配置填充数据为十六进制字符串“aa”，当探测报文数据段长度为1字节时，则取“aa”作为填充数据；当探测报文大小为6字节时，则使用“aaaaaaaaaaaa”作为填充数据。

注意事项

本命令与data-fill命令作用相同，多次执行这两条命令时，最后一次执行的命令生效。

【举例】

# 在TCP类型的NQA模板视图下配置探测报文的填充字符串为abcd。

<Sysname> system-view

[Sysname] nqa template tcp tcptplt

[Sysname-nqatplt-tcp-tcptplt] hex-data-fill abcd

# 在TWAMP-light-client-session视图下配置探测报文十六进制的填充字符串为abcd。

<Sysname> system-view

[Sysname] nqa twamp-light client

[Sysname-nqa-twamp-light-client] test-session 1

[Sysname-nqa-twamp-light-client-session1] hex-data-fill abcd

1.1.35 high-performance-mode

high-performance-mode enable命令用来开启UDP-jitter测试的高性能模式。

undo high-performance-mode enable命令用来关闭UDP-jitter测试的高性能模式。

【命令】

high-performance-mode enable

undo high-performance-mode enable

【缺省情况】

UDP-jitter测试的高性能模式处于关闭状态。

【视图】

UDP-jitter测试类型视图

【缺省用户角色】

network-admin

【使用指导】

应用场景

配置本命令后，UDP-jitter测试将开启高性能模式，该模式下UDP-jitter测试的测试效率和测试结果的精确度将大大提升。

注意事项

开启高性能模式后，命令route-option bypass-route、data-size、reaction checked-element { jitter-ds | jitter-sd } threshold-type accumulate、reaction checked-element rtt threshold-type accumulate将不再生效。

【举例】

# 开启UDP-jitter测试的高性能模式。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type udp-jitter

[Sysname-nqa-admin-test-udp-jitter] high-performance-mode enable

1.1.36 history-record enable

history-record enable命令用来开启NQA测试组的历史记录保存功能。

undo history-record enable命令用来关闭NQA测试组的历史记录保存功能。

【命令】

history-record enable

undo history-record enable

【缺省情况】

UDP-tracert测试类型的历史记录保存功能处于开启状态，其他类型的NQA测试组的历史记录保存功能处于关闭状态。

【视图】

ICMP-echo/TCP/UDP-echo测试类型视图

ARP/DHCP/DLSw/DNS/FTP/HTTP/HTTP2/SNMP测试类型视图

UDP-tracert测试类型视图

【缺省用户角色】

network-admin

【使用指导】

如果开启NQA测试组的历史记录保存功能，则系统会记录该NQA测试组的历史信息，通过display nqa history命令可以查看该测试组的历史记录信息。

如果关闭NQA测试组的历史记录保存功能，则系统不会记录该测试组的历史信息，原有的历史记录信息也会被删除。

【举例】

# 在ICMP-echo测试类型下开启NQA测试组的历史记录保存功能。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] history-record enable

【相关命令】

· display nqa history

1.1.37 history-record keep-time

history-record keep-time命令用来配置NQA测试组中历史记录的保存时间。

undo history-record keep-time命令用来恢复缺省情况。

【命令】

history-record keep-time keep-time

undo history-record keep-time

【缺省情况】

NQA测试组中历史记录的保存时间为120分钟。

【视图】

ICMP-echo/TCP/UDP-echo测试类型视图

ARP/DHCP/DLSw/DNS/FTP/HTTP/HTTP2/SNMP测试类型视图

UDP-tracert测试类型视图

【缺省用户角色】

network-admin

【参数】

keep-time：历史记录的保存时间，取值范围为1～1440，单位为分钟。

【使用指导】

NQA测试结束后，开始计算该测试组中所有历史记录的保存时间。保存时间达到配置的值后，将删除这些记录。

【举例】

# 在ICMP-echo测试类型下配置NQA测试组中历史记录的保存时间为100分钟。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] history-record keep-time 100

1.1.38 history-record number

history-record number命令用来配置在一个测试组中能够保存的最大历史记录个数。

undo history-record number命令用来恢复缺省情况。

【命令】

history-record number number

undo history-record number

【缺省情况】

一个测试组中能够保存的最大历史记录个数为50。

【视图】

ICMP-echo/TCP/UDP-echo测试类型视图

ARP/DHCP/DLSw/DNS/FTP/HTTP/HTTP2/SNMP测试类型视图

UDP-tracert测试类型视图

【缺省用户角色】

network-admin

【参数】

number：在一个测试组中能够保存的最大历史记录个数，取值范围为0～50。

【使用指导】

如果一个测试组中历史记录个数超过设定的最大数目，则最早的历史记录将会被删除。

【举例】

# 在ICMP-echo测试类型下配置一个测试组中能够保存的最大历史记录数为10个。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] history-record number 10

1.1.39 init-ttl

init-ttl命令用来配置UDP-tracert探测报文的初始跳数。

undo init-ttl命令用来恢复缺省情况。

【命令】

init-ttl value

undo init-ttl

【缺省情况】

UDP-tracert探测报文的初始跳数为1。

【视图】

UDP-tracert测试类型视图

Tracert类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

value：UDP-tracert探测报文的初始跳数，取值范围1～255。

【举例】

# 在UDP-tracert测试类型下配置UDP-tracert探测报文的初始跳数为5跳。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type udp-tracert

[Sysname-nqa-admin-test-udp-tracert] init-ttl 5

1.1.40 key

key命令用来设置RADIUS认证和计费使用的共享密钥。

undo key命令用来恢复缺省情况。

【命令】

key { cipher | simple } string

undo key

【缺省情况】

未设置RADIUS认证和计费使用的共享密钥。

【视图】

RADIUS认证探测/RADIUS-ACCOUNT计费探测类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

cipher：以密文方式设置密钥。

simple：以明文方式设置密钥，该密钥将以密文形式存储。

string：密钥字符串，区分大小写。明文密钥为1～64个字符的字符串，密文密钥为1～117个字符的字符串。

【使用指导】

必须保证设备上设置的共享密钥与RADIUS认证和计费服务器上的完全一致。

【举例】

# 在RADIUS类型的NQA模板视图下设置RADIUS认证使用的共享密钥为明文abc。

<Sysname> system-view

[Sysname] nqa template radius radiustplt

[Sysname-nqatplt-radius-radiustplt] key simple abc

1.1.41 local-host-name

local-host-name命令用来配置Diameter探测报文中本地主机名字段的值。

undo local-host-name命令用来恢复缺省情况。

【命令】

local-host-name host-name

undo local-host-name

【缺省情况】

Diameter探测报文中本地主机名字段的值是报文出接口的IP地址。

【视图】

Diameter类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

host-name：表示Diameter探测报文中本地主机名字段的值，为1～127个字符的字符串，区分大小写，字符串中可以包含字母、数字、“-”和“.”。

【使用指导】

本命令用于配置Diamater探测请求报文中Origin-Host键值对的值。Diameter服务器通过Origin-Host和Origin-Realm键值对来识别消息来源。

【举例】

# 配置Diameter探测报文中本地主机名字段的值为host.example.com。

<Sysname> system-view

[Sysname] nqa template diameter diametertplt

[Sysname-nqatplt-diameter-diametertplt] local-host-name host.example.com

1.1.42 local-realm-name

local-realm-name命令用来配置Diameter探测报文中本地域名字段的值。

undo local-realm-name命令用来恢复缺省情况。

【命令】

local-realm-name realm-name

undo local-realm-name

【缺省情况】

Diameter探测报文中本地域名字段的值是h3c.com。

【视图】

Diameter类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

realm-name：表示Diameter探测报文中本地域名字段的值，为1～127个字符的字符串，区分大小写，字符串中可以包含字母、数字、“-”和“.”。

【使用指导】

本命令用于配置Diamater探测请求报文中Origin-Realm键值对的值。Diameter服务器通过Origin-Host和Origin-Realm键值对来识别消息来源。

【举例】

# 配置Diameter探测报文中本地域名字段的值为realm.example.com。

<Sysname> system-view

[Sysname] nqa template diameter diametertplt

[Sysname-nqatplt-diameter-diametertplt] local-realm-name realm.example.com

1.1.43 lsr-path

lsr-path命令用来配置松散路由。

undo lsr-path命令用来恢复缺省情况。

【命令】

lsr-path ip-address&<1-8>

undo lsr-path

【缺省情况】

未配置松散路由。

【视图】

Path-jitter测试类型视图

【缺省用户角色】

network-admin

【参数】

ip-address&<1-8>：松散路由IP地址，&<1-8>表示最多可以输入8个IP地址，每个IP地址之间用空格分隔。

【使用指导】

通过本命令配置松散路由，用户只需给出NQA探测报文必须经过的一些“节点”，并不需要给出一条完备的路径，无直接连接的“节点”之间的路由需要路由器寻址功能补充。

Path-jitter测试中，NQA客户端通过tracert过程使用该命令配置的松散路由进行探路，并根据收到ICMP报文计算主要“节点”时延和抖动时间。

【举例】

# 在Path-jitter测试类型下配置松散路由为10.1.1.20和10.1.2.10两跳。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type path-jitter

[Sysname-nqa-admin-test- path-jitter] lsr-path 10.1.1.20 10.1.2.10

1.1.44 mailbox

mailbox命令用来配置IMAP测试操作的邮箱名称。

undo mailbox命令用来恢复缺省情况。

【命令】

mailbox mailbox-name

undo mailbox

【缺省情况】

IMAP测试操作的邮箱名称为INBOX。

【视图】

IMAP类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

mailbox-name：IMAP探测使用的邮箱名称，为1～64个字符的字符串，区分大小写。

【举例】

# 在IMAP类型的NQA模板视图下配置邮箱名称为fortest1。

<Sysname> system-view

[Sysname] nqa template imap imaptplt

[Sysname-nqatplt-imap-imaptplt] mailbox fortest1

1.1.45 max-failure

max-failure命令用来配置一次UDP-tracert测试中连续探测失败的最大次数。

undo max-failure命令用来恢复缺省情况。

【命令】

max-failure times

undo max-failure

【缺省情况】

一次UDP-tracert测试中连续探测失败的最大次数为5。

【视图】

UDP-tracert测试类型视图

Tracert类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

times：表示一次UDP-tracert测试中连续探测失败的最大次数，取值范围0～255。0和255意味着UDP-tracert探测不会因为连续探测失败而停止测试。

【使用指导】

当UDP-tracert测试中连续探测失败的次数达到指定的最大值时，设备认为测试失败并停止探测。

【举例】

# 在UDP-tracert测试类型下配置一次UDP-tracert测试中连续探测失败的最大次数为20次。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type udp-tracert

[Sysname-nqa-admin-test-udp-tracert] max-failure 20

1.1.46 memory

memory命令用来配置SNMP-DCA测试的SNMP Agent内存的阈值和权重。

undo memory命令用来恢复缺省情况。

【命令】

memory { threshold threshold-value | weight weight-value } *

undo memory

【缺省情况】

SNMP-DCA测试的SNMP Agent内存的阈值为70，权重为2。

【视图】

SNMP-DCA类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

threshold threshold-value：阈值，表示内存使用率可达到的上限。取值范围为0～100，取值为0时表示内存不作为判断SNMP Agent是否繁忙的参考。不指定该参数时，表示使用缺省值。

weight weight-value：权重，表示内存在用于计算SNMP Agent状态时应占有的比重。取值范围为0～100，取值为0时表示内存权重不参与计算SNMP Agent的状态。不指定该参数时，表示使用缺省值。

【使用指导】

本命令仅对Net-SNMP或Windows类型的SNMP Agent生效。

NQA客户端对Net-SNMP或Windows类型的SNMP Agent进行SNMP-DCA测试时，会自动获取SNMP Agent当前的内存使用率。

【举例】

# 在SNMP-DCA类型的NQA模板视图下配置测试的SNMP Agent内存的阈值为90、权重为90。

<Sysname> system-view

[Sysname] nqa template snmpdca test

[Sysname-nqatplt-snmpdca-test] memory threshold 90 weight 90

【相关命令】

· agent-type

1.1.47 mode

mode命令用来配置FTP测试的数据传输方式。

undo mode命令用来恢复缺省情况。

【命令】

mode { active | passive }

undo mode

【缺省情况】

FTP测试的数据传输方式为主动方式。

【视图】

FTP测试类型视图

FTP类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

active：设置FTP的数据传输方式为主动方式。表示在建立数据连接时由服务器主动发起连接请求。

passive：设置FTP的数据传输方式为被动方式。表示在建立数据连接时由客户端主动发起连接请求。

【举例】

# 在FTP测试类型下配置FTP测试的数据传输方式为被动方式。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type ftp

[Sysname-nqa-admin-test-ftp] mode passive

1.1.48 mpls-simulation enable

mpls-simulation enable命令用来开启UDP-jitter测试的MPLS模拟测试功能。

undo mpls-simulation enable命令用来恢复缺省情况。

【命令】

mpls-simulation enable [ exp exp-value ]

undo mpls-simulation enable

【缺省情况】

UDP-jitter测试的MPLS模拟测试功能处于关闭状态。

【视图】

UDP-jitter测试类型视图

【缺省用户角色】

network-admin

【参数】

exp exp-value：UDP-jitter探测报文的MPLS EXP优先级，取值范围为0～7，缺省值为0。

【使用指导】

工作机制

配置本命令后，UDP-jitter测试将会模拟发送MPLS报文进行测试，用于测试链路对于MPLS流量的服务质量。

如需测试MPLS流量的服务质量，必须开启UDP-jitter测试的高性能模式，且只能测试直连链路上MPLS流量的服务质量。请在直连链路的两端配置NQA客户端和服务器，并使用mpls enable命令开启接口的MPLS功能。有关mpls enable命令的详细介绍，请参见“MPLS命令参考”的“MPLS基础”。

注意事项

UDP-jitter测试的MPLS模拟测试功能暂不支持使用IPv6地址作为探测报文的目的地址。

【举例】

# 开启UDP-jitter测试的MPLS模拟测试功能。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type udp-jitter

[Sysname-nqa-admin-test-udp-jitter] mpls-simulation enable exp 5

1.1.49 next-hop

next-hop命令用来配置探测报文的下一跳IP地址。

undo next-hop命令用来恢复缺省情况。

【命令】

next-hop { dhcp | ip ipv4-address | ipv6 ipv6-address }

undo next-hop { dhcp | ip | ipv6 }

【缺省情况】

未配置探测报文的下一跳IP地址。

【视图】

ICMP-echo测试类型视图

DNS/ICMP/TCP/TCP Half Open类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

dhcp：配置该参数时，需要同时配置out interface命令。设备会使用out interface命令中指定的接口从DHCP服务器获取的网关地址作为NQA探测报文的下一跳IP地址。本参数仅ICMP-echo测试类型视图支持。

ip ipv4-address：配置NQA探测报文的下一跳IPv4地址。该地址必须为直连下一跳的IP地址，否则，会导致测试失败。

ipv6 ipv6-address：配置NQA探测报文的下一跳IPv6地址。该地址不能为链路本地地址。该地址必须为直连下一跳的IPv6地址，否则，会导致测试失败。

【使用指导】

应用场景

如图1-1所示，如果要检测Device A到达Device C的链路1的连通性，而当前路由表中没有到达Device C的路由，或者有效路由为链路2，此时，需要配置next-hop命令为探测报文指定下一跳：

· 如果已知Device B的IPv4地址，请配置next-hop ip ipv4-address命令，ipv4-address为Device B的IPv4地址。

· 如果已知Device B的IPv6地址，请配置next-hop ipv6 ipv6-address命令，ipv6-address为Device B的IPv6地址。

· 如果已知Device B为网关，且Device B的IP地址不固定，请配置next-hop dhcp和out interface命令，根据探测报文的目的地址是IPv4地址还是IPv6地址来确定下一跳是使用IPv4网关地址还是IPv6网关地址。

图1-1 next-hop命令应用场景

工作机制

配置next-hop ip ipv4-address或next-hop ipv6 ipv6-address命令后，设备发送探测报文时将不再查找路由表，而直接使用本命令中指定的地址作为NQA探测报文的下一跳地址，发送NQA探测报文。

配置next-hop dhcp和out interface命令后，设备发送探测报文时将不再查找路由表，根据以下情况选择下一跳地址：

· 对于IPv4网络，设备使用指定接口（通过out interface命令指定）从DHCP服务器获取的网关地址，作为ICMP-echo探测报文的下一跳地址，发送NQA探测报文。

· 对于IPv6网络，设备使用指定接口（通过out interface命令指定）从ND邻居获取的网关地址，作为ICMP-echo探测报文的下一跳地址，发送NQA探测报文。

注意事项

对于同一NQA测试，如果同时配置了next-hop ip、next-hop ipv6 和out interface命令，则next-hop ip、next-hop ipv6命令生效，out interface命令不生效。

next-hop dhcp命令仅ICMP-echo测试类型视图支持。

多次配置本命令，最新配置生效。

【举例】

# 在ICMP-echo测试类型下配置探测报文的下一跳IP地址为10.1.1.1。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] next-hop ip 10.1.1.1

# 在ICMP-echo测试类型下配置探测报文的下一跳IPv6地址为2001::1。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] next-hop ipv6 2001::1

【相关命令】

· ip address dhcp-alloc（三层技术-IP业务命令参考/DHCP）

· ipv6 address auto（三层技术-IP业务命令参考/DHCPv6）

· out interface

1.1.50 no-fragment enable

no-fragment enable命令用来开启UDP-tracert探测类型的禁止报文分片功能。

undo no-fragment enable命令用来关闭UDP-tracert探测类型的禁止报文分片功能。

【命令】

no-fragment enable

undo no-fragment enable

【缺省情况】

UDP-tracert测试类型的禁止报文分片功能处于关闭状态。

【视图】

UDP-tracert测试类型视图

Tracert类型的NQA模板视图

【缺省用户角色】

network-admin

【使用指导】

开启此功能后，设备发送的IP报文头部的DF（don't fragment）字段会被置一，这样报文在转发过程中将无法被分片。通过配置这条命令可以对一条链路的路径MTU值进行测试。

【举例】

# 在UDP-tracert测试类型下开启UDP-tracert探测类型的禁止报文分片功能。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type udp-tracert

[Sysname-nqa-admin-test-udp-tracert] no-fragment enable

1.1.51 nqa

nqa命令用来创建NQA测试组，并进入NQA测试组视图。如果指定的NQA测试组视图已经存在，则直接进入NQA测试组视图。

undo nqa命令用来删除指定的NQA测试组。

【命令】

nqa entry admin-name operation-tag

undo nqa { all | entry admin-name operation-tag }

【缺省情况】

不存在NQA测试组。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

admin-name：创建NQA测试组的管理员名称，为1～32个字符的字符串，字符串中不能包括“-”，不区分大小写。

operation-tag：测试操作的标签，为1～32个字符的字符串，字符串中不能包括“-”，不区分大小写。

all：所有NQA测试组。

【使用指导】

创建NQA测试组之后需要指定NQA测试类型，一个测试组只能配置一个测试类型，对于已配置测试类型的测试组，本命令将直接进入测试类型视图。

如果测试组与NQA操作组关联，那么必须先解除关联后才能删除该测试组，all参数无此限制。

【举例】

# 创建一个管理员名为admin，测试操作标签为test的NQA测试组，并进入NQA测试组视图。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test]

1.1.52 nqa agent enable

nqa agent enable命令用来开启NQA客户端功能。

undo nqa agent enable命令用来关闭NQA客户端功能，并停止所有正在进行的测试。

【命令】

nqa agent enable

undo nqa agent enable

【缺省情况】

NQA客户端功能处于开启状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【举例】

# 开启NQA客户端功能。

<Sysname> system-view

[Sysname] nqa agent enable

【相关命令】

· nqa server enable

1.1.53 nqa schedule

nqa schedule命令用来配置测试组的启动时间和持续时间。

undo nqa schedule命令用来停止指定测试组的测试。

【命令】

nqa schedule admin-name operation-tag start-time { hh:mm:ss [ yyyy/mm/dd | mm/dd/yyyy ] | now } lifetime { lifetime | forever } [ recurring ]

undo nqa schedule admin-name operation-tag

【缺省情况】

未配置NQA调度功能。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

admin-name：创建NQA测试组的管理员名称，为1～32个字符的字符串，字符串中不能包括“-”，不区分大小写。

operation-tag：测试操作的标签，为1～32个字符的字符串，字符串中不能包括“-”，不区分大小写。

start-time：指定测试组的启动时间和日期。

hh:mm:ss：测试组的启动时间，小时:分钟:秒。

yyyy/mm/dd：测试组的启动日期，年:月:日，缺省值为系统的当前日期，年的取值范围为2000～2035。

mm/dd/yyyy：测试组的启动日期，月:日:年，缺省值为系统的当前日期，年的取值范围为2000～2035。

now：测试组立即开始测试。

lifetime：指定测试的持续时间。

lifetime：测试的持续时间，取值范围为1～2147483647，单位为秒。

forever：测试组将一直进行测试。

recurring：指定测试组每天都被调度运行。每天启动测试的时间由start-time参数指定。若不指定该参数，则测试组只在当天的指定时间内调度运行一次。

【使用指导】

工作机制

测试组被调度后不允许进入测试类型视图。若需要重新进入测试类型视图，请使用undo nqa schedule命令停止指定测试组的测试。

系统时间在启动时间～启动时间＋持续时间范围内时，测试组进行测试。执行nqa schedule命令时，如果系统时间尚未到达启动时间，则到达启动时间后，启动测试；如果系统时间在启动时间～启动时间＋持续时间之间，则立即启动测试；如果系统时间已经超过启动时间＋持续时间，则不会启动测试。通过display clock命令可以显示系统的当前时间。

测试组被调度后不允许进入测试类型视图。若需要重新进入测试类型视图，请使用undo nqa schedule命令停止指定测试组的测试。

注意事项

配置lifetime时间请保证一次测试能够完成，否则可能导致测试结果错误。测试的持续时间需大于等于“探测报文的个数*发送探测报文的时间间隔 + 单个探测报文的超时时间”。其中：

· 测试的持续时间由nqa schedule中的lifetime参数配置。

· 探测报文的个数由probe packet-number命令配置。

· 发送探测报文的时间间隔由probe packet-interval命令配置。

· 单个探测报文的超时时间由probe packet-timeout命令配置。

【举例】

# 启动管理员名称为admin，标签为test的测试组进行测试，测试组的启动时间为2019年8月8日以后（包含当天）的每天的08:08:08，测试持续时间为1000秒。

<Sysname> system-view

[Sysname] nqa schedule admin test start-time 08:08:08 2019/08/08 lifetime 1000 recurring

【相关命令】

· destination ip

· display clock（基础配置命令参考/设备管理）

· nqa entry

· type

1.1.54 nqa template

nqa template命令用来创建指定类型NQA模板，并进入NQA模板视图。如果指定的NQA模板视图已经存在，则直接进入NQA模板视图。

undo nqa template命令用来删除指定类型的NQA模板。

【命令】

nqa template { arp | diameter | dns | ftp | http | http2 | https | icmp | imap | pop3 | radius | radius-account | rtsp | sip | smtp | snmp | snmpdca | ssl | tcp | tcphalfopen | tracert | udp | wap } name

undo nqa template { arp | diameter | dns | ftp | http | http2 | https | icmp | imap | pop3 | radius | radius-account | rtsp | sip | smtp | snmp | snmpdca | ssl | tcp | tcphalfopen | tracert | udp | wap } name

【缺省情况】

不存在NQA模板。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

arp：配置ARP模板类型。

diameter：配置Diameter模板类型。

dns：配置DNS模板类型。

ftp：配置FTP模板类型。

http：配置HTTP模板类型。

http2：配置HTTP2模板类型。

https：配置HTTPS模板类型。

icmp：配置ICMP模板类型。

imap：配置IMAP模板类型。

pop3：配置POP3模板类型。

radius：配置RADIUS认证探测模板类型。

radius-account：配置RADIUS-ACCOUNT计费探测模板类型。

rtsp：配置RTSP模板类型。

sip：配置SIP模版类型。

smtp：配置SMTP模板类型。

snmp：配置SNMP模板类型。

snmpdca：配置SNMP DCA模板类型。

ssl：配置SSL模板类型。

tcp：配置TCP模板类型。

tcphalfopen：配置TCP Half Open模板类型。

tracert：配置Tracert模板类型。

udp：配置UDP模板类型。

wap：配置WAP模板类型。

name：NQA模板名称，为1～32个字符的字符串，不区分大小写。

【使用指导】

如需删除正在被业务模块引用的NQA模板，请先取消引用关系，再删除。

【举例】

# 创建一个类型为ICMP、名称为icmptplt的模板，并进入NQA模板视图。

<Sysname> system-view

[Sysname] nqa template icmp icmptplt

[Sysname-nqatplt-icmp-icmptplt]

1.1.55 nqa twamp-light client

nqa twamp-light client命令用来创建TWAMP-light Client，并进入TWAMP-light-client视图。如果TWAMP-light Client已经存在，则直接进入TWAMP-light-client视图。

undo nqa twamp-light client命令用来删除TWAMP-light Client。

【命令】

nqa twamp-light client

undo nqa twamp-light client

【缺省情况】

不存在TWAMP-light Client。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

工作机制

双向主动测量协议TWAMP满足对复杂、多样化组网场景性能测量的需求。当使用NQA TWAMP-light统计业务时，需要执行nqa twamp-light client命令进入client视图，在TWAMP-light-client视图下可以创建TWAMP-light Client测试会话（Test session），然后基于这些会话启动相关统计业务。

注意事项

执行undo nqa twamp-light client命令时，系统会删除TWAMP-light Client及其所有的会话和统计信息。

【举例】

# 创建TWAMP-light Client，并进入TWAMP-light-client视图。

<Sysname> system-view

[Sysname] nqa twamp-light client

[Sysname-nqa-twamp-light-client]

1.1.56 nqa twamp-light sender

nqa twamp-light sender命令用来创建TWAMP-light Sender，并进入TWAMP-light-sender视图。如果TWAMP-light Sender已经存在，则直接进入TWAMP-light-sender视图。

undo nqa twamp-light sender命令用来删除TWAMP-light Sender。

【命令】

nqa twamp-light sender

undo nqa twamp-light sender

【缺省情况】

不存在TWAMP-light Sender。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

在TWAMP-light-sender视图下可以控制TWAMP-light测试的启动和停止。

【举例】

# 创建TWAMP-light Sender，并进入TWAMP-light Sender。

<Sysname> system-view

[Sysname] nqa twamp-light sender

[Sysname-nqa-twamp-light-sender]

1.1.57 oid

oid命令用来配置SNMP-DCA测试的SNMP Agent上MIB节点的阈值和权重。

undo oid命令用来恢复缺省情况。

【命令】

oid oid threshold threshold-value weight weight-value

undo oid oid

【缺省情况】

未配置SNMP-DCA测试的SNMP Agent上MIB节点的阈值和权重。

【视图】

SNMP-DCA类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

oid：SNMP-DCA测试的SNMP Agent上MIB节点的OID，为1～255个字符的字符串，其中OID指代的MIB节点的返回值必须为MIB节点的资源使用率。

threshold threshold-value：阈值，表示MIB节点的资源使用率可达到的上限，取值范围为0～100。取值为0时表示该MIB节点不作为判断SNMP Agent是否繁忙的参考。

weight weight-value：权重，表示MIB节点在用于计算SNMP Agent状态时应占有的比重。取值范围为0～100，取值为0时表示该MIB节点的权重不参与SNMP Agent状态的计算。

【使用指导】

当agent-type配置为User-defined时，必须进行本配置，用户最多可以配置8条自定义的OID命令。

NQA客户端对Net-SNMP或Windows类型的SNMP Agent进行SNMP-DCA测试时，会自动获取SNMP Agent当前MIB节点的资源使用率。

【举例】

# 在SNMP-DCA类型的NQA模板视图下配置测试的SNMP Agent上MIB节点的阈值和权重。

<Sysname> system-view

[Sysname] nqa template snmpdca test

[Sysname-nqatplt-snmpdca-test] oid 1.3.6.1.4.1.2021.11.11.0 threshold 90 weight 90

【相关命令】

· agent-type

1.1.58 operation (FTP operation view)

operation命令用来配置FTP测试的操作方式。

undo operation命令用来恢复缺省情况。

【命令】

operation { get | put }

undo operation

【缺省情况】

FTP测试的操作方式为get操作。

【视图】

FTP测试类型视图

FTP类型的模板视图

【缺省用户角色】

network-admin

【参数】

get：从FTP服务器获取文件。

put：向FTP服务器传送文件。

【使用指导】

工作机制

进行Put操作时，若配置了filename，发送数据前判断filename指定的文件是否存在，如果存在则上传该文件，如果不存在则探测失败。

进行Get操作时，如果FTP服务器上没有以url中所配置的文件名为名称的文件，则测试不会成功。进行Get操作时，设备上不会保存从服务器获取的文件。

注意事项

进行Put、Get操作时，请选用较小的文件进行测试，如果文件较大，可能会因为超时而导致测试失败，或由于占用较多的网络带宽而影响其他业务。

【举例】

# 在FTP测试类型下配置FTP测试的操作方式为put操作。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type ftp

[Sysname-nqa-admin-test-ftp] operation put

【相关命令】

· filename

· password

· url

· username

1.1.59 operation (HTTP/HTTP2 operation view and HTTP/HTTP2/HTTPS template view)

operation命令用来配置HTTP、HTTP/2、HTTPS测试的操作方式。

undo operation命令用来恢复缺省情况。

【命令】

operation { get | post | raw }

undo operation

【缺省情况】

HTTP/HTTP2/HTTPS测试的操作方式为get操作。

【视图】

HTTP/HTTP2测试类型视图

HTTP/HTTP2/HTTPS类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

get：从HTTP服务器、HTTP/2服务器、HTTPS服务器获取数据。

post：向HTTP服务器、HTTP/2服务器、HTTPS服务器提交数据。

raw：向HTTP服务器、HTTP/2服务器、HTTPS服务器发送RAW请求报文。

【使用指导】

HTTP测试中以HTTP请求报文作为探测报文。HTTP/2测试中以HTTP/2请求报文作为探测报文。HTTPS测试中以HTTPS请求报文作为探测报文。

测试的操作方式为get或post时，请求报文内容从url中获取。

测试的操作方式为raw时，请求报文为raw-request子视图中配置的内容。在配置HTTP、HTTP/2、HTTPS操作方式中的raw操作可以通过在raw-request子视图中配置get、post或其他服务器支持的请求类型的HTTP、HTTP/2、HTTPS报文，以此直接作为探测报文。请确保raw-request子视图中所配置报文内容的正确性。

【举例】

# 在HTTP测试类型下配置HTTP测试的操作方式为raw操作。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type http

[Sysname-nqa-admin-test-http] operation raw

# 在HTTP类型的NQA模板视图下配置测试的操作方式为raw操作。

<Sysname> system-view

[Sysname] nqa template http httptplt

[Sysname-nqatplt-http-httptplt] operation raw

【相关命令】

· password

· raw-request

· username

1.1.60 out interface

out interface命令用来指定探测报文的出接口。

undo out interface命令用来恢复缺省情况。

【命令】

out interface interface-type interface-number

undo out interface

【缺省情况】

设备通过查询路由表信息确认探测报文出接口。

【视图】

ICMP-echo测试类型视图

DHCP测试类型视图

HTTP/HTTP2测试类型视图

UDP-tracert测试类型视图

UDP-jitter测试类型视图

Diameter/DNS/HTTP/HTTP2/HTTPS/ICMP/TCP/TCP Half Open/Tracert/UDP类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

interface-type interface-number：探测报文出接口的接口类型和接口编号。

【使用指导】

应用场景

本命令的典型应用场景如下：

· 当到达测试目的端有多条等价路由时，配置本命令后，可帮助NQA从路由表匹配到唯一的下一跳，从而，实现对指定链路的NQA测试。

· 当探测报文的下一跳为网关，且网关的IP地址不固定时，可将本命令和next-hop dhcp命令配合使用，帮助ICMP-echo测试报文获取下一跳（网关）的地址。

工作机制

· 如果测试类型视图或者NQA模板视图下配置了out interface命令，同时还使用next-hop ip或者next-hop ipv6命令为探测报文配置了下一跳，则下一跳配置生效，本命令不生效。NQA无需查询路由表，直接使用指定的下一跳IP地址发送探测报文。

· 如果测试类型视图或者NQA模板视图下配置了out interface命令，但未使用next-hop命令配置下一跳，则NQA会使用NQA测试的目的地址、本命令配置的出接口和VPN查询路由表，找到唯一的下一跳作为NQA探测报文的下一跳。

· 本命令和next-hop dhcp命令配合使用时，NQA会使用本命令指定的接口从DHCP服务器上获取的网关地址作为NQA探测报文的下一跳。所以，该接口下还需要配置通过DHCP协议自动获取IP地址。

配置限制

该命令指定的接口必须处于UP状态，否则NQA探测会失败。

对于ICMP-echo测试类型和DNS/ICMP/TCP Half Open类型的NQA模板，支持配置next-hop命令。

仅ICMP-echo测试支持配置next-hop dhcp命令。

【举例】

# 在ICMP-echo测试类型下配置接口GigabitEthernet0/0/1作为ICMP-echo探测报文出接口。‌

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] out interface gigabitethernet 0/0/1

【相关命令】

· ip address dhcp-alloc（三层技术-IP业务命令参考/DHCP）

· ipv6 address dhcp-alloc（三层技术-IP业务命令参考/DHCPv6）

· next-hop

1.1.61 password

password命令用来配置测试服务器的用户登录密码。

undo password命令用来恢复缺省情况。

【命令】

password { cipher | simple } string

undo password

【缺省情况】

未配置测试服务器的用户登录密码。

【视图】

FTP/HTTP/HTTP2测试类型视图

FTP/HTTP/HTTP2/HTTPS/IMAP/POP3/RADIUS认证探测类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

cipher：以密文方式设置密码。

simple：以明文方式设置密码，该密码将以密文形式存储。

string：密码字符串，区分大小写。明文密码为1～32个字符的字符串，密文密码为1～73个字符的字符串。

【举例】

# 在FTP测试类型下配置FTP服务器的用户登录密码为ftpuser。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type ftp

[Sysname-nqa-admin-test-ftp] password simple ftpuser

【相关命令】

· operation

· username

1.1.62 port-detect enable

port-detect enable命令用来开启端口检测功能。

undo port-detect enable命令用来关闭端口检测功能。

【命令】

port-detect enable

undo port-detect enable

【缺省情况】

端口检测功能处于关闭状态。

【视图】

TCP Half Open/UDP类型的NQA模板视图

【缺省用户角色】

network-admin

【使用指导】

开启TCP Half Open模板的端口检测功能是用于测试对端TCP服务的端口是否可用。NQA客户端将主动向对端发出TCP SYN报文，如果在探测超时时间（probe timeout命令配置）内，收到目的端回应的SYN+ACK报文，则认为测试成功，反之则认为测试失败。

开启UDP模板的端口检测功能用于测试对端UDP服务的端口是否可用。如果在探测超时时间（probe timeout命令配置）内，没有收到任何标识目的端不可达的ICMP差错报文，则认为测试成功，反之则认为测试失败。需要在目的端开启ICMP目的不可达报文发送功能，如果目的端是H3C设备，需要在设备上执行ip unreachables enable命令。另外，需要配置data-fill string raw或hex-data-fill hex raw命令，填充字符串可以是在参数允许范围内的任意值。

要使本功能生效，必须通过destination port命令配置目的端口号。

【举例】

# 在TCP Half Open类型的NQA模板视图下开启TCP Half Open的端口检测功能。

<Sysname> system-view

[Sysname] nqa template tcphalfopen tplt

[Sysname-nqatplt-tcphalfopen-tplt] port-detect enable

【相关命令】

· data-fill

· destination port

· hex-data-fill

· ip unreachables enable（三层技术-IP业务命令参考/IP性能优化）

1.1.63 priority 8021p

priority 8021p命令用来配置探测报文的802.1p优先级。

undo priority 8021p命令用来恢复缺省情况。

【命令】

priority 8021p value

undo priority 8021p

【缺省情况】

探测报文的802.1p优先级为0。

【视图】

TWAMP-light-client-session视图

【缺省用户角色】

network-admin

【参数】

value：探测报文的802.1p优先级，取值范围为0～7。

【使用指导】

为了测试在二层网络环境下，对于业务流量拥塞的情况下设备根据报文不同的优先级给予不同的优先转发策略时，路径上对于该类流量的服务质量。此时使用本命令指定测试流量的优先级。

有关802.1p优先级的详细介绍，请参见“ACL和QoS配置指导”中的“QoS”。

【举例】

# 配置TWAMP-light测试探测报文的802.1p优先级为1。

<Sysname> system-view

[Sysname] nqa twamp-light client

[Sysname-nqa-twamp-light-client] test-session 1

[Sysname-nqa-twamp-light-client-session1] priority 8021p 1

1.1.64 probe count

probe count命令用来配置一次NQA测试中探测的次数。

undo probe count命令用来恢复缺省情况。

【命令】

probe count times

undo probe count

【缺省情况】

对于UDP-tracert测试类型，对于一个TTL值的节点发送的探测报文次数为3次；其他类型的NQA测试一次NQA测试中的探测次数为1次。

【视图】

ICMP-echo/TCP/UDP-echo测试类型视图

ARP/DHCP/DLSw/DNS/FTP/HTTP/HTTP2/SNMP测试类型视图

UDP-tracert测试类型视图

ICMP-jitter/UDP-jitter测试类型视图

【缺省用户角色】

network-admin

【参数】

times：对于UDP-tracert测试类型，表示对于一个TTL值的节点发送的探测报文次数，取值范围为1～10；对于其他测试类型，表示一次NQA测试中进行探测的次数，取值范围为1～15。

【使用指导】

不同测试类型中，探测的含义不同：

· 对于TCP和DLSw测试，一次探测操作是指建立一次连接。

· 对于ICMP-jitter和UDP-jitter测试，一次探测操作是指连续发送多个探测报文，发送探测报文的个数由probe packet-number命令指定。

· 对于FTP、DHCP、DNS、HTTP和HTTP2测试，一次探测操作是指完成一次相应的功能，例如上传或下载一个文件，获取一个Web页面，为接口申请一个IP地址，将一个域名解析为IP地址。

· 对于ICMP-echo、ARP和UDP-echo测试，一次探测操作是指发送一个探测报文。

· 对于SNMP测试，一次探测操作是指发送三个SNMP协议报文，分别对应SNMP v1、SNMP v2c和SNMP v3三个版本。

· 对于Path-jitter测试，一次探测操作分为两个步骤：首先通过tracert探路获取到达目的地址的路径（最大为64跳）；再根据tracert结果，分别向路径上的每一跳发送多个ICMP-echo探测报文，发送探测报文的个数由用户来设定。

· 对于UDP-tracert测试，一次探测操作是指一个特定TTL值的节点发送一个探测报文的操作。

对于UDP-tracert测试，同一个TTL的节点，设备会发送数量为probe count命令配置的探测报文，系统在进行第一次探测之后，等待回应；对于其他类型的测试，如果配置的次数大于1，那么系统在进行第一次探测之后，等待回应。如果到达probe timeout命令指定的探测超时时间时，仍然没有收到回应，则发起第二次探测。如此反复，直到完成指定次数的探测。

【举例】

# 在ICMP-echo测试类型下配置一次ICMP-echo测试中探测的次数为10次。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] probe count 10

1.1.65 probe packet-interval

probe packet-interval命令用来配置发送探测报文的时间间隔。

undo probe packet-interval命令用来恢复缺省情况。

【命令】

probe packet-interval interval

undo probe packet-interval

【缺省情况】

发送探测报文的时间间隔为20毫秒。

【视图】

ICMP-jitter/Path-jitter/UDP-jitter/Voice测试类型视图

【缺省用户角色】

network-admin

【参数】

interval：测试中发送探测报文的时间间隔，取值范围为10～60000，单位为毫秒。

【举例】

# 在UDP-jitter测试类型下配置测试中发送探测报文的时间间隔为100毫秒。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type udp-jitter

[Sysname-nqa-admin-test-udp-jitter] probe packet-interval 100

1.1.66 probe packet-number

probe packet-number命令用来配置一次探测中发送探测报文的个数。

undo probe packet-number命令用恢复缺省情况。

【命令】

probe packet-number number

undo probe packet-number

【缺省情况】

一次ICMP-jitter、UDP-jitter或Path-jitter探测中发送10个探测报文；一次Voice探测中发送1000个探测报文。

【视图】

ICMP-jitter/Path-jitter/UDP-jitter/Voice测试类型视图

【缺省用户角色】

network-admin

【参数】

number：一次探测中发送探测报文的个数，对于ICMP-jitter、UDP-jitter和Path-jitter测试，取值范围为10～1000；对于Voice测试，取值范围为10～60000。

【举例】

# 在UDP-jitter测试类型下配置一次探测中发送100个探测报文。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type udp-jitter

[Sysname-nqa-admin-test-udp-jitter] probe packet-number 100

1.1.67 probe packet-timeout

probe packet-timeout命令用来配置一次探测中等待响应报文的超时时间。

undo probe packet-timeout命令用来恢复缺省情况。

【命令】

probe packet-timeout timeout

undo probe packet-timeout

【缺省情况】

ICMP-jitter、UDP-jitter和Path-jitter测试中等待响应报文的超时时间为3000毫秒；Voice测试中等待响应报文的超时时间为5000毫秒。

【视图】

ICMP-jitter/Path-jitter/UDP-jitter/Voice测试类型视图

【缺省用户角色】

network-admin

【参数】

timeout：一次探测中等待响应报文的超时时间，取值范围为10～3600000，单位为毫秒。

【举例】

# 在UDP-jitter测试类型下配置一次探测中等待响应报文的超时时间为100毫秒。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type udp-jitter

[Sysname-nqa-admin-test-udp-jitter] probe packet-timeout 100

1.1.68 probe timeout

probe timeout命令用来配置探测的超时时间。

undo probe timeout命令用来恢复缺省情况。

【命令】

probe timeout timeout

undo probe timeout

【缺省情况】

探测的超时时间为3000毫秒。

【视图】

ICMP-echo/TCP/UDP-echo测试类型视图

ARP/DHCP/DLSw/DNS/FTP/HTTP/HTTP2/SNMP测试类型视图

UDP-tracert测试类型视图

任意类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

timeout：一次探测的超时时间，单位为毫秒。在FTP、HTTP、HTTP/2探测中，取值范围为10～86400000；在DHCP、DLSw、DNS、ICMP-echo、SNMP、TCP、UDP-echo、ARP和UDP-tracert探测中，取值范围为10～3600000。对于NQA模板类型来说，FTP、HTTP、HTTP/2和HTTPS模板的范围为10～86400000，其他模板范围为10～3600000。

【使用指导】

如果NQA探测没有在probe timeout命令指定的时间内完成，则认为本次探测超时。

frequency命令中配置的interval参数的值需要大于probe timeout命令中的timeout参数的值。否则，probe timeout命令将没有机会生效。

【举例】

# 在ICMP-echo测试类型下配置探测的超时时间为10000毫秒。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] probe timeout 10000

1.1.69 product-name

product-name命令用来配置Diameter探测报文中设备产品名字段的值。

undo product-name命令用来恢复缺省情况。

【命令】

product-name product-name

undo product-name

【缺省情况】

Diameter探测报文中设备产品名字段的值为H3C Diameter Health Monitoring。

【视图】

Diameter类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

product-name：表示Diameter探测报文中设备产品名字段的值，为1～127个字符的字符串，区分大小写。

【使用指导】

本命令用于配置Diamater探测请求报文中Product-Name键值对的值。Diamater探测请求报文中Vendor-Id、Product-Name和Firmware-Reversion（固件版本，如果设备没有固件版本，可不携带Firmware-Reversion键值对）组合可以为Diamater服务器提供很有用的调试信息。

【举例】

# 配置Diameter探测报文中设备产品名字段的值为Diameter Health Monitoring。

<Sysname> system-view

[Sysname] nqa template diameter diametertplt

[Sysname-nqatplt-diameter-diametertplt] product-name Diameter Health Monitoring

1.1.70 proxy-url

proxy-url命令用来配置HTTP/HTTP2/HTTPS代理服务器的网址。

undo proxy-url命令用来恢复缺省情况。

【命令】

proxy-url url

undo proxy-url

【缺省情况】

未配置HTTP/HTTP2/HTTPS代理服务器的网址。

【视图】

HTTP/HTTP2/HTTPS类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

url：HTTP/HTTP2/HTTPS代理服务器的网址，为1～255个字符的字符串，区分大小写。url的主机名部分，由“.”分隔的字符串组成（如 aabbcc.com），每个字符串的长度不超过63个字符，区分大小写；字符串中可以包含字母、数字、“-”及“_”，不能出现连续“.”。

· HTTP测试类型时，url格式为http://host或http://host:port。

· HTTPS测试类型时，url格式为https://host或https://host:port。

· HTTP2测试类型时，url格式为http://host、http://host:port、https://host或https://host:port。

【使用指导】

在必须通过代理服务器才能访问HTTP/HTTP2/HTTPS服务器的组网环境下，必须配置本命令。配置本命令后，设备发送的探测报文以及HTTP/HTTP2/HTTPS服务器返回的响应报文，都会经过代理服务器中转。

【举例】

# 在HTTP类型的NQA模板视图下配置HTTP代理服务器的网址为http://www.company.com。

<Sysname> system-view

[Sysname] nqa template http httptplt

[Sysname-nqatplt-http-httptplt] proxy-url http://www.company.com

1.1.71 raw-request

raw-request命令用来进入raw-request子视图，并在该子视图下配置HTTP/HTTPS测试请求报文内容。

undo raw-request命令用来恢复缺省情况。

【命令】

raw-request

undo raw-request

【缺省情况】

未配置HTTP/HTTPS测试请求报文的内容。

【视图】

HTTP测试类型视图

HTTP/HTTPS类型的NQA模板视图

【缺省用户角色】

network-admin

【使用指导】

每次使用raw-request命令进入raw-request子视图时，之前在该子视图下配置的HTTP测试请求报文内容会被清除。

HTTP/HTTPS测试的操作方式为raw时，必须配置该命令。raw-request子视图下支持配置TEXT命令。TEXT命令为HTTP/HTTPS测试报文的内容，即HTTP/HTTPS的请求报文。要求报文内容中不能包含alias命令配置的别名，请用户自行确保报文的正确性，否则探测将失败。有关alias命令的详细介绍请参见“基础配置命令参考”中的“CLI”。

【举例】

# 进入raw-request子视图，并在该子视图下配置HTTP测试GET操作的请求报文的内容。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type http

[Sysname-nqa-admin-test-http] raw-request

[Sysname-nqa-admin-test-http-raw-request] GET /sdn/ui/app/index HTTP/1.0\r\nHost: 172.0.0.2\r\n\r\n

# 在HTTP类型的NQA模板视图下，进入raw-request子视图，并在该子视图下配置HTTP测试POST操作的请求报文的内容。

<Sysname> system-view

[Sysname] nqa template http httptplt

[Sysname-nqatplt-http-httptplt] raw-request

[Sysname-nqatplt-http-httptplt-raw-request] POST /sdn/ui/app/index HTTP/1.0\r\nHost:

172.0.0.2\r\nAuthorization: Basic cm9vdDoxMjM0NTY=\r\n\r\n

1.1.72 raw-request-hex

raw-request-hex命令用来进入raw-request-hex子视图，并在该子视图下配置HTTP/2测试请求报文内容。

undo raw-request-hex命令用来恢复缺省情况。

【命令】

raw-request-hex

undo raw-request-hex

【缺省情况】

未配置HTTP/2测试请求报文的内容。

【视图】

HTTP2测试类型视图

HTTP2类型的NQA模板视图

【缺省用户角色】

network-admin

【使用指导】

每次使用raw-request-hex命令进入raw-request-hex子视图时，之前在该子视图下配置的HTTP/2测试请求报文内容会被清除。

HTTP/2测试的操作方式为raw时，必须配置该命令。raw-request-hex子视图下支持配置十六进制字符串填充HTTP/2测试报的内容，即HTTP/2的请求报文。字符串为2～512个字符，字符串长度必须是偶数且不区分大小写。要求用户自行确保报文的正确性，否则探测将失败。

【举例】

# 进入raw-request-hex子视图，并在该子视图下配置HTTP/2测试GET操作的请求报文的内容。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type http2

[Sysname-nqa-admin-test-http2] raw-request-hex

[Sysname-nqa-admin-test-http2-raw-request-hex] 505249202a20485454502f322e300d0a0d0a534d0d0a0d0a00002404000000000000010000100000020000000100030000000100040001000000050000400000060000100000009401250000000300000000008286110b31302e32312e32312e323114082f31622e68746d6c1006616363657074032a2f2a100f6163636570742d6c616e677561676505656e2d757390100a757365722d6167656e74454d6f7a696c6c612f342e302028636f6d70617469626c653b204d53494520362e303b2057696e646f7773204e5420352e313b202e4e455420434c5220312e312e3433323229

# 在HTTP/2类型的NQA模板视图下，进入raw-request-hex子视图，并在该子视图下配置HTTP/2测试GET操作的请求报文的内容。

<Sysname> system-view

[Sysname] nqa template http2 http2tplt

[Sysname-nqatplt-http2-http2tplt] raw-request-hex

[Sysname-nqatplt-http2-http2tplt-raw-request-hex] 505249202a20485454502f322e300d0a0d0a534d0d0a0d0a00002404000000000000010000100000020000000100030000000100040001000000050000400000060000100000009401250000000300000000008286110b31302e32312e32312e323114082f31622e68746d6c1006616363657074032a2f2a100f6163636570742d6c616e677561676505656e2d757390100a757365722d6167656e74454d6f7a696c6c612f342e302028636f6d70617469626c653b204d53494520362e303b2057696e646f7773204e5420352e313b202e4e455420434c5220312e312e3433323229

【相关命令】

· operation (HTTP/HTTP2 operation view)

1.1.73 reaction checked-element { jitter-ds | jitter-sd }

reaction checked-element { jitter-ds | jitter-sd }命令用来创建监测单向抖动时间的阈值告警组。

undo reaction命令用来删除指定的阈值告警组。

【命令】

reaction item-number checked-element { jitter-ds | jitter-sd } threshold-type { accumulate accumulate-occurrences | average } threshold-value upper-threshold lower-threshold [ action-type { none | trap-only } ]

undo reaction item-number

【缺省情况】

不存在监测单向抖动时间的阈值告警组。

【视图】

ICMP-jitter/UDP-jitter/Voice测试类型视图

【缺省用户角色】

network-admin

【参数】

item-number：阈值告警组编号，取值范围为1～10。

jitter-ds：监测从目的到源的单向抖动时间。

jitter-sd：监测从源到目的的单向抖动时间。

threshold-type：指定阈值类型。

accumulate accumulate-occurrences：每次测试中，累计的单向抖动时间超出阈值的报文个数。对于ICMP-jitter与UDP-jitter测试，取值为1～14999；对于Voice测试，取值范围为1～59999。

average：每次测试中，单向抖动时间的平均值。

threshold-value：指定阈值范围。

upper-threshold：阈值上限，取值范围为0～3600000，单位为毫秒。

lower-threshold：阈值下限，取值范围为0～3600000，且必须小于等于阈值上限，单位为毫秒。

action-type：触发的动作类型，缺省动作类型为none。

none：只在显示信息中记录监测结果，不向网管发送Trap消息。

trap-only：条件满足时，在显示信息中记录监测结果的同时，向网管发送Trap消息。

【使用指导】

阈值告警组创建后，不能再通过reaction命令修改该阈值告警组的内容。若要修改阈值告警组的内容，则需要先通过undo reaction命令用来删除阈值告警组，再利用新的参数创建阈值告警组。

监测的对象是探测成功的报文，探测失败的报文不参与计数。

【举例】

# 在UDP-jitter测试类型下创建编号为1的阈值告警组，监测UDP-jitter探测报文的从目的到源的单向抖动时间，阈值上限为50毫秒，下限为5毫秒。NQA测试组启动前，初始的阈值状态为invalid。每次测试结束后，检查本次测试的平均单向抖动时间，若超出阈值，阈值状态置为over-threshold；反之，置为below-threshold。当阈值状态改变时，向网管发送Trap消息。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type udp-jitter

[Sysname-nqa-admin-test-udp-jitter] reaction 1 checked-element jitter-ds threshold-type average threshold-value 50 5 action-type trap-only

# 在UDP-jitter测试类型下创建编号为2的阈值告警组，监测UDP-jitter探测报文的从目的到源的单向抖动时间，阈值上限为50毫秒，下限为5毫秒。NQA测试组启动前，初始的阈值状态为invalid。每次测试结束后，检查本次测试中累计的单向抖动时间超出阈值的报文个数，若达到或超过100个，阈值状态置为over-threshold；反之，置为below-threshold。当阈值状态改变时，向网管发送Trap消息。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type udp-jitter

[Sysname-nqa-admin-test-udp-jitter] reaction 2 checked-element jitter-ds threshold-type accumulate 100 threshold-value 50 5 action-type trap-only

1.1.74 reaction checked-element { owd-ds | owd-sd }

reaction checked-element { owd-ds | owd-sd }命令用来创建监测单向时延的阈值告警组。

undo reaction命令用来删除指定的阈值告警组。

【命令】

reaction item-number checked-element { owd-ds | owd-sd } threshold-value upper-threshold lower-threshold [ action-type { none | trap-only } ]

undo reaction item-number

【缺省情况】

不存在监测单向时延的阈值告警组。

【视图】

ICMP-jitter/UDP-jitter/Voice测试类型视图

【缺省用户角色】

network-admin

【参数】

item-number：阈值告警组编号，取值范围为1～10。

owd-ds：监测每个探测报文的从目的到源的单向时延。

owd-sd：监测每个探测报文的从源到目的的单向时延。

threshold-value：指定阈值范围。

upper-threshold：阈值上限，取值范围为0～3600000，单位为毫秒。

lower-threshold：阈值下限，取值范围为0～3600000，单位为毫秒，且必须小于等于阈值上限。

action-type：触发的动作类型，缺省动作类型为none。

none：只在显示信息中记录监测结果，不向网管发送Trap消息。

trap-only：条件满足时，在显示信息中记录监测结果的同时，向网管发送Trap消息。

【使用指导】

应用场景

本命令用于配置监测单向时延的阈值告警，当单向时延达到配置的阈值时，执行指定的动作。

注意事项

监测的对象是探测成功的报文，探测失败的报文不参与计数。

监测单向时延的阈值告警组不支持触发动作，但可以通过相关显示命令display nqa reaction counters和display nqa statistics显示当前的监测结果。

【举例】

# 在UDP-jitter测试类型下创建编号为1的阈值告警组，监测每个UDP-jitter探测报文的从目的到源的单向时延，阈值上限为50毫秒，下限为5毫秒。NQA测试组启动前，初始的阈值状态为invalid。收到探测报文的应答报文后，计算该探测报文从目的到源的单向时延，若超出阈值范围，阈值状态置为over-threshold；反之，置为below-threshold。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type udp-jitter

[Sysname-nqa-admin-test-udp-jitter] reaction 1 checked-element owd-ds threshold-value 50 5

1.1.75 reaction checked-element icpif

reaction checked-element icpif命令用来创建监测Voice测试ICPIF值的阈值告警组。

undo reaction命令用来删除指定的阈值告警组。

【命令】

reaction item-number checked-element icpif threshold-value upper-threshold lower-threshold [ action-type { none | trap-only } ]

undo reaction item-number

【缺省情况】

不存在监测Voice测试ICPIF值的阈值告警组。

【视图】

Voice测试类型视图

【缺省用户角色】

network-admin

【参数】

item-number：阈值告警组编号，取值范围为1～10。

threshold-value：指定阈值范围。

upper-threshold：阈值上限，取值范围为1～100。

lower-threshold：阈值下限，取值范围为1～100，且必须小于等于阈值上限。

action-type：触发的动作类型，缺省动作类型为none。

none：只在显示信息中记录监测结果，不向网管发送Trap消息。

trap-only：条件满足时，在显示信息中记录监测结果的同时，向网管发送Trap消息。

【使用指导】

【举例】

# 在Voice测试类型下创建编号为1的阈值告警组，监测每次Voice测试的ICPIF值，阈值上限为50，下限为5。NQA测试组启动前，初始的阈值状态为invalid。每次测试结束后，检查本次测试的ICPIF值，若超出阈值范围，阈值状态置为over-threshold；反之，置为below-threshold。当阈值状态改变时，向网管发送Trap消息。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type voice

[Sysname-nqa-admin-test-voice] reaction 1 checked-element icpif threshold-value 50 5 action-type trap-only

1.1.76 reaction checked-element mos

reaction checked-element mos命令用来创建监测Voice测试MOS值的阈值告警组。

undo reaction命令用来删除指定的阈值告警组。

【命令】

reaction item-number checked-element mos threshold-value upper-threshold lower-threshold [ action-type { none | trap-only } ]

undo reaction item-number

【缺省情况】

不存在监测Voice测试MOS值的阈值告警组。

【视图】

Voice测试类型视图

【缺省用户角色】

network-admin

【参数】

item-number：阈值告警组的编号，取值范围为1～10。

threshold-value：指定阈值范围。

upper-threshold：阈值上限，取值范围为1～500。

lower-threshold：阈值下限，取值范围为1～500，且必须小于等于阈值上限。

action-type：触发的动作类型，缺省动作类型为none。

none：只在显示信息中记录监测结果，不向网管发送Trap消息。

trap-only：条件满足时，在显示信息中记录监测结果的同时，向网管发送Trap消息。

【使用指导】

工作机制

实际的阈值下限（或阈值上限）为输入的阈值下限/100（或阈值上限/100），即如果输入的阈值下限和阈值上限分别为100、200，则MOS值在1～2之间时，未超出阈值。

注意事项

【举例】

# 在Voice测试类型下创建编号为1的阈值告警组，监测每次Voice测试的MOS值，阈值上限为200，下限为100。NQA测试组启动前，初始的阈值状态为invalid。每次测试结束后，检查本次测试的MOS值，若超出阈值范围，阈值状态置为over-threshold；反之，置为below-threshold。当阈值状态改变时，向网管发送Trap消息。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type voice

[Sysname-nqa-admin-test-voice] reaction 1 checked-element mos threshold-value 200 100 action-type trap-only

1.1.77 reaction checked-element packet-loss

reaction checked-element packet-loss命令用来创建监测每次测试中丢包数的阈值告警组。

undo reaction命令用来删除指定的阈值告警组。

【命令】

reaction item-number checked-element packet-loss threshold-type accumulate accumulate-occurrences [ action-type { none | trap-only } ]

undo reaction item-number

【缺省情况】

不存在监测每次测试中丢包数的阈值告警组。

【视图】

ICMP-jitter/UDP-jitter/Voice测试类型视图

【缺省用户角色】

network-admin

【参数】

item-number：阈值告警组的编号，取值范围为1～10。

threshold-type：指定阈值类型。

accumulate accumulate-occurrences：每次测试中，累计的丢包数。对于ICMP-jitter与UDP-jitter测试，取值范围为1～15000；对于Voice测试，取值范围为1～60000。

action-type：触发的动作类型，缺省动作类型为none。

none：只在显示信息中记录监测结果，不向网管发送Trap消息。

trap-only：条件满足时，在显示信息中记录监测结果的同时，向网管发送Trap消息。

【使用指导】

【举例】

# 在UDP-jitter测试类型下创建编号为1的阈值告警组，监测每次UDP-jitter测试的丢包数。NQA测试组启动前，初始的阈值状态为invalid。每次测试结束后，检查本次测试中累计的丢包数，若达到或超过100个，阈值状态置为over-threshold；反之，置为below-threshold。当阈值状态改变时，向网管发送Trap消息。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type udp-jitter

[Sysname-nqa-admin-test-udp-jitter] reaction 1 checked-element packet-loss threshold-type accumulate 100 action-type trap-only

1.1.78 reaction checked-element probe-duration

reaction checked-element probe-duration命令用来创建监测探测持续时间的阈值告警组。

undo reaction命令用来删除指定的阈值告警组。

【命令】

reaction item-number checked-element probe-duration threshold-type { accumulate accumulate-occurrences | average | consecutive consecutive-occurrences } threshold-value upper-threshold lower-threshold [ action-type { none | trap-only } ]

undo reaction item-number

【缺省情况】

不存在监测探测持续时间的阈值告警组。

【视图】

ICMP-echo/TCP/UDP-echo测试类型视图

ARP/DHCP/DLSw/DNS/FTP/HTTP/HTTP2/SNMP测试类型视图

【缺省用户角色】

network-admin

【参数】

item-number：阈值告警组的编号，取值范围为1～10。

threshold-type：指定阈值类型。

accumulate accumulate-occurrences：每次测试中，累计的探测持续时间超出阈值的探测次数。accumulate-occurrences取值范围为1～15。

average：每次测试中，探测持续时间的平均值。

consecutive consecutive-occurrences：测试组启动后，连续的探测持续时间超出阈值的探测次数。consecutive-occurrences取值范围为1～16。

threshold-value：指定阈值范围。

upper-threshold：阈值上限，取值范围为0～3600000，单位为毫秒。

lower-threshold：阈值下限，取值范围为0～3600000，单位为毫秒，且必须小于等于阈值上限。

action-type：触发的动作类型，缺省动作类型为none。

none：只在显示信息中记录监测结果，不向网管发送Trap消息。

trap-only：条件满足时，在显示信息中记录监测结果的同时，向网管发送Trap消息。DNS测试不支持发送Trap，DNS测试类型视图下无此参数。

【使用指导】

监测的对象是成功的探测，失败的探测不参与计数。

【举例】

# 在ICMP-echo测试类型下创建编号为1的阈值告警组，监测ICMP-echo探测的持续时间，阈值上限为50毫秒，下限为5毫秒。NQA测试组启动前，初始的阈值状态为invalid。每次测试结束后，检查本次测试的平均探测持续时间，若超出阈值，阈值状态置为over-threshold；反之，置为below-threshold。当阈值状态改变时，向网管发送Trap消息。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] reaction 1 checked-element probe-duration threshold-type average threshold-value 50 5 action-type trap-only

# 在ICMP-echo测试类型下创建编号为2的阈值告警组，监测ICMP-echo探测的持续时间，阈值上限为50毫秒，下限为5毫秒。NQA测试组启动前，初始的阈值状态为invalid。每次测试结束后，检查本次测试中累计的持续时间超出阈值的探测次数，若达到或超过10次，阈值状态置为over-threshold；反之，置为below-threshold。当阈值状态改变时，向网管发送Trap消息。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] reaction 2 checked-element probe-duration threshold-type accumulate 10 threshold-value 50 5 action-type trap-only

# 在ICMP-echo测试类型下创建编号为3的阈值告警组，监测ICMP-echo探测的持续时间，阈值上限为50毫秒，下限为5毫秒。NQA测试组启动前，初始的阈值状态为invalid。每次探测结束后，检查测试组启动以来连续的持续时间超出阈值的探测次数，若达到或超过10次，阈值状态置为over-threshold；反之，置为below-threshold。当阈值状态改变时，向网管发送Trap消息。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] reaction 3 checked-element probe-duration threshold-type consecutive 10 threshold-value 50 5 action-type trap-only

1.1.79 reaction checked-element probe-fail (for trap)

reaction checked-element probe-fail命令用来创建监测探测失败次数的阈值告警组。

undo reaction命令用来删除指定的阈值告警组。

【命令】

reaction item-number checked-element probe-fail threshold-type { accumulate accumulate-occurrences | consecutive consecutive-occurrences } [ action-type { none | trap-only } ]

undo reaction item-number

【缺省情况】

不存在监测探测失败次数的阈值告警组。

【视图】

ICMP-echo/TCP/UDP-echo测试类型视图

ARP/DHCP/DLSw/DNS/FTP/HTTP/HTTP2/SNMP测试类型视图

【缺省用户角色】

network-admin

【参数】

item-number：阈值告警组编号，取值范围为1～10。

threshold-type：指定阈值类型。

accumulate accumulate-occurrences：一次测试中，累计的探测失败次数。accumulate-occurrences取值范围为1～15。

consecutive consecutive-occurrences：NQA测试组启动以来，连续的探测失败次数。consecutive-occurrences取值范围为1～16。

action-type：触发的动作类型，缺省动作类型为none。

none：只在显示信息中记录监测结果，不向网管发送Trap消息。

trap-only：条件满足时，在显示信息中记录监测结果的同时，向网管发送Trap消息。DNS测试不支持发送trap，DNS测试类型视图下无此参数。

【使用指导】

【举例】

# 在ICMP-echo测试类型下创建编号为1的阈值告警组，监测ICMP-echo探测的失败次数。NQA测试组启动前，初始的阈值状态为invalid。每次测试结束后，检查本次测试中累计的探测失败次数，若达到或超过10次，阈值状态置为over-threshold；反之，置为below-threshold。当阈值状态改变时，向网管发送Trap消息。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] reaction 1 checked-element probe-fail threshold-type accumulate 10 action-type trap-only

# 在ICMP-echo测试类型下创建编号为2的阈值告警组，监测ICMP-echo探测的失败次数。NQA测试组启动前，初始的阈值状态为invalid。每次探测结束后，检查测试组启动以来连续的探测失败次数，若达到或超过10次，阈值状态置为over-threshold；反之，置为below-threshold。当阈值状态改变时，向网管发送Trap消息。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] reaction 2 checked-element probe-fail threshold-type consecutive 10 action-type trap-only

1.1.80 reaction checked-element probe-fail (for trigger)

reaction checked-element probe-fail命令用来建立联动项，对当前所在测试组中的探测进行监测，当连续探测失败次数达到阈值时，就触发其他模块联动。

undo reaction命令用来删除指定的联动项。

【命令】

reaction item-number checked-element probe-fail threshold-type consecutive consecutive-occurrences action-type trigger-only

undo reaction item-number

【缺省情况】

不存在联动项。

【视图】

ICMP-echo/TCP/UDP-echo测试类型视图

ARP/DHCP/DLSw/DNS/FTP/HTTP/HTTP2/SNMP测试类型视图

【缺省用户角色】

network-admin

【参数】

item-number：联动项序号，取值范围为1～10。

threshold-type：指定门限类型。

consecutive consecutive-occurrences：NQA测试组启动以来连续的探测失败次数，取值范围为1～16。

action-type：触发的动作类型。

trigger-only：条件满足时，触发其它模块联动。

【使用指导】

联动项创建后，不能再通过reaction命令修改该联动项的内容。若要修改联动项的内容，则需要先通过undo reaction命令用来删除联动项，再利用新的参数创建联动项。

【举例】

# 在TCP测试类型下建立序号为1的联动项，连续探测失败3次，触发其他模块联动。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type tcp

[Sysname-nqa-admin-test-tcp] reaction 1 checked-element probe-fail threshold-type consecutive 3 action-type trigger-only

【相关命令】

· track（可靠性命令参考/Track）

1.1.81 reaction checked-element rtt

reaction checked-element rtt命令用来创建监测报文往返时延的阈值告警组。

undo reaction命令用来删除指定的阈值告警组。

【命令】

reaction item-number checked-element rtt threshold-type { accumulate accumulate-occurrences | average } threshold-value upper-threshold lower-threshold [ action-type { none | trap-only } ]

undo reaction item-number

【缺省情况】

不存在监测报文往返时延的阈值告警组。

【视图】

ICMP-jitter/UDP-jitter/Voice测试类型视图

【缺省用户角色】

network-admin

【参数】

item-number：阈值告警组编号，取值范围为1～10。

threshold-type：指定阈值类型。

accumulate accumulate-occurrences：每次测试中，累计的RTT超出阈值的报文个数。对于ICMP-jitter与UDP-jitter测试，取值范围为1～15000；对于Voice测试，取值范围为1～60000。

average：每次测试中，报文往返时间的平均值。

threshold-value：指定阈值范围。

upper-threshold：阈值上限，取值范围为0～3600000，单位为毫秒。

lower-threshold：阈值下限，取值范围为0～3600000，单位为毫秒，且必须小于等于阈值上限。

action-type：触发的动作类型，缺省动作类型为none。

none：只在显示信息中记录监测结果，不向网管发送Trap消息。

trap-only：条件满足时，在显示信息中记录监测结果的同时，向网管发送Trap消息。

【使用指导】

监测的对象是探测成功的报文，探测失败的报文不参与计数。

【举例】

# 在UDP-jitter测试类型下创建编号为1的阈值告警组，监测UDP-jitter探测报文的往返时间，阈值上限为50毫秒，下限为5毫秒。NQA测试组启动前，初始的阈值状态为invalid。每次测试结束后，检查本次测试的平均报文往返时间，若超出阈值，阈值状态置为over-threshold；反之，置为below-threshold。当阈值状态改变时，向网管发送Trap消息。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type udp-jitter

[Sysname-nqa-admin-test-udp-jitter] reaction 1 checked-element rtt threshold-type average threshold-value 50 5 action-type trap-only

# 在UDP-jitter测试类型下创建编号为2的阈值告警组，监测每个UDP-jitter探测报文的往返时间，阈值上限为50毫秒，下限为5毫秒。NQA测试组启动前，初始的阈值状态为invalid。每次测试结束后，检查本次测试中累计的RTT超出阈值的报文个数，若达到或超过100个，阈值状态置为over-threshold；反之，置为below-threshold。当阈值状态改变时，向网管发送Trap消息。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type udp-jitter

[Sysname-nqa-admin-test-udp-jitter] reaction 1 checked-element rtt threshold-type accumulate 100 threshold-value 50 5 action-type trap-only

1.1.82 reaction checked-element test-fail

reaction checked-element test-fail命令用来创建监测连续测试失败次数的阈值告警组。

undo reaction命令用来删除指定的阈值告警组。

【命令】

reaction item-number checked-element test-fail threshold-type consecutive consecutive-occurrences threshold-value upper-threshold [ action-type { none | trap-only } ]

undo reaction item-number

【缺省情况】

不存在监测连续测试失败次数的阈值告警组。

【视图】

ICMP-echo/TCP/UDP-echo测试类型视图

ARP/DHCP/DLSw/DNS/FTP/HTTP/HTTP2/SNMP测试类型视图

【缺省用户角色】

network-admin

【参数】

item-number：阈值告警组编号，取值范围为1～10。

threshold-type：指定阈值类型。

consecutive consecutive-occurrences：NQA测试组启动以来，连续的测试失败次数。consecutive-occurrences取值范围为1～16。

threshold-value：指定判定测试失败的阈值。

upper-threshold：阈值上限，取值范围为1～15。

action-type：触发的动作类型，缺省动作类型为none。

none：只在显示信息中记录监测结果，不向网管发送Trap消息。

trap-only：条件满足时，在显示信息中记录监测结果的同时，向网管发送Trap消息。DNS测试不支持发送Trap，DNS测试类型视图下无此参数。

【使用指导】

应用场景

本命令用于配置当测试连续失败达到指定次数时，执行指定的动作。

工作机制

一次测试Test中包含多次探测Probe，配置本命令后：

(1) 当一次测试中探测失败的次数大于或者等于threshold-value upper-threshold参数配置值时，NQA会认定本次测试失败；当一次测试中探测失败的次数小于threshold-value upper-threshold参数配置值时，NQA会认定本次测试成功。

(2) 当连续测试失败的次数达到consecutive consecutive-occurrences参数配置值时，则触发执行指定的动作。

例如，ICMP-echo测试视图下有配置probe count 15和reaction 1 checked-element test-fail threshold-type consecutive 2 threshold-value 10 action-type trap-only。表示：

(3) 一次ICMP-echo测试中包含15次探测。

(4) 如果一次ICMP-echo测试中，累计探测失败的次数达到10次，则记一次测试失败。

(5) 如果连续两次测试结果记录均为测试，则触发动作——向网管发送Trap消息。

注意事项

【举例】

# 在ICMP-echo测试类型下配置测试中累计探测失败10次，连续测试失败次数等于2次时，发送测试失败的Trap消息。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] reacton 1 checked-element test-fail threshold-type consecutive 2 threshold-value 10 action-type trap-only

1.1.83 reaction checked-element test-result-change

reaction checked-element test-result-change命令用来创建监测测试结果变化告警组。

undo reaction命令用来删除指定的阈值告警组。

【命令】

reaction item-number checked-element test-result-change threshold-value upper-threshold [ action-type { none | trap-only } ]

undo reaction item-number

【缺省情况】

不存在监测测试结果变化告警组。

【视图】

ICMP-echo测试类型视图

【缺省用户角色】

network-admin

【参数】

item-number：阈值告警组编号，取值范围为1～10。

threshold-value：指定阈值范围。

upper-threshold：阈值上限，取值范围为1～15。

action-type：触发的动作类型，缺省动作类型为none。

none：只在显示信息中记录监测结果，不向网管发送Trap消息。

trap-only：条件满足时，在显示信息中记录监测结果的同时，向网管发送Trap消息。

【使用指导】

应用场景

本命令用于配置当测试结果发生变化时，执行指定的动作。

工作机制

一次测试Test中包含多次探测Probe，配置本命令后：

(2) NQA测试结果从成功变成失败，或者从失败变成成功时，触发执行指定的动作。持续的测试成功或者持续的测试失败，不触发执行动作。

注意事项

【举例】

# 在ICMP-echo测试类型下测试结果变化时发送Trap消息，配置测试中探测累计失败次数大于或等于5次时，判定测试失败。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] reacton 1 checked-element test-result-change threshold-value 5 action-type trap-only

1.1.84 reaction checked-element two-way-delay

reaction checked-element two-way-delay命令用来创建监测双向时延的阈值告警组。

undo reaction命令用来删除指定的阈值告警组。

【命令】

reaction item-number checked-element two-way-delay threshold-value upper-threshold lower-threshold [ action-type { none | trap-only } ]

undo reaction item-number

【缺省情况】

不存在监测双向时延的阈值告警组。

【视图】

TWAMP-light-client-session视图

【缺省用户角色】

network-admin

【参数】

item-number：阈值告警组编号，取值范围为1～10。

threshold-value：指定阈值范围。

upper-threshold：上限阈值，取值范围是2～1000000，单位为微秒。

lower-threshold：下限阈值，取值范围是1～999999，且必须小于等于上限阈值，单位为微秒。

action-type：触发的动作类型，缺省动作类型为none。

none：只在显示信息中记录监测结果，不向网管发送Trap消息。

trap-only：条件满足时，在显示信息中记录监测结果的同时，向网管发送Trap消息。

【使用指导】

工作机制

在监控时间内的测试结果均大于上限阈值或者从大于下限阈值恢复到小于下限阈值时，将触发告警。监控时间由start命令的monitor-time参数配置。

注意事项

阈值告警组创建后，不能再通过reaction命令修改该阈值告警组的内容。若要修改阈值告警组的内容，则需要先通过undo reaction命令用来删除阈值告警组，再重新配置。

监测的对象是探测成功的报文，探测失败的报文不参与计数。

【举例】

# 创建编号为1的阈值告警组，监测探测报文的从目的到源和从源到目的的双向时延，阈值上限为50毫秒，下限为5毫秒。

<Sysname> system-view

[Sysname] nqa twamp-light client

[Sysname-nqa-twamp-light-client] test-session 1

[Sysname-nqa-twamp-light-client-session1] reaction 1 checked-element two-way-delay threshold-value 50 5 action-type trap-only

【相关命令】

· start (TWAMP-light-sender view)

1.1.85 reaction checked-element two-way-jitter

reaction checked-element two-way-jitter命令用来创建监测双向抖动的阈值告警组。

undo reaction命令用来删除指定的阈值告警组。

【命令】

reaction item-number checked-element two-way-jitter threshold-value upper-threshold lower-threshold [ action-type { none | trap-only } ]

undo reaction item-number

【缺省情况】

不存在监测双向抖动的阈值告警组。

【视图】

TWAMP-light-client-session视图

【缺省用户角色】

network-admin

【参数】

item-number：阈值告警组编号，取值范围为1～10。

threshold-value：指定阈值范围。

upper-threshold：上限阈值，取值范围2～1000000，单位为微秒。

lower-threshold：下限阈值，取值范围为1～999999，且必须小于等于上限阈值，单位为微秒。

action-type：触发的动作类型，缺省动作类型为none。

none：只在显示信息中记录监测结果，不向网管发送Trap消息。

trap-only：条件满足时，在显示信息中记录监测结果的同时，向网管发送Trap消息。

【使用指导】

工作机制

在监控时间内的测试结果均大于上限阈值或者从大于下限阈值恢复到小于下限阈值时，将触发告警。监控时间由start命令的monitor-time参数配置。

注意事项

监测的对象是探测成功的报文，探测失败的报文不参与计数。

【举例】

# 创建编号为1的阈值告警组，监测探测报文的从目的到源和从源到目的的双向抖动时间，阈值上限为20毫秒，下限为3毫秒。

<Sysname> system-view

[Sysname] nqa twamp-light client

[Sysname-nqa-twamp-light-client] test-session 1

[Sysname-nqa-twamp-light-client-session1] reaction 1 checked-element two-way-jitter threshold-value 20 3 action-type trap-only

【相关命令】

· start (TWAMP-light-sender view)

1.1.86 reaction checked-element two-way-loss

reaction checked-element two-way-loss命令用来创建监测双向丢包率的阈值告警组。

undo reaction命令用来删除指定的阈值告警组。

【命令】

reaction item-number checked-element two-way-loss threshold-value upper-threshold lower-threshold [ action-type { none | trap-only } ]

undo reaction item-number

【缺省情况】

不存在监测双向丢包率的阈值告警组。

【视图】

TWAMP-light-client-session视图

【缺省用户角色】

network-admin

【参数】

item-number：阈值告警组编号，取值范围为1～10。

threshold-value：指定阈值范围。

upper-threshold：上限阈值，表示每1000000个包中设备可接受的丢包数，取值范围是2～1000000，单位为1/1000000。

lower-threshold：上限阈值，表示每1000000个包中设备可接受的丢包数，取值范围是1～999999，且必须小于等于上限阈值，单位为1/1000000。

action-type：触发的动作类型，缺省动作类型为none。

none：只在显示信息中记录监测结果，不向网管发送Trap消息。

trap-only：条件满足时，在显示信息中记录监测结果的同时，向网管发送Trap消息。

【使用指导】

工作机制

在监控时间内的测试结果均大于上限阈值或者从大于下限阈值恢复到小于下限阈值时，将触发告警。监控时间由start命令的monitor-time参数配置。

注意事项

【举例】

# 创建编号为1的阈值告警组，监测探测报文的从目的到源和从源到目的的双向丢包率。阈值上限为1000，下限为500。

<Sysname> system-view

[Sysname] nqa twamp-light client

[Sysname-nqa-twamp-light-client] test-session 1

[Sysname-nqa-twamp-light-client-session1] reaction 1 checked-element two-way-loss threshold-value 1000 500 action-type trap-only

【相关命令】

· start (TWAMP-light-sender view)

1.1.87 reaction trap

reaction trap命令用来配置在指定条件下向网管服务器发送Trap消息。

undo reaction trap命令用来恢复缺省情况。

【命令】

reaction trap { path-change | probe-failure consecutive-probe-failures | test-complete | test-failure [ accumulate-probe-failures ] }

undo reaction trap { path-change | probe-failure | test-complete | test-failure }

【缺省情况】

不向网管服务器发送Trap消息。

【视图】

ICMP-echo/TCP/UDP-echo测试类型视图

ARP/DHCP/DLSw/DNS/FTP/HTTP/HTTP2/SNMP测试类型视图

UDP-tracert测试类型视图

ICMP-jitter/UDP-jitter/Voice测试类型视图

【缺省用户角色】

network-admin

【参数】

path-change：当进行UDP-tracert类型测试时，在配置了frequency命令后进行连续测试后，如果检测到当前路径相对于上一次测试路径发生变化，则设备发送一次Trap消息。

probe-failure consecutive-probe-failures：每次探测结束后，计算本次NQA测试中探测连续失败的次数，如果连续失败次数大于或等于consecutive-probe-failures，则向网管服务器发送探测失败的Trap消息。一次测试中，可能发送多次Trap消息。consecutive-probe-failures为一次测试中连续探测失败的次数，取值范围为1～15。

test-complete：对于非UDP-tracert类型测试，当测试完成时发送测试完成的Trap消息。对于UDP-tracert类型测试，测试出到达目的设备的路径后，发送测试完成的Trap消息。

test-failure accumulate-probe-failures：对于非UDP-tracert类型测试，一次NQA测试结束后，计算本次NQA测试中探测失败的累计次数，如果累计失败次数大于或等于accumulate-probe-failures，则向网管服务器发送测试失败的Trap消息。accumulate-probe-failures为一次测试中累计探测失败的次数，为必须输入的参数，取值范围为1～15。对于UDP-tracert类型测试，只要未能测试出到达目的地的路径，就发送一次Trap消息。用户不能输入参数accumulate-probe-failures。

【使用指导】

ARP测试支持reaction trap probe-failure、reaction trap test-complete和reaction trap test-failure。

ICMP-jitter、UDP-jitter 和Voice测试只支持reaction trap test-complete。

UDP-tracert测试支持reaction trap path-change，reaction trap test-complete和reaction trap test-failure（其中UDP-tracert测试不支持reaction trap test-failure的accumulate-probe-failures参数）。

【举例】

# 在ICMP-echo测试类型下配置测试中连续探测失败次数大于或等于5次时，发送探测失败的Trap消息。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] reaction trap probe-failure 5

1.1.88 reaction trigger per-probe

reaction trigger per-probe命令用来配置每次探测结果发送机制，即每次探测结束时都会将探测结果发送给外部特性，使外部特性利用NQA测试的结果进行相应处理。

undo reaction trigger per-probe命令用来恢复缺省情况。

【命令】

reaction trigger per-probe

undo reaction trigger per-probe

【缺省情况】

连续探测成功或失败3次时，NQA客户端会把探测成功或失败的消息发送给外部特性，使外部特性利用NQA测试的结果进行相应处理。

【视图】

DNS/ICMP/TCP Half Open/Tracert类型的NQA模板视图

【缺省用户角色】

network-admin

【使用指导】

本命令与reaction trigger probe-fail命令作用相同，多次执行这两条命令时，最后一次执行的命令生效。

本命令与reaction trigger probe-pass命令作用相同，多次执行这两条命令时，最后一次执行的命令生效。

【举例】

# 在ICMP类型的NQA模板视图下配置每次探测结果发送机制，即每次探测结束时都会将探测结果发送给外部特性，使外部特性利用NQA测试的结果进行相应处理。

<Sysname> system-view

[Sysname] nqa template icmp icmptplt

[Sysname-nqatplt-icmp-icmptplt] reaction trigger per-probe

【相关命令】

· reaction trigger probe-fail

· reaction trigger probe-pass

1.1.89 reaction trigger probe-fail

reaction trigger probe-fail命令用来配置连续探测失败的次数。

undo reaction trigger probe-fail命令用来恢复缺省情况。

【命令】

reaction trigger probe-fail count

undo reaction trigger probe-fail

【缺省情况】

连续探测失败3次时，NQA客户端会把探测失败的消息发送给外部特性，使外部特性利用NQA测试的结果进行相应处理。

【视图】

任意类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

count：连续探测失败的次数，取值范围为1～15。

【使用指导】

应用场景

当连续探测失败次数达到命令配置的数值时，NQA客户端会把探测失败的消息发送给外部特性，使外部特性利用NQA测试的结果进行相应处理。

外部特性调用NQA模板后进行相应的NQA测试，使用此命令可以设定节点失效的连续测试失败次数。

注意事项

本命令与reaction trigger per-probe命令作用相同，多次执行这两条命令时，最后一次执行的命令生效。

【举例】

# 在HTTP类型的NQA模板视图下配置确定节点失效需要连续探测失败5次。当连续探测失败的次数达到5次时，NQA客户端把探测失败的消息发送给外部特性，使外部特性能利用NQA测试的结果进行相应处理。

<Sysname> system-view

[Sysname] nqa template http httptplt

[Sysname-nqatplt-http-httptplt] reaction trigger probe-fail 5

【相关命令】

· reaction trigger per-probe

· reaction trigger probe-pass

1.1.90 reaction trigger probe-pass

reaction trigger probe-pass命令用来配置连续探测成功次数。

undo reaction trigger probe-pass命令用来恢复缺省情况。

【命令】

reaction trigger probe-pass count

undo reaction trigger probe-pass

【缺省情况】

连续探测成功3次时，NQA客户端会把探测成功的消息发送给外部特性，使外部特性利用NQA测试的结果进行相应处理。

【视图】

任意类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

count：连续探测成功的次数，取值范围为1～15。

【使用指导】

应用场景

当连续探测成功次数达到命令配置的数值时，NQA客户端会把探测成功的消息发送给外部特性，使外部特性利用NQA测试的结果进行相应处理。

外部特性调用NQA模板后进行相应的NQA测试，使用此命令可以设定节点有效的连续探测成功次数。

注意事项

本命令与reaction trigger per-probe命令作用相同，多次执行这两条命令时，最后一次执行的命令生效。

【举例】

# 在HTTP类型的NQA模板视图下配置确定节点有效需要连续探测成功5次。当连续探测成功的次数达到5次时，NQA客户端把探测成功的消息发送给外部特性，使外部特性能利用NQA测试的结果进行相应处理。

<Sysname> system-view

[Sysname] nqa template http httptplt

[Sysname-nqatplt-http-httptplt] reaction trigger probe-pass 5

【相关命令】

· reaction trigger per-probe

· reaction trigger probe-fail

1.1.91 request-method

request-method命令用来配置RTSP模板测试请求方式。

undo request-method命令用来恢复缺省情况。

【命令】

request-method { describe | options }

undo request-method

【缺省情况】

RTSP模板测试请求方式为options。

【视图】

RTSP类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

describe：Describe方式，用于获取URL路径中指定对象的相关信息。

options：Options方式，用于获取RTSP服务器提供的可用方法。

【使用指导】

配置探测请求方式为Describe方式时，必须通过url命令配置文件路径，NQA客户端通过url命令指定的配置文件路径必须对应RTSP服务器上的文件路径。

【举例】

# 配置RTSP请求方式为Describe方式。

<Sysname> system-view

[Sysname] nqa template rtsp rtsptplt

[Sysname-nqatplt-rtsp-rtsptplt] request method describe

【相关命令】

· url

1.1.92 reset nqa twamp-light statistics

reset nqa twamp-light statistics命令用来清除TWAMP-light测试会话的统计信息。

【命令】

reset nqa twamp-light statistics { all | test-session session-id }

【视图】

用户视图

【缺省用户角色】

network-admin

【参数】

all：清除所有TWAMP-light测试会话的统计信息

test-session session-id：清除指定的TWAMP-light测试会话的统计信息。session-id表示测试会话的ID，取值范围为1～128。

【使用指导】

TWAMP-light会话统计信息清除后将无法恢复。在执行reset twamp-light statistics命令前请确认是否进行清除。

【举例】

# 清除所有TWAMP-light测试会话的统计信息。

<Sysname> reset nqa twamp-light statistics all

【相关命令】

· display nqa twamp-light client statistic

1.1.93 resolve-target

resolve-target命令用来配置要解析的域名。

undo resolve-target命令用来恢复缺省情况。

【命令】

resolve-target domain-name

undo resolve-target

【缺省情况】

未配置要解析的域名。

【视图】

DNS测试类型视图

DNS类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

domain-name：要解析的域名，由“.”分隔的字符串组成（如aabbcc.com），每个字符串的长度不超过63个字符，包括“.”在内的总长度不超过255个字符，区分大小写。字符串中可以包含字母、数字、“-”及“_”，不能出现连续“.”。

【举例】

# 在DNS测试类型下配置DNS测试要解析的域名为domain1。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type dns

[Sysname-nqa-admin-test-dns] resolve-target domain1

1.1.94 resolve-type

resolve-type命令用来配置域名解析类型。

undo resolve-type命令用来恢复缺省情况。

【命令】

resolve-type { A | AAAA }

undo resolve-type

【缺省情况】

域名解析类型为A类型。

【视图】

DNS类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

A：域名解析类型为A类型请求，即将域名解析为IPv4地址。

AAAA：域名解析类型为AAAA类型请求，即将域名解析为IPv6地址。

【举例】

# 在DNS类型的NQA模板视图下，配置测试的域名解析类型为A。

<Sysname> system-view

[Sysname] nqa template dns dnstplt

[Sysname-nqatplt-dns-dnstplt] resolve-type A

1.1.95 resource-release { data-fill | hex-data-fill }

resource-release { data-fill | hex-data-fill }命令用来配置向服务器发送的资源释放报文。

undo resource-release命令用来恢复缺省情况。

【命令】

resource-release { data-fill | hex-data-fill } string

undo resource-release

【缺省情况】

未配置向服务器发送的资源释放报文。

【视图】

TCP/UDP类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

data-fill：表示使用文本格式的字符串来填充探测报文。

hex-data-fill：表示使用十六进制字符串来填充探测报文。

string：探测报文的填充内容。和data-fill关键字配合使用时，为1～200个字符的字符串，区分大小写；和hex-data-fill关键字配合使用时，为2～200个字符的字符串，字符串长度必须是偶数且不区分大小写。

【使用指导】

配置本命令后，设备会给服务器发送包含指定字符串的报文，用来通知服务器本次测试结束，要求服务器关闭连接并释放相应资源。

【举例】

# 在TCP类型的NQA模板视图下配置探测报文的填充字符串为abcd。

<Sysname> system-view

[Sysname] nqa template tcp tcptplt

[Sysname-nqatplt-tcp-tcptplt] resource-release data-fill abcd

1.1.96 route-option bypass-route

route-option bypass-route命令用来开启路由表旁路功能，探测直连目的地的连通情况。

undo route-option bypass-route命令用来关闭路由表旁路功能。

【命令】

route-option bypass-route

undo route-option bypass-route

【缺省情况】

路由表旁路功能处于关闭状态。

【视图】

ICMP-echo/TCP/UDP-echo测试类型视图

DLSw/DNS/FTP/HTTP/HTTP2/SNMP测试类型视图

UDP-tracert测试类型视图

ICMP-jitte/UDP-jitter/Voice测试类型视图

【缺省用户角色】

network-admin

【使用指导】

工作机制

开启该功能后，将不进行路由查找，而直接将报文发送到直连网络的目的地。

注意事项

开启该功能后，设备转发探测报文可以经过的最大跳数为1，ttl命令设置的跳数不会生效。

测试目的端使用IPv6地址时，本命令配置无效。

【举例】

# 在ICMP-echo测试类型下开启路由旁路功能。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] route-option bypass-route

1.1.97 source interface (ICMP-echo/UDP-tracert operation view)

source interface命令用来配置指定接口的IP地址作为探测报文的源IP地址。

undo source interface命令用来恢复缺省情况。

【命令】

source interface interface-type interface-number

undo source interface

【缺省情况】

以报文发送接口的主IP地址作为探测报文中的源IP地址。

【视图】

ICMP-echo测试类型视图

UDP-tracert测试类型视图

ICMP/Tracert类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

interface-type interface-number：探测报文源接口的接口类型和接口编号。

【使用指导】

本命令指定的接口必须处于UP状态，否则探测将会失败。

【举例】

# 在ICMP-echo测试类型下指定接口GigabitEthernet0/0/1的IP地址作为ICMP-echo探测报文的源IP地址。‌

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] source interface gigabitethernet 0/0/1

【相关命令】

· source ip

· source ipv6

1.1.98 source interface (TWAMP-light Client-session view)

source interface命令用来配置探测报文的源AC或源接口。

undo source interface命令用来恢复缺省情况。

【命令】

source interface interface-type interface-number

undo source interface

【缺省情况】

未配置探测报文的源AC和源接口。

【视图】

TWAMP-light-client-session视图

【缺省用户角色】

network-admin

【参数】

interface-type interface-number：接口类型和接口编号。

【使用指导】

在三层网络中进行测试时，执行本命令是将三层以太网接口作为探测报文的源接口。

【举例】

# 在TWAMP-light-client-session视图下指定探测报文的源AC口为GigabitEthernet0/0/1。

<Sysname> system-view

[Sysname] nqa twamp-light client

[Sysname-nqa-twamp-light-client] test-session 1

[Sysname-nqa-twamp-light-client-session1] source interface gigabitethernet 0/0/1

【相关命令】

· source ip

1.1.99 source ip

source ip命令用来配置探测报文的源IPv4地址。

undo source ip命令用来恢复缺省情况。

【命令】

source ip ip-address

undo source ip

【缺省情况】

以报文发送接口的主IP地址作为探测报文中的源IPv4地址。

【视图】

ICMP-echo/TCP/UDP-echo测试类型视图

ARP/DHCP/DLSw/FTP/HTTP/HTTP2/SNMP测试类型视图

UDP-tracert测试类型视图

ICMP-jitter/Path-jitter/UDP-jitter/Voice测试类型视图

TWAMP-light-client-session视图

ICMP/Tracert类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

ip-address：探测报文的源IPv4地址。

【使用指导】

source ip命令配置的源IP地址必须是设备上接口的IPv4地址，且接口为up状态，否则测试将会失败。

对于NQA模板类型来说，当源地址类型和目的地址类型不一致时，以目的地址类型为准，进行该类型的报文探测，此时源地址的配置不生效。

对于ICMP-echo/UDP-tracert测试类型，本命令和source interface命令作用相同，多次执行这两条命令时，最后一次执行的命令生效。

【举例】

# 在ICMP-echo测试类型下配置ICMP-echo探测报文中的源IPv4地址为10.1.1.1。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] source ip 10.1.1.1

# 在TWAMP-light-client-session视图下配置探测报文中的源IPv4地址为10.1.1.1。

<Sysname> system-view

[Sysname] nqa twamp-light client

[Sysname-nqa-twamp-light-client] test-session 1

[Sysname-nqa-twamp-light-client-session1] source ip 10.1.1.1

【相关命令】

· source interface

1.1.100 source ipv6

source ipv6命令用来配置探测报文的源IPv6地址。

undo source ipv6命令用来恢复缺省情况。

【命令】

source ipv6 ipv6-address

undo source ipv6

【缺省情况】

以报文发送接口的IPv6地址作为探测报文中的源IPv6地址。

【视图】

ICMP-echo/TCP/UDP-echo/UDP-jitter测试类型视图

TWAMP-light-client-session视图

Diameter/DNS/FTP/HTTP/HTTP2/HTTPS/ICMP/IMAP/POP3/RADIUS认证探测/RADIUS-ACCOUNT计费探测/RTSP/SMTP/SNMP/SNMP-DCA/SSL/TCP/TCP Half Open/UDP/WAP类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

ipv6-address：探测报文的源IPv6地址，不支持IPv6链路本地地址。

【使用指导】

source ipv6命令配置的源IPv6地址必须是设备上接口的IPv6地址，且接口为up状态，否则测试将会失败。

对于ICMP-echo测试类型，本命令和source interface命令作用相同，多次执行这两条命令时，最后一次执行的命令生效。

【举例】

# 在ICMP-echo测试类型下配置ICMP-echo探测报文中的源IPv6地址为1::1。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] source ipv6 1::1

# 在TWAMP-light-client-session视图下配置探测报文中的源IPv6地址为1::1。

<Sysname> system-view

[Sysname] nqa twamp-light client

[Sysname-nqa-twamp-light-client] test-session 1

[Sysname-nqa-twamp-light-client-session1] source ipv6 1::1

【相关命令】

· source interface

1.1.101 source mac

source mac命令用来配置探测报文的源MAC地址。

undo source mac命令用来恢复缺省情况。

【命令】

source mac mac-address

undo source mac

【缺省情况】

对于TWAMP-light测试，未配置探测报文的源MAC地址。

【视图】

TWAMP-light-client-session视图

【缺省用户角色】

network-admin

【参数】

mac-address：探测报文的源MAC地址，格式为H-H-H。在配置时，可以省去MAC地址中每段开头的“0”，例如：输入“f-e2-1”即表示输入的MAC地址为“000f-00e2-0001”。

【举例】

# 在TWAMP-light-client-session视图下配置探测报文的源MAC地址为0001-0001-0001。

<Sysname> system-view

[Sysname] nqa twamp-light client

[Sysname-nqa-twamp-light-client] test-session 1

[Sysname-nqa-twamp-light-client-session1] source mac 1-1-1

1.1.102 source port

source port命令用来配置探测报文的源端口号。

undo source port命令用来恢复缺省情况。

【命令】

source port port-number

undo source port

【缺省情况】

对于TWAMP-light测试类型，未配置源端口号；对于其它测试类型，系统自动选择设备当前空闲的端口号作为探测报文的源端口号。

【视图】

UDP-echo测试类型视图

SNMP测试类型视图

UDP-tracert测试类型视图

UDP-jitter/Voice测试类型视图

TWAMP-light-client-session视图

DNS/Tracert类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

port-number：探测报文的源端口号，取值范围为1～65535。

【使用指导】

注意事项

如需配置本命令，要求指定的端口号不能是当前设备中其它服务正在使用的端口号，否则会导致探测失败。

· 通过display tcp和display udp命令显示信息中的Local Addr:port字段，可查看本端正在被使用的IPv4地址及端口号。

· 通过display ipv6 tcp和display ipv6 udp命令显示信息中的LAddr->port字段，可查看本端正在被使用的IPv6地址及端口号。

【举例】

# 在UDP-echo测试类型下配置探测报文的源端口号为8000。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type udp-echo

[Sysname-nqa-admin-test-udp-echo] source port 8000

# 在TWAMP-light-client-session视图下配置探测报文的源端口号为8000。

<Sysname> system-view

[Sysname] nqa twamp-light client

[Sysname-nqa-twamp-light-client] test-session 1

[Sysname-nqa-twamp-light-client-session1] source port 8000

【相关命令】

· display ipv6 tcp（三层技术-IP业务命令参考/IPv6基础）

· display ipv6 udp（三层技术-IP业务参考/IPv6基础）

· display tcp（三层技术-IP业务命令参考/IP性能优化）

· display udp（三层技术-IP业务命令参考/IP性能优化）

1.1.103 ssl-client-policy

ssl-client-policy命令用来为Diameter/HTTP2/HTTPS/SSL类型的NQA模板绑定SSL客户端策略。

undo ssl-client-policy命令用来恢复缺省情况。

【命令】

ssl-client-policy policy-name

undo ssl-client-policy

【缺省情况】

未绑定SSL客户端策略。

【视图】

Diameter/HTTP2/HTTPS/SSL类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

policy-name：SSL客户端策略名，为1～31个字符的字符串，不区分大小写。

【使用指导】

通过绑定SSL客户端策略与服务器建立SSL连接，确认服务器业务的可用性。

【举例】

# 在SSL类型的NQA模板视图下配置SSL客户端策略为policy。

<Sysname> system-view

[Sysname] nqa template ssl ssltplt

[Sysname-nqatplt-ssl-ssltplt] ssl-client-policy policy

1.1.104 start (TWAMP-light-sender view)

start命令用来启动TWAMP-light测试。

【命令】

start test-session session-id { permanent | duration duration | packet-count count } [ tx-interval { 10 | 100 | 1000 | 10000 | 30000 } ] [ timeout timeout ] [ [ statistics-interval statistics-interval ] monitor-time time ]

【缺省情况】

TWAMP-light测试处于关闭状态。

【视图】

TWAMP-light-sender视图

【缺省用户角色】

network-admin

【参数】

test-session session-id：启动指定的TWAMP-light测试会话测试。session-id表示测试会话的ID，取值范围为1～128。

permanent：指定会话的TWAMP-light测试将一直进行测试。

duration duration：指定会话的TWAMP-light测试的持续时间，duration表示测试持续时间，取值范围为60～3600，单位为秒。

packet-count count：指定会话的TWAMP-light测试的发送报文个数，count表示测试报文个数，取值范围100～30000。

tx-interval { 10 | 100 | 1000 | 10000 | 30000 }：指定报文发送周期，每个周期时间内发送一个报文。取值为10、100、1000、10000、30000，单位为ms，缺省值为100ms。

timeout timeout：指定统计周期内反射报文的超时时间，取值范围为1～128，单位为秒，缺省值为5。

statistics-interval interval：TWAMP-light测试的统计周期，每间隔周期时间统计一次报文收发的服务质量并上报统计结果。单位为毫秒，取值范围为1000～6000000。统计周期必须是10ms的整数倍。本参数的缺省值与报文发送周期的取值有关，详情请参见表1-14。

monitor-time time：TWAMP-light测试的报文监控时间。取值范围为1000～86400000，单位为毫秒。监控时间必须是统计周期的整数倍。

【使用指导】

工作机制

TWAMP-light测试包括按需测试和连续测试两种方式。

· 按需测试是指有限的时间内为了诊断而由人工干预发起的性能检测，可以实现在诊断期间单次的性能检测。

会话在达到指定的时间间隔或者指定的发送报文数量后会自动停止统计。

· 连续测试是指连续、不间断发生的测试动作，直到使用stop（TWAMP-light-sender view）命令手工停止测试为止。

测试启动后，系统将持续监控探测结果，一旦出现不符合阈值的结果出现便启动监控时间计时，当在监控时间段内探测结果始终不符合阈值时，则打印日志并发送告警。不符合阈值的情况如下：

· 在监控时间段内的探测结果始终大于上限阈值。

· 探测结果从大于下限阈值恢复到小于下限阈值则开始计时，在监控时间段内的探测结果始终小于下限阈值。

其中监控时间与monitor-time参数的配置有关：

· 配置monitor-time参数时，会同时将丢包、时延和抖动监控时间配置为相同值。

· 不配置monitor-time参数时，丢包、时延和抖动的监控时间使用缺省值，缺省值与报文发送周期的取值有关，详情请参见表1-14。

阈值告警的上下限阈值由NQA TWAMP-light阈值告警功能配置。

注意事项

如果同时启动多个TWAMP-light测试，那么每个测试会话指定的源IP、源端口、目的IP和目的端口四个参数不能均相同，否则多个测试匹配同一条流将影响测试结果。

如果配置了data-fill命令，则报文发送周期不允许配置为10ms和100ms。

统计周期建议配置为大于等于报文发送周期，否则将出现上报的统计信息为空的情况。

统计周期和监控时间的缺省值和测试报文发送周期的取值有关，关系如表1-14所示：

表1-14 统计周期和监控时间缺省情况描述表

报文发送周期	统计周期缺省值	双向丢包监控时间缺省值	双向时延和双向抖动监控时间缺省值
10ms	2s	60s	2s
100ms	20s	60s	20s
1s	200s	200s	200s
10s	400s	400s	400s
30s	600s	600s	600s

【举例】

# 启动TWAMP-light测试，并指定发送报文数量为3000个。

<Sysname> system-view

[Sysname] nqa twamp-light sender

[Sysname-nqa-twamp-light-sender] start test-session 1 packet-count 3000

【相关命令】

· data-fill

· stop (TWAMP-light-sender view)

· reaction checked-element two-way-delay

· reaction checked-element two-way-loss

· reaction checked-element two-way-jitter

1.1.105 statistics hold-time

statistics hold-time命令用来配置统计组的保留时间。

undo statistics hold-time命令用来恢复缺省情况。

【命令】

statistics hold-time hold-time

undo statistics hold-time

【缺省情况】

统计组的保留时间为120分钟。

【视图】

ICMP-echo/TCP/UDP-echo测试类型视图

ARP/DHCP/DLSw/DNS/FTP/HTTP/HTTP2/SNMP测试类型视图

ICMP-jitter/Path-jitter/UDP-jitter/Voice测试类型视图

【缺省用户角色】

network-admin

【参数】

hold-time：统计组的保留时间，取值范围为1～1440，单位为分钟。

【使用指导】

统计组具有老化功能。统计组保存一定时间后将被删除，以便记录新的统计组信息。

【举例】

# 在ICMP-echo测试类型下配置统计组的保留时间为3分钟。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] statistics hold-time 3

1.1.106 statistics interval

statistics interval命令用来配置对测试结果进行统计的时间间隔。

undo statistics interval命令用来恢复缺省情况。

【命令】

statistics interval interval

undo statistics interval

【缺省情况】

对测试结果进行统计的时间间隔为60分钟。

【视图】

ICMP-echo/TCP/UDP-echo测试类型视图

ARP/DHCP/DLSw/DNS/FTP/HTTP/HTTP2/SNMP测试类型视图

ICMP-jitter/Path-jitter/UDP-jitter/Voice测试类型视图

【缺省用户角色】

network-admin

【参数】

interval：对测试结果进行统计的时间间隔，取值范围为1～35791394，单位为分钟。

【使用指导】

NQA将统计时间间隔内完成的NQA测试归为一组，计算该组测试结果的统计值，这些统计值构成一个统计组。通过display nqa statistics命令可以显示该统计组的信息。

【举例】

# 在ICMP-echo测试类型下配置对测试结果进行统计的时间间隔为2分钟。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] statistics interval 2

1.1.107 statistics max-group

statistics max-group命令用来配置能够保留的最大统计组个数。

undo statistics max-group命令用来恢复缺省情况。

【命令】

statistics max-group number

undo statistics max-group

【缺省情况】

能够保留的最大统计组个数为2。

【视图】

ICMP-echo/TCP/UDP-echo测试类型视图

ARP/DHCP/DLSw/DNS/FTP/HTTP/HTTP2/SNMP测试类型视图

ICMP-jitter/Path-jitter/UDP-jitter/Voice测试类型视图

【缺省用户角色】

network-admin

【参数】

number：能够保留的最大统计组个数，取值范围为0～100。

【使用指导】

当保留的统计组数目达到最大值时，如果形成新的统计组，保存时间最久的统计组将被删除。

能够保留的最大统计组个数为0时，不进行统计。

【举例】

# 在ICMP-echo测试类型下配置能够保留的最大统计组个数为5。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] statistics max-group 5

1.1.108 stop (TWAMP-light-sender view)

stop命令用来停止TWAMP-light测试。

【命令】

stop { all | test-session session-id }

【视图】

TWAMP-light-sender视图

【缺省用户角色】

network-admin

【参数】

all：停止所有TWAMP-light测试会话的测试。

test-session session-id：停止TWAMP-light测试会话。session-id表示测试会话的编号，取值范围为1～128。

【举例】

# 停止TWAMP-light测试会话1的测试。

<Sysname> system-view

[Sysname] nqa twamp-light sender

[Sysname-nqa-twamp-light-sender] stop test-session 1

【相关命令】

· start (TWAMP-light-sender view)

1.1.109 target-only

target-only命令用来配置Path-jitter测试中仅针对到达目的地址的完整路径进行探测，不逐跳进行探测。

undo target-only命令用来恢复缺省情况。

【命令】

target-only

undo target-only

【缺省情况】

Path-jitter测试中会逐跳进行探测。

【视图】

Path-jitter测试类型视图

【缺省用户角色】

network-admin

【举例】

# 在Path-jitter测试类型下配置仅针对到达目的地址的完整路径进行探测。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type path-jitter

[Sysname-nqa-admin-test-path-jitter] target-only

1.1.110 test-session (TWAMP-light-client view)

test-session命令用来创建TWAMP-light Client端的测试会话，并进入Client-session视图。如果TWAMP-light Client端的测试会话已经存在，则直接进入Client-session视图。

undo test-session命令用来删除TWAMP-light Client端的测试会话。

【命令】

test-session session-id

undo test-session session-id

【缺省情况】

不存在TWAMP-light Client端的测试会话。

【视图】

TWAMP-light-client视图

【缺省用户角色】

network-admin

【参数】

session-id：表示测试会话的ID。取值范围为1～128。

【使用指导】

请创建TWAMP-light Client端的测试会话并完成会话相关参数的配置后，再通过nqa twamp-light sender命令进入TWAMP-light-sender视图启动TWAMP-light测试。

【举例】

# 创建TWAMP-light Client端的测试会话1，并进入Client-session1视图。

<Sysname> system-view

[Sysname] nqa twamp-light client

[Sysname-nqa-twamp-light-client] test-session 1

[Sysname-nqa-twamp-light-client-session1]

1.1.111 test-session bind interface

test-session bind interface命令用来配置TWAMP-light测试会话的绑定出接口。

undo test-session bind interface命令用来取消TWAMP-light测试会话绑定出接口配置。

【命令】

test-session session-id bind interface interface-type interface-number

undo test-session session-id bind interface [ interface-type interface-number ]

【缺省情况】

未配置TWAMP-light测试会话的绑定出接口。

【视图】

TWAMP-light-client视图

【缺省用户角色】

network-admin

【参数】

session-id：表示测试会话的ID。取值范围为1～128。

interface-type interface-number：绑定出接口的接口类型和接口编号。不指定该参数时，表示所有接口。

【使用指导】

工作机制

配置本命令后，设备会将绑定出接口作为TWAMP-light测试报文的出接口，发送测试报文。所以，请将该接口配置为到达TWAMP-light服务器的路由出接口。

配置本命令会同时开启TWAMP-light模块和业务模块的联动功能：当TWAMP-light测量到有效统计数据时，会将时延信息（包括远端IP、最大时延、最小时延、平均时延）发布给其他业务模块（例如IS-IS），配合其他业务模块完成相关功能。

只有当TWAMP-light配置连续探测，并且统计到有效的时延数据时，TWAMP-light才会将数据发布给其他业务模块。

注意事项

一个TWAMP-light测试会话只能绑定一个接口。多次配置本命令，最新配置生效。

【举例】

# 配置TWAMP-light测试会话的绑定出接口为GigabitEthernet0/0/1。

<Sysname> system-view

[Sysname] nqa twamp-light client

[Sysname-nqa-twamp-light-client] test-session 1 bind interface gigabitethernet 0/0/1

1.1.112 timestamp-format

timestamp-format命令用来配置TWAMP-light测试探测报文的时间戳格式。

undo timestamp-format命令用来恢复缺省情况。

【命令】

timestamp-format { ntp | ptp }

undo timestamp-format

【缺省情况】

TWAMP-light测试的时间戳格式为PTP。

【视图】

TWAMP-light-client-session视图

【缺省用户角色】

network-admin

【参数】

ntp：配置探测报文的时间戳格式为NTP。

ptp：配置探测报文的时间戳格式为PTP。

【使用指导】

工作机制

TWAMP-light测试的探测报文会携带时间戳，本命令用来配置测试时报文携带的时间戳封装格式。相比NTP时间戳格式，PTP时间戳格式可携带更高精度的时间，可使TWAMP-light测试结果更精确。

注意事项

使用本命令时，如果设备未达到NTP或者PTP时间同步，或者TWAMP-light Sender端和Responder端使用的时间戳格式不同，设备都可以进行TWAMP-light测试，只是测试结果的精确度会有差异。

【举例】

# 配置TWAMP-light测试的时间戳格式为NTP。

<Sysname> system-view

[Sysname] nqa twamp-light client

[Sysname-nqa-twamp-light-client] test-session 1

[Sysname-nqa-twamp-light-client-session1] timestamp-format ntp

1.1.113 tos

tos命令用来配置NQA探测报文IP报文头中服务类型域的值。

undo tos命令用来恢复缺省情况。

【命令】

tos value

undo tos

【缺省情况】

NQA探测报文IP报文头中服务类型域的值为0。

【视图】

任意测试类型视图

TWAMP-light-client-session视图

Diameter/DNS/FTP/HTTP/HTTP2/HTTPS/ICMP/IMAP/POP3/RADIUS认证探测/RADIUS-ACCOUNT计费探测/RTSP/SIP/SMTP/SNMP/SNMP-DCA/SSL/TCP/TCP Half Open/UDP/WAP/Tracert类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

value：探测报文IP报文头中服务类型域的值，取值范围为0～255。

【举例】

# 在ICMP-echo测试类型下配置探测报文IP报文头中服务类型域的值为1。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] tos 1

# 在TWAMP-light-client-session视图下配置探测报文IP报文头中服务类型域的值为1。

<Sysname> system-view

[Sysname] nqa twamp-light client

[Sysname-nqa-twamp-light-client] test-session 1

[Sysname-nqa-twamp-light-client-session1] tos 1

1.1.114 transparent enable

transparent enable命令用来开启透明模式功能。

undo transparent enable命令用来关闭透明模式功能。

【命令】

transparent enable

undo transparent enable

【缺省情况】

透明模式功能处于关闭状态。

【视图】

DNS/ICMP/TCP/TCP Half Open类型的NQA模板视图

【缺省用户角色】

network-admin

【使用指导】

在负载均衡模块引用NQA模板进行实服务器的健康检测时，开启透明模式，NQA模板下只须将目的地址配置为虚服务的地址，无需配置下一跳，NQA使用负载均衡模块配置的实服务器地址作为测试报文的下一跳，从而，可以简化了NQA模板的配置。

【举例】

# 在TCP类型的模板视图下开启透明模式功能。

<Sysname> system-view

[Sysname] nqa template tcp test

[Sysname-nqatplt-tcp-test] transparent enable

1.1.115 transport-protocol

transport-protocol命令用来配置SIP测试使用的传输协议。

undo transport-protocol命令用来恢复缺省情况。

【命令】

transport-protocol { tcp | udp }

undo transport-protocol

【缺省情况】

SIP测试使用的传输协议为UDP。

【视图】

SIP类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

tcp：使用TCP连接发起SIP探测。

udp：使用UDP连接发起SIP探测。

【使用指导】

修改NQA模板下SIP使用的传输协议后，系统将会停止使用该模板的已有SIP探测，并发起一个新的探测请求。

【举例】

# 配置SIP测试使用的传输协议为TCP。

<Sysname> system-view

[Sysname] nqa template sip siptplt

[Sysname-nqatplt-sip-siptplt] transport-protocol tcp

1.1.116 ttl

ttl命令用来配置探测报文在网络中可以经过的最大跳数。

undo ttl命令用来恢复缺省情况。

【命令】

ttl value

undo ttl

【缺省情况】

UDP-tracert类型探测报文在网络中可以经过的最大跳数是30跳。其它测试类型下探测报文在网络中可以经过的最大跳数为20跳。

【视图】

ICMP-echo/TCP/UDP-echo测试类型视图

DLSw/DNS/FTP/HTTP/HTTP2/SNMP测试类型视图

UDP-tracert测试类型视图

ICMP-jitter/UDP-jitter/Voice测试类型视图

Diameter/DNS/FTP/HTTP/HTTP2/HTTPS/ICMP/IMAP/POP3/RADIUS认证探测/RADIUS-ACCOUNT计费探测/RTSP/SIP/SMTP/SNMP/SNMP-DCA/SSL/TCP/TCP Half Open/UDP/WAP/Tracert类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

value：对于UDP-tracert测试类型，表示允许探测报文填充的最大跳数值；对于其它测试类型，表示探测报文在网络中可以经过的最大跳数。取值范围为1～255。

【使用指导】

配置route-option bypass-route命令后，探测报文在网络中可以经过的最大跳数为1，ttl命令不会生效。

配置UDP-tracert类型测试时，如果使用init-ttl命令配置的初始跳数值大于此值，测试将无法启动。

【举例】

# 在ICMP-echo测试类型下配置探测报文在网络中可以经过的最大跳数为16跳。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] ttl 16

1.1.117 type

type命令用来配置当前测试组的测试类型，并进入测试组测试类型视图。

【命令】

type { arp | dhcp | dlsw | dns | ftp | http | http2 | icmp-echo | icmp-jitter | path-jitter | snmp | tcp | udp-echo | udp-jitter | udp-tracert | voice }

【缺省情况】

未配置当前测试组的测试类型。

【视图】

NQA测试组视图

【缺省用户角色】

network-admin

【参数】

arp：测试类型为ARP。

dhcp：测试类型为DHCP。

dlsw：测试类型为DLSw。

dns：测试类型为DNS。

ftp：测试类型为FTP。

http：测试类型为HTTP。

http2：测试类型为HTTP/2。

icmp-echo：测试类型为ICMP-echo。

icmp-jitter：测试类型为ICMP-jitter。

path-jitter：测试类型为Path-jitter。

snmp：测试类型为SNMP。

tcp：测试类型为TCP。

udp-echo：测试类型为UDP-echo。

udp-jitter：测试类型为UDP-jitter。

udp-tracert：测试类型为UDP-tracert。

voice：测试类型为Voice。

【使用指导】

一个NQA测试组对应一个NQA测试类型。当进入NQA测试组视图后，需要指定测试类型并配置测试类型相应的属性。当NQA测试组指定了一个测试类型后，测试组将与测试类型绑定，若需要重新指定测试类型，请在系统视图下删除测试组之后重新创建测试组并指定测试类型。

【举例】

# 配置测试组的测试类型为FTP测试，并进入测试组测试类型视图。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type ftp

[Sysname-nqa-admin-test-ftp]

1.1.118 url

url命令用来配置测试访问的网址。

undo url命令用来恢复缺省情况。

【命令】

url url

undo url

【缺省情况】

未配置测试访问的网址。

【视图】

FTP/HTTP/HTTP2测试类型视图

ICMP-echo测试类型视图

UDP-jitter测试类型视图

FTP/HTTP/HTTP2/HTTPS/ICMP/TCP/RTSP/WAP类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

url：测试操作访问的目标资源地址，为1～255个字符的字符串，区分大小写。url中的主机名部分，由“.”分隔的字符串组成（如aabbcc.com），每个字符串的长度不超过63个字符，区分大小写；字符串中可以包含字母、数字、“-”及“_”，不能出现连续“.”。

【使用指导】

不同测试类型，url参数的格式不同：

· 对于HTTP测试类型，url格式为http://host[:port]/resource，port为可选参数。

· 对于HTTP/2测试类型，url格式为http://host[:port]/resource或https://host[:port]/resource，port为可选参数。

· 对于HTTPS测试类型，url格式为https://host[:port]/resource，port为可选参数。

· 对于FTP测试类型，url格式为ftp://host[:port]/filename，port为可选参数。

· 对于RSTP测试类型，url格式为rstp://host[:port]/resource，port为可选参数。

· 对于UDP-jitter测试类型，url格式为host:port。

· 对于ICMP、ICMP-echo、TCP测试类型，url格式为host[:port]，port为可选参数。

· 对于WAP测试类型，url格式为http://host[:port]/resource或https://host[:port]/resource，port为可选参数。

url中，host为目的设备的域名；port为目的设备提供服务的端口号。如果host参数取值为一个IPv6地址，且携带了协议类型，则IPv6地址外面需要添加[ ]，例如http://[2001::1]/test。

对于UDP-jitter测试类型，配置了destination ip或destination port命令后，不能再配置本命令，反之，配置了本命令后不能再配置destination ip和destination port命令。

【举例】

# 在HTTP测试类型下配置HTTP测试访问的网址为http://www.company.com/index.html。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type http

[Sysname-nqa-admin-test-http] url http://www.company.com/index.html

【相关命令】

· filename

· operation

1.1.119 username

username命令用来配置登录用户名。

undo username命令用来恢复缺省情况。

【命令】

username username

undo username

【缺省情况】

未配置登录用户名。

【视图】

FTP/HTTP/HTTP2测试类型视图

FTP/HTTP/HTTP2/HTTPS/IMAP/POP3/RADIUS认证探测/RADIUS-ACCOUNT计费探测类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

username：测试使用的登录用户名，区分大小写。FTP、HTTP、HTTP/2和HTTPS登录用户名，为1～32个字符的字符串；POP3和IMAP登录用户名，为1～40个字符的字符串，形如[email protected]；RADIUS和RADIUS-ACCOUNT用户名，为1～253个字符的字符串。

【举例】

# 在FTP测试类型下配置FTP登录用户名为administrator。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type ftp

[Sysname-nqa-admin-test-ftp] username administrator

【相关命令】

· operation

· password

1.1.120 vendor-id

vendor-id命令用来配置Diameter探测报文中设备厂商ID字段的值。

undo vendor-id命令用来恢复缺省情况。

【命令】

vendor-id vendor-id

undo vendor-id

【缺省情况】

Diameter探测报文中设备厂商ID字段的值为0。

【视图】

Diameter类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

vendor-id：表示Diameter探测报文中设备厂商ID字段的值，取值范围为0～4294967295。其中0为保留值，Diameter服务器收到这样的Diameter探测报文时会忽略该字段。

【使用指导】

本命令用于配置Diamater探测请求报文中Vendor-Id键值对的值。协议规定，Diamater探测请求报文中必须填写设备厂商在IANA（The Internet Assigned Numbers Authority，互联网数字分配机构）上申请的SMI网络管理私有企业码。

【举例】

# 配置Diameter探测报文中设备厂商ID字段的值为25506。

<Sysname> system-view

[Sysname] nqa template diameter diametertplt

[Sysname-nqatplt-diameter-diametertplt] vendor-id 25506

1.1.121 vendor-specific-app-id

vendor-specific-app-id命令用来配置Diameter探测报文中特定厂商应用ID字段的值。

undo vendor-specific-app-id命令用来恢复缺省情况。

【命令】

vendor-specific-app-id vendor-id vendor-id [ { auth-app-id | acct-app-id } application-id ]

undo vendor-specific-app-id

【缺省情况】

未配置Diameter探测报文中特定厂商应用ID字段的值。

【视图】

Diameter类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

vendor-id vendor-id：表示Diameter探测报文中特定厂商应用ID字段的值，取值范围为1～4294967295。

auth-app-id：认证和授权应用。

acct-app-id：计费应用。

application-id：应用ID，取值范围为1～4294967295。Diameter协议规定除了基础协议应用外，每个Diameter应用必须有一个IANA分配的应用ID。

【使用指导】

本命令用于配置Diamater探测请求报文中Vendor-Specific-Application-Id组合键值对的值，Vendor-Specific-Application-Id组合键值对用于通知Diamater服务器群本设备支持的特定厂商Diameter应用。

【举例】

# 配置Diameter探测报文中特定厂商应用ID字段的值为25506，计费应用ID名字段的取值为2000。

<Sysname> system-view

[Sysname] nqa template diameter diametertplt

[Sysname-nqatplt-diameter-diametertplt] vendor-specific-app-id vendor-id 25506 acct-app-id 2000

1.1.122 version (HTTP operation view and HTTP/HTTPS template view)

version命令用来配置HTTP测试所使用的版本。

undo version命令用来恢复缺省情况。

【命令】

version { v1.0 | v1.1 }

undo version

【缺省情况】

HTTP测试所使用的版本为1.0。

【视图】

HTTP测试类型视图

HTTP/HTTPS类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

v1.0：测试使用的版本为1.0。

v1.1：测试使用的版本为1.1。

【举例】

# 在HTTP测试类型下配置HTTP测试使用的版本为1.1。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type http

[Sysname-nqa-admin-test-http] version v1.1

1.1.123 version (SNMP-DCA template view)

version命令用来配置SNMP-DCA测试所使用的SNMP版本。

undo version命令用来恢复缺省情况。

【命令】

version { v1 | v2c }

undo version

【缺省情况】

SNMP-DCA测试所使用的SNMP版本为SNMPv1。

【视图】

SNMP-DCA类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

v1：SNMPv1版本。

v2c：SNMPv2c版本。

【使用指导】

只有本命令配置的版本和测试的SNMP Agent使用的SNMP版本相同时，SNMP-DCA才能正常工作。

【举例】

# 在SNMP-DCA类型的NQA模板视图下配置SNMP-DCA测试所使用的SNMP版本为SNMPv2c。

<Sysname> system-view

[Sysname] nqa template snmpdca test

[Sysname-nqatplt-snmpdca-test] version v2c

1.1.124 vlan

vlan命令用来配置探测报文的VLAN标签。

undo vlan命令用来恢复缺省情况。

【命令】

vlan { vlan-id | s-vid vlan-id c-vid vlan-id }

undo vlan

【缺省情况】

未配置探测报文的VLAN标签。

【视图】

TWAMP-light-client-session视图

【缺省用户角色】

network-admin

【参数】

vlan-id：探测报文所属的VLAN，取值范围为1～4094。

s-vid：匹配外层VLAN标签（Service VLAN ID）。

c-vid：匹配内层VLAN标签（Customer VLAN ID）。

【使用指导】

配置该命令后探测报文将在指定的VLAN内发送。

当需要使用封装内外层VLAN标签的报文进行测试时，用户可根据需求来配置探测报文的内外层VLAN。

【举例】

# 在TWAMP-light-client-session视图下配置探测报文的所属VLAN为VLAN 3。

<Sysname> system-view

[Sysname] nqa twamp-light client

[Sysname-nqa-twamp-light-client] test-session 1

[Sysname-nqa-twamp-light-client-session1] vlan 3

1.1.125 vpn-instance

vpn-instance命令用来指定测试操作所属的VPN实例。

undo vpn-instance命令用来恢复缺省情况。

【命令】

vpn-instance vpn-instance-name

undo vpn-instance

【缺省情况】

未指定测试操作所属的VPN，表示在公网中进行NQA测试。

【视图】

ICMP-echo/TCP/UDP-echo测试类型视图

ARP/DHCP/DLSw/DNS/FTP/HTTP/HTTP2/SNMP测试类型视图

UDP-tracert测试类型视图

ICMP-jitter/Path-jitter/UDP-jitter/Voice测试类型视图

TWAMP-light-client-session视图

任意类型的NQA模板视图

【缺省用户角色】

network-admin

【参数】

vpn-instance-name：表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。

【使用指导】

配置本命令后，NQA将在指定的VPN中进行测试。

【举例】

# 在ICMP-echo测试类型下指定测试操作所属的VPN实例为vpn1。

<Sysname> system-view

[Sysname] nqa entry admin test

[Sysname-nqa-admin-test] type icmp-echo

[Sysname-nqa-admin-test-icmp-echo] vpn-instance vpn1

# 在TWAMP-light-client-session视图下指定测试操作所属的VPN实例为vpn1。

<Sysname> system-view

[Sysname] nqa twamp-light client

[Sysname-nqa-twamp-light-client] test-session 1

[Sysname-nqa-twamp-light-client-session1] vpn-instance vpn1

1.2 NQA服务器端命令

只有在测试类型为TCP和UDP-echo时，才需要配置NQA服务器。

1.2.1 display nqa server

display nqa server命令用来显示NQA服务器的状态信息。

【命令】

display nqa server

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【举例】

# 显示NQA服务器的状态信息。

<Sysname> display nqa server

NQA server status: Enabled

TCP connect:

IP address: 2.2.2.2

Port: 3000

ToS:200

VPN instance: -

UDP echo:

IP address: 3.3.3.3

Port: 3000

ToS: 255

VPN instance: -

表1-15 display nqa server命令输出信息描述

字段	描述命令
NQA server status	NQA服务器状态，包括的取值如下： · Disabled：未启用NQA服务器功能； · Enabled：启用了NQA服务器功能；
TCP connect	NQA TCP测试中服务器的状态信息
UDP echo	NQA UDP测试中服务器的状态信息
IP address	NQA服务器TCP/UDP监听服务的IP地址
Port	NQA服务器TCP/UDP监听服务的端口号
ToS	NQA服务器TCP/UDP监听服务的回应报文携带的ToS值未配置ToS参数时，本字段显示为-，但： · 对于TCP监听服务，回应报文中实际携带的ToS值为0 · 对于UDP监听服务，回应报文中实际携带的ToS值为从客户端发送的请求报文中获取到的ToS值
VPN instance	NQA服务器监听的IP地址所属的VPN实例名称。如果NQA服务器监听的是公网IP地址，则显示为-

1.2.2 display nqa twamp-light responder

display nqa twamp-light responder命令用来显示TWAMP-light Responder端的会话信息。

【命令】

display nqa twamp-light responder [ test-session session-id ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

test-session session-id：显示指定会话的信息。session-id表示会话ID，取值范围为1～128。未指定本参数时，表示显示所有会话的信息。

【举例】

# 显示所有TWAMP-light Responder端的会话信息。

<Sysname> display nqa twamp-light responder

Session ID : 1

Status : Active

Interface : -

Service instance : -

Destination IP : 1.1.1.1

Destination IPv6 : -

Source IP : 2.2.2.2

Source IPv6 : -

Destination port : 2001

Source port : 2010

VPN instance : -

Destination MAC : 1-1-2

Source MAC : 1-1-1

VLAN ID : -

Service VLAN ID : -

Customer VLAN ID : -

Timestamp format : PTP

Description : -

Session ID : 2

Status : Active

Interface : -

Service instance : -

Destination IP : 1.1.1.1

Destination IPv6 : -

Source IP : 3.3.3.3

Source IPv6 : -

Destination port : 2001

Source port : 2020

VPN instance : -

Destination MAC : 1-1-2

Source MAC : 1-1-1

VLAN ID : -

Service VLAN ID : -

Customer VLAN ID : -

Timestamp format : NTP

Description : -

表1-16 display nqa twamp-light responder命令显示信息描述表

字段	描述
Session ID	会话ID
Status	测试会话的工作状态，取值为： · Active：激活状态，表示测试会话的NQA服务器的TWAMP-light Responder的反射功能已被激活 · Inactive：未激活状态，表示测试会话的NQA服务器的TWAMP-light Responder的反射功能未被激活
Interface	反射端口
Service instance	关联的以太网服务实例
Destination IP	待反射报文的目的IP地址
Destination IPv6	待反射报文的目的IPv6地址
Source IP	待反射报文的源IP地址
Source IPv6	待反射报文的源IPv6地址
Destination port	待反射报文的目的端口号
Source port	待反射报文的源端口号
VPN instance	MPLS L3VPN实例名称
Destination MAC	待反射报文的目的MAC地址
Source MAC	待反射报文的源MAC地址
VLAN ID	待反射报文的VLAN ID
Service VLAN ID	待反射报文的外层VLAN ID
Customer VLAN ID	待反射报文的内层VLAN ID
Timestamp format	时间戳格式，取值为： · AUTO：表示由TWAMP-light Responder自动决定使用的时间戳格式。如果用户未通过test-session命令指定时间戳格式，则使用AUTO格式 · NTP：NTP格式 · PTP：PTP格式
Description	测试会话的描述信息

【相关命令】

· nqa reflector

· test-session (TWAMP-light-responder view)

1.2.3 nqa server enable

nqa server enable命令用来开启NQA服务器功能。

undo nqa server enable命令用来关闭NQA服务器功能。

【命令】

nqa server enable

undo nqa server enable

【缺省情况】

NQA服务器功能处于关闭状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【举例】

# 开启NQA服务器功能。

<Sysname> system-view

[Sysname] nqa server enable

1.2.4 nqa server tcp-connect

nqa server tcp-connect命令用来在NQA服务器上创建TCP监听服务。

undo nqa server tcp-connect命令用来删除指定的TCP监听服务。

【命令】

nqa server tcp-connect { ipv4-address | ipv6 ipv6-address } port-number [ vpn-instance vpn-instance-name ] [ tos tos ]

undo nqa server tcp-connect { ipv4-address | ipv6 ipv6-address } port-number [ vpn-instance vpn-instance-name ]

【缺省情况】

不存在TCP监听服务

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

ipv4-address：NQA服务器TCP监听服务监听的IPv4地址。

ipv6-address：NQA服务器TCP监听服务监听的IPv6地址。

port-number：NQA服务器TCP监听服务监听的端口号，取值范围为1～65535。

vpn-instance vpn-instance-name：NQA服务器监听的IP地址所属的VPN实例。vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。如果不指定本参数，则表示TCP监听的是公网IP地址。

tos tos：NQA服务器应答报文中的ToS域的值。取值范围为0～255。不指定本参数时，取值为0。

【使用指导】

仅TCP和DLSw测试类型下必须配置本命令，且对于DLSw测试类型，port-number值必须为2065。否则，测试失败。

所配置的IP地址、端口号及VPN实例必须与NQA客户端的配置一致，且不能与已有的监听服务冲突。

所配置的IP地址必须是作为服务器的设备上的接口的IP地址，否则配置无效。

建议不要配置1～1023之间的端口（知名端口），否则可能导致NQA测试失败或该知名端口对应的服务不可用。

【举例】

# 创建IP地址为169.254.10.2，端口号为9000的TCP监听服务。

<Sysname> system-view

[Sysname] nqa server tcp-connect 169.254.10.2 9000

【相关命令】

· destination ip

· destination port

· vpn-instance

1.2.5 nqa server udp-echo

nqa server udp-echo命令用来在NQA服务器上创建UDP监听服务。

undo nqa server udp-echo命令用来删除指定的UDP监听服务。

【命令】

nqa server udp-echo { ipv4-address | ipv6 ipv6-address } port-number [ vpn-instance vpn-instance-name ] [ high-performance-mode ][ tos tos ]

undo nqa server udp-echo { ipv4-address | ipv6 ipv6-address } port-number [ vpn-instance vpn-instance-name ]

【缺省情况】

不存在UDP监听服务

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

ipv4-address：NQA服务器UDP监听服务监听的IPv4地址。

ipv6-address：NQA服务器UDP监听服务监听的IPv6地址。

port-number：NQA服务器UDP监听服务监听的端口号，取值范围为1～65535。

vpn-instance vpn-instance-name：NQA服务器监听的IP地址所属的VPN实例。vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。如果不指定本参数，则表示UDP监听的是公网IP地址。

high-performance-mode：开启NQA服务器端对于UDP-jitter测试的高性能模式。不指定本参数则NQA服务器对于UDP-jitter测试的高性能模式处于关闭状态。

tos tos：NQA服务器应答报文中的ToS域的值。取值范围为0～255。不指定本参数时，取值从客户端发送的请求报文中获取。

【使用指导】

只有在测试类型为UDP-jitter、UDP-echo和Voice时，才需在NQA服务器上配置此命令。

通过本命令可以指定发送应答NQA探测报文（UDP报文）中携带的ToS值。

配置的IP地址、端口号及VPN实例必须与NQA客户端的配置一致，且不能与已有的监听服务冲突。

所配置的IP地址必须是作为服务器的设备上的接口的IP地址，否则配置无效。

建议不要配置1～1023之间的端口（知名端口），否则可能导致NQA测试失败或该知名端口对应的服务不可用。

在高性能模式下，NQA服务器将大大提升UDP-jitter测试的探测报文应答效率。此时NQA服务器端不能处理大于100字节的NQA报文，若客户端发送的报文长度大于100字节，可能导致NQA测试失败。

【举例】

# 创建IP地址为169.254.10.2、端口号为9000的UDP监听服务。

<Sysname> system-view

[Sysname] nqa server udp-echo 169.254.10.2 9000

【相关命令】

· destination ip

· destination ipv6

· destination port

· vpn-instance

1.2.6 nqa twamp-light responder

nqa twamp-light responder命令用来创建TWAMP-light Responder，并进入TWAMP-light-responder视图。如果TWAMP-light Responder已经存在，则直接进入TWAMP-light-responder视图。

undo nqa twamp-light responder命令用来删除TWAMP-light Responder。

【命令】

nqa twamp-light responder

undo nqa twamp-light responder

【缺省情况】

不存在TWAMP-light Responder。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

应用场景

在TWAMP-light-responder视图下创建与TWAMP-light Client测试会话相对应的测试会话，从而与TWAMP-light Client测试会话进行交互。

注意事项

执行undo nqa twamp-light responder命令时，系统会删除Responder以及所有的会话信息。

【举例】

# 创建TWAMP-light Responder，并进入TWAMP-light-responder视图。

<Sysname> system-view

[Sysname] nqa twamp-light responder

[Sysname-nqa-twamp-light-responder]

1.2.7 test-session (TWAMP-light-responder view)

test-session命令用来配置TWAMP-light Responder端的测试会话。

undo test-session命令用来删除TWAMP-light Responder端的测试会话。

【命令】

test-session session-id [ interface interface-type interface-number ] { { ip | ipv6 } destination address source address destination-port port-number source-port port-number [ vpn-instance vpn-instance-name ] | destination-mac mac-address source-mac mac-address } * [ vlan { vlan-id | s-vid vlan-id c-vid vlan-id } | timestamp-format { ntp | ptp } | description text ] *

undo test-session session-id

【缺省情况】

未配置TWAMP-light Responder端的测试会话。

【视图】

TWAMP-light-responder视图

【缺省用户角色】

network-admin

【参数】

session-id：表示测试会话的ID。取值范围与设备的型号有关，请以设备的实际情况为准。

interface interface-type interface-number：测试会话中反射报文的接口。interface-type interface-number表示接口类型和接口编号。

ip：待反射报文的IPv4地址。

ipv6：待反射报文的IPv6地址。

destination：待反射报文的目的地址。指定ip参数时表示IPv4地址，指定ipv6参数时表示IPv6地址。

source：待反射报文的源地址。指定ip参数时表示IPv4地址，指定ipv6参数时表示IPv6地址。

address：IP地址。

destination-port port-number：测试会话待反射报文的目的UDP端口号，port-number表示UDP端口号，取值范围为1～65535。

source-port port-number：测试会话待反射报文的源UDP端口号。port-number表示UDP端口号，取值范围为1～65535。

vpn-instance vpn-instance-name：表示在指定VPN中进行测试。vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。不指定该参数时，表示在公网中进行测试。

destination-mac：测试会话待反射报文的目的MAC地址。

source-mac：测试会话待反射报文的源MAC地址。

mac-address：MAC地址。格式为H-H-H。在配置时，可以省去MAC地址中每段开头的“0”，例如：输入“f-e2-1”即表示输入的MAC地址为“000f-00e2-0001”。

vlan：测试会话待反射报文的VLAN或内外层VLAN标签。

· vlan-id：VLAN的编号，取值范围为1～4094。

· s-vid：外层VLAN标签（Service VLAN ID）。

· c-vid：内层VLAN标签（Customer VLAN ID）。

timestamp-format：TWAMP-light Responder端的时间戳格式。缺省值为AUTO，AUTO表示由TWAMP-light Responder端自动选择使用的时间戳格式。

· ntp：NTP时间戳格式。

· ptp：PTP时间戳格式。

description text：测试会话的描述信息。text表示描述信息，为1～200个字符的字符串，区分大小写。使用本参数可为测试会话增加描述信息，方便用户查看和管理测试会话。

【使用指导】

应用场景

TWAMP-light Responder端的测试会话是与TWAMP-light Client测试会话相对应的测试会话，用于和TWAMP-light Client测试会话进行交互。

注意事项

本命令指定的发送端IP地址、反射端IP地址、发送端UDP端口号、反射端UDP端口号以及VPN实例名组成的五元组信息需要和TWAMP-light Client测试会话的信息相互对应。

当创建的会话ID不存在，则创建一个新的会话；如果指定的会话ID已存在，则对会话信息进行修改。

配置本命令时，如果指定了destination address source address参数，则要求：源地址必须设备接口上已经配置的IP地址且该接口支持TWAMP-light测试，本设备与目的地址之间路由可达。否则，命令会配置失败。

一个会话ID只能指定一个反射接口，但多个会话ID可以指定同一个反射接口；一旦指定了反射接口则无法更改，只能通过undo test-session命令删除对应的会话后重新指定；已配置的会话相关参数除反射接口外，均可以修改或删除，但若删除掉所有配置，那么该测试会话也会一同删除。

【举例】

# 创建TWAMP-light Responder端的测试会话1，并指定源IPv4地址为1.1.1.1.，目的IPv4地址为2.2.2.2，源端口为3000，目的端口为3001，VPN实例名称为vpn1。

<Sysname> system-view

[Sysname] nqa twamp-light responder

[Sysname-nqa-twamp-light-responder] test-session 1 ip destination 2.2.2.2 source 1.1.1.1 destination-port 3001 source-port 3000 vpn-instance vpn1

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

热门推荐

热门推荐

H3C服务器

HPE服务器

热门推荐

H3C存储

HPE存储

热门推荐

商用台式机

商用笔记本

商用显示器

配件

热门推荐

热门推荐

智能终端

技术解决方案

热门推荐

热门推荐

热门推荐

热门推荐

热门推荐

热门推荐

热门推荐

专业安全服务

安全运营服务

热门推荐

热门推荐

热门推荐

热门推荐

热门推荐

技术支持

自助服务

热门推荐

热门推荐

热门推荐

热门推荐

合作伙伴培训与认证

热门推荐

热门推荐

公司刊物

加入我们

国家/地区

21-网络管理与监控命令参考

目录

03-NQA命令

1 NQA

1.1 NQA客户端配置命令

应用场景

工作机制

推荐配置

应用场景

工作机制

应用场景

工作机制

注意事项

1.1.9 data-size

应用场景

注意事项

1.1.10 description

1.1.13 destination ipv6

1.1.14 destination mac

1.1.15 destination port

1.1.16 disconnect-mode

1.1.20 display nqa result

1.1.21 display nqa statistics

工作机制

注意事项

1.1.22 display nqa twamp-light client

1.1.25 expect { data | hex-data }

1.1.26 expect { failed-data | hex-failed-data }

1.1.27 expect failed-status

1.1.28 expect ip

1.1.33 frequency-adjustment

1.1.34 hex-data-fill

工作机制

注意事项

应用场景

注意事项

1.1.36 history-record enable

1.1.38 history-record number