fail-percent

Function

The fail-percent command sets the percentage of the number of failed probes in a test instance to the total number of probes. If the set percentage expires, the test is considered a failure.

The undo fail-percent command restores the setting.

Format

fail-percent percent

undo fail-percent

Parameters

Parameter	Description	Value
percent	Specifies the percent of failed probes.	The value is an integer ranging from 1 to 100. By default, the failure percentage is 100%. That is, the test is regarded as a failure only when all the probes fail.

Views

NQA view

Default Level

2: Configuration level

Usage Guidelines

Usage Scenario

In an NQA test instance, multiple probes are sent to test probe packets. Statistics obtained from multiple probe tests show the network quality.

In actual scenarios, however, a probe test may fail because of interference in the network. In addition, a failure in a probe test does not mean that the NQA test fails. The undo fail-percent command can be used to set failure percentage to check whether an NQA test fails or not. If the number of failure probe packets to the total number of probe packets reaches a specified percentage, the NQA test is considered as a failure.

For example, the number of sent packets set in the probe-count command is 10, but seven of them are lost during the probe test, the following situations occur:

If the failure percentage is set to 80, the probe test is considered a success.
If the failure percentage is set to 60, the probe test is considered a failure.

Prerequisites

Before using the fail-percent, run the test-type to specify the type of a test instance, but the failure percentage cannot be set for an FTP, an UDP-tracert, or a DNS test instance.

Precautions

The failure percentage of a running test instance cannot be changed.

Example

# Set the percent of the failed probes to 10% in the test named admin http.

<sysname> system-view
[sysname] nqa test-instance admin http
[sysname-nqa-admin-http] test-type http
[sysname-nqa-admin-http] fail-percent 10