To stay informed on fleet activity, create alerts for the events that matter most to you and your administrators. To minimize alert fatigue, consider a narrow scope where you alert contacts in a need-to-know and requires-immediate-action approach.
To manage workflows you must have a Full Admin role or custom role with the following Alerts permissions as needed:
For more information on permissions, see Administrative Access and Permissions.
There are two versions of Samsara alerts: v1 and v2. The workflows to configure alerts for both versions are similar but have slight differences. Refer to Alert Triggers to learn more about all alert types and the following topics on how to create alerts for each version:
-
Select the Alerts (
). -
+ Create Alert.
-
Select a trigger for which you want to create an alert. If desired, use the Search to narrow the list of triggers.
-
Enter a descriptive name for your alert configuration.
-
Define the trigger settings:
-
Define the condition under which you want to raise an alert.
The specifications for each trigger differ based on the trigger type:
-
Event-based: An event occurred (for example, a DVIR is submitted)
-
State-based: An asset is in a particular state (for example, a gateway is disconnected)
-
Metric-based: A metric crossed a user-defined threshold (for example, the vehicle speed is above 70 mph). For metric-based triggers, you must also define the threshold. For example, for the Speed Above Limit trigger, you specify the speed threshold.
-
-
Define the minimum duration (seconds, minutes, or hours) for which the condition must hold to trigger an alert.
For all state-based and metric-based triggers, you can configure the duration between 0 to 3 days. Duration is not available for event-based triggers since they occur once.
-
Specify the source for the trigger: a selection of specific objects, a group of objects (identified using Tags), or all objects.
For example, you can apply the alert configuration to specific groups of vehicles or drivers.
-
(Optional) Limit the alert configuration by additional criteria (choose one).
-
Add Geofence: Trigger an alert only when the vehicle or asset is inside or outside a geofence location.
-
Add Engine On/Off: Trigger an alert only for specific engine states.
-
-
(Optional) Specify the time range during which the alert notification is relevant.
By default, an alert configuration is always active. If you want the alert to trigger only during a specific time range select Edit.
The configuration can be Active between where Samsara only sends notifications when conditions trigger during specified days and time period, or Inactive between where Samsara only sends notifications when conditions trigger outside a specific time range.
-
-
Define one or more actions you want to initiate when the trigger conditions are met.
The following notifications options are available:
-
Email or push notifications using SMS: By default, notifications are sent via both email and text if both an email address and phone number are provided. Select the email icon or push notification (SMS) icon next to the alert contact to selectively disable notification using the specific method.
If needed, you can define a New Contact. You also Manage Contacts to jump to the Alerts Contacts page where you can edit the email or phone number of an existing contact.
If you need to remove a contact, select the x to the right of the notification method icons.
-
Slack notifications: Click Add Action > Send Slack Notification and choose an existing Slack integration to which you want to send notifications or Manage to set up or modify a Slack integration.
-
Webhook notifications: Click Add Action > Send Webhook and choose an existing Webhook configuration to which you want to send notifications or Manage to set up or modify a Webhook integration.
To remove an action, hover over the action and click the trash (
) icon. -
-
Save the alert configuration.
-
After you save your configuration you can return to the Alerts > Configured Alerts page at any time to enable, disable, or delete the configuration.
You can also review specific incidents on the Alerts > Alerts Incidents page. See View Alert Incidents.
Notice
Each alert supports a max of 4000 devices.
-
Select Alerts (
). -
Select Create Alert.
-
Select a trigger for which you want to create an alert. If desired, use the Search to narrow the list of triggers.
-
Configure the settings for the alert.
Settings vary by alert type, but typically include the conditions under which Samsara should send the alert and the specific devices for which you are configuring the alert. In addition, your alert configuration can include:
-
Alert Schedule: Designate time range and days of the week during which you want to Enable or Disable notifications. Click + Add range to assign multiple schedule configurations.
-
Send Alert To: Choose one or more contacts in your address book to whom you want to send the alert. You can also add New or Manage existing contacts. For more information on adding alert contacts, see Manage Alert Contacts.
The contacts that appear in the contact book are a mix of manual entries and user accounts that have access privileges to view the type of alert. Manual entries are identified by an address book icon and user accounts that have access are identified by a circular profile image (or a randomized color and first initial, if no profile picture is provided).
-
Send Webhook Notifications: If you use Webhooks to send notifications for Samsara events to external servers, you can set the Webhook you want to use as a recipient for notifications. Click Manage to set up a new integration.
-
Send Slack Notifications: If you set up Slack to post a message when there is an alert, you can choose the Slack integration you want to use. Click Manage to set up a new integration.
-
Description: Enter an optional description that identifies or describes the purpose or scope of the alert.
-
-
Save the alert configuration.
-
At any time, you can return to the Alerts page to manage your alert configurations and View Alert Incidents.
Comments
0 comments
Please sign in to leave a comment.