Thresholds

Thresholds is a standard configuration interface for adding, editing, and removing thresholds in Oracle Communications Unified Assurance.

For information about interacting with the grid and form, see Standard Configuration Interface in Unified Assurance Concepts.

This user interface calls REST methods from api/metric/thresholds. See REST API for Unified Assurance Core for details.

To open this interface, from the main navigation menu, select Configuration, then Metrics, then Thresholds, and then Thresholds.

Form Fields

The following fields appear in the form for this UI:

• Name: The name of the threshold.

• Type: The threshold type.

• Abnormal Profile: Appears when Type is set to Abnormal. The abnormal profile to use for the confidence band calculation and threshold.

• Measurement: The metric type that the threshold checks.

• Metric Field: The data type that the threshold checks. Must be set to one of the following:

  • availability

  • utilization

  • value

• Time Range: Unless Type is set to Abnormal, the period of time in which data points are retrieved and evaluated. For example, 15m.

  Must be a combination of a numerical value and one of the following duration values:

  • m: Minutes

  • h: Hours

  • d: Days

  • w: Weeks

  • M: Months

  • Y: Years

• Forecast: Appears when Type is set to Trend Prediction. The relative time, starting now, to use when predicting when the metric value will breach the threshold.

  The format is a combination of a numerical value and one of the following duration values:

  • m: Minutes

  • h: Hours

  • d: Days

  • w: Weeks

  • M: Months

  • Y: Years

  For example, use 6M to notify when the threshold is expected to be breached within six months.

• Frequency: Appears when Type is set to Standard and Check Location is set to Threshold Engine. How often the threshold is checked.

  Use the following guidelines when setting the threshold frequency:

  • Because thresholds can only be checked as frequently as the Standard Thresholding Engine polls, you must set this to a value greater than or equal to the PollTime of the Standard Thresholding Engine (the default is one minute).

  • Because metric values are only updated when the metric is polled, you must set this to a value greater than or equal to the PollTime of the metric the threshold is for (the default is five minutes).

  The format is a combination of a numerical value and one of the following duration values:

  • m: Minutes

  • h: Hours

  • d: Days

  • w: Weeks

  • M: Months

  • Y: Years

  For example, use 5m to check every five minutes.

• Offset: Appears when Type is set to Standard and Check Location is set to Threshold Engine. The offset to apply to the time range.

  The format is a combination of a numerical value and one of the following duration values:

  • m: Minutes

  • h: Hours

  • d: Days

  • w: Weeks

  • M: Months

  • Y: Years

  For example:

  • Use 5m to go back five minutes when checking the threshold to ensure most recent poll data is considered.

  • Use 0m for no offset.

• Function: Appears when Type is set to Standard. The function to apply when calculating if a threshold is breached. Expands from previous Mean. The following options are available:

  • 95th Percentile: Use when you do not want to count infrequently-occurring high outliers and odd values, when most data points will be under a certain value.

  • Count: Use to ensure there is no missing data, when you expect data points frequently. For example, if you expected a data point every minute, checking a TimeRange of X minutes every Y minutes shows if data is missing after the last Y minutes.

  • Maximum: Use to ensure all data is below a certain value.

  • Mean: Use to consider the average of the values.

  • Minimum: Use to ensure the data never falls below a certain value.

  • Standard Deviation: Use when the variation of data points should be below a certain value.

• Warning: When to send a threshold warning notification.

  • Operator: Unless Type is set to Abnormal, the threshold comparison operator.

  • Value: Unless Type is set to Abnormal, the value to compare against.

  • Severity: The severity for the event on the event list.

• Critical: When to send a threshold critical notification.

  • Operator: Unless Type is set to Abnormal, the threshold comparison operator.

  • Value: Unless Type is set to Abnormal, the value to compare against.

  • Severity: Unless Type is set to Abnormal, the severity for the event on the event list.

• Message: The message for the event on the event list. Usually appears in the event's Summary field.

• Check Location: Used for standard thresholds only. What checks the threshold, an application or the threshold engine.

• Status: Whether the threshold is enabled or disabled.