ラベル一致の仕組み

このドキュメントのトピックは、Grafana バージョン 9.x をサポートする Grafana ワークスペース向けです。

Grafana バージョン 12.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 12 での作業。

Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「Grafana バージョン 10 での作業」を参照してください。

Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「Grafana バージョン 8 での作業」を参照してください。

ラベルとラベルマッチャーを使用して、アラートルールを通知ポリシーとサイレンスにリンクできます。これにより、アラートインスタンスを柔軟に管理し、処理するポリシーとサイレンスするアラートを指定できます。

ラベルマッチャーは、ラベル、値、演算子 の 3 つの異なる部分で構成されます。

• [ラベル]フィールドは、一致するラベルの名前です。ラベル名と完全に一致する必要があります。

• [値]フィールドは、指定されたラベル名の対応する値と一致します。一致方法は、演算子の値によって異なります。

• [演算子] フィールドは、ラベル値と一致させる演算子です。利用できる演算子は次のとおりです。

演算子	説明
=	値と完全に等しいラベルを選択します。
!=	値と等しくないラベルを選択します。
=~	値と正規表現が一致するラベルを選択します。
!~	値と正規表現が一致しないラベルを選択します。

複数のラベルマッチャーを使用している場合は、AND 論理演算子を使用して組み合わせられます。つまり、ルールをポリシーにリンクするには、すべてのマッチャーが一致する必要があります。

シナリオの例

アラートに次のラベルセットを定義する場合：

{ foo=bar, baz=qux, id=12 }

次に：

• foo=bar として定義されたラベルマッチャーは、このアラートルールと一致します。

• foo!=bar として定義されたラベルマッチャーがこのアラートルールと一致しません。

• id=~[0-9]+ として定義されたラベルマッチャーは、このアラートルールと一致します。

• baz!~[0-9]+ として定義されたラベルマッチャーは、このアラートルールと一致します。

• foo=barとid=~[0-9]+として定義された 2 つのラベルマッチャーは、このアラートルールと一致します。