翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
通知ポリシーの使用
このドキュメントトピックは、Grafana バージョン 9.x をサポートする Grafana ワークスペース向けに設計されています。
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 10 での作業。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 8 での作業。
通知ポリシーは、アラートを問い合わせポイントにルーティングする方法を決定します。ポリシーにはツリー構造があり、各ポリシーには 1 つ以上の子ポリシーを含めることができます。ルートポリシーを除く各ポリシーは、特定のアラートラベルと一致することもできます。各アラートはルートポリシーによって評価され、次に各子ポリシーによって評価されます。特定のポリシーに対して Continue matching subsequent sibling nodes
オプションを有効にすると、1 つ以上の一致後も評価が続行されます。親ポリシーの設定と連絡先情報は、子ポリシーのいずれにも一致しないアラートの動作を制御します。ルートポリシーは、特定のポリシーに一致しないアラートを管理します。
注記
Grafana マネージドアラートの通知ポリシーを作成および編集できます。Alertmanager アラートの通知ポリシーは読み取り専用です。
通知のグループ化
グループ化は、類似する性質のアラート通知を 1 つのファネルに分類します。これにより、システムの多くの部分が一度に障害が発生し、多数のアラートが同時に開始されるときに、大規模な停止中のアラート通知を制御できます。
グループ化の例
異なる環境のデータベースに 100 のサービスが接続されているとします。これらのサービスは、ラベル によって区別されますenv=environmentname
。サービスがデータベースに到達できるかどうかをモニタリングするためのアラートルールが設定されています。アラートルールは、 という名前のアラートを作成しますalertname=DatabaseUnreachable
。
サービスの半分がデータベースに到達できなくなるネットワークパーティションが発生すると、50 個の異なるアラートが開始されます。この状況では、影響を受ける環境のリストを含む 1 ページの通知 (50 ではなく) を受け取る必要があります。
グループ化を (サービスごとに異なる env
ラベルを使用group_by: [alertname]
せずに) に設定できます。この設定を行うと、Grafana は、このアラートルールの影響を受けるすべての環境を含む単一のコンパクトな通知を送信します。
特別なグループ
Grafana には 2 つの特別なグループがあります。デフォルトのグループでは、group_by: null
すべてのアラートを 1 つのグループにグループ化します。という名前の特別なラベルを使用して、すべてのラベルでアラート...
をグループ化し、グループを効果的に無効にして、各アラートを独自のグループに送信することもできます。
通知の使用
次の手順は、通知ポリシーを作成および管理する方法を示しています。
ルート通知ポリシーを編集するには
-
Grafana コンソールの Grafana メニューで、アラート (ベル) アイコンを選択してアラートページを開きます。
-
通知ポリシー を選択します。
-
アラートマネージャードロップダウンから、編集するアラートマネージャーを選択します。
-
ルートポリシーセクションで、編集アイコン (pen) を選択します。
-
デフォルトのコンタクトポイント で、アラートルールが特定のポリシーと一致しない場合に通知を送信するコンタクトポイントを更新します。
-
Group by で、アラートをグループ化するラベル (または特別なグループ) を選択します。
-
タイミングオプション で、次のオプションから選択します。
-
グループ待機 — 最初の通知を送信する前に、同じグループのアラートをバッファするのを待機する時間。デフォルト値は 30 秒です。
-
グループ間隔 — グループに対する 2 つの通知間の最小時間間隔。デフォルトは 5 分です。
-
繰り返し間隔 — グループに新しいアラートが追加されていない場合、通知を再送信するまでの最小時間間隔。デフォルトは 4 時間です。
-
-
[保存] を選択して変更を保存します。
新しい最上位ポリシーを追加するには
-
Grafana コンソールの Grafana メニューで、アラート (ベル) アイコンを選択してアラートページを開きます。
-
通知ポリシー を選択します。
-
アラートマネージャードロップダウンから、編集するアラートマネージャーを選択します。
-
「特定のルーティング」セクションで、「新しい特定のポリシー」を選択します。
-
ラベルの一致セクションで、一致するアラートラベルを 1 つ以上追加します。ラベルマッチングの詳細については、このトピックの後半で説明します。
-
コンタクトポイント で、アラートがこの特定のポリシーと一致する場合に通知を送信するコンタクトポイントを追加します。ネストされたポリシーは、このコンタクトポイントを上書きします。
-
オプションで、アラートが現在のポリシーに一致した後でも、後続の兄弟ノードのマッチングを継続を有効にして、兄弟ポリシーのマッチングを継続します。このポリシーを有効にすると、同じアラートに対して複数の通知を受け取ることができます。
-
必要に応じて、グループ化を上書きを選択して、ルートポリシーとは異なるグループ化を指定します。
-
オプションで、グループ通知ポリシーのタイミングオプションをオーバーライドする一般的なタイミングをオーバーライドを選択します。
-
[Save policy(ポリシーの保存)] を選択して変更を保存します。
ネストされたポリシーを追加するには
-
ネストされたポリシーを作成する特定のポリシーを展開します。
-
ネストされたポリシーを追加 を選択し、詳細を追加します (最上位の特定のポリシーを追加する場合など)。
-
[Save policy(ポリシーの保存)] を選択して変更を保存します。
特定のポリシーを編集するには
-
アラートページから通知ポリシーを選択して、既存のポリシーを一覧表示するページを開きます。
-
編集するポリシーを選択し、編集アイコン (ペン) を選択します。
-
変更を加えます (最上位の特定のポリシーを追加する場合と同様)。
-
[ポリシーを保存]を選択します。
ポリシーの検索
ポリシーのツリー内では、ラベルマッチャーまたはコンタクトポイント で検索できます。
-
コンタクトポイントで検索するには、コンタクトポイントで検索フィールドにコンタクトポイントの名前の一部または全体を入力します。
-
ラベルで検索するには、ラベルで検索フィールドに有効なラベルマッチャーを入力します。複数のマッチャーをカンマで区切って入力できます。例えば、有効なマッチャー入力は です
severity=high, region=~EMEA|NA
。注記
ラベルで検索する場合、一致するポリシーはすべて完全一致になります。部分一致と正規表現形式の一致はサポートされていません。
ラベルマッチングの仕組み
アラートのラベルがポリシーで指定されたすべての一致ラベルと一致する場合、ポリシーはアラートに一致します。
-
Label – 一致するラベルの名前。アラートのラベル名と完全に一致する必要があります。
-
Operator – ラベル値と一致するラベル値の比較に使用される演算子。利用できる演算子は次のとおりです。
-
=
指定された文字列と正確に一致する値を持つラベルを選択します。 -
!=
値が指定された文字列と一致しないラベルを選択します。 -
=~
指定された文字列の正規表現解釈値と一致するラベルを選択します (指定された文字列は正規表現として解釈されます。 -
!=
指定された正規表現と一致しないラベルを選択します。
-
-
値 – ラベル値と一致する値。選択した演算子に応じて、文字列または正規表現として一致させることができます。