2022-05-26 23:06:25 +08:00
---
aliases:
2024-03-14 23:58:18 +08:00
- rules/ # /docs/grafana/< GRAFANA_VERSION > /alerting/rules/
- unified-alerting/alerting-rules/ # /docs/grafana/< GRAFANA_VERSION > /alerting/unified-alerting/alerting-rules/
- ./create-alerts/ # /docs/grafana/< GRAFANA_VERSION > /alerting/create-alerts/
2023-07-18 18:29:00 +08:00
canonical: https://grafana.com/docs/grafana/latest/alerting/alerting-rules/
2024-02-27 21:00:09 +08:00
description: Configure alert rules
Explicitly set all front matter labels in the source files (#71548)
* Set every page to have defaults of 'Enterprise' and 'Open source' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration pages to have of 'Cloud', 'Enterprise', and 'Open source' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/enterprise-licensing pages to have 'Enterprise' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/organization-management pages to have 'Enterprise' and 'Open source' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/provisioning pages to have 'Enterprise' and 'Open source' labels
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/recorded-queries pages to have labels cloud,enterprise
* Set administration/roles-and-permissions/access-control pages to have labels cloud,enterprise
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set administration/stats-and-license pages to have labels cloud,enterprise
* Set alerting pages to have labels cloud,enterprise,oss
* Set breaking-changes pages to have labels cloud,enterprise,oss
* Set dashboards pages to have labels cloud,enterprise,oss
* Set datasources pages to have labels cloud,enterprise,oss
* Set explore pages to have labels cloud,enterprise,oss
* Set fundamentals pages to have labels cloud,enterprise,oss
* Set introduction/grafana-cloud pages to have labels cloud
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Fix introduction pages products
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set panels-visualizations pages to have labels cloud,enterprise,oss
* Set release-notes pages to have labels cloud,enterprise,oss
* Set search pages to have labels cloud,enterprise,oss
* Set setup-grafana/configure-security/audit-grafana pages to have labels cloud,enterprise
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set setup-grafana/configure-security/configure-authentication pages to have labels cloud,enterprise,oss
* Set setup-grafana/configure-security/configure-authentication/enhanced-ldap pages to have labels cloud,enterprise
* Set setup-grafana/configure-security/configure-authentication/saml pages to have labels cloud,enterprise
* Set setup-grafana/configure-security/configure-database-encryption/encrypt-secrets-using-hashicorp-key-vault pages to have labels cloud,enterprise
* Set setup-grafana/configure-security/configure-request-security pages to have labels cloud,enterprise,oss
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set setup-grafana/configure-security/configure-team-sync pages to have labels cloud,enterprise
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set setup-grafana/configure-security/export-logs pages to have labels cloud,enterprise
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
* Set troubleshooting pages to have labels cloud,enterprise,oss
* Set whatsnew pages to have labels cloud,enterprise,oss
* Apply updated labels from review
Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com>
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
---------
Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
Co-authored-by: brendamuir <100768211+brendamuir@users.noreply.github.com>
Co-authored-by: Isabel <76437239+imatwawana@users.noreply.github.com>
2023-07-18 16:10:12 +08:00
labels:
products:
- cloud
- enterprise
- oss
2024-02-27 21:00:09 +08:00
title: Configure alert rules
2023-10-25 02:31:03 +08:00
weight: 120
2024-12-09 16:43:19 +08:00
refs:
alert-rules:
- pattern: /docs/grafana/
destination: /docs/grafana/< GRAFANA_VERSION > /alerting/fundamentals/alert-rules/
- pattern: /docs/grafana-cloud/
destination: /docs/grafana-cloud/alerting-and-irm/alerting/fundamentals/alert-rules/
configure-grafana-alerts:
- pattern: /docs/grafana/
destination: /docs/grafana/< GRAFANA_VERSION > /alerting/alerting-rules/create-grafana-managed-rule/
- pattern: /docs/grafana-cloud/
destination: /docs/grafana-cloud/alerting-and-irm/alerting/alerting-rules/create-grafana-managed-rule/
configure-ds-alerts:
- pattern: /docs/grafana/
destination: /docs/grafana/< GRAFANA_VERSION > /alerting/alerting-rules/create-data-source-managed-rule/
- pattern: /docs/grafana-cloud/
destination: /docs/grafana-cloud/alerting-and-irm/alerting/alerting-rules/create-data-source-managed-rule/
recording-rules:
- pattern: /docs/grafana/
destination: /docs/grafana/< GRAFANA_VERSION > /alerting/alerting-rules/create-recording-rules/
- pattern: /docs/grafana-cloud/
destination: /docs/grafana-cloud/alerting-and-irm/alerting/alerting-rules/create-recording-rules/
2025-06-26 20:25:32 +08:00
import-to-grafana-managed:
2024-12-09 16:43:19 +08:00
- pattern: /docs/grafana/
2025-06-26 20:25:32 +08:00
destination: /docs/grafana/< GRAFANA_VERSION > /alerting/alerting-rules/alerting-migration/
2024-12-09 16:43:19 +08:00
- pattern: /docs/grafana-cloud/
2025-06-26 20:25:32 +08:00
destination: /docs/grafana-cloud/alerting-and-irm/alerting/alerting-rules/alerting-migration/
comparison-ds-grafana-rules:
2025-01-10 22:21:18 +08:00
- pattern: /docs/grafana/
2025-06-26 20:25:32 +08:00
destination: /docs/grafana/< GRAFANA_VERSION > /alerting/alerting-rules/create-data-source-managed-rule/#comparison-with-grafana-managed-rules
2025-01-10 22:21:18 +08:00
- pattern: /docs/grafana-cloud/
2025-06-26 20:25:32 +08:00
destination: /docs/grafana-cloud/alerting-and-irm/alerting/alerting-rules/create-data-source-managed-rule/#comparison-with-grafana-managed-rules
2022-05-26 23:06:25 +08:00
---
2021-06-04 00:59:45 +08:00
2024-02-27 21:00:09 +08:00
# Configure alert rules
2023-06-20 17:43:12 +08:00
2024-12-09 16:43:19 +08:00
[Alert rules ](ref:alert-rules ) are the central component of your alerting system.
2023-06-20 17:43:12 +08:00
2024-12-09 16:43:19 +08:00
An alert rule consists of one or more queries and expressions that select the data you want to measure. It contains a condition to trigger the alert, an evaluation period that determines how often the rule is evaluated, and additional options to manage alert events and their notifications.
2021-08-06 21:52:36 +08:00
2024-12-09 16:43:19 +08:00
Grafana supports two types of alert rules:
2021-10-28 04:57:54 +08:00
2025-06-26 20:25:32 +08:00
1. **Grafana-managed alert rules** — the recommended option. They can query backend data sources—including Prometheus-based ones—and offer a [richer feature set ](ref:comparison-ds-grafana-rules ).
1. **Data source-managed alert rules** — supported for Prometheus-based data sources (such as Mimir, Loki, and Prometheus), with rules stored in the data source itself.
2021-10-28 04:57:54 +08:00
2025-06-26 20:25:32 +08:00
You can [convert and import data source-managed rules into Grafana-managed rules ](ref:import-to-grafana-managed ) to let Grafana Alerting manage them.
2022-10-17 17:48:39 +08:00
2024-12-09 16:43:19 +08:00
Both types of alert rules can be configured in Grafana using the ** + New alert rule** flow. For step-by-step instructions, refer to:
2023-06-20 17:43:12 +08:00
2024-12-09 16:43:19 +08:00
- [Configure Grafana-managed alert rules ](ref:configure-grafana-alerts )
- [Configure data source-managed alert rules ](ref:configure-ds-alerts )
2023-06-20 17:43:12 +08:00
2025-06-26 20:25:32 +08:00
In Grafana Alerting, you can also [configure recording rules ](ref:recording-rules ), which pre-compute queries and save the results as new time series metrics for use in other alert rules or dashboard queries.