Skip to content

docs: add cluster-wide inhibition example to alerting tutorial#3015

Open
yugstar wants to merge 1 commit into
prometheus:mainfrom
yugstar:docs-add-cluster-wide-inhibition-example
Open

docs: add cluster-wide inhibition example to alerting tutorial#3015
yugstar wants to merge 1 commit into
prometheus:mainfrom
yugstar:docs-add-cluster-wide-inhibition-example

Conversation

@yugstar

@yugstar yugstar commented Jun 16, 2026

Copy link
Copy Markdown

Closes #1353

The Alertmanager docs mention that inhibition can suppress alerts from an entire cluster, but as noted in #1353 there is no concrete example showing how. As suggested on the issue, this adds an "Inhibiting alerts from an entire cluster" section to the Alerting based on metrics tutorial.

It shows an inhibit_rules configuration that mutes every alert sharing the same cluster label as a firing ClusterUnreachable alert, and explains source_matchers, target_matchers, and the equal label list (using the current matcher syntax).

The Alertmanager docs mention that inhibition can suppress alerts from
an entire cluster, but (as noted in prometheus#1353) there is no concrete example
showing how. As suggested on the issue, this adds an "Inhibiting alerts
from an entire cluster" section to the "Alerting based on metrics"
tutorial.

It shows an inhibit_rules configuration that mutes every alert sharing
the same cluster label as a firing ClusterUnreachable alert, and
explains source_matchers, target_matchers, and the equal label list.

Closes prometheus#1353

Signed-off-by: yugstar <aman.yug@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Needs example of cluster wide inhibition

1 participant