Generated at:
Prometheus Rule Group
Definition
A group of rules evaluated together at a common interval. Follows the Prometheus rule group concept (https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/).
Note: The upstream RuleGroup fields partial_response_strategy and limit are
intentionally omitted as they are not supported by the Dash0 evaluation engine.
Caveat for synthetic metrics: when a rule reads from a synthetic metric (one
computed on demand from underlying signals at query time, rather than pre-computed
during ingestion), evaluation near the leading edge of available data may
under-count, since late-arriving signals may not yet have been processed. Two
rules within the same group can therefore disagree even when their queries share
a strict subset/superset relationship — a ratio of the two values may briefly
exceed 1.0 at some timestamps. Use query_offset to delay evaluation enough for
the underlying data to settle.
Display name for the rule group.
Evaluation interval for all rules in the group. Applies to every rule in the group; individual rules cannot override it. Defaults to "1m" if not specified.
For recording rules, the minimum interval depends on the longest matrix-selector range in the rule's PromQL expression (the "query window"):
| Query window | Minimum interval |
|---|---|
| ≤ 1h+10m | 1m (absolute floor) |
| (1h+10m, 8h+10m] | 5m |
| (8h+10m, 24h+10m] | 10m — relaxed to 5m for RR-over-RR |
| (24h+10m, 30d+15m] | 1h — relaxed to 5m for RR-over-RR |
| > 30d+15m | rejected |
"RR-over-RR" means every metric referenced by the recording rule's expression is itself an active recording-rule output in the same (organization, dataset). In that case the relaxed 5m floor applies for query windows above 8h+10m — the inner recording rule's own validation already bounded the per-eval cost.
Alerting rules are not subject to these interval constraints.
Shifts the timestamp at which rules in the group query their data backwards by this duration (e.g. "5m"). Output series points are stamped at the shifted moment, allowing late-arriving data to settle before being counted. Maximum 1h. Defaults to 0 if omitted (no shift).
Labels to apply to all rules in the group. These are merged with rule-level labels; rule-level labels take precedence in case of conflict.
List of rules in this group.
Used by 1
These schemas and endpoints reference this type directly.