AutoMerge is generally available

Generated at:

Component schema

PrometheusRuleGroup

object1 direct reference

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.

stringrequired

Display name for the rule group.

string

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 windowMinimum interval
≤ 1h+10m1m (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+15mrejected

"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.

string

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).

object

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.