grafana_bak/docs/sources/alerting/alerting-rules/link-alert-rules-to-panels.md

aliases, canonical, description, keywords, labels, title, weight, refs

aliases	canonical	description	keywords	labels	title	weight	refs
../../alerting/alerting-rules/create-alerts-panels/	https://grafana.com/docs/grafana/latest/alerting/alerting-rules/link-alert-rules-to-panels/	Grafana allows you to link alert rules with panels and dashboards. This helps connect alerts with an existing dashboard and informs alert responders on where to investigate.	grafana alerting panels create grafana-managed data source-managed	products cloud enterprise oss	Create and link alert rules to panels	300	time-series-visualizations annotations view-alert-state-on-panels pattern destination /docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/panels-visualizations/visualizations/time-series/ pattern destination /docs/grafana-cloud/ /docs/grafana-cloud/visualizations/panels-visualizations/visualizations/time-series/ pattern destination /docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/alerting/fundamentals/alert-rules/annotation-label/#annotations pattern destination /docs/grafana-cloud/ /docs/grafana-cloud/alerting-and-irm/alerting/fundamentals/alert-rules/annotation-label/#annotations pattern destination /docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/alerting/monitor-status/view-alert-state/#view-alert-state-on-panels pattern destination /docs/grafana-cloud/ /docs/grafana-cloud/alerting-and-irm/alerting/monitor-status/view-alert-state/#view-alert-state-on-panels

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.

{{% admonition type="tutorial" %}} For a hands-on example of integrating alert rules with dashboards, check out Part 5 of our Get Started with Grafana Alerting tutorial. {{% /admonition %}}

Link alert rules to panels

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.

{{< figure src="/media/docs/alerting/panel-displays-alert-state.png" max-width="1200px" caption="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.

{{% admonition type="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. {{% /admonition %}}

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.