Grafana アラートのラベル

このドキュメントトピックは、Grafana バージョン 10.x をサポートする Grafana ワークスペース向けに設計されています。

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

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

このトピックでは、ラベルがアラートの基本的なコンポーネントである理由について説明します。

• アラートの完全なラベルセットは、Grafana アラート内でアラートを一意に識別するものです。

• Alertmanager は、ラベルを使用して、通知ポリシー内の無音とアラートグループのアラートを照合します。

• アラート UI には、そのルールの評価中に生成されたすべてのアラートインスタンスのラベルが表示されます。

• コンタクトポイントはラベルにアクセスして、通知の結果であるアラートに固有の情報を含む通知を動的に生成できます。

• アラートルール にラベルを追加できます。ラベルは手動で設定でき、テンプレート関数を使用し、他のラベルを参照できます。アラートルールに追加されたラベルは、ラベルが衝突した場合に優先されます (Grafana の予約ラベルの場合を除く。詳細については、以下を参照してください）。

外部アラートマネージャーの互換性

Grafana の組み込み Alertmanager は、Unicode ラベルキーと値の両方をサポートしています。外部 Prometheus アラートマネージャーを使用している場合、ラベルキーはデータモデル と互換性がある必要があります。つまり、ラベルキーには、ASCII 文字 、数字 、アンダースコア のみを含める必要があり、正規表現 と一致する必要があります[a-zA-Z_][a-zA-Z0-9_]*。無効な文字は、次のルールに従って外部アラートマネージャーに送信される前に、Grafana アラートエンジンによって削除または置き換えられます。

• Whitespace は削除されます。

• ASCII characters は に置き換えられます_。

• All other characters は、小文字の 16 進数表現に置き換えられます。これが最初の文字の場合、プレフィックスとして が付けられます_。

注記

複数のラベルキーが同じ値にサニタイズされている場合、重複には元のラベルの短いハッシュがサフィックスとして追加されます。

Grafana 予約ラベル

注記

プレフィックスに が付いたラベルgrafana_は、Grafana が特別な使用のために予約しています。で始grafana_まる手動で設定されたラベルを追加すると、衝突時に上書きされます。

Grafana の予約済みラベルは、手動で設定したラベルと同じ方法で使用できます。使用可能な予約済みラベルの現在のリストは次のとおりです。

ラベル	説明
grafana_folder	アラートを含むフォルダのタイトル。