From 54fb34f59b2a061a68f3105ddc48cc54e2c67f33 Mon Sep 17 00:00:00 2001 From: Pepe Cano <825430+ppcano@users.noreply.github.com> Date: Tue, 22 Apr 2025 22:17:45 +0200 Subject: [PATCH] docs(alerting): specify sequential evaluation for imported DS rules (#104234) --- .../alert-rule-evaluation/_index.md | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/docs/sources/alerting/fundamentals/alert-rule-evaluation/_index.md b/docs/sources/alerting/fundamentals/alert-rule-evaluation/_index.md index bc610c4457f..24e71878bc7 100644 --- a/docs/sources/alerting/fundamentals/alert-rule-evaluation/_index.md +++ b/docs/sources/alerting/fundamentals/alert-rule-evaluation/_index.md @@ -20,6 +20,11 @@ refs: destination: /docs/grafana//alerting/fundamentals/alert-rule-evaluation/state-and-health/ - pattern: /docs/grafana-cloud/ destination: /docs/grafana-cloud/alerting-and-irm/alerting/fundamentals/alert-rule-evaluation/state-and-health/ + import-ds-rules: + - pattern: /docs/grafana/ + destination: /docs/grafana//alerting/alerting-rules/alerting-migration/ + - pattern: /docs/grafana-cloud/ + destination: /docs/grafana-cloud/alerting-and-irm/alerting/alerting-rules/alerting-migration/ --- # Alert rule evaluation @@ -33,17 +38,19 @@ The criteria determining when an alert rule fires are based on two settings: ## Evaluation group -Every alert rule is assigned to an evaluation group. You can assign the alert rule to an existing evaluation group or create a new one. +Every alert rule and recording rule is assigned to an evaluation group. You can assign the rule to an existing evaluation group or create a new one. -Each evaluation group contains an **evaluation interval** that determines how frequently the alert rule is checked. For instance, the evaluation may occur every `10s`, `30s`, `1m`, `10m`, etc. +Each evaluation group contains an **evaluation interval** that determines how frequently the rule is checked. For instance, the evaluation may occur every `10s`, `30s`, `1m`, `10m`, etc. **Evaluation strategies** -Alert rules in different groups can be evaluated simultaneously. +Rules in different groups can be evaluated simultaneously. -- **Grafana-managed** alert rules within the same group are evaluated concurrently—they are evaluated at different times over the same evaluation interval but display the same evaluation timestamp. +- **Grafana-managed** rules within the same group are evaluated concurrently—they are evaluated at different times over the same evaluation interval but display the same evaluation timestamp. -- **Data-source managed** alert rules within the same group are evaluated sequentially, one after the other—this is useful to ensure that recording rules are evaluated before alert rules. +- **Data source-managed** rules within the same group are evaluated sequentially, one after the other—this is useful to ensure that recording rules are evaluated before alert rules. + +- **Grafana-managed rules [imported from data source-managed rules](ref:import-ds-rules)** are evaluated sequentially, like data source-managed rules. ## Pending period