Skip to content

Rules

Rules determine condition states based on an input signal. Conditional rule state changes trigger an event status which is recorded to the event log, notifications are sent out, and the signal and asset statuses are updated in the application.

Rules offer the ability to run logic against a signal to determine a current condition of a signal. Signals may have multiple rules associated with them to look for different types of conditions and overall, the rule states provide the current conditions for an asset.

When a rule detects a new state, a state change event is recorded to the asset log, the rule state changes, and any associated notification subscriptions are triggered.

Rule States

Rules generate status events which are logged in the Asset Log and affect the connected Signals status and the overall Asset Status. In the application, Critical status (shown as red) takes preference over Warning status (yellow), which takes preference over OK status (green).

Event Status General Description
Ok

Condition state associated as being normal or good.

Warning Condition State used by some rules for noting that a condition is not normal or close too bad. This should be monitored appropriately or preemptive action taken.
Critical Condition State used by some rules for noting that a condition is bad and action should be taken immediately.
Informational Condition State used by some rules to provide information but is not associated as good or bad.
Error (Not Supported in the UI) There is an issue with the signal or rule that prevents the rule from actually determining the current state. Action is recommended.
Timeout The signal for a rule has not updated past a given timeout period meaning the rule can not appropriately provide a condition state.

Notifications Messages

Rule status events are recorded to an Asset's event log. In addition, notifications are sent out based on a user's notification preferences set up in their profile.

Rules may support additional custom messages that can be included in notifications. Each rule function supports this individually. The text entered in these fields is included in the notification messages sent out to users.

Notifications

Standard Rules

Threshold (Numeric type)

Allows user to configure the following thresholds for an input signal. If the value of the signal goes above / below these thresholds, the status changes (critical take preference over warning) and an event is created in the Asset log.

Overall Parameters

Parameter Description
Name The rule name used in the asset modify view.
Extra details for when value does not match Prefix text that is applied to Event messages (Log, Notifications) when there are no threshold parameters that are true.

Parameters for each Contains Match

Parameter Required? Description
Operation Required The logical operator used in the threshold calculation
A value to compare to Required The numeric threshold for the operation to compare to
Duration Type Required See below for Duration options. Default is 'Sustained Duration'.
Extra details for when value does match Optional Prefix text that is applied to Event messages (Log, Notifications) when this specific value has a match.

Duration Options

Duration Option Description
Once When selected the function will only evaluate the last signal value with the operator and threshold value.
Sustained Duration [Default] When selected the function will evaluate based on a time Duration and Duration Units. The signal value threshold operation comparison must stay true for this time duration for a state change.
Repeated When selected the threshold operator function will evaluate based on the number of continuous (Count) times the threshold operator is true in a row. If this count condition is met, it will cause a state change.
Repeated Over Time When selected, both a Count (number of times) and Duration (time period) are used. The function will look for the specified matching threshold operator count within the given duration for a state change.

Setting up parameters for the Threshold Rule

Example Chart Showing Sustained Thresholds Event Periods

Contains (String type)

A String signal type rule that will perform a substring search for the specified string value inside of the actual signal's last value.

Note that this Rule function supports multiple match conditions, each with it's own event level.

Overall Parameters

Parameter Description
Name The rule name used in the asset modify view.
Extra Notification Message text when no value matches Prefix text that is applied to Event messages (Log, Notifications) when there are no matches for the contains values.

Parameters for each Contains Match

Parameter Required? Description
The substring value to look for Required
Alert level for a matching value Required
Duration Type Required See below for Duration options. Default is 'Once'.
Prefix Notification Message text when a match is found Optional Prefix text that is applied to Event messages (Log, Notifications) when this specific value has a match.

Duration Options

Duration Option Description
Once Default Duration option. When selected the function will only evaluate the last signal value for a matching comparison.
Sustained Duration When selected the function will evaluate based on a time Duration. The signal value matching comparison must stay the same for this long for a state change.
Repeated When selected the function will evaluate based on the number of continuous (Count) times a matching comparison has been made. If this count condition is met, it will cause a state change.
Repeated Over Time When selected, both a Count (number of times) and Duration (time period) are used. The function will look for the specified matching comparisons count within the given duration for a state change.

Boolean (Boolean type)

Evaluates a Boolean signal type and allows setting a status for true and for false values.

Parameters

Parameter Required? Description
The Alert Level for True Required The severity level of the event status state change created when the signal value is true.
The Alert Level for False Required The severity level of the event status state change created when the signal value is false.
Duration Type Required See below for Duration options. Default is 'Once'.

Prefix Notification Message text when equal

Optional Pre-fix text that is applied to Event messages (Log, Notifications) when the value is true.

Prefix Notification Message text when not equal

Optional Pre-fix text that is applied to Event messages (Log, Notifications) when the value is false.

Duration Options

Duration Option Description
Once Default Duration Option. When selected the function will only evaluate the last signal value for a comparison.
Sustained Duration When selected the function will evaluate based on a time Duration. The signal value must stay the same for this long for a state change to occur.
Repeated When selected the function will evaluate based on the number of continuous (Count) times the same value has been sent. If this count condition is met, it will cause a state change.
Repeated Over Time When selected, both a Count (number of times) and Duration (time period) are used. The function will look for the specified count of the same value within the given duration for a state change.

Is Equal To (Numeric type)

Allows a user to set a value to compare a numeric value against. If any match it will set the status to whichever status value was set for that comparison.

Parameters:

Parameter Required? Description
Value to compare to Required The value the rule will compare to the current signal value.
The number of decimal places to check Required The function will compare the signal value to this many decimal places. Default is 1.
The alert when equal Required The severity level of the event status state change created when there is an equal comparison.
Duration Type Required See below for Duration options. Default is 'Once'.

Prefix Notification Message text when equal

Optional Pre-fix text that is applied to Event messages (Log, Notifications) when the comparison is true.

Prefix Notification Message text when not equal

Optional Pre-fix text that is applied to Event messages (Log, Notifications) when the comparison is false.

Duration Options

Duration Option Description
Once Default Duration Option. When selected the function will only evaluate the last signal value for a comparison.
Sustained Duration When selected the function will evaluate based on a time Duration. The signal value must stay the same for this long for a state change.
Repeated When selected the function will evaluate based on the number of continuous (Count) times the same value has been sent. If this count condition is met, it will cause a state change.
Repeated Over Time When selected, both a Count (number of times) and Duration (time period) are used. The function will look for the specified count within the given duration for a state change.

Configuring the Is Equal To standard rule


Last update: April 10, 2021