Skip to main content
All CollectionsAppFleet Management
A guide to Fleet Health Alerts
A guide to Fleet Health Alerts

Get proactively notified about device downtime via email

David Hagan avatar
Written by David Hagan
Updated over 3 months ago

The QuantAQ Cloud now supports Fleet Health Alerts which allows Organization Administrators to receive notifications about device health issues via email.

In short:

  • You can create automated rules called Alerts

  • The QuantAQ Cloud will continually check to see if the conditions of the Alert are met

  • When the conditions are met, the QuantAQ Cloud will notify you per your Subscription preferences to that Alert

Fleet Health Alerts only support creating Alerts based on whether a device has gone offline or come back online. QuantAQ anticipates expanding the Alerts to encompass other types of Fleet Health issues in the future.

How Alerts work

Concepts

There are several components to Fleet Health Alerts:

Alerts describe the conditions under which an "Event" will be created. One Alert can have multiple Subscriptions from different users.

Alert Subscriptions describe which devices a user wants to apply an Alert to, and how that user wants to be notified when Events occur on those devices.

Events are the time periods for which a device meets the criteria of an Alert.

Notifications are the emails sent for a Subscription. These will either be sent every time an event starts and ends, or in a "Daily Digest", that contains any events that have occurred in the last 24 hours.

Use Cases

Many users want to know if a device has unexpectedly gone offline. For this use case, creating an Alert for a device downtime duration of "longer than 1 day" might be helpful. Once in place, the Administrator will be notified when any device in the subscription has been offline for longer than 1 day.

In other applications, a more sensitive Alert of 1 hour or even 15 minute downtime durations may be more appropriate. However, if a device has poor cellular connectivity, it may be temporarily offline for minutes or even hours at a time somewhat regularly. In these cases, shorter downtime duration Alerts may be too noisy to be useful, as due to onboard data buffering and backfilling once a device regains cellular connectivity, continuous measurement collection is still likely being achieved.

How to create an Alert

Only Organization Administrators can currently use Alerts.

  1. Navigate to the "Alerts" page in the left-hand nav pane under "Organization"

  2. Look if there are any existing Alerts created in your Organization. If another Administrator has already created an Alert that matches what you're looking for, you can subscribe to that existing Alert instead.

  3. Create a new alert by clicking "New Alert" in the top right corner

    1. Fill out the Alert's details, giving it a Title and Duration.

    2. Select your subscription preferences:

      1. Do you want to receive notifications when this Alert is met for specific networks, or for every device in the entire organization?

      2. Do you want to bundle notifications into one per day, or hear about them as soon as they happen?

    3. Click Create alert

Congratulations, you have successfully created a Fleet Health Alert. You will be notified via email per your Subscription preferences whenever the conditions in the Alert are met.

How to manage an existing Alert

Edit an Alert

To edit an Alert, click "Edit" on the right hand side of the Alert you would like to edit.

Change the Title or Conditions of the Alert, then click "Update Alert". Note that this will change the Alert for all Subscribers.

Manage your Subscription to an Alert

To manage your Subscription to an Alert, click "Manage" under "My Subscriptions" for the Alert you want to manage.

Change your Subscription details, then click Update Subscription. Note that this will only change your subscription to the Alert, not anyone else's.

If you would like to pause receiving notifications for this alert, you can change your Subscription to "No Devices"

Delete an Alert

To permanently delete an Alert, click "Delete" on the left hand side of the Alert you would like to remove.


Confirm the deletion by clicking "Delete Alert"

FAQ

How do notification limits work?

Fleet Health Alerts are currently limited to 100 notifications per month, per Organization. This limit applies to all subscriptions and users in the Organization. Once this limit is reached, no new notifications will be sent until the following month, when the limit resets. Daily Digest emails count as a single notification. If you are running into this limit, consider if digest emails or a longer duration for your alert would still be useful, or reach out to us via support.

Is there an API for Fleet Health Alerts?

No, not at this time. We may add support for this feature in the future.

What is the latency of Fleet Health Alerts?

The conditions of Fleet Health Alerts are checked every 10 minutes. Notifications are sent within several minutes of events occurring, but events only occur after the conditions of the Alert have been met, which adds some delay after a device goes offline. If an Alert is set up to trigger after a Device has been offline for an 1 hour, you might receive an email up to 75 minutes after the device actually went offline. Once the device comes back online, you should receive another email within 15 minutes. Daily Digests are sent once per day and include all events in the previous 24 hours up to the time the digest was sent.

Did this answer your question?