Skip to content

The easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:

docs: alert management (#75478)

Alex Yarosh9ac9602d2644
diff --git a/docs/installation-and-operation/alert-management.md b/docs/installation-and-operation/alert-management.md
new file mode 100644
index 00000000000..b536d006910
--- /dev/null
+++ b/docs/installation-and-operation/alert-management.md
@@ -0,0 +1,77 @@
+---
+title: Alerts management
+summary: "See all alerts in your instance and manage them in bulk"
+---
+
+# Alerts management
+
+_Admin > Tools > Alerts management_
+
+In the Alert management section, Admins can:
+
+- View and search all [question alerts](../questions/alerts.md) in their Metabase
+- Identify failed or orphaned alerts
+- Edit alerts, including changing the alert's owner
+- Delete alerts in bulk
+
+![Alert management](./images/alert-management.png)
+
+Currently, [dashboard subscriptions](../dashboards/subscriptions.md) are not included.
+
+## See all alerts
+
+To see all alerts active in your Metabase instance, go to **Admin > Tools > Alerts management**.
+
+You can:
+
+- Filter alerts by channel ([email](../configuring-metabase/email.md), [Slack](../configuring-metabase/slack.md), or [webhook](../configuring-metabase/webhooks.md)) or recipient.
+
+- See alerts that **failed** the last time they were ran.
+
+ Failed alerts view include both alerts that were attempted but failed (for example, because of a query error) and alerts that were abandoned and never attempted (for example, because the instance was restarting at the moment when the alert was scheduled).
+
+ To see the entire history of alert runs (not just the last attempt), go to **Admin > Tools > Tasks** instead.
+
+- See **ownerless** alerts - alerts whose owner has been deactivated
+
+ This is helpful when you want to [mass-delete](#delete-alerts) alerts that are no longer relevant, or [change the owner](#change-alert-owners) to an active user.
+
+- See individual alert's properties and history.
+
+- [Delete alerts in bulk](#delete-alerts).
+
+- [Change alert owners in bulk](#change-alert-owners).
+
+If you want to get some analytics about your alerts (rather than manage them) - for example, you want to see how many alerts have failed per week, or which questions have the most number of alerts - use [Usage Analytics](../usage-and-performance-tools/usage-analytics.md) instead.
+
+## Change alert owners
+
+The owner of an alert has the power to edit or delete the alert. Usually, the person who created the alert is also the alert's owner.
+
+Admins can change owners of alerts. This is useful, for example, if the original alert owner left the company, and you need to give some else the power to manage the alert.
+
+To change the owner for one or more alerts:
+
+1. Go to **Admin > Tools > Alerts management**.
+2. Select the alerts whose owners you'd like to change.
+3. Click **Change owner** at the bottom of the screen.
+4. Assign a new owner.
+
+## Delete alerts
+
+![Bulk delete](./images/alerts-bult.png)
+
+You can delete multiple alerts at once.
+
+1. Go to **Admin > Tools > Alerts management**.
+2. Select the alerts whose owners you'd like to delete.
+3. Click **Delete** at the bottom of the screen.
+
+## Further reading
+
+- [Alerts](../questions/alerts.md)
+- [Usage analytics](../usage-and-performance-tools/usage-analytics.md)
+- [Setting up email](../configuring-metabase/email.md)
+- [Setting up Slack](../configuring-metabase/slack.md)
+- [Setting up webhooks](../configuring-metabase/webhooks.md)
+- [Managing people](../people-and-groups/managing.md)
diff --git a/docs/installation-and-operation/images/alert-management.png b/docs/installation-and-operation/images/alert-management.png
new file mode 100644
index 00000000000..c70429074c9
Binary files /dev/null and b/docs/installation-and-operation/images/alert-management.png differ
diff --git a/docs/installation-and-operation/images/alerts-bult.png b/docs/installation-and-operation/images/alerts-bult.png
new file mode 100644
index 00000000000..9cc3909d47a
Binary files /dev/null and b/docs/installation-and-operation/images/alerts-bult.png differ
diff --git a/docs/questions/alerts.md b/docs/questions/alerts.md
index e7478da5e50..45edc006bee 100644
--- a/docs/questions/alerts.md
+++ b/docs/questions/alerts.md
@@ -32,13 +32,13 @@ To create an alert:
2. Click on the **three dots** in the top-right of the screen.
3. Select **Create an alert**.
4. Select what you want to be alerted about (options depend on the question type):
- - [When a question returns a result](#results-alerts) - for any question.
- - [When a time series crosses a goal line](#goal-line-alerts) - for a line, bar, or area chart displaying a time series.
- - [When a progress bar reaches or goes below its goal](#progress-bar-alerts) - for progress bars.
-6. Select when you want Metabase to check the results: by the minute, hourly, daily, weekly, monthly, or on a custom schedule that you set using the Quartz [cron syntax](https://www.quartz-scheduler.org/documentation/quartz-2.3.0/tutorials/crontrigger.html).
-7. Select the alert's destination: [email](../configuring-metabase/email.md), [Slack](../configuring-metabase/slack.md), or to a [webhook](../configuring-metabase/webhooks.md) (only admins and people with [settings access](../permissions/application.md#settings-access) can create and send to webhooks).
-8. Configure any other options (like [only sending the alert once](#send-a-one-time-alert)).
-9. Click **Done**.
+ - [When a question returns a result](#results-alerts) - for any question.
+ - [When a time series crosses a goal line](#goal-line-alerts) - for a line, bar, or area chart displaying a time series.
+ - [When a progress bar reaches or goes below its goal](#progress-bar-alerts) - for progress bars.
+5. Select when you want Metabase to check the results: by the minute, hourly, daily, weekly, monthly, or on a custom schedule that you set using the Quartz [cron syntax](https://www.quartz-scheduler.org/documentation/quartz-2.3.0/tutorials/crontrigger.html).
+6. Select the alert's destination: [email](../configuring-metabase/email.md), [Slack](../configuring-metabase/slack.md), or to a [webhook](../configuring-metabase/webhooks.md) (only admins and people with [settings access](../permissions/application.md#settings-access) can create and send to webhooks).
+7. Configure any other options (like [only sending the alert once](#send-a-one-time-alert)).
+8. Click **Done**.
## Send a one-time alert
@@ -75,11 +75,11 @@ To create an alert when a time series crosses a goal line:
5. Save the question.
6. Click the **three dots** icon in top and select "Create alert"
- You can choose:
+ You can choose:
- - Whether you want Metabase to alert you when the time series goes above the goal line or when it goes below the goal line.
- - Whether you want Metabase to alert you every time the time series crosses a goal line, or only the first time it crosses the goal line.
- - How often you want Metabase to check to see if the goal line has been crossed.
+ - Whether you want Metabase to alert you when the time series goes above the goal line or when it goes below the goal line.
+ - Whether you want Metabase to alert you every time the time series crosses a goal line, or only the first time it crosses the goal line.
+ - How often you want Metabase to check to see if the goal line has been crossed.
7. Select the schedule and recipients for the alert, and click "Done"
@@ -116,6 +116,8 @@ Admins:
- Admins can add or remove recipients on any alert, even ones that they didn't create themselves.
- Admins can bulk manage alerts per person from the [People menu in Admin settings](../people-and-groups/managing.md#unsubscribe-from-all-subscriptions-and-alerts).
+- Admins can bulk manage all alerts in the instance in [Admin > Tools > Alert management](../installation-and-operation/alert-management.md).
+
Metabase will email you when:
- You set up an alert