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

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 Event Timeline shows:


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)
button_stop Stop: Asset not moving
button_cargo Cargo: Asset cargo state change (Cargo Present).
button_temp Temperature: Temperature reading as well as temperature events and configured temperature range, if available.
button_humid Humidity: Humidity reading as well as humidity events and configured humidity range, if available.

The following example has Geofence, Stop, 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.

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.


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, this Downloads folder contains a few event 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 that in the example above, "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 temprature or humidity indication similar to the example below, your temperature and humidity alerts are not configured.

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.