Events 2.0

Event alerting includes event configuration and event reporting. You define and manage event alerting rules using the Event Rules view and view active events and alerts on the Asset Alerts dashboard.

This section describes the functions of Event Rules in detail. For event reporting, see Asset Alerts dashboard.

Event rule examples

When an event rule is evaluated, all of its configured asset conditions and exceptions are evaluated. For rules without configured asset exceptions, the selected action will be taken only when all the asset conditions are satisfied. For rules with asset exceptions, the selected actions will be omitted only when all exceptions are satisfied.

Example 1: Event rule without exceptions

This rule specifies that if the Door Open event is detected when Asset-A is in Geofence-A, raise an alert.

Event type: Door Open/Close. Asset condition 1: Asset Identifier is Asset-A; Asset condition 2: Asset Location is Geofence-A; No exceptions; Action: Alert when door is open.

When this rule is evaluated, only if the data matches both conditions above would alerts be raised; that is,

Example 2: Event rule with exceptions

This rule specifies that for all assets, if the Door Open event is detected, raise an alert except for Asset-B when found inside a geofence.

Event type: Door Open/Close. All Assets; no asset conditions; Asset exception 1: Asset Identifier is Asset-B; Asset exception 2: Asset Location is in Geofence X; Action: Alert when door is open.

When this rule is evaluated, only if both exceptions above are satisfied would the specified action, Alert, be left out; that is,

Add an event rule

In the Event Rules view you can find all the system-defined event types. To define an event rule means to specify a set of conditions under which you want to be alerted if the event occurs. For each rule, you can:

If you are not interested in a particular event type, you do not need to configure any rules for that event type (see Unconfigured event types).

Cargo Loaded/Unloaded events

When defining an event rule for the Cargo Loaded/Unloaded events, keep in mind that cargo events cannot be detected when the asset door is open. For example, consider the following scenario:

  1. You define a rule that will alert you on the Cargo Unloaded event for asset X.
  2. Asset X arrives at its destination and is unloaded.
  3. The asset door is left open for an extended period of time after the unloading is completed.

In this case, you won't receive any alert of the Cargo Unloaded event until the asset door is closed.

Adding an event type rule

  1. Click Event Rules on the main menu.
  2. Under System Events, select the event type you want to configure, for example, Door Open/Close.
  3. Click Add Event Type Rule. Note that some event types include multiple events; for example, the Door Open/Close event type includes the Door Open and Door Closed events. You may want to create an event rule for each event.
  4. In the Add Event Type Rule window, enter a name for this rule in the Name field.
  5. The Add Rule section allows you to specify asset conditions, asset exceptions, and actions to perform when the rule triggers. If you want this alert raised for all assets, go to step 9.
  6. If you want to restrict the alerts to certain assets, you will want to add conditions:
    • Click Add Asset Condition.
    • In the three selection boxes, the left box lets you choose the type of asset condition. Click and select a condition type from the dropdown list. By default, Asset Identifier is selected.
    • Depending on the type of asset condition selected, you will need to complete either one or two more selection boxes.
    • The second selection box configures how the asset condition type will be used. Each asset condition type will have different options in the second selection box. Click and select from the middle box list.
    • If a third selection box is present, you need to choose the acceptable values for your condition. Click to display the selections and choose as many items as needed.
  7. To define additional asset conditions, click Add Asset Condition and repeat the last step.
  8. If your conditions are generic and you need to prevent certain assets from generating alerts, you will want to add exceptions. Click Add Asset Exception. Note: To be excluded from this rule, all exceptions need to be satisfied.
    • Setting an exception works the same way as setting a condition. You can select multiple exceptions by clicking Add Asset Exception to add another row.
    • For more information, see Event rule examples.
  9. If you prefer delaying the alerts, under Preferred delay before alerting, select a delay time from the dropdown lists.
  10. Note: When the event occurs, if all the conditions are satisfied and not all of the exceptions are satisfied, the actions you select will be performed. If Alert is selected, this means that after the selected delay time:
    • The asset marker turns red.
    • An alert is added to the asset Status panel of the asset Details tab.
    • The event is added to the Asset Alerts dashboard.
  11. Check the Alert box to have alerts displayed.
  12. Check the Send Email box to receive the alert via email.
    • Enter or select an email address in the text box.
    • Add additional email addresses if needed.
  13. Review your rule to ensure it makes sense. When ready, click Add Rule at the bottom.
  14. To change the priority of this rule, use the arrow buttons on the right. For more information, see the section below.
  15. In the Event Rules window, click Save Changes.

Priority of an event rule

Event rules are evaluated in the order they appear in the Event Rules view. If you have more than one rule defined for an event type, each rule's position in the list indicates its priority: the rule on the top has the highest priority and the one at the bottom the lowest.

In general, you should arrange your rules from the most specific to the most general; that is, give the highest priority to the rule with the most specific conditions and the lowest priority to the most general rule. For example, if the following three rules are defined under Cargo Loaded/Unloaded,

  1. Alert for one specific asset, Asset-X
  2. Alert and email for a few selected asset types
  3. Alert for all assets

Arrange the rules in the above order in the Event Rules view, with Rule #1 at the top and Rule #3 at the bottom. At processing time, Rule #1 will be evaluated first. If the asset involved is Asset-X, processing is completed at the end of Rule #1; otherwise, Rule #2 will be evaluated. If the asset involved matches the condition in Rule #2, processing is completed at the end of Rule #2; otherwise, Rule #3 is applied and so on.

Changing rule priority

You can change the priority of a rule using the arrow buttons on the right.

  1. Click Event Rules on the main menu.
  2. Under System Events, select the event type.
  3. Click the up arrow to increase a rule's priority, or the down arrow to decrease its priority.
  4. Click Save Changes at the bottom.

Change an event rule

You can change any rule under any event type.

  1. Click Event Rules on the main menu.
  2. Under System Events, select the event type.
  3. Click the rule you want to edit.
  4. In the edit window, you can
    • Edit the name of the event type rule.
    • Add asset conditions.
    • Remove asset conditions.
    • Check Send Email to add email notification. Click and select email addresses in the box, or type an email address in the box.
    • If you remove all email addresses from the box, uncheck the Send Email box.
    • Under Except if, add or remove asset exceptions.
  5. Click Update Rule.
  6. Click Save Changes.

Remove an event rule

You can remove any rule under any event type. Note: If your assets have any active events based on this rule, removing the rule will remove those events.

  1. Click Event Rules on the main menu.
  2. Under System Events, select the event type.
  3. Click the rule you want to remove.
  4. In the popup window, click the garbage can.
  5. Click Save Changes.

Resolve error conditions

If you see a warning icon next to an event rule, that means an error has been detected and one or more conditions in the rule definition are no longer valid.

An invalid condition is a condition that is impossible to reach. For example, the following situation will result in an invalid condition:

  1. An asset type is included as an event condition.
  2. The asset type is then deleted from the Radar Dashboard.

To fix such errors,

  1. In the Event Rules view, select the rule to open the edit window.
  2. In the edit window, a warning icon identifies the condition that contains an error. The erroneous selection has been removed. You need to
  3. Click Update Rule.
  4. Click Save Changes.

Unconfigured event rules

If you are not interested in a particular event type, you do not need to configure any rules for that event type. Most unconfigured events will still appear on the Radar Dashboard when detected. You will see their event markers on the map and information in the Timeline view, but you will not be alerted on the Asset Alerts dashboard or via email. The following events are the exceptions, which require configuration: