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 and the location history dot turn red to highlight the condition. You can click the red location history dot to see alert details.

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:

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, you can check the boxes to set the following alert conditions (see example):
    • Door: Raise an alert when the door is open.
    • Cargo: Raise an alert when cargo is unloaded.
    • Low battery: Raise an alert when battery is low.
    • Extended stop over: Raise an alert when the asset hasn’t moved for the length of time indicated by the selections. Click each box and select the value you need from the dropdown list.
    • Temperature outside range: Raise an alert when temperature is out of the specified range. Click and drag the blue dials to modify the temperature range.
    • Humidity outside range: Raise an alert when humidity is out of the specified range. Click and drag the blue dials to modify the humidity range.
  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 boxes you want to include in alert notifications (see example):
    • Door: Raise an alert when the door is open.
    • Cargo: Raise an alert when cargo is unloaded.
    • Low battery: Raise an alert when battery is low.
    • Extended stop over: Raise an alert when the asset hasn’t moved for the length of time indicated by the selections. Click each box and select the value you need from the dropdown list.
    • Temperature outside range: Raise an alert when temperature is out of the specified range. Click and drag the blue dials to modify the temperature range.
    • Humidity outside range: Raise an alert when humidity is out of the specified range. Click and drag the blue dials to modify the humidity range.
  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 boxes you want to include in alert notifications (see example):
    • Door: Raise an alert when the door is open.
    • Cargo: Raise an alert when cargo is unloaded.
    • Low battery: Raise an alert when battery is low.
    • Extended stop over: Raise an alert when the asset hasn’t moved for the length of time indicated by the selections. Click each box and select the value you need from the dropdown list.
    • Temperature outside range: Raise an alert when temperature is out of the specified range. Click and drag the blue dials to modify the temperature range.
    • Humidity outside range: Raise an alert when humidity is out of the specified range. Click and drag the blue dials to modify the humidity range.
  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.