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:
- Door state
- Asset movement
- Cargo state
A Radar-L module allows your asset to monitor and report the following events:
- Door state
- Asset movement
The “Door” events are not applicable to assets of the following Asset Class:
- Light vehicle
- Heavy equipment
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:
- Click the asset marker on the map, or
- Select the asset in the Assets view.
The Timeline view opens at the lower half of the application window.
The Timeline view shows:
- The asset identifier at the upper left corner.
- Event filter buttons at the top of the Timeline view:
- If you asset is associated with a Radar-L module, you may see only the first three event buttons.
- If your asset has the following Asset Class, the “Door” button is not applicable.
- Light vehicle
- Heavy equipment
- Click any button to hide corresponding events from the timeline. See Filter events.
- Event timeline commands at the upper right corner:
- : Download events in timeline. Button turns blue when selected; remains grey otherwise.
- : Locate the asset on the map. Button turns blue when selected; remains grey otherwise.
- : Minimize Timeline view.
- : Close Timeline view.
- Time range buttons. Click to select a preferred range. Default range is Today.
- Events retrieved.
- The Radar-M module presents geofence, door, stop, cargo, temperature, and humidity readings and events.
- The Radar-L module presents geofence, door, and stop events.
The example above includes Stop, Cargo, and Temperature events as well as Humidity values. See Interpret the Timeline view for more information.
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:
|Geofence: The geofence that the asset is in.|
|Door: Asset door state change (Door Open). Not applicable to some asset classes such as chassis.|
|Stop: Asset not moving. Includes Extended Stopover alert when configured.|
|Cargo: Asset cargo state change (Cargo Detected). Not available in Radar-L modules.|
|Temperature: Temperature reading as well as temperature events and configured temperature range, if available. Not available in Radar-L modules.|
|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.
- To select a custom time range, click Custom.
- Click the button on the left.
- Select the start time: select the date, hour, and minute in each window that appears.
- Use the arrow buttons to see more choices.
- Click the button on the right.
- 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:
- Place your cursor inside the graph
- Use your mouse scroll wheel or trackpad scroll gesture to zoom in or out
- When zoomed in, click and drag across the display to see other sections of your timeline.
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
- Highlight the time period when that event is active, along with any other events that might be happening at the same time
- Zoom in on and highlight the event on the map
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:
- Horizontal bars represent Geofence, Door, Stop, and Cargo events:
- Length of the bar indicates the duration of the event.
- A bar in a solid color indicates that alert condition is either not detected or not configured. For example, in the image above, the second "Stop" bar means that a 15-minute extended stopover alert was configured and that the alert was triggered when the 15-minute threshold was crossed.
- A bar with a checkerboard pattern indicates that an alert has been triggered. Length of the checkerboard indicates the duration of the alert state.
- The "Cargo" event is shown with a checkerboard pattern if cargo alerting is enabled when the cargo is unloaded. In this example, the second "Cargo" bar indicates that cargo alerting was enabled and triggered, whereas the first bar indicates no alert condition. Note: "Cargo" events are only available to assets with Radar-M modules.
- Bar shows a lighter shade when the event is ongoing; note that in the example, both the "Door" event and the "Stop" event are on-going, the right end of both events touching the red line (current time).
- Bar takes on a deeper shade when the event is completed. Note that in this example, the "Door" event is completed.
- You can hover over any bar to see event detail.
- Vertical bars and dots along the bars represent Temp (temperature) and Humid (humidity) information. Note that this information is only available to assets with Radar-M modules.
- The green vertical bar represents the configured temperature or humidity alert range.
- The red or black dot indicates the temperature or humidity value, as well as its position along (in range), or distance from (out of range) the configured range. In the examples below,
- You can hover over any red or black dot to see details, including the configured range and the reported value.
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.
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.
- Click .
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.
- Extended stopover
- Humidity out of range
- Humidity back in range
- Temperature out of range
- Temperature back in range
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 Asset view, click the Options tab.
- Check Override alerting.
- Check the Temperature or Humidity box.
- Move the dials to set the range (see example).
In the next example, temperature alert is enabled while humidity is not.