Custom Event Setup

Settings > Engine Diagnostics > Custom Event Setup

PREREQUISITE: Companies must have Engine Diagnostics licensing to use this screen.

Administrators use custom events to monitor against specific driver activities, such as hard breaking, excessive idling, and low fuel. These events consist of multiple engine data filters with threshold values associated. Expression-based logic (And/Or) is then applied to trigger the eventEngine data recorded by TrackIt that includes fault codes and driver behaviors like hard braking. for a vehicleAll machines used as a means of production on a construction site or at a batch plant. when one or more conditions are met.

These events are used when establishing an Engine Config Setup and with setting Driver Goals.

Custom Event Setup screen

Setting up a Custom Event can be compared to setting up Alerts. However, while an Alert can be acknowledged and sent away, a Custom Event behaves differently in that the notification sent can be configured to only disappear when certain parameters are met. The type of notification for a Custom Event can be configured on the Driver Messages tab on the Results tab when adding or editing an Event.

Name

Name or description of the event.

In Use

This column shows a Yes or No value depending on if the event is assigned to an engine configuration.

Max Occurrence

The maximum number of times the event can be triggered before notifications will be sent to the server for the event.

Notify Dispatch

When the event is triggered, a True value in the column indicates a notificationA software-generated message or warning triggered by vehicle data. will be sent to dispatch. A False value indicates that dispatch will not receive a notification about the event.

Notify Email

This column shows whether or not an email will be sent to an email group when the event is triggered.

Adding custom events

Custom events are invaluable for providing insight into a driver's activities and the state of a piece of equipmentAll machines used as a means of production on a construction site or at a batch plant.. Without the proper criteria for events and filtering for the data received, you run the risk of incomplete and inaccurate data reporting. Therefore, as you configure an event, consider the goal of the event and how to best establish the criteria conditions under which it is triggered.

In the Event tab, you describe the event and set the criteria for triggering the event.

Name

A short description of the event to help identify it's purpose.

Driver Performance Event

Flags the event as pertinent to driver performance tracking functionality.

Selected check box

Selected

The event appears as an Infraction in the Driver Goal dialog windowA pop-up window that requires user input. and will also display on Driver Performance reports. It will be made available from a list of other engine events.

Cleared check box

Cleared/
Unchecked/
Deselected

The event is not treated as a driver performance goal and will not display on performance-related reports.

Probe Event

Controls whether event occurrences appear on ProbeA probe device mounted in the side of a bin to measure the moisture content of aggregate materials such as sand.-related reporting.

Selected check box

Selected

Checking this indicates the event is associated with the probe. Each occurrenceA single incident or event recorded by TrackIt. when the event is triggered will display on the Load Properties report.

Cleared check box

Cleared/
Unchecked/
Deselected

The event is not Probe-related and will not appear on associated reports.

Use Expressions

Creates additional functionality for handling multiple filters that trigger an event.

Selected check box

Selected

Changes the filterA search tool that restricts data queried based on factors like equipment type, employee groups, and date ranges. options for the event by including Parens and And/Or columns. The addition of parentheses allows for the grouping of multiple filters. This means that each filter included in the same set of parentheses must be triggered to trigger an event occurrence.

Cleared check box

Cleared/
Unchecked/
Deselected

Parentheses will not be added to filters.
Filters

Each event consists of one or more filters that act as the required criteria for triggering an event occurrence. The filter types selected here will indicate what behavior must occur before the event will occur.

Parens

Signals where the expression begins and ends.

These columns only appear when Use Expressions is selected.

Filter

Defines what kind of data to check for the event criteria. This filter determines what value measurement the event will be based on, such as fuel levels, hard braking, and hard acceleration.

Operator

Provides a comparison between the Filter and Value fields.

For a Hard Acceleration event, the operator signals the system to check if Wheel Based Acceleration is Greater Than the amount entered into the Value field.
Value Sets a numeric quantity for the Filter in determining at what point the event should trigger.
On Delay(s) Indicates how many seconds the event will be delayed from triggering once the event criteria has been met.
Off Delay(s)

Indicates how many seconds after the event criteria is triggered that the event will turn off.

And/Or

Sets how multiple filters should be grouped or viewed independently when triggering an event.

This column only appears when Use Expressions is selected.

And

Choosing And will allow you to continue to add additional filters to the expression. Each filter must be met to trigger the event.

Or

Choosing Or allows you to add an alternative filter to the previous expression. Only one filter must be met to trigger the event.

From this tab, you indicate the return values that will show up in the Engine Events report, the Driver MessagesText messages exchanged between drivers and dispatchers using TrackIt., Dispatch Notification, and sometimes StatusThe specific activity or task a driver is currently engaged in, typically as part of a process called a "status loop." Changes. Additionally, you use this tab to set up when the event is saved and how often the event can occur.

Save Event when

Options for choosing when the event will be saved to the TrackIt system. For certain events, saving the event after it turns off provides more relevant information. This is also sometimes true when the event is turned On or both when the event turns On and Off.

Max Daily Occurrences

Usually, the maximum number of times the event can be triggered before it will no longer be triggered.

Each occurrence will contribute to the Max Daily Events, which is set at a value of fifty. So, once the Max Daily Events threshold has been reached, alerts will no longer trigger. This could cause an event to stop triggering before its individual daily occurrences have been met.

When an event is triggered, certain values can be saved with the event and appear on the Engine Events report. These values can represent data types such as Engine Speed (RPM), Odometer (Miles), probe data, and other vehicle data recorded at the time of the event.

When the return values are added to an event, they should be for the purpose of getting additional details about the event. For example, if you add a Hard Acceleration event, we recommend that you also return values of road speed, truck status, wheel-based acceleration, and accelerator pedal position.
  1. Under the Return Values tab, click the Add Row button.
  2. Select the desired value from the drop-down menu that appears.
  3. Repeat this process for each value you want to include.
  4. Click the Delete button to get rid of unwanted values.
  5. Continue to create your custom event or click Save & Close .

Each time an alertA software-generated message or warning triggered by vehicle data. is triggered for a driver, a messageText messages exchanged between drivers and dispatchers using TrackIt. can be sent with the alert that appears on the driver tablet. The message entered into the message field can more clearly communicate why the alert was triggered and what the driver should do in response, if anything.

Message Type

Allows you to choose how to inform the driver of the severity of the event.

  • None
  • Warning
  • Critical

On

When the event turns on, the fields below allow you to configure how the message will display.

Visual Display

Controls whether the message displays on the driver tablet.

Selected check box

Selected

Displays the message on the tablet screen when the event turns on.

Cleared check box

Cleared/
Unchecked/
Deselected

Does not display the message on the tablet screen.
Audible Noise

Controls the use of an audible tone that can play on the driver tablet. when the event triggers.

Selected check box

Selected

Plays an audible beep on the driver tablet when the event is triggered.

We recommend selecting this option if the Visual Display option is also selected.

Cleared check box

Cleared/
Unchecked/
Deselected

No audible beep is played on the driver tablet when the event triggers.
Message

Enter the message text that the driver will see displayed on their device when the event is triggered.

This message will only appear if the Visual Display or Alert Bar Display options are selected.
Off When the event turns off, the fields below allow you to configure how the message will display.
Visual Display

Controls whether the message displays on the driver tablet.

Selected check box

Selected

Displays the message on the tablet screen when the event turns off.

Cleared check box

Cleared/
Unchecked/
Deselected

Does not display the message on the tablet screen.
Audible Noise

Controls the use of an audible tone that can play on the driver tablet. when the event stops triggering.

Selected check box

Selected

Plays an audible beep on the driver tablet when the event is no longer triggered.

We recommend selecting this option if the Visual Display option is also selected.

Cleared check box

Cleared/
Unchecked/
Deselected

No audible beep is played on the driver tablet when the event stops triggering.
Message

Enter the message text that the driver will see displayed on their device when the event is turned off.

This message will only appear if the Visual Display or Alert Bar Display options are selected.
Alert Bar Display

Controls whether the message appears as a red notification bar at the bottom of the driver tablet screen.

Selected check box

Selected

The message displays at the bottom of the driver tablet screen as a red notification bar.

Cleared check box

Cleared/
Unchecked/
Deselected

The message does not appear as a red notification bar.

A key part of using events properly is making sure the correct parties are aware of relevant information in a timely manner. From the Notification tab, you can adjust how each specific alert will be communicated to dispatch and other groups that may need to be aware of certain information.

Severity

Classifies the severity of the event and determines which symbol icon to use if displayed on the Equipment Map screen.

Show on map

Replaces the vehicle icon on the Equipment MapA map view that tracks the locations and statuses of individual equipment in a fleet. The dispatcher's equivalent to a "bird's-eye view." screen with the severity icon.

Email Group

Specifies who will receive an email notification for the event. Adding a row using the button will allow you to choose an email group from a drop-down menu. You may add multiple Email Groups as needed to the event.

This tab may only be used when the Show ED Event Status Change option is set to True.

Vehicle Type

Lists available vehicle types that may be applied to the event.

On

Provides a list of statuses associated with the Equipment Type. The status chosen here indicates the starting status in the status loopA series of statuses that constitute the typical process a driver should progress through as part of their daily duties. when the event may be triggered.

Off

Lists statuses associated with the Vehicle Type. This Off status indicates after which status the event cannot trigger.

For example, if you chose the To Job status as the On status and the At Plant status as the Off status, the Custom Event would only be allowed to trigger when the driver selected the To Job status and any status up until the At Plant status.