05-NQA命令
本章节下载: 05-NQA命令 (197.84 KB)
目 录
1.1.3 description (any NQA test type view)
1.1.7 display nqa reaction counters
1.1.12 history-record keep-time
1.1.20 reaction checked-element probe-duration
1.1.21 reaction checked-element probe-fail
1.1.22 reaction checked-element probe-fail (for trigger)
1.1.23 route-option bypass-route
data-fill命令用来配置发送的探测报文的填充字符串。
undo data-fill命令用来恢复缺省情况。
【命令】
data-fill string
undo data-fill
【缺省情况】
探测报文的填充内容为十六进制数值00010203040506070809。
【视图】
ICMP-echo/UDP-echo测试类型视图
【缺省用户角色】
network-admin
【参数】
string:探测报文的填充内容,为1~200个字符的字符串,区分大小写。
【使用指导】
· 如果探测报文的数据段长度比配置的填充数据长度小,系统在报文封装时以报文的数据段长度为界截取该字符串的前一部分。
· 如果探测报文的数据段长度比配置的填充数据长度大,系统在报文封装时用该字符串进行循环填充,直到填满。
例如,配置填充数据为“abcd”,当探测报文数据段长度为3字节时,则取“abc”作为填充数据;当探测报文大小为6字节时,则使用“adcdab”作为填充数据。
· 在ICMP-echo测试中,配置的字符串用来填充ICMP Echo消息的数据字段。
· 在UDP-echo测试中,由于UDP报文数据字段的前5个字节具有特定用途,所以只用所配置的字符串填充报文中剩余的字节。
【举例】
# 配置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
data-size命令用来配置发送的探测报文的大小。
undo data-size命令用来恢复缺省情况。
【命令】
data-size size
undo data-size
【缺省情况】
探测报文的大小为100。
【视图】
ICMP-echo/UDP-echo测试类型视图
【缺省用户角色】
network-admin
【参数】
size:探测报文的大小,单位为字节,ICMP-echo和UDP-echo测试类型取值范围为20~8100。
【使用指导】
· 对于ICMP-echo测试,探测报文大小为ICMP Echo消息中数据字段的长度。
· 对于UDP-echo测试,探测报文大小为UDP报文中数据字段的长度。
【举例】
# 配置发送的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
description命令用来对测试组进行简要描述,通常用于描述一个测试组的测试类型或测试目的。undo description命令用来删除已配置的描述信息。
【命令】
description text
undo description
【缺省情况】
未配置描述字符串。
【视图】
任意测试类型视图
【缺省用户角色】
network-admin
【参数】
text:测试组的描述,为1~200个字符的字符串,区分大小写。
【举例】
# 配置测试组的描述字符串为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
destination ip命令用来配置测试操作的目的IP地址。
undo destination ip命令用来删除已配置的目的IP地址。
【命令】
destination ip ip-address
undo destination ip
【缺省情况】
未配置测试操作的目的IP地址。
【视图】
ICMP-echo/UDP-echo测试类型视图
【缺省用户角色】
network-admin
【参数】
ip-address:测试操作的目的IP地址。
【举例】
# 配置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] destination ip 10.1.1.1
destination port命令用来配置测试操作的目的端口号。
undo destination port命令用来删除已配置的目的端口号。
【命令】
destination port port-number
undo destination port
【缺省情况】
未配置测试操作的目的端口号。
【视图】
UDP-echo测试类型视图
【缺省用户角色】
network-admin
【参数】
port-number:测试操作的目的端口号,取值范围为1~65535。
【举例】
# 配置测试操作的目的端口号为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
display nqa history命令用来显示NQA测试组的历史记录。
【命令】
display nqa history [ admin-name operation-tag ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
admin-name operation-tag:显示指定测试组的历史记录。如果不指定这两个参数,将显示所有测试组的历史记录。其中,admin-name为创建NQA测试组的管理员名字,为1~32个字符的字符串,字符串中不能包括“-”,不区分大小写;operation-tag为测试操作的标签,为1~32个字符的字符串,字符串中不能包括“-”,不区分大小写。
【举例】
# 查看管理员名字为administrator,测试操作标签为test的NQA测试组的历史记录。
<Sysname> display nqa history administrator test
NQA entry (admin administrator, tag test) history records:
Index Response Status Time
10 329 Succeeded 2007-04-29 20:54:26.5
9 344 Succeeded 2007-04-29 20:54:26.2
8 328 Succeeded 2007-04-29 20:54:25.8
7 328 Succeeded 2007-04-29 20:54:25.5
6 328 Succeeded 2007-04-29 20:54:25.1
5 328 Succeeded 2007-04-29 20:54:24.8
4 328 Succeeded 2007-04-29 20:54:24.5
3 328 Succeeded 2007-04-29 20:54:24.1
2 328 Succeeded 2007-04-29 20:54:23.8
1 328 Succeeded 2007-04-29 20:54:23.4
表1-1 display nqa history命令显示信息描述表
字段 |
描述 |
Index |
历史记录的编号 |
Response |
测试成功时,为测试报文的往返时延;如果测试超时,则为超时时间;不能完成测试时,则为0。单位为毫秒 |
Status |
测试结果的状态值,具体如下: · Succeeded:测试成功,接收到响应报文 · Unknown error:未知错误 · Internal error:内部错误 · Timeout:请求超时 |
Time |
测试完成时间 |
display nqa reaction counters命令用来显示阈值告警组的当前监测结果。
【命令】
display nqa reaction counters [ admin-name operation-tag [ item-number ] ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
admin-name operation-tag:显示指定测试组中阈值告警组的当前监测结果。如果不指定这两个参数,将显示所有测试组中所有阈值告警组的当前监测结果。其中,admin-name为创建NQA测试组的管理员名字,为1~32个字符的字符串,字符串中不能包括“-”,不区分大小写;operation-tag为测试操作的标签,为1~32个字符的字符串,字符串中不能包括“-”,不区分大小写。
item-number:显示指定阈值告警组的当前监测结果。如果不指定该参数,将显示所有阈值告警组的当前监测结果。item-number为阈值告警组的编号,取值范围为1~10。
【使用指导】
· 如果NQA阈值告警组的阈值类型为平均值,则显示的监测结果为无效值。
· 测试结束后,不会清除监测结果,即测试组启动后,监测结果会不断累加。
【举例】
# 显示ICMP-echo测试组admin test的所有阈值告警组的当前监测结果。
<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
4 probe-fail accumulate 12 0
5 probe-fail consecutive 162 2
表1-2 display nqa reaction counters命令显示信息描述
字段 |
描述 |
Index |
阈值告警组的编号 |
Checked Element |
监测的对象 |
Threshold Type |
阈值类型 |
Checked Num |
已监测的样本个数 |
Over-threshold Num |
超出阈值的样本个数 |
表1-3 display nqa reaction counters命令显示字段取值描述
监测对象 |
阈值类型 |
监测的样本范围 |
Checked Num取值 |
Over-threshold Num取值 |
probe-duration |
accumulate |
启动NQA测试组后进行的探测 |
启动NQA测试组后已完成的探测次数 |
启动NQA测试组后探测持续时间不在阈值范围内的探测次数 |
average |
- |
- |
- |
|
consecutive |
启动NQA测试组后进行的探测 |
启动NQA测试组后已完成的探测次数 |
启动NQA测试组后探测持续时间不在阈值范围内的探测次数 |
|
probe-fail |
accumulate |
启动NQA测试组后进行的探测 |
启动NQA测试组后已完成的探测次数 |
启动NQA测试组后失败的探测次数 |
consecutive |
启动NQA测试组后进行的探测 |
启动NQA测试组后已完成的探测次数 |
启动NQA测试组后失败的探测次数 |
display nqa result命令用来显示最近一次NQA测试的结果。
【命令】
display nqa result [ admin-name operation-tag ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
admin-name operation-tag:显示指定测试组的最近一次测试的结果。如果不指定这两个参数,将显示所有测试组的最近一次测试的结果。其中,admin-name为创建NQA测试组的管理员名字,为1~32个字符的字符串,字符串中不能包括“-”,不区分大小写;operation-tag为测试操作的标签,为1~32个字符的字符串,字符串中不能包括“-”,不区分大小写。
【举例】
# 显示UDP-echo测试的最近一次测试的结果。
<Sysname> display nqa result admin test
NQA entry (admin admin, tag test) test results:
Destination IP address: 192.168.0.58
Send operation times: 1 Receive response times: 1
Min/Max/Average round trip time: 3/3/3
Square-Sum of round trip time: 9
Last succeeded probe time: 2011-01-01 03:15:12.6
Extended results:
Packet loss in test: 0%
Failures due to timeout: 0
Failures due to internal error: 0
Failures due to other errors: 0
表1-4 display nqa result命令显示信息描述
字段 |
描述 |
Destination IP address |
目的IP地址 |
Send operation times |
发送的探测报文数 |
Receive response times |
收到的响应报文数 |
Min/Max/Average round trip time |
最小/最大/平均往返时间,单位为毫秒 |
Square-Sum of round trip time |
往返时间平方和 |
Last succeeded probe time |
一次测试中最后一次成功探测的完成时间,如果一次测试中的探测均失败,则该时间显示为全0 |
Packet loss in test |
平均丢包率 |
Failures due to internal error |
因内部错误失败的次数 |
Failures due to other errors |
因其它错误失败的次数 |
display nqa statistics命令用来显示NQA测试的统计信息。
【命令】
display nqa statistics [ admin-name operation-tag ]
【视图】
任意视图
【缺省用户角色】
network-admin
network-operator
【参数】
admin-name operation-tag:显示指定测试组的统计信息。如果不指定这两个参数,将显示所有测试组的统计信息。其中,admin-name为创建NQA测试组的管理员名字,为1~32个字符的字符串,字符串中不能包括“-”,不区分大小写;operation-tag为测试操作的标签,为1~32个字符的字符串,字符串中不能包括“-”,不区分大小写。
【使用指导】
· 测试开始后,如果第一次测试中的所有探测尚未完成,则无法生成统计信息。若此时通过该命令查看统计信息,则显示信息为全0。
· 如果配置了阈值告警组,将显示在statistics interval命令指定的统计周期内的监测结果。若阈值告警组的阈值类型为平均值,则显示的监测结果为无效值。
【举例】
# 显示ICMP-echo测试的统计信息。
<Sysname> display nqa statistics admin test
NQA entry (admin admin, tag test) test statistics:
NO. : 1
Destination IP address: 192.168.0.58
Start time: 2011-01-01 05:59:14.5
Life time: 19 seconds
Send operation times: 184 Receive response times: 184
Min/Max/Average round trip time: 2/44/4
Square-Sum of round trip time: 9117
Extended results:
Packet loss in test: 0%
Failures due to timeout: 0
Failures due to internal error: 0
Failures due to other errors: 0
Reaction statistics:
Index Checked Element Threshold Type Checked Num Over-threshold Num
1 probe-failure consecutive 184 0
表1-5 display nqa statistics命令显示信息描述
字段 |
描述 |
No. |
统计组的组号 |
Destination IP address |
目的IP地址 |
Start time |
测试组启动时间 |
Life time |
测试的持续时间,单位为秒 |
Send operation times |
发送的探测报文数 |
Receive response times |
收到的响应报文数 |
Min/Max/Average round trip time |
最小/最大/平均往返时间,单位为毫秒 |
Square-Sum of round trip time |
往返时间平方和 |
Packet loss in test |
平均丢包率 |
Failures due to timeout |
测试过程中超时的次数 |
Failures due to internal error |
因内部错误失败的次数 |
Failures due to other errors |
因其它错误失败的次数 |
Reaction statistics |
阈值告警组在统计周期内的监测结果 |
Index |
阈值告警组的编号 |
Checked Element |
监测对象 |
Threshold Type |
阈值类型 |
Checked Num |
已监测的样本个数 |
Over-threshold Num |
超出阈值的样本个数 |
表1-6 display nqa statistics命令显示阈值告警功能相关字段取值描述
监测对象 |
阈值类型 |
监测的样本范围 |
Checked Num取值 |
Over-threshold Num取值 |
probe-duration |
accumulate |
统计周期内,进行的探测 |
统计周期内,已完成的探测次数 |
统计周期内,探测持续时间不在阈值范围内的探测次数 |
average |
- |
- |
- |
|
consecutive |
统计周期内,进行的探测 |
统计周期内,已完成的探测次数 |
统计周期内,探测持续时间不在阈值范围内的探测次数 |
|
probe-fail |
accumulate |
统计周期内,进行的探测 |
统计周期内,已完成的探测次数 |
统计周期内,失败的探测次数 |
consecutive |
统计周期内,进行的探测 |
统计周期内,已完成的探测次数 |
统计周期内,失败的探测次数 |
【相关命令】
· statistics interval
frequency命令用来配置测试组连续两次测试开始时间的时间间隔。
undo frequency命令用来恢复缺省情况。
【命令】
frequency interval
undo frequency
【缺省情况】
连续两次测试开始时间的时间间隔为0毫秒,即只进行一次测试。
【视图】
任意测试类型视图
【缺省用户角色】
network-admin
【参数】
interval:连续两次测试开始时间的时间间隔,取值范围为0~604800000,单位为毫秒。时间间隔为0,表示两次测试的时间间隔为无穷,即只进行一次测试,此时不会生成统计结果。
【使用指导】
通过nqa schedule命令启动NQA测试组后,每隔interval时间启动一次测试。
需要注意的时,如果到达frequency指定的时间间隔时,上次测试尚未完成,则不启动新一轮测试。
【举例】
# 配置连续两次测试开始时间的时间间隔为1000毫秒。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type icmp-echo
[Sysname-nqa-admin-test-icmp-echo] frequency 1000
history-record enable命令用来开启NQA测试组的历史记录保存功能。
undo history-record enable命令用来关闭NQA测试组的历史记录保存功能。
【命令】
history-record enable
undo history-record enable
【缺省情况】
NQA测试组的历史记录保存功能处于关闭状态。
【视图】
ICMP-echo/UDP-echo测试类型视图
【缺省用户角色】
network-admin
【使用指导】
· 如果开启NQA测试组的历史记录保存功能,则系统会记录该NQA测试组的历史信息,通过display nqa history命令可以查看该测试组的历史记录信息。
· 如果关闭NQA测试组的历史记录保存功能,则系统不会记录该测试组的历史信息,原有的历史记录信息也会被删除。
【举例】
# 开启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
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/UDP-echo测试类型视图
【缺省用户角色】
network-admin
【参数】
keep-time:历史记录的保存时间,取值范围为1~1440,单位为分钟。
【使用指导】
NQA测试结束后,开始计算该测试组中所有历史记录的保存时间。保存时间达到配置的值后,将删除这些记录。
【举例】
# 配置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
history-record number命令用来配置在一个测试组中能够保存的最大历史记录个数。
undo history-record number命令用来恢复缺省情况。
【命令】
history-record number number
undo history-record number
【缺省情况】
一个测试组中能够保存的最大历史记录个数为50。
【视图】
ICMP-echo/UDP-echo测试类型视图
【缺省用户角色】
network-admin
【参数】
number:在一个测试组中能够保存的最大历史记录个数,取值范围为0~50。
【使用指导】
如果一个测试组中历史记录个数超过设定的最大数目,则最早的历史记录将会被删除。
【举例】
# 配置一个测试组中能够保存的最大历史记录数为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
next-hop命令用来配置探测报文的下一跳IP地址。
undo next-hop命令用来删除所配置的下一跳IP地址。
【命令】
next-hop ip-address
undo next-hop
【缺省情况】
未配置下一跳IP地址。
【视图】
ICMP-echo测试类型视图
【缺省用户角色】
network-admin
【参数】
ip-address:探测报文的下一跳IP地址。
【举例】
# 配置探测报文的下一跳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 10.1.1.1
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 entry命令进入该测试组时,系统将直接进入测试类型视图。
【举例】
# 创建一个管理员名为admin,测试操作标签为test的NQA测试组,并进入NQA测试组视图。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test]
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 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参数指定。
【使用指导】
· 测试组被调度后不允许进入测试组视图和测试类型视图。
· 系统时间在启动时间~启动时间+持续时间范围内时,测试组进行测试。执行nqa schedule命令时,如果系统时间尚未到达启动时间,则到达启动时间后,启动测试;如果系统时间在启动时间~启动时间+持续时间之间,则立即启动测试;如果系统时间已经超过启动时间+持续时间,则不会启动测试。通过display clock命令可以显示系统的当前时间。
· 配置lifetime时间请保证一次测试能够完成,否则无法完成正常的联动操作
【举例】
# 启动管理员名字为admin,标签为test的测试组进行测试,测试组的启动时间为2008年8月8日以后(包含当天)的每天的08:08:08,测试持续时间为1000秒。
<Sysname> system-view
[Sysname] nqa schedule admin test start-time 08:08:08 2008/08/08 lifetime 1000 recurring
【相关命令】
· destination ip
· display clock(基础配置命令参考/设备管理)
· nqa entry
· type
probe count命令用来配置一次NQA测试中探测的次数。
undo probe count命令用来恢复缺省情况。
【命令】
probe count times
undo probe count
【缺省情况】
一次NQA测试中的探测次数为1次。
【视图】
ICMP-echo/UDP-echo测试类型视图
【缺省用户角色】
network-admin
【参数】
times:一次NQA测试中进行探测的次数,取值范围为1~15。
【使用指导】
对于ICMP-echo和UDP-echo测试,一次探测操作是指发送一个探测报文。
如果配置的次数大于1,那么系统在进行第一次探测之后,等待回应。如果到达probe timeout命令指定的探测超时时间时,仍然没有收到回应,则发起第二次探测。如此反复,直到完成指定次数的探测。
【举例】
# 配置一次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
probe timeout命令用来配置探测的超时时间。
undo probe timeout命令用来恢复缺省情况。
【命令】
probe timeout timeout
undo probe timeout
【缺省情况】
探测的超时时间为3000毫秒。
【视图】
ICMP-echo/UDP-echo测试类型视图
【缺省用户角色】
network-admin
【参数】
timeout:一次探测的超时时间,单位为毫秒,取值范围为10~3600000。
【使用指导】
如果NQA探测没有在probe timeout命令指定的时间内完成,则认为本次探测超时。
【举例】
# 配置DHCP探测的超时时间为10000毫秒。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type dhcp
[Sysname-nqa-admin-test-dhcp] probe timeout 10000
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 ]
undo reaction item-number
【缺省情况】
未创建监测探测持续时间的阈值告警组。
【视图】
ICMP-echo/UDP-echo测试类型视图
【缺省用户角色】
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:只在显示信息中记录监测结果。
【使用指导】
· 阈值告警组创建后,不能再通过reaction命令修改该阈值告警组的内容。若要修改阈值告警组的内容,则需要先通过undo reaction命令用来删除阈值告警组,再利用新的参数创建阈值告警组。
· 监测的对象是成功的探测,失败的探测不参与计数。
【举例】
# 创建编号为1的阈值告警组,监测ICMP-echo探测的持续时间,阈值上限为50毫秒,下限为5毫秒。NQA测试组启动前,初始的阈值状态为invalid。每次测试结束后,检查本次测试的平均探测持续时间,若超出阈值,阈值状态置为over-threshold;反之,置为below-threshold。当阈值状态改变时,只在本地记录监测结果。
<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 none
# 创建编号为2的阈值告警组,监测ICMP-echo探测的持续时间,阈值上限为50毫秒,下限为5毫秒。NQA测试组启动前,初始的阈值状态为invalid。每次测试结束后,检查本次测试中累计的持续时间超出阈值的探测次数,若达到或超过10次,阈值状态置为over-threshold;反之,置为below-threshold。当阈值状态改变时,只在本地记录监测结果。
<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 none
# 创建编号为3的阈值告警组,监测ICMP-echo探测的持续时间,阈值上限为50毫秒,下限为5毫秒。NQA测试组启动前,初始的阈值状态为invalid。每次探测结束后,检查测试组启动以来连续的持续时间超出阈值的探测次数,若达到或超过10次,阈值状态置为over-threshold;反之,置为below-threshold。当阈值状态改变时,只在本地记录监测结果。
<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 none
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 ]
undo reaction item-number
【缺省情况】
未创建监测探测失败次数的阈值告警组。
【视图】
ICMP-echo/UDP-echo测试类型视图
【缺省用户角色】
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:只在显示信息中记录监测结果。
【使用指导】
阈值告警组创建后,不能再通过reaction命令修改该阈值告警组的内容。若要修改阈值告警组的内容,则需要先通过undo reaction命令用来删除阈值告警组,再利用新的参数创建阈值告警组。
【举例】
# 创建编号为1的阈值告警组,监测ICMP-echo探测的失败次数。NQA测试组启动前,初始的阈值状态为invalid。每次测试结束后,检查本次测试中累计的探测失败次数,若达到或超过10次,阈值状态置为over-threshold;反之,置为below-threshold。当阈值状态改变时,只在本地记录监测结果。
<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 none
# 创建编号为2的阈值告警组,监测ICMP-echo探测的失败次数。NQA测试组启动前,初始的阈值状态为invalid。每次探测结束后,检查测试组启动以来连续的探测失败次数,若达到或超过10次,阈值状态置为over-threshold;反之,置为below-threshold。当阈值状态改变时,只在本地记录监测结果。
<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 none
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/UDP-echo测试类型视图
【缺省用户角色】
network-admin
【参数】
item-number:联动项序号,取值范围为1~10。
threshold-type:指定门限类型。
consecutive consecutive-occurrences:NQA测试组启动以来,连续的探测失败次数。consecutive-occurrences取值范围为1~16。
action-type:触发的动作类型。
trigger-only:条件满足时,触发其它模块联动。
【使用指导】
联动项创建后,不能再通过reaction命令修改该联动项的内容。若要修改联动项的内容,则需要先通过undo reaction命令用来删除联动项,再利用新的参数创建联动项。
【举例】
# 建立序号为1的联动项,连续探测失败3次,触发其他模块联动。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type udp-echo
[Sysname-nqa-admin-test-udp-echo] reaction 1 checked-element probe-fail threshold-type consecutive 3 action-type trigger-only
【相关命令】
· track(可靠性命令参考/Track)
route-option bypass-route命令用来启动路由表旁路功能,探测直连目的地的连通情况。
undo route-option bypass-route命令用来关闭路由表旁路功能。
【命令】
route-option bypass-route
undo route-option bypass-route
【缺省情况】
路由表旁路功能处于关闭状态。
【视图】
ICMP-echo/UDP-echo测试类型视图
【缺省用户角色】
network-admin
【使用指导】
启动该功能后,将不进行路由查找,而直接将报文发送到直连网络的目的地。
【举例】
# 启动路由旁路功能。
<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
source interface命令用来配置探测报文的源接口,即将指定源接口的IP地址作为ICMP-echo测试中探测报文的源IP地址。
undo source interface命令用来恢复缺省情况。
【命令】
source interface interface-type interface-number
undo source interface
【缺省情况】
未配置探测报文的源接口。
【视图】
ICMP-echo测试类型视图
【缺省用户角色】
network-admin
【参数】
interface-type interface-number:探测报文源接口的接口类型和接口编号。
【使用指导】
· 如果使用source ip命令配置了ICMP-echo测试的源IP地址,则source interface命令配置无效。
· 该命令指定的接口必须处于up状态,否则探测将会失败。
【举例】
# 配置将VLAN接口2的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 vlan-interface 2
【相关命令】
· source ip
source ip命令用来配置测试操作中探测报文的源IP地址。
undo source ip命令用来取消已配置的源IP地址,即以报文发送接口的IP地址作为探测报文中的源IP地址。
【命令】
source ip ip-address
undo source ip
【缺省情况】
未指定源IP地址。
【视图】
ICMP-echo/UDP-echo测试类型视图
【缺省用户角色】
network-admin
【参数】
ip-address:测试操作的源IP地址。
【使用指导】
· 对于ICMP-echo测试类型,如果没有指定源IP地址,但是配置了source interface,则该源接口的IP地址将作为探测报文中的源IP地址。
· source ip命令指定的源IP地址必须是设备上接口的IP地址,且接口为up状态,否则测试将会失败。
【举例】
# 配置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] source ip 10.1.1.1
【相关命令】
· source interface
source port命令用来配置测试操作中探测报文的源端口号。
undo source port命令用来取消已配置的端口号。
【命令】
source port port-number
undo source port
【缺省情况】
未指定源端口号。
【视图】
UDP-echo测试类型视图
【缺省用户角色】
network-admin
【参数】
port-number:探测报文的源端口号,取值范围为1~50000。
【举例】
# 配置探测报文的源端口号为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
statistics hold-time命令用来配置统计组的保留时间。
undo statistics hold-time命令用来恢复缺省情况。
【命令】
statistics hold-time hold-time
undo statistics hold-time
【缺省情况】
统计组的保留时间为120分钟。
【视图】
ICMP-echo/UDP-echo测试类型视图
【缺省用户角色】
network-admin
【参数】
hold-time:统计组的保留时间,取值范围为1~1440,单位为分钟。
【使用指导】
统计组具有老化功能。统计组保存一定时间后将被删除,以便记录新的统计组信息。
【举例】
# 配置统计组的保留时间为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
statistics interval命令用来配置对测试结果进行统计的时间间隔。
undo statistics interval命令用来恢复缺省情况。
【命令】
statistics interval interval
undo statistics interval
【缺省情况】
对测试结果进行统计的时间间隔为60分钟。
【视图】
ICMP-echo/UDP-echo测试类型视图
【缺省用户角色】
network-admin
【参数】
interval:对测试结果进行统计的时间间隔,取值范围为1~35791394,单位为分钟。
【使用指导】
NQA将统计时间间隔内完成的NQA测试归为一组,计算该组测试结果的统计值,这些统计值构成一个统计组。通过display nqa statistics命令可以显示该统计组的信息。
【举例】
# 配置对测试结果进行统计的时间间隔为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
statistics max-group命令用来配置能够保留的最大统计组个数。
undo statistics max-group命令用来恢复缺省情况。
【命令】
statistics max-group number
undo statistics max-group
【缺省情况】
能够保留的最大统计组个数为2。
【视图】
ICMP-echo/UDP-echo测试类型视图
【缺省用户角色】
network-admin
【参数】
number:能够保留的最大统计组个数,取值范围为0~100。
【使用指导】
当保留的统计组数目达到最大值时,如果形成新的统计组,保存时间最久的统计组将被删除。
需要注意的是,能够保留的最大统计组个数为0时,不进行统计。
【举例】
# 配置能够保留的最大统计组个数为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
tos命令用来配置NQA探测报文IP报文头中服务类型域的值。
undo tos命令用来恢复缺省情况。
【命令】
tos value
undo tos
【缺省情况】
NQA探测报文IP报文头中服务类型域的值为0。
【视图】
ICMP-echo/UDP-echo测试类型视图
【缺省用户角色】
network-admin
【参数】
value:探测报文IP报文头中服务类型域的值,取值范围为0~255。
【举例】
# 配置探测报文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
ttl命令用来配置探测报文在网络中可以经过的最大跳数。
undo ttl命令用来恢复缺省情况。
【命令】
ttl value
undo ttl
【缺省情况】
探测报文在网络中可以经过的最大跳数为20跳。
【视图】
ICMP-echo/UDP-echo测试类型视图
【缺省用户角色】
network-admin
【参数】
value:探测报文在网络中可以经过的最大跳数,取值范围1~255。
【使用指导】
配置route-option bypass-route命令后,探测报文在网络中可以经过的最大跳数为1,ttl命令不会生效。
【举例】
# 配置探测报文在网络中可以经过的最大跳数为16跳。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type icmp-echo
[Sysname-nqa-admin-test-icmp-echo] ttl 16
type命令用来配置当前测试组的测试类型,并进入测试组测试类型视图。
【命令】
type { icmp-echo | udp-echo }
【缺省情况】
没有配置测试类型。
【视图】
NQA测试组视图
【缺省用户角色】
network-admin
【参数】
icmp-echo:测试类型为ICMP-echo。
udp-echo:测试类型为UDP-echo。
【举例】
# 配置测试组的测试类型为ICMP-echo测试,并进入测试组测试类型视图。
<Sysname> system-view
[Sysname] nqa entry admin test
[Sysname-nqa-admin-test] type icmp-echo
[Sysname-nqa-admin-test-icmp-echo]
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!