Alerting¶
The Alerting feature allows you detect issues in the field faster, in order to control your deployments in a more refined way.
Create an alert for your organization¶
By clicking on the "+ New" button, a form allows you to create an alert for you and your organization's users.
Select an alert type, press "Next", and configure your alert. For some alerts, only the name is configurable, for others the form will display modifiable data such as thresholds or the time at which you want the alert to be triggered.
Warning
Times are all in UTC timezone, please adapt to your timezone when subscribing to an alert with a specific trigger time.
Permissions
The following list includes all permissions tied to this MDM section and the impacts they have on the MDM interface or the MDM API.
You can pick and choose these permissions when creating a new Custom Role or MDM API token.
Permission category - "Alerts - Configuration"
Read (alerting.alerttype.read)
- What it does: Allows users to access the alerts configurations page.
- Where it applies: Alert configurations page (/alerting).
- What happens without this permission: The alert configurations page is not accessible.
Create (alerting.alerttype.create)
- What it does: Allows users to create Alert Configurations.
- Where it applies: Alert configurations page (/alerting).
- What happens without this permission: The button to create a new Alert Configuration is not visible.
Update (alerting.alerttype.update)
- What it does: Allows users to update Alert Configurations.
- Where it applies: Alert configurations page (/alerting).
- What happens without this permission: The button to update an Alert Configuration is not visible.
Delete (alerting.alerttype.delete)
- What it does: Allows users to delete Alert Configurations.
- Where it applies: Alert configurations page (/alerting).
- What happens without this permission: The button to delete an Alert Configuration is not visible.
Subscribe to alerts¶
Clicking on the toggles seen below allows you and other people in your organization to subscribe to created alerts and receive feedback, either by e-mail or by MDM Notification.
Permissions
The following list includes all permissions tied to this MDM section and the impacts they have on the MDM interface or the MDM API.
You can pick and choose these permissions when creating a new Custom Role or MDM API token.
Permission category - "Alerts - Subscriptions"
Create (alerting.subscription.create)
- What it does: Allows users to create a subscription for an existing alert configuration.
- Where it applies:
- Subscriptions page (/alerting)
- After creating a new alert configuration, it automatically subscribes via e-mail and notifications.
- What happens without this permission: After creating an alert configuration, the system does not create subscriptions.
Read (alerting.subscription.read)
- What it does: Allows users to see their subscriptions for alerts.
- Where it applies:
- Subscriptions page (/alerting)
- Grants access to the toggle buttons in an alert configuration card showing if the user is subscribed via email or notification.
- What happens without this permission: Subscription toggle buttons are not visible.
Update (alerting.subscription.update)
- What it does: Allows users to update their subscriptions for alerts.
- Where it applies:
- Subscriptions page (/alerting)
- Grants access to the toggle buttons in an alert configuration card to manage subscription status.
- What happens without this permission: Subscription toggle buttons are not visible.
Alerts depending on Insights¶
If you have access to the Insights Paid MDM Add-On feature, some special alerts are accessible to you.
If not, a visual warning will highlight that this alert won't work in your organization.
Review the history of alerts triggered in your organization¶
The "History" menu allows you to review all alerts which were triggered in your organization. Clicking on any of them gives you the exact content you would have received per e-mail or MDM notification.
Permissions
The following list includes all permissions tied to this MDM section and the impacts they have on the MDM interface or the MDM API.
You can pick and choose these permissions when creating a new Custom Role or MDM API token.
Permission category - "Alerts - History"
Read (alerting.alert.read)
- What it does: Allows users to view the alert history on /and the Recent Alerts widget.
- Where it applies:
- Main dashboard (/)
- History page (/alerting/history)
- What happens without this permission:
- The Recent Alerts widget is not visible on the main dashboard
- The Alerting History page can’t be accessed.