home User Guide Getting Started Help Center Documentation Community Training Certification
menu
close
settings
Looker keyboard_arrow_down
language keyboard_arrow_down
English
Français
Deutsch
日本語
search
print
Viewing alerts that you own or follow

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 warning icons or error 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 warning icon with a stale alert warning 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 the alert is checked for whether conditions have been met or exceeded.
Status This column indicates whether the alert is currently active or disabled.
  • An alert is marked as Disabled when a user disables their own alert (using the three-dot menu) or when a Looker admin pauses the alert. Hover over the Disabled status to see the alert owner’s or Looker admin’s explanation as to why the alert was disabled. Disabling or pausing an alert will pause notifications for any alert recipients, but the alert will still appear on the alert view window. The alert owner may see that the alert status shows as Active until the next time the alert query is run.
  • If an admin disables the alert, followers will no longer receive alert notifications.
Following A button that indicates your following status for the alert. See more in 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 warning icon or error 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 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. Hovering over this icon displays the message Stale Alert Warning.

There are a few possible 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.

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:

You will see an unclickable Follow button next to the alert if any of these conditions are true:

Alert management options

To the right of the alerts that you own is a three-dot menu with these options:

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: 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.

Enhanced alert information

When the Enhanced Alerts Labs feature is enabled, the Manage Alerts user page uses an updated UI that provides information about 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. Click the alert name to open the Alert Details page for that alert.
Dashboard The name of the dashboard that contains the tile with the alert. Click the link to navigate to the dashboard. None indicates that the alert has become unsynced from its dashboard. To resolve an unsynced alert, see the Effect of dashboard edits on alerts documentation page.
Owner The name of the user who created the alert.
Avg Run Time The duration of the alert query in seconds.
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 warning icons or error icons related to any errors or warnings that surface when the alert query is run or the alert notification is delivered. Hover over the warning icon or error icon to see the associated error message, if applicable.

A warning icon with a stale alert warning 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.
Frequency The frequency at which the alert is checked for whether conditions have been met or exceeded.
Status This column indicates whether the alert is currently active or disabled.
  • An alert is marked as Disabled when a user disables their own alert (using the three-dot menu) or when a Looker admin pauses the alert. Hover over the Disabled status to see the alert owner’s or Looker admin’s explanation as to why the alert was disabled. Disabling or pausing an alert will pause notifications for any alert recipients, but the alert will still appear on the alert view window. The alert owner may see that the alert status shows as Active until the next time the alert query is run.
  • If an admin disables the alert, followers will no longer receive alert notifications.
Following A button that indicates your following status for the alert. See more in the Following section on this page.
Activity A link that directs you to the alert’s Activity tab on the Alert Details page.
Three-dot menu A menu from which you can take additional actions on the alert. See more in the Enhanced alert management options section on this page.

Filtering alerts

To filter the list of alerts, click the filter icon at the top of the alert list:

You can filter alerts by:

You can impose multiple filters on your results. To delete a filter, click the x next to the filter name. Refreshing the browser will also delete all selected filters.

Enhanced 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 warning icon or error 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 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. Hovering over this icon displays the message Stale Alert Warning and this text:

The data for this tile did not change between the two most recent alert queries. Verify that the caching policies defined for this dashboard tile are aligned with the alert frequency.

There are a few possible 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.

Enhanced alert 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:

You will see an unclickable Follow button next to the alert if any of these conditions are true:

Enhanced alert management options

To the right of the alerts that you own is a three-dot menu with these options:

Click View Alert to open the Alert Details page.

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: 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.

Alert Details page

The Alert Details page is a pop-up that shows a summary of alert information, which is configured by the alert owner. Alert owners and followers experience a different view of this page.

You can open the Alert Details page in one of these ways:

  1. Clicking the three-dot menu to the right of the alert and selecting View Alert
  2. Clicking the alert title

Configuring the Alert Details page

After you’ve created an alert, an entry for that alert appears on the Manage Alerts user page. Open the Alert Details page to configure the information about the alert that its followers and recipients can view:

  1. Click in the text box to add context about what conditions trigger your alert or what it means for an alert to be triggered. Click Save to save your description.
  2. Click the + Link Investigative Dashboard button to open a new window in which you can connect another dashboard to this alert:

In the Link Dashboard to Alert window, select the folder that contains the dashboard and then click on the name of the dashboard. The name of the linked dashboard will appear in place of the + Link Investigative Dashboard button. You can delete the linked dashboard by clicking the x in the dashboard name — Looker will ask you to confirm that you want to delete the link to the dashboard. You cannot navigate to the linked dashboard if you own the alert.

Some alert details are displayed automatically on the Alert Details page and cannot be configured:

Other ways to interact with an alert you own include:

Click Done to close the Alert Details page.

Viewing the Alert Details page

You can view the Alert Details for an alert that you do not own if you’re listed as a recipient for that alert or if you have chosen to follow the alert. Open the Details tab on the Alert Details page to view the information about an alert that its owner has configured:

  1. View context about what conditions trigger your alert or what it means for an alert to be triggered.
  2. Click on the linked dashboard to navigate to another dashboard that may add context to the alert query.
  3. View the alert visualization.
  4. View the alert’s synchronization status and the name of the dashboard with which the alert is associated.
    • A green encircled check mark indicates that the alert is still synced to its dashboard.
    • A yellow triangular warning symbol indicates that the alert has become unsynced from its dashboard. The status includes a timestamp of when the synchronization was broken. An unsynced alert displays a None value in the Dashboard column. For information about resolving an unsynced alert, see the Effect of dashboard edits on alerts documentation page.
  5. Click the three-dot menu on the alert visualization, and then click Explore from here to open an Explore that is pre-set with the query for the dashboard tile on which the alert is set.
  6. Click the Test Now button to run an instant alert query — if the alert is triggered, a notification will be sent to its owner, recipients, and followers.
  7. Click Done to close the Alert Details page.

Viewing alert activity

Looker runs an alert query at its specified frequency to check whether data has met or exceeded alert conditions. The results of these checks become the alert’s history. You can click on the Activity tab at the top of the Alert Details page to view the alert’s history as well as additional information:

  1. View the frequency with which the alert is checked against its conditions.
  2. View alert metadata:
Heading Definition Possible values
Ran At The timestamp of when the alert query was initiated Any timestamp in the format 6/25/2021, 10:45:21 AM
Run Time How long the alert query took to run Any duration in the format 0.81s
Fresh A Boolean that indicates whether the alert query checked data that had changed between the two most recent alert queries. If the data changed; if the data did not change
  • Yes (if data changed)
  • No (if data did not change)
Source The origin of the data from which the alert query checked for the conditional value
  • query
  • cache
  • stale cache
Source Time The timestamp of the database row from which the alert query checked for the conditional value Any timestamp in the format 6/25/2021, 9:25:40 AM
Condition Met A Boolean that indicates whether or not the alert conditions were met
  • Yes (conditions were met)
  • No (conditions were not met)
Trigger The conditional value that would trigger the alert if met or exceeded Any numerical value
Observed The observed value that met or exceeded the alert conditions and triggered the alert Any numerical value
Status The status of the alert query
  • Complete
  • Running
  • Not Started
  1. View the alert’s synchronization status and the name of the dashboard with which the alert is associated.
    • A green encircled check mark indicates that the alert is still synced to its dashboard.
    • A yellow triangular warning symbol indicates that the alert has become unsynced from its dashboard. The status includes a timestamp of when the synchronization was broken. An unsynced alert displays a None value in the Dashboard column. For information about resolving an unsynced alert, see the Effect of dashboard edits on alerts documentation page.
  2. Click the Test Now button to run an instant alert query — if the alert is triggered, a notification will be sent to its owner, recipients, and followers.
  3. Click Done to close the Alert Details page.

Sharing the Alert Details page

If the alert has Public permissions, you can share the unique browser URL of its Alert Details page with other users.

Top