Administer > Administer the NNM iSPI Performance for QA > Configure Thresholds > Configure Ping Latency Pair Thresholds

Configure Ping Latency Pair Thresholds

This topic includes the following sections:

Using ping latency pair thresholds, you can track the status of every ping pair you define in your environment. Using the NNM iSPI Performance for QA Configuration console, you can configure a threshold for a ping pair. The NNM iSPI Performance for QA generates incidents when a threshold violation is detected.

To configure the thresholds for ping pairs:

  1. In the NNMi console, go to the Configuration workspace and click Quality Assurance Configuration. The NNM iSPI Performance for QA Configuration console opens.

  2. In the NNM iSPI Performance for QA Configuration console, click Ping Latency Thresholds. The Ping Pair Threshold Configuration form opens.

  3. You can perform the following tasks:
Tasks for Ping Pair Threshold Configuration
Task Description
Add Launches the Ping Pair - Add Threshold Configuration form to add a new threshold.
Edit Selects an existing ping pair and launches the Ping Pair - Edit Threshold Configuration form to edit the threshold.
Export Exports threshold configurations.
Import Imports threshold configurations.
Applies all the threshold configurations.
Close Closes the Threshold Configuration form without saving the current configuration.
Refresh Refreshes the list of thresholds.
Delete Deletes the selected ping pair thresholds.
Delete All Deletes all thresholds.

Add Ping Latency Pair Thresholds

Make sure QA groups are already created for ping pairs.

To add a new ping pair threshold:

  1. Launch the Ping Pair - Add Threshold Configuration form.
  2. In the Threshold Type section, specify the following details:
    • Order: Specify a numeric value. NNM iSPI Performance for QA checks the configuration settings in the order you define (lowest number first).
    • QA Group: Select a QA group of your choice. The threshold configuration is applied to all ping pairs that belong to the selected QA group.
  3. Click Add and use the Ping Pair - Add Threshold Settings form to add a threshold setting. You can add more than one threshold setting.
  4. Click Save and Close.

Add Threshold Settings

To add a new ping pair threshold:

  1. Launch the Ping Pair - Add Threshold Configuration form.
  2. In the Threshold Type section, specify the following details:

    • Type: Select the metric type (count-based or time-based).

    • Metric: Select one of the following metrics:
      • Interface Utilization in Pair
      • RTT (ms)
      • Interface Utilization (%)
  3. If you select count-based, specify the following details:

    • High Value: Type the threshold value. This value indicates the maximum value above which the metric will be considered to have violated the nominal range.

    • High Value Rearm: The High Value Rearm is used to indicate the end of the high threshold state and NNM iSPI Performance for QA clears the incident once it reaches below this value. Type a value lower than the High Value that you specified in the above step.
    • Trigger Count: Specify after how many consecutive threshold violations, the NNM iSPI Performance for QA must alert the operator by transitioning the threshold state to High.
    • Generate Incident: Select this option if you want NNM iSPI Performance for QA to generate an incident. By default this option is selected.
  4. If you select time-based, specify the following details:
    • High Value: Type the threshold value. This value indicates the maximum value above which the metric will be considered to have violated the nominal range.
    • High Value Rearm: The High Value Rearm is used to indicate the end of the high threshold state and NNM iSPI Performance for QA clears the incident once it reaches below this value. Type a value lower than the High Value that you specified in the above step.
    • High Duration: Type the minimum amount of time for which the ping pair must report high metric values.
    • High Duration Window: Define a window for the high duration value. This value must be greater than zero and can be same as the High Duration value.
    • Generate Incident: Select this option if you want NNM iSPI Performance for QA to generate an incident. By default this option is selected.
  5. Click Save and Close.

Count-Based Threshold Configuration

You can generate an incident based on the count or number of consecutive times a metric violates the threshold value. You can define this count in the Threshold Configuration form.

Time-Based Threshold Configuration

Time-Based threshold configuration enables you to raise an alert when the threshold breached state persists for more than a specific time period. This is derived by specifying X as the duration of time in minutes when the metric is in a threshold breached state within Y number of minutes specified in the sliding window.

Example for Time-Based Threshold Configuration

Consider a scenario, where the polling interval is 5 minutes; High duration is 10 minutes; and High Duration Window is 60 minutes. In this scenario, an incident is generated whenever the High Duration exceeds 10 minutes within the 60 minute duration. NNM iSPI Performance for QA uses a sliding window wherein each time the High Duration (10 minutes) is reached, NNM iSPI Performance for QA drops the oldest polled value (first 5 minutes) and adds the most recent (between 60 to 65 minutes). This procedure continues and enables you to determine time-based threshold violation.

You can make utmost use of the Time-Based threshold violation by ensuring that the duration specified in the sliding window is greater than or equal to the polling interval.

Edit an Existing Ping Pair Threshold

To edit an existing ping pair threshold:

  1. Launch the Ping Pair - Edit Threshold Configuration form.
  2. In the Threshold Type section, modify the following details:
    • Order: Specify a numeric value. NNM iSPI Performance for QA checks the configuration settings in the order you define (lowest number first).
    • QA Group: Select a QA group of your choice. The threshold configuration is applied to all ping pairs that belong to the selected QA group.
  3. Click Add and use the Ping Pair - Add Threshold Settings form to add a threshold setting . You can add more than one threshold setting. For more information about adding threshold settings, see
  4. Click Delete Delete to delete a threshold setting.
  5. Click Save and Close.

Export Ping Latency Pair Thresholds 

To export the existing threshold configurations to an XML file:

  1. Launch the Ping Latency Pair Threshold Configuration form.
  2. Click Export.

  3. Type the file name where you want to export the existing threshold configuration in the user prompt dialog.

    You must type the file name with full path information; for example, C:\temp\PL_threshold_conf.xml

    If you type the XML file name without entering the absolute path, by default the file gets saved in the following directory:

    Linux: $NnmDataDir/shared/qa/conf

    Windows : %NnmDataDir%\shared\qa\conf

  4. Click OK in the user prompt dialog.

You can also export the existing threshold configuration using the following command line utility:

Linux: $NnmInstallDir/bin/nmsqathresholdconfigutil.ovpl –u <username> –p <password> –export –type pingpair <filename>

Windows:%NnmInstallDir%\bin\nmsqathresholdconfigutil.ovpl –u <username> –p <password> –export –type pingpair <filename>

The threshold export utility does not export a threshold unless the threshold is associated with at least one site.

If the threshold export fails, check the following log files:

Linux:$NnmDataDir/log/qa/qa.log

Windows:%NnmDataDir%\log\qa\qa.log

-u <username> -p <password> are optional parameters.

Import the Ping Latency Pair Threshold Configurations

To import the existing threshold configurations from an XML file:

  1. Launch the Ping Latency Pair Threshold Configuration form.
  2. Click Import.

  3. In the user prompt dialog, enter the file name from where you want to import the threshold configuration information.

    You must enter the file name with full path information; for example, C:\temp\PL_threshold_conf.xml

  4. Click OK in the user prompt dialog.

    If a threshold is already defined and displayed in the Site Wide Threshold Settings panel, the import utility does not import the configuration information for this threshold from the XML file.

You can also import threshold configuration information using the following command line utility:

Linux: $NnmInstallDir/bin/nmsqathresholdconfigutil.ovpl –u <username> –p <password> –import –type pingpair <filename>

Windows:%NnmInstallDir%\bin\nmsqathresholdconfigutil.ovpl –u <username> –p <password> –import –type pingpair <filename>

If the threshold import fails, check the following log files:

Linux: $NnmDataDir/log/qa/qa.log

Windows:%NnmDataDir%\log\qa\qa.log

-u <username> -p <password> are optional parameters.

Send Help Center feedback