Timing Tab - Threshold Condition

The Timing tab of the Threshold Conditions property dialog box is used to set when and how often the Threshold will check for an individual Threshold condition.

While a Threshold is running, it will continuously check for each defined condition. It will only 'trigger' based upon the details that have been added to the Schedule Tab - Threshold of the Threshold Properties dialog box, unless these have been over-ridden by settings in this Timing tab of an individual Threshold Condition.

Field

Description

Condition Name

Defaults to the Record_Name.Field_Name used in the Where Clause.

Options

Acknowledgement Required by operator
Check this box if all reported cases of this condition are to be manually acknowledged by an operator. This option is only available if the condition logs to the PROBLEM record and will cause the PROBLEM record to remain in a special state until the operator acknowledges the problem. Until acknowledged, the particular problem will not be reported again. For full details of this function please refer to the Operator Acknowledgement for Thresholds section.


Start Disabled

When a Threshold is started, it will normally start checking immediately for each condition defined in the Threshold document, when this option is checked the Threshold will start with the individual condition disabled. The condition can then be started later from the Nodes Navigator when required. See Starting/Stopping a Threshold Condition for further information.

Check Interval

When a Threshold starts and it does not find a condition exception, it uses the information specified in the Check Interval field of the Timing tab to determine how often to check for the condition. The Check Interval defines the interval at which data will be sent to the Threshold from the Collector. For example, if this field is set to 30 seconds, the Threshold will check the collected data for the condition every 30 seconds. If it finds a condition exception, it uses the information specified in the Log Frequency fields to determine how often to log an ON EVENT message.

Log Frequency

The 'Log at most every <n>' parameter is used to set how many times the Threshold should log the same re-occurring condition exception during a nominated period of time. For example, if 'Log at most every 1 minute' is specified, once the first occurrence of the condition exception is detected an ON EVENT message will be generated, but no further messages will be generated over the next one minute even if the condition exception re-occurs. When an OFF EVENT is set, the OFF EVENT message is independent of the 'Log at most every <n>' parameter in that once a Threshold event is logged and is no longer occurring an OFF EVENT will always be logged. An OFF EVENT will also take priority over the 'Log at most every <n>' parameter, in that an ON EVENT message will not be re-logged every <n> minutes while a condition exception is awaiting an OFF EVENT. If only an ON EVENT is configured, then the 'Log at most every <n>' parameter will log an ON EVENT message as specified whilst the condition exception exists.

The 'Log after <n> consecutive occurrences' is used to set how many times a condition exception should occur before the Threshold will generate an ON EVENT message. For example, 'Log after 3 consecutive occurrences', in this case an exception to the condition would need to be detected three times before an ON EVENT message would be generated. The 'Log after' parameter is NOT affected by the existence, or lack thereof, of an OFF EVENT. The 'Log after' parameter will always take affect, regardless of whether or not there is an OFF EVENT configured.

Schedule


The options in this section of the Timing tab specific days of the week can be nominated when the Threshold will check for the condition, the default is every day. In the Except These Dates box specific dates can be selected for when the Threshold should not check for the condition, such as on public holidays. The Time Window field allows for start and end times to be set so that the condition is only checked during the nominated time period of the day, the default is for the whole day.


Use default Days of Week

When this box is checked the settings made on the Schedule Tab - Threshold of the Threshold properties dialog will be used. Unchecking this box will enable the following fields to be used:


Monday - Sunday

Check the boxes for the days that the Threshold is to 'trigger' when a defined condition is met. These check boxes will only be active as long as the 'Use default Days of Week' box is unchecked.


Use Default Time Window

When this box is checked the settings made on the Schedule Tab - Threshold of the Threshold properties dialog will be used. Unchecking this box will enable the following fields to be used:


Whole Day

Sets the Threshold 'trigger' period to be between 12:00am and 11:59pm.


Start and End

Enter a specific start and end time during which the Threshold will 'trigger' when a defined condition is met. Outside of these hours the Threshold will not 'trigger'.


Use default Except These Dates

This field is used to enter specific dates that are to be excluded from the Threshold Condition schedule, e.g.  01 January (New Year's Day). That is, the Threshold Condition will not 'trigger' on these days.

When this box is checked the settings made on the Schedule Tab - Threshold of the Threshold properties dialog will be used. Unchecking this box will enable the data that has been entered into this field to be used.

 Click this icon to open the calendar to add a specific date that is to be excluded.

  Click this icon to remove the highlighted date from the field.

  Select this icon to re-open the calendar for modification of the highlighted date.


The above features are applicable to each individual Threshold condition. However, a schedule can be set that will apply to all conditions contained in the Threshold. This is done through the Schedule tab of the Threshold Properties dialog box. Here again, the days of the week, the time period and any days to be excluded from the Threshold condition checking can be set. If this option is used ensure that the Use default ... boxes on the Timing tab of the Threshold conditions dialog box are checked for each condition required.

When using Thresholds to send messages to Dispatch Manager it must be remembered that whenever the Threshold condition is exceeded, a message will be sent to all groups in the designated profile configuration within Dispatch Manager.

To avoid unnecessary or repetitive notifications it is best to pay special attention to the Thresholds Log Frequency field. This is not how often the Threshold checks for exceptions, it simply specifies that after a Threshold condition exception has occurred, at what frequency the Threshold should issue a message.

Provide feedback on this article