Understanding events and alerts

The Event Timeline view provides a bird's-eye view of all events that have occurred with a given asset during a specified time range. It allows one to easily call out areas to focus on and identify correlations between the events, for example, identifying times when an asset has breached the temperature thresholds that have been set.

The user can easily define which parameters are visible in the timeline view and choose a custom range or quickly access a predetermined range with a simple tab choice.

The Event Timeline view

Depending on the type of module an asset is associated with, you may see a different Timeline view in different assets.

A BlackBerry Radar-M module allows your asset to monitor and report the following events:

A Radar-L module allows your asset to monitor and report the following events:

The “Door” events are not applicable to assets of the following Asset Class:

Timeline view - Radar-M

Timeline view - Radar-L

For a detailed description of the Event Timeline view, see:

View the Event Timeline

You can open the Event Timeline view in one of the following ways:

The Timeline view opens at the lower half of the application window.

The Timeline view shows:

The example above includes Stop, Cargo, and Temperature events as well as Humidity values. See Interpret the Timeline view for more information.

Filter events

You can filter events on the timeline using the event buttons at the top of the Timeline view. By default, the Event Timeline view includes all events. The event buttons are toggles. You can click any button to show or hide the corresponding events from the display graph.

The following table describes the event buttons:

Event button Description
button_geo Geofence: The geofence that the asset is in.
button_door Door: Asset door state change (Door Open). Not applicable to some asset classes such as chassis.
button_stop Stop: Asset not moving. Includes Extended Stopover alert when configured.
button_cargo Cargo: Asset cargo state change (Cargo Detected). Not available in Radar-L modules.
button_temp Temperature: Temperature reading as well as temperature events and configured temperature range, if available. Not available in Radar-L modules.
button_humid Humidity: Humidity reading as well as humidity events and configured humidity range, if available. Not available in Radar-L modules.

The following example has Cargo, Temperature, and Humidity events filtered out. The corresponding buttons change color to grey and the events are hidden from the graph.

Set event time range

By default, the Event Timeline view displays all events and alerts that have occurred today. You can select a different time range--the past 48 hours, the past week, or a custom range. The Timeline view supports a custom range of up to two months.

  1. To select a custom time range, click Custom.
  2. Click the calendar button on the left.
  3. Select the start time: select the date, hour, and minute in each window that appears.
  4. Use the arrow buttons to see more choices.
  5. Click the calendar button on the right.
  6. Select the end time: select the date, hour, and minute in each window that appears.

Note: The maximum time range you can select is two months. If you select a time range larger than two months, the Timeline view automatically adjusts the range to two months.

Here's an example of a custom-selected time range:

Interpret the Timeline view

The event timeline presents the history of an asset's events and alerts in color and along a selected time range. You can select any time range, up to a period of two months, to see the events and alerts that occurred in it. Move your cursor over any event to see details.

The example below explains the event details:

Zooming in and out

Within the selected time range, you can zoom in or out as you do in the map:

This is helpful especially when you have a long timeline. The example below has a timeline of 30 days, and is zoomed in to highlight one afternoon.

Zooming in on a specific event

To zoom in on a specific event, you can click the event in your Timeline view. This will

When you click on a current event on the map, you will see similar results.

How events are represented

Two types of representation are used to describe the events in the Timeline view:

Note: If you don't see the green vertical bar in the temperature or humidity area in your timeline, you don't have them configured for this asset. To check temperature or humidity event configuration, see Temperature and humidity event configuration.

Cargo events

The Cargo row shows cargo events as well as the cargo percentage when a change in cargo amount is detected. For example, in the following screenshot, the Cargo row indicates a cargo status change from 20% to 40%, then to 75%. If you hover over a percentage indication, you can see more details about the change.

When cargo status changes, a "Cargo changed" event is raised. When cargo is unloaded, a "Cargo unloaded" event is raised and the cargo bar is cleared. You can download all the events shown in Timeline and view the detailed event description, including any cargo percentage changes, in a CSV file. See Download events in Timeline below.

Download events in Timeline

You can download the events in the selected timeline in a comma-separated values (.csv) file. This file presents the timeline of events in tabular format and can be opened in spreadsheet software such as Microsoft Excel.

  1. Click timeline_download.
  2. Go to your downloaded file location. The downloaded file is a .csv file with a file name of "asset_[id]" followed by the date and time of the download; for example, here are a few downloaded files for Assets IG8187 and GO9788:

Below is a downloaded CSV file and its corresponding Timeline view. The numbers in blue in both pictures indicate the corresponding sequence of events.

Events that require configuration

For the following events and alerts to be reported in either the downloaded CSV file or the Timeline view, they must be configured.

Note: For assets that are associated with Radar-L modules, only "extended stopover" (when configured) is available.

Note that in the example above, the "Extended Stopover" alert was configured as 15 minutes and the alert was raised when the threshold was crossed. In the example below, the "Extended Stopover" alert was not configured. As a result, the "Stop" event didn't trigger any alert (no checkerboard in the "Stop" event bar). Note also the configured temperature alert and unconfigured humidity alert.

Temperature and humidity event configuration

Reporting of temperature and humidity out-of-range events requires configuration. If you see temperature or humidity indication similar to the example below, your temperature and humidity alerts are not configured.

Note: Temperature and humidity readings are not available to assets that are associated with Radar-L modules. This configuration doesn't apply to these assets.

Alert configuration is set for each asset type. Check your alert setting under the asset type of your asset. See Retrieve asset type information.

If your asset is in a geofence, its event timeline is also affected by the alert settings under that geofence. See View geofence information.

To set temperature or humidity alerts, contact your Radar Dashboard administrator. Alternatively, you may configure these alerts for an individual asset in the Asset view. Changes made in the Asset view override any other alert configuration for this asset.

In the next example, temperature alert is enabled while humidity is not.