The Manage Alerts user page shows a list of all the alerts that you own or follow, or for which you are listed as a recipient, depending on your alerts permissions:
| Permissions | Alerts Displayed on the Manage Alerts User Page |
|---|---|
admin |
Users can see the alerts that they have created or followed, or for which they are listed as a recipient. |
create_alerts |
Users can see the alerts that they have created. |
follow_alerts |
Users can see the alerts that they have followed or for which they are listed as a recipient. |
Accessing the Manage Alerts user page
If your Looker admin has not given you alerts permissions, you will not be able to access this page from the user menu.
To reach the Manage Alerts user page, click your user profile picture or icon and choose Alerts:
Alert information
The Manage Alerts user page provides information about all the alerts that you have created (and not deleted), that you have chosen to follow, or for which you are listed as a recipient:
The columns in the Manage Alerts user page table show these settings:
| Column | Definition |
|---|---|
| Alert Name | The title of the alert, which is set when the alert is created or edited. The default alert title indicates the conditions that need to be met or exceeded for the alert to be triggered. |
| Dashboard | The name of and link to the dashboard that contains the tile with the alert. Click the link to navigate to the dashboard. |
| Owner | The name of the user who created the alert. |
| Last Ran At | The date and time at which the most recent alert query was run. If the alert query has not yet run, there will be no entry for this alert. |
| Condition Met | A Yes or No that indicates whether the alert conditions were met when the alert query was last run. A — symbol is displayed if the alert query has not yet run or if the alert query ran but it could not be determined whether the alert conditions were met. This column displays red error or yellow warning icons related to any errors or warnings that surface when the alert query is run or the alert notification is delivered. Hover over the error or warning icon to see the associated error message, if applicable. A yellow icon indicates that the data on the dashboard tile did not change between the two most recent alert queries. Read more about this message in the Alert error and warning messages section on this page. |
| Schedule | The frequency at which notifications are sent once the alert conditions have been met or exceeded. |
| Status | This column indicates whether the alert is currently active or disabled.
|
| Following | A button that indicates your following status for the alert. See more on the Following section on this page. |
Alert error and warning messages
The Manage Alerts user page displays any errors or warnings that are surfaced when the alert query is run or the alert notification is delivered:
Error messages, if applicable, appear when you hover over the error or warning icon in the Condition Met column.
For alerts that are set up to deliver notifications to the Slack or Slack Attachment (API Token) integrations, the error message Notification delivery failed with existing configuration appears when the alert query determines that the alert conditions have been met but the notification could not be delivered. This failure may occur if something about the Slack configuration has changed since the alert was created — for example, if the Slack workspace that the alert was delivering to was disconnected from the Looker instance, or if the Slack channel that the alert was delivering to was deleted, or if Looker cannot connect to the integrations.
Warning: Querying fresh data
A yellow warning icon in the Condition Met column indicates that the data on the dashboard tile upon which the alert is based did not change between the two most recent alert queries.
There are a few explanations for why the data did not change between queries. If this warning persists, talk to your Looker admin or developer to verify that the caching policies that are defined for this dashboard tile are aligned with the alert frequency setting.
Alert management options
Next to the alerts you own is a three-dot menu with the following options:
- Edit Alert
- Disable Alert (if the alert is currently enabled)
- Enable Alert (if the alert is currently disabled)
Click Edit Alert to open the alert window where you can modify the alert’s settings. Click Save Alert to save changes or Cancel to close the alert window without saving.
If a user deletes the dashboard or dashboard tile that the alert is on, that alert will be disabled and any followers or recipients will no longer receive notifications when the alert conditions are met.
On this page, the alert owner will see immediately that the name of the dashboard has been deleted for the alert. After the next time the alert query runs, the alert status will show as Disabled.
Following
The Following column shows clickable Unfollow and Follow buttons and unclickable Follow buttons.
You will see an Unfollow button next to the alert if you are following the alert. If you click Unfollow, you will stop receiving notifications when this alert is triggered. After you click Unfollow:
- If you own the alert, you will see a Follow button in this column.
- If you do not own the alert, this alert will be removed from this page once you refresh your browser.
- If you were listed as a recipient for an alert’s notifications but did not follow the alert from the alert view window, you will see an unclickable Follow button. To unfollow the alert, you must unsubscribe directly from your alert notification.
You will see an unclickable Follow button next to the alert if any of the following conditions are true:
- You own the alert but it is unfollowable.
- You were listed as an email recipient for the alert notifications but did not follow the alert from the alert view window. To unfollow the alert, you must unsubscribe directly from your alert notification.
- The alert is configured to send notifications to Slack.
The alert owner may see that the alert status shows as Active on the Manage Alerts user page until the next time the alert query is run.