send-trap

Function

The send-trap command configures conditions for sending traps.

The undo send-trap command deletes the previous configuration.

By default, the device is disabled from sending traps.

Format

send-trap { all | { probefailure | rtd | testcomplete | testfailure | testresult-change } ^* }

undo send-trap { all | { probefailure | rtd | testcomplete | testfailure | testresult-change } ^* }

Parameters

Parameter	Description	Value
all	Indicates that a trap is sent in any of the following situations: The RTD exceeds the threshold. NQA probes fail. An NQA test succeeds. NQA tests fail.	-
probefailure	Indicates that a trap is sent when the number of probe failures reaches the threshold. NOTE: This parameter does not apply to the UDP Jitter and ICMP Jitter test instances.	-
rtd	Indicates that a trap is sent when the RTD exceeds the threshold.	-
testcomplete	Indicates that a trap is sent when a test succeeds.	-
testfailure	Indicates that a trap is sent when the number of test failures reaches the threshold.	-
testresult-change	Indicates that a trap is sent when the probe result changes. NOTE: This function supports only ICMP test instances.	-

Views

NQA view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

Traps are generated no matter whether the NQA test succeeds or fails. You can determine whether traps are sent to the NMS by enabling or disabling the trap function.

The device sends traps to the NMS in any of the following situations:

The RTD exceeds the threshold.

If the RTD exceeds the threshold, the device sends a trap to the NMS using the configured address.
NQA probes fail.

When no response packet is received after a specified number of continuous test packets are sent, the device sends a trap to the NMS using the configured address.
An NQA test succeeds.

When the device receives a response packet from a destination address, the device sends a trap to the NMS using the configured address.
NQA tests fail.

When the number of continuous test failures reaches the maximum number, the device sends a trap to the NMS using the configured address.

You can run the send-trap command to configure conditions for sending traps. When a condition is met, the device sends a trap to the NMS.

Prerequisites

The type of a test instance has been specified using the test-type command. Path jitter test is not supported.

The route between the device and NMS is reachable, and related configurations are complete. The host where traps are sent is configured using the snmp-agent target-host trap command; otherwise, traps cannot be sent to the NMS.

Precautions

You cannot change this configuration of a running test instance.

Example

# Configure the test instance user test to send a trap when the test fails.

<HUAWEI> system-view
[HUAWEI] nqa test-instance user test
[HUAWEI-nqa-user-test] test-type jitter
[HUAWEI-nqa-user-test] send-trap testfailure