Table Of Contents

Alarm Threshold Triggers

Value Equal

Value Not Equal

Upper Threshold

Lower Threshold

Upper Rate

Lower Rate

Alarm Threshold Triggers

---

This chapter describes the pre-defined alarm threshold triggers available for defining TCA alarms that are displayed in the Trigger tab of the Add TCA dialog box. For each alarm threshold trigger its name, description, and the unique fields displayed in the dialog box are described.

The user can define multiple alarms for the same soft property. The alarm is displayed in the ticket pane of the NetworkVision window.

A counter value, as described in this chapter, is a numeric value that always increases.

For more information about the Add TCA dialog box see Defining the TCA Alarms Parameters, page 2-16.

•Value Equal—Describes the Value Equal threshold type.

•Value Not Equal—Describes the Value Not Equal threshold type.

•Upper Threshold—Describes the Upper Threshold type.

•Lower Threshold—Describes the Lower Threshold type.

•Upper Rate—Describes the Upper Rate threshold type.

•Lower Rate—Describes the Lower Rate threshold type.

Value Equal

The alarm condition is reached when the soft property value is equal to the value defined in the "Alarm Value" regardless if it is numeric or not.

When the Value Equal threshold type is selected from the Trigger dropdown list of the Add TCA dialog box the Trigger tab is displayed.

The following fields are displayed in the Trigger tab when the Value Equal threshold type is selected:

•To value—The target value.

•Trigger alarm only if change persists more than—Select this option to trigger the alarm if the alarm criteria persist for the defined period. The time period is defined in milliseconds in the trigger alarm field. For example, if CPU usage is over 85% (the alarm criteria) and this persists for more than one minute (the defined period), then the alarm is triggered. Considering that the soft property polls the device every x seconds, if the defined period is less than x, this will be meaningless.

Value Not Equal

The alarm condition is reached when the soft property value is NOT equal to the value defined in the "Alarm Value" regardless if it is numeric or not.

When the Value Not Equal threshold type is selected from the Trigger dropdown list of the Add TCA dialog box the Trigger tab is displayed as follows:

Figure B-1 Trigger Tab - Value Not Equal

The following fields are displayed in the Trigger tab when the Value Not Equal threshold type is selected:

•To value—The target value.

•Trigger alarm only if change persists more than—Select this option to trigger the alarm if the alarm criteria persist for the defined period. The time period is defined in milliseconds in the trigger alarm field.

Upper Threshold

The upper threshold value, which when crossed triggers the alarm for the defined numeric properties.

This threshold trigger must receive a numeric value. In order to receive a numeric value the parse integer rule must be applied on the soft property as an ending rule. For more information about parsing integers see Appendix A, "Parsing Operators/Rules".

When the Upper Threshold type is selected from the Trigger dropdown list of the Add TCA dialog box the Trigger tab is displayed as follows:

Figure B-2 Trigger Tab - Upper Threshold

The following fields are displayed in the Trigger tab when the Upper Threshold type is selected:

•Trigger alarm when value is above—The value which when crossed generates the alarm.

•Clear alarm when value is below—The value which when crossed (when going back) clears the alarm.

•Trigger alarm only if change persists more than—Select this option to trigger the alarm if the alarm criteria persist for the defined period. The time period is defined in milliseconds in the trigger alarm field.

Lower Threshold

The lower threshold value, which when crossed triggers the alarm for the defined numeric properties.

This threshold trigger must receive a numeric value. In order to receive a numeric value the parse integer rule must be applied on the soft property as an ending rule. For more information about parsing integers see Appendix A, "Parsing Operators/Rules".

When the Lower Threshold type is selected from the Trigger dropdown list of the Add TCA dialog box the Trigger tab is displayed as follows:

Figure B-3 Trigger Tab - Lower Threshold

The following fields are displayed in the Trigger tab when the Lower Threshold type is selected:

•Trigger alarm when value is below—The value which when crossed generates the alarm.

•Clear alarm when value is above—The value which when crossed (when going back) clears the alarm.

•Trigger alarm only if change persists more than—Select this option to trigger the alarm if the alarm criteria persist for the defined period. The time period is defined in milliseconds in the trigger alarm field.

Upper Rate

The upper rate trigger is used for checking the counter value changes over a period of one second. When the specified rate is crossed it triggers the alarm for the defined numeric property. When this is used together with the Trigger alarm only if change persists more than option, described in Upper Threshold, you can check that the rate is maintained above the specified value over time.

---

Note The calculation for the "rate every one second" is as follows, if the property is sampled every x seconds the calculation will be the current value less the previous value divided by x seconds.

---

This threshold trigger must receive a numeric value. In order to receive a numeric value the parse integer rule must be applied on the soft property as an ending rule. For more information about parsing integers see Appendix A, "Parsing Operators/Rules".

When the Upper Rate threshold type is selected from the Trigger dropdown list of the Add TCA dialog box the Trigger tab is displayed as follows:

Figure B-4 Trigger Tab - Upper Rate

The following fields are displayed in the Trigger tab when the Upper Rate threshold type is selected:

•Trigger alarm when value is above—The value which when crossed generates the alarm.

•Clear alarm when value is below—The value which when crossed (when going back) clears the alarm.

•Trigger alarm only if change persists more than—Select this option to trigger the alarm if the alarm criteria persist for the defined period. The time period is defined in milliseconds in the trigger alarm field.

Lower Rate

The lower rate trigger is used for checking the counter value changes over a period of one second. When the specified rate is crossed it triggers the alarm for the defined numeric property. When this is used together with the Trigger alarm only if change persists more than option, described in Upper Threshold, you can check that the rate is maintained below the specified value over time.

---

Note The calculation for the "rate every one second" is as follows, if the property is sampled every x seconds the calculation will be the current value less the previous value divided by x seconds.

---

This threshold trigger must receive a numeric value. In order to receive a numeric value the parse integer rule must be applied on the soft property as an ending rule. For more information about parsing integers see Appendix A, "Parsing Operators/Rules".

When the Lower Rate threshold type is selected from the Trigger dropdown list of the Add TCA dialog box the Trigger tab is displayed as follows:

Figure B-5 Trigger tab - Lower Rate

The following fields are displayed in the Trigger tab when the Lower Rate threshold type is selected:

•Trigger alarm when value is below—The value which when crossed generates the alarm.

•Clear alarm when value is above—The value which when crossed (when going back) clears the alarm.

•Trigger alarm only if change persists more than—Select this option to trigger the alarm if the alarm criteria persist for the defined period. The time period is defined in milliseconds in the trigger alarm field.