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:
- On the map, click the asset. This opens both the Asset Details view and the Timeline view.
- In the Assets view, select the asset from the list.
The Event Timeline shows:
- The asset identifier at the upper left corner.
- Event filter buttons at the top of the Timeline view:
- Click to remove 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 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)|
|Stop: Asset not moving|
|Cargo: Asset cargo state change (Cargo Present).|
|Temperature: Temperature reading as well as temperature events and configured temperature range, if available.|
|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.
- 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.
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.
- Bar shows a lighter shade when the event is on going; 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:
- 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.
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, 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.
- Extended stopover
- Humidity out of range
- Humidity back in range
- Temperature out of range
- Temperature back in range
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 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.