翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
通知ポリシーの使用
このドキュメントトピックは、Grafana バージョン 8.x をサポートする Grafana ワークスペース向けに設計されています。
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 10 での作業。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「」を参照してくださいGrafana バージョン 9 での作業。
通知ポリシーは、アラートをコンタクトポイントにルーティングする方法を決定します。ポリシーにはツリー構造があり、各ポリシーには 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(ポリシーの保存)] を選択して変更を保存します。
特定のポリシーを編集するには
-
アラートページから通知ポリシーを選択して、既存のポリシーを一覧表示するページを開きます。
-
編集するポリシーを選択し、編集アイコン (ペン) を選択します。
-
変更を加えます (最上位の特定のポリシーを追加する場合と同様)。
-
[ポリシーを保存]を選択します。
ラベルマッチングの仕組み
アラートのラベルがポリシーで指定されたすべての一致ラベルと一致する場合、ポリシーはアラートに一致します。
-
Label – 一致するラベルの名前。アラートのラベル名と完全に一致する必要があります。
-
Operator – ラベル値と一致するラベル値の比較に使用される演算子。利用できる演算子は次のとおりです。
-
=
指定された文字列と正確に一致する値を持つラベルを選択します。 -
!=
値が指定された文字列と一致しないラベルを選択します。 -
=~
指定された文字列の正規表現解釈値と一致するラベルを選択します (指定された文字列は正規表現として解釈されます。 -
!=
指定された正規表現と一致しないラベルを選択します。
-
-
値 – ラベル値と一致する値。選択した演算子に応じて、文字列または正規表現として一致させることができます。
ミュートタイミング
ミュートタイミングは、ポリシーの新しい通知が生成または送信されない定期的な時間間隔です。定期的なメンテナンス期間など、アラートが特定の期間に発生し、繰り返し発生するのを防ぐために使用します。
無音と同様に、ミュートタイミングによってアラートルールの評価が妨げられることも、アラートインスタンスがユーザーインターフェイスに表示されなくなることもありません。通知の作成のみを防ぎます。
外部の Alertmanager データソースの Grafana マネージドミュートタイミングとミュートタイミングを設定できます。
無音と比較したミュートタイミング
次の表は、ミュートのタイミングと無音の違いを示しています。
ミュートタイミング | 無音 |
---|---|
繰り返し発生する可能性のある時間間隔定義を使用する |
開始時刻と終了時刻が固定されている |
作成され、通知ポリシーに追加される |
ラベルを使用してアラートと照合し、無音にするかどうかを決定します |
ミュートタイミングを作成するには
-
Grafana コンソールの Grafana メニューで、アラート (ベル) アイコンを選択してアラートページを開きます。
-
通知ポリシー を選択します。
-
アラートマネージャードロップダウンから、編集するアラートマネージャーを選択します。
-
「ミュートタイミング」セクションで、「ミュートタイミングを追加」ボタンを選択します。
-
ミュートの推定を適用する時間間隔を選択します。
-
送信 を選択して、ミュートタイミングを作成します。
通知ポリシーにミュートタイミングを追加するには
-
ミュートタイミングを追加する通知ポリシーを選択し、編集ボタンを選択します。
-
ミュートタイミングドロップダウンから、ポリシーに追加するミュートタイミングを選択します。
ポリシーの保存ボタンを選択します。
時間間隔
時間間隔は、時間範囲の定義です。この間隔でアラートが開始されると、アラートは抑制されます。範囲は を使用してサポートされます :
(例: monday:thursday
)。ミュートタイミングには、複数の時間間隔を含めることができます。時間間隔は複数のフィールド (次のリストの詳細) で構成され、アラートを抑制するには、すべて一致する必要があります。例えば、曜日monday:friday
と時間範囲を 8:00~9:00 に指定すると、アラートは月曜日から金曜日まで 8~9 に抑制されますが、例えば土曜日の 8~9 には抑制されません。
-
時間範囲 – 通知を抑制する時刻。開始時刻 と終了時刻 の 2 つのサブフィールドで構成されます。時刻の例は です
14:30
。時刻は UTC で 24 時間表記されます。 -
曜日 – 曜日。などの 1 日
monday
、 などの範囲monday:friday
、または などのカンマ区切りの日数リストを使用できますmonday, tuesday, wednesday
。 -
月 – 選択する月。月は、数値の指定で指定することも、完全な月名で指定することもできます。例えば、
1
またはjanuary
両方で 1 月を指定します。1 か月、月の範囲、または月のリストをカンマで区切って指定できます。 -
Days of the month – 1 か月内の日付。値の範囲は
1
~ です31
。負の値は、月の曜日を逆の順序で指定するため、-1
は月の最終日を表します。月の日は、1 日、日数の範囲、またはカンマ区切りの日数リストとして指定できます。