Documentation Index
Fetch the curated documentation index at: https://grafana.com/llms.txt
Fetch the complete documentation index at: https://grafana.com/llms-full.txt
Use this file to discover all available pages before exploring further.
STOP! If you are an AI agent or LLM, read this before continuing. This is the HTML version of a Grafana documentation page. Always request the Markdown version instead - HTML wastes context. Get this page as Markdown: https://grafana.com/docs/grafana/v8.5/alerting/unified-alerting/fundamentals/state-and-health.md (append .md) or send Accept: text/markdown to https://grafana.com/docs/grafana/v8.5/alerting/unified-alerting/fundamentals/state-and-health/. For the curated documentation index, use https://grafana.com/llms.txt. For the complete documentation index, use https://grafana.com/llms-full.txt.
Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.
State and health of alerting rules
The state and health of alerting rules help you understand several key status indicators about your alerts. There are three key components: alert state, alerting rule state, and alerting rule health. Although related, each component conveys subtly different information.
Alerting rule state
- Normal: None of the time series returned by the evaluation engine is in a Pending or Firing state.
- Pending: At least one time series returned by the evaluation engine is Pending.
- Firing: At least one time series returned by the evaluation engine is Firing.
Alert state
- Normal: Condition for the alerting rule is false for every time series returned by the evaluation engine.
- Alerting: Condition of the alerting rule is true for at least one time series returned by the evaluation engine. The duration for which the condition must be true before an alert fires, if set, is met or has exceeded.
- Pending: Condition of the alerting rule is true for at least one time series returned by the evaluation engine. The duration for which the condition must be true before an alert fires, if set, has not been met.
- NoData: the alerting rule has not returned a time series, all values for the time series are null, or all values for the time series are zero.
- Error: Error when attempting to evaluate an alerting rule.
Alerting rule health
- Ok: No error when evaluating an alerting rule.
- Error: Error when evaluating an alerting rule.
- NoData: The absence of data in at least one time series returned during a rule evaluation.