6397b34f8b
* Moved annotation and labels topic to fundamentals and added label matching to the same section * Cosmetic updates to "How label matching works topic" * Few more changes to annotations and label section. Also added stem sentence to silences topics. * Fixed one more broken relref. * Update docs/sources/alerting/fundamentals/_index.md Co-authored-by: Christopher Moyer <35463610+chri2547@users.noreply.github.com> Co-authored-by: Christopher Moyer <35463610+chri2547@users.noreply.github.com>
1.8 KiB
+++ title = "Label matchers" description = "Learn about labels and label matchers in alerting" keywords = ["grafana", "alerting", "guide", "fundamentals"] weight = 117 +++
How label matching works
Use labels and label matchers to link alert rules to [notification policies]({{< relref "../../notifications/_index.md" >}}) and [silences]({{< relref "../../silences/_index.md" >}}). This allows for a very flexible way to manage your alert instances, specify which policy should handle them, and which alerts to silence.
A label matchers consists of 3 distinct parts, the label, the value and the operator.
-
The Label field is the name of the label to match. It must exactly match the label name.
-
The Value field matches against the corresponding value for the specified Label name. How it matches depends on the Operator value.
-
The Operator field is the operator to match against the label value. The available operators are:
| Operator | Description |
|---|---|
= |
Select labels that are exactly equal to the value. |
!= |
Select labels that are not equal to the value. |
=~ |
Select labels that regex-match the value. |
!~ |
Select labels that do not regex-match the value. |
Example of a label matcher
Imagine we've defined the following set of labels for our alert.
{ foo=bar, baz=qux, id=12 }
In this situation,
- A label matcher defined as
foo=barwill match this alert rule. - A label matcher defined as
foo!=barwill not match this alert rule. - A label matcher defined as
id=~[0-9]+will match this alert rule. - A label matcher defined as
baz!~[0-9]+will match this alert rule.