Menu

This is documentation for the next version of Grafana. For the latest stable release, go to the latest version.

Documentationbreadcrumb arrow Grafana documentationbreadcrumb arrow Alertingbreadcrumb arrow Configure alert rulesbreadcrumb arrow Create and link alert rules to panels
Grafana Cloud Enterprise Open source

Create and link alert rules to panels

Grafana allows you to link an alert rule to a dashboard panel. This can help you:

  • Inform alert responders about where to investigate and which data to examine.
  • Visualize the alert state directly from dashboards.

An alert rule is linked to a panel by setting the dashboardUId and panelId annotations. Both annotations must be set together.

When configuring the alert rule, you can set the dashboard and panel annotations as shown in this video.

  1. Configure the alert rule.
  2. In the Configure notification message section, click Link dashboard and panel.
  3. Select an existing dashboard, then choose a panel from the selected dashboard.
  4. Complete the alert rule configuration and click Save rule to initiate the alert rule.

You can then view the alert state on the panel.

A panel displaying the alert status and state changes.
A panel displaying the alert status and state changes.

Create alert rules from panels

To streamline alert creation, you can create an alert rule directly from a panel.

  1. Navigate to a dashboard in the Dashboards section.
  2. Hover over the top-right corner of a panel and click the panel menu icon.
  3. From the dropdown menu, select More… > New alert rule.
  4. This opens the Edit rule form and pre-fills some values:
    • Sets the dashboardUId and panelId annotations to the corresponding dashboard and panel.
    • Sets the alert rule query using the panel query.
  5. Complete the alert rule configuration and click Save rule to initiate the alert rule.

You can then view the alert state on the panel.

Note

Changes to panel and alert rule queries aren’t synchronized. If you change a query, you have to update it in both the panel and the alert rule.

Access linked alert rules from panels

This option is available only in time series panels. To access alert rules associated to a time series panel, complete the following steps.

  1. Hover over the top-right corner of the panel and click the panel menu icon.
  2. Click Edit.
  3. Click the Alert tab to view existing alert rules or create a new one.