Configuring events and alerts

An event is an asset condition that the Dashboard brings to the user's attention; for example, the time an asset stops moving. An alert is an event that meets the user's specified alert configuration; for example, temperature falling out of a specified range. An alert will also trigger a notification to registered recipients.

When an alert is raised, the asset marker on the map turns red to highlight the condition. You can click the red marker to see alert details. For more information, see Understanding events and alerts.

For a user to receive an alert notification, the following are required:

Events and alerts

The Dashboard application reports a variety of events on the Dashboard: on the map, in the Asset Details view, and in the Event Timeline. Some of the events are enabled by default and are always reported. A few events require configuration.

Most events have corresponding alert conditions. For example, there're two events associated with door status: Door Open and Door Closed. "Door open" is an alert condition, which would trigger an alert notification email when enabled. An alert notification email is only sent when the alert is enabled.

The following events are enabled by default. If not configured, any detected events will still be reported on your Dashboard, but no conditions will be highlighted, nor any notifications sent.

The following events require alert configuration to be activated. When you configure these alerts and when a specified condition is detected, the corresponding alert will be highlighted both in the Asset view and on the map, and the alert recipients will receive an email notification regarding the alert.

Event colors

Events are represented in three different colors.

To manage alerts and alert notifications, you can:

Configure or modify alert settings

You can configure alerts to be raised when certain conditions are detected. When an unexpected condition (such as an open door or out-of-range temperature) is detected, an alert is raised and highlighted with:

Alerts you can configure

The alerts you can configure are as follows:

Note: These alerts may not apply to all assets.

There are three ways to configure or modify alert conditions:

Configure alerts for an asset type

  1. Open the Asset Types view.
  2. Open an asset type. Under Alert On, check the alert boxes you want to include. Select values where applicable (see example).
  3. Click Save Changes.

Modify alert settings for a geofence

  1. Open the Geofences view.
  2. Click on the geofence to open it. In each geofence, you can set or override existing alert settings for specific asset types.
  3. Under each asset type are three checkboxes. Check the boxes you want:
    • Alert on enter
    • Alert on exit
    • Override alerting
  4. The Override alerting box opens more checkboxes. Check the alert boxes you want to include. Select values where applicable (see example).
  5. Scroll to the bottom and click Save Changes.

Modify alert settings for an asset

  1. Open the Assets view.
  2. Click on the asset to open it.
  3. Click Options to open the Options tab.
  4. Check the Override alerting box. Check the alert boxes you want to include. Select values where applicable. Note: An asset that is associated with a Radar-L module has fewer alert options. See examples:
  5. Scroll to the bottom and click Save Changes.

Enable alert notification for a user

You can enable alert notification for registered users of the BlackBerry Radar Dashboard, or for unregistered, external users. Alert notifications are sent to users through email.

Note: Alerts must be configured before they can be raised and any notifications sent.

  1. Open the Alerts view.
  2. Click the alert you want to set notification for.
  3. To enable a registered user, select the user from the User Account dropdown list and click Add New User Recipient.
  4. To enable an external user, enter the user’s email address and click Add New Email Recipient.

Disable alert notification for a user

To disable alert notification for a user:

  1. Open the Alerts view.
  2. Click the alert you want to disable notification for.
  3. Click Delete under the user’s email address.
  4. Click Yes in the confirmation dialog box.