Adding New Threshold-Crossing Alarms

Prime Network enables the creation of Threshold-Crossing Alarms (TCAs), which are generated when a specific condition is met. These alarms can be viewed in the Prime Network Vision and Events GUI clients.

TCAs are associated with soft properties. A soft property is a mechanism for extending the NE information that Prime Network models. The soft property contains rules for retrieving new NE information, parsing the retrieved information, and displaying it in the Inventory window. To create a TCA, you can apply it to an existing soft property, or create a new soft property and associate a TCA to it. For information on creating soft properties, see Steps for Adding New NE Property Information to the Inventory.

This topic explains how to create TCAs for soft properties:

Creating a New Threshold-Crossing Alarm

The procedure for creating a TCA is an extension of the procedure for creating a soft property, described in Displaying a New Property in the Inventory Window. You can create a TCA for an existing soft property, or create a new soft property and associate a TCA to it. You can create multiple TCAs for the same soft property. If necessary, the TCA can be disabled, in which case it will not be triggered for the specified condition until it is re-enabled.

TCAs are only supported on Property type soft properties.

Before You Begin

To create a TCA:


Step 1blank.gif In Prime Network Vision, right-click a relevant NE and choose Management > Soft Properties Management.

The Soft Properties Manager dialog box opens and displays any existing soft properties for the selected NE.

Step 2blank.gif If you are creating a new soft property, choose File > New Element and follow the procedure in Displaying a New Property in the Inventory Window.

or

If you are adding a TCA for an existing soft property, choose File > Edit Element. This displays a window listing the complete hierarchy for the soft property. Checks indicate the classes to which the soft property is available.

Step 3blank.gif In the Edit Soft Property dialog box, locate the local instance of the soft property; this is most likely at the very bottom of the table. Select it and click OK.

Step 4blank.gif Click the TCA Alarms tab. If the soft property has any defined TCAs, they will be listed.

Step 5blank.gif Click Add to open the Add TCA dialog box.

Step 6blank.gif Click the General tab and enter the basic alarm information.

Field
Description
Example

Name

Alarm name that is displayed in the ticket pane when the alarm is triggered.

My value is not 5

Enabled

Whether the VNE is monitoring for this alarm. This field allows you to temporarily disable a TCA, if needed.

(Enabled)

Description

(Optional) A description of the alarm.

Show this alarm if the value is not equal to 5

Alarm Severity

Choose the severity that is appropriate for this TCA in your network: Critical, Major, Minor, Warning, or Normal (clearing).

Critical

Can be correlated to other alarms

Enables correlating this alarm to other alarms.

(Not selected)

Other alarms can correlate to this alarm

Enables other alarms to correlate to this alarm.

(Not selected)

Step 7blank.gif Click the Trigger tab and define the conditions that will trigger the alarm.

note.gif

Noteblank.gif For triggers that require numeric values, the parse integer rule must be applied on the soft property as an ending rule.


 

Trigger
Description

Value Equal

Generates an alarm when the when the soft property value is equal to the specified target value.

Value Not Equal

Generates an alarm when the when the soft property value is not equal to the specified target value.

Upper Threshold

Generates an alarm when the value exceeds the specified value. Clears this alarm when the value drops below the specified value. The upper threshold value must be numeric.

Lower Threshold

Generates an alarm when the value drops below the specified value. Clears this alarm when the value rises above the specified value. The lower threshold value must be numeric.

Upper Rate

Checks counter value changes over a period of one second. Generates an alarm when the specified upper rate is exceeded. Clears the alarm when the rate drops to the specified value. When this trigger is used with the Trigger alarm only if change persists more than option, you can check that the rate is maintained above the specified value over time.

Note If the property is sampled every x seconds, the calculation is the current value less the previous value divided by x seconds.

Lower Rate

Checks counter value changes over a period of one second. Generates an alarm when the rate drops below the specified lower rate. Clears the alarm when the rate reaches the specified value. When this is used with the Trigger alarm only if change persists more than option, you can check that the rate is maintained below the specified value over time.

Note If the property is sampled every x seconds, the calculation is the current value less the previous value divided by x seconds.

Step 8blank.gif To generate the alarm only if the trigger condition is maintained for a certain length of time, select the relevant check box and specify the length of time in seconds.

Step 9blank.gif Click OK to exit the Edit TCA dialog box.

Step 10blank.gif Click OK to exit the Edit Soft Property dialog box.

Step 11blank.gif Click Close to exit the Soft Properties Manager.

The TCA is activated on the NE. If the trigger conditions are met, you should see the event in the Tickets tab (Prime Network Vision) or tickets table (Prime Network Events). When you restart the VNE, the TCA is applied to all similar components on the VNE.


 

If you want to make the TCA available to other NEs, follow the procedure in Making the Soft Property Available to Other NEs.