Files
Pepe Cano 5c1b263664 docs(alerting): simplify Intro to Grafana Alerting docs (#106944)
* docs(alerting): improve `Intro > Alert rule evaluation` docs

* Update Introduction to Grafana Alerting

* Simplify `Intro > Alert rules` and related docs

* minor copy change phrasing GMA and DS differences

* fix vale error
2025-06-26 12:25:32 +00:00

3.4 KiB

canonical description keywords labels title weight refs
https://grafana.com/docs/grafana/latest/alerting/fundamentals/alert-rule-evaluation/alert-rule-state-and-health/ An alert instance is considered stale when its series disappears for a number of consecutive evaluation intervals. Learn how Grafana resolves them.
grafana
alerting
guide
state
products
cloud
enterprise
oss
Alert rule state and health 130
example-multi-dimensional-alerts alert-instance-states
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/alerting/best-practices/multi-dimensional-alerts/
pattern destination
/docs/grafana-cloud/ /docs/grafana-cloud/alerting-and-irm/alerting/best-practices/multi-dimensional-alerts/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/alerting/fundamentals/alert-rule-evaluation/nodata-and-error-states/#alert-instance-states
pattern destination
/docs/grafana-cloud/ /docs/grafana-cloud/alerting-and-irm/alerting/fundamentals/alert-rule-evaluation/nodata-and-error-states/#alert-instance-states

Alert rule state and health

Each alert rule can generate one or more alert instances—one alert instance for each series or dimension, as shown in the multi-dimensional alert example.

Each alert instance of the same alert rule represents a different target and can be in a different state; for example, one alert instance may be Normal while another is Alerting.

{{< figure src="/media/docs/alerting/alert-rule-example-multiple-alert-instances.png" max-width="750px" alt="Multi dimensional alert rule. The alert rule state and alert rule health are determined by the state of the alert instances." >}}

The alert rule state and alert rule health are determined by the state of the alert instances.

Alert rule states

An alert rule can be in either of the following states:

State Description
Normal None of the alert instances returned by the evaluation engine is in a Pending or Alerting state.
Pending At least one alert instances returned by the evaluation engine is Pending.
Firing At least one alert instances returned by the evaluation engine is Alerting.

Alert rule health

An alert rule can have one of the following health statuses:

State Description
Ok No error when evaluating the alert rule.
Error An error occurred when evaluating the alert rule.
No Data The alert rule query returns no data.
{status}, KeepLast The rule would have received another status but was configured to keep the last state of the alert rule.