翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# アラートを設定する
****
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。
アラートの作成と管理に必要な機能と統合を設定します。
**Topics**
+ [Grafana マネージドアラートルールを設定する](v10-alerting-configure-grafanamanaged.md)
+ [データソースマネージドアラートルールを設定する](v10-alerting-configure-datasourcemanaged.md)
+ [記録ルールを設定する](v10-alerting-configure-recordingrules.md)
+ [コンタクトポイントの設定](v10-alerting-configure-contactpoints.md)
+ [通知ポリシーを設定する](v10-alerting-configure-notification-policies.md)
# Grafana マネージドアラートルールを設定する
****
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。
Grafana マネージドルールは、最も柔軟なアラートルールの種類です。これにより、サポートされている任意のデータソースのデータに対して動作するアラートを作成できます。複数のデータソースをサポートするだけでなく、式を追加してデータを変換し、アラート条件を設定することもできます。アラート通知での画像の使用もサポートされています。これは、単一のルール定義で複数のデータソースからのアラートを許可する唯一のルールタイプです。
1 つのアラートルール (多次元アラートとも呼ばれます) の結果として、複数のアラートインスタンスを作成できます。
Grafana マネージドアラートルールは、ルールを保存するフォルダの編集権限を持つユーザーのみが編集または削除できます。
UI で作成されたアラートリソースを削除すると、そのリソースを取得できなくなります。設定のバックアップを作成し、削除されたアラートリソースを復元できるようにするには、Terraform またはアラート API を使用してアラートリソースを作成します。
以下の手順では、Grafana マネージドアラートルールを作成するプロセスについて説明します。
Grafanaマネージドアラートルールを作成するには、ワークスペース内のアラート作成フローを使用し、以下の手順に従います。
**アラートルール名を設定する**
1. **[アラート]** -> **[アラートルール]** -> **[\$1 新しいアラートルール]** を選択します。
1. アラートルールを識別する名前を入力します。
この名前はアラートルールリストに表示されます。またこの名前は、このルールから作成されるすべてのアラートインスタンスの `alertname` ラベルにもなります。
次に、測定するデータと、アラートルールを起動する前に満たす必要がある条件を取得するクエリを定義します。
**クエリと条件の定義方法**
1. データソースの選択。
1. **[オプション]** ドロップダウンから、[[時間範囲]](v10-dash-using-dashboards.md#v10-dash-setting-dashboard-time-range) を指定します。
**注記**
Grafana アラートは、`now-24hr: now` などの固定相対時間範囲のみをサポートします。
絶対時間範囲 `2021-12-02 00:00:00 to 2021-12-05 23:59:592` または半相対時間範囲 `now/d to: now` はサポートされていません。
1. クエリを追加します。
複数の[クエリ](v10-panels-query-xform.md#v10-panels-query-xform-add)を追加するには、**[クエリの追加]** を選択します。
すべてのアラートルールは、デフォルトで Grafana が管理します。データソース管理のアラートルールに切り替える場合は、**[データソースマネージドアラートルールに切り替える]** をクリックします。
1. 1 つ以上の[式](v10-panels-query-xform-expressions.md)を追加します。
1. 式ごとに **[クラシック条件]**を選択して単一のアラートルールを作成するか、**[Math]**、**[削減]**、**[リサンプリング]** オプションから選択して、各シリーズに個別のアラートを作成します。
**注記**
Prometheus を使用する場合、インスタントベクトルと組み込み関数を使用できます。そのため、式を追加する必要はありません。
1. **[プレビュー]** を選択して、式が成功したことを確認します。
1. [オプション] 復旧しきい値を追加するには、**[カスタム復旧しきい値]** のトグルをオンにして、アラートルールが発射を停止するタイミングの値を入力します。
クエリに追加できる復旧しきい値は 1 つだけで、アラート条件である必要があります。
1. アラート条件を設定するクエリまたは式で **[Set as alert condition (アラート条件として設定)]** を選択します。
アラートルールの評価を使用して、アラートルールを評価する頻度と状態の変更速度を決定します。
これを行うには、アラートルールが適切な評価グループにあることを確認し、ユースケースに最適な保留期間を設定する必要があります。
**アラート評価の動作の設定方法**
1. フォルダを選択するか、**[\$1 新しいフォルダ]** を選択します。
1. 評価グループを選択するか、**[\$1 新しい評価グループ]** を選択します。
新しい評価グループを作成するには、グループの間隔を指定します。
同じグループ内のすべてのルールは、同じ時間間隔で同時に評価されます。
1. 保留期間を入力します。
保留期間は、アラートルールが発射するまで条件に違反している可能性がある期間です。
条件が満たされると、アラートは**保留**状態になります。指定された期間、条件がアクティブなままの場合、アラートは**発射**状態に移行します。アクティブでない場合は**[普通]**状態に戻ります。
1. 必要に応じて、アラート通知の一時停止を有効にします。
**注記**
アラートルールの評価を一時停止して、アラートの調整中にノイズの多いアラートが発生しないようにします。一時停止すると、アラートルールの評価が停止し、アラートインスタンスは作成されません。これは、通知の配信を停止するミュートのタイミングとは異なりますが、アラートルールの評価とアラートインスタンスの作成は可能です。
アラートの調整中にアラートルールの評価を一時停止して、ノイズの多いアラートを防ぐことができます。一時停止すると、アラートルールの評価が停止し、アラートインスタンスは作成されません。これは、通知の配信を停止するミュートのタイミングとは異なりますが、アラートルールの評価とアラートインスタンスの作成は可能です。
1. **[Configure no data and error handling]** (データなしとエラー処理の設定) で、データがない場合のアラート動作を設定します。
このセクションの後半のガイドラインに従います。
アラートルールにラベルを追加して、発射アラートインスタンスを処理する通知ポリシーを設定します。
ラベルに関係なく、すべてのアラートルールとインスタンスはデフォルトの通知ポリシーと一致します。ネストされたポリシーがない場合、またはネストされたポリシーがアラートルールまたはアラートインスタンスのラベルと一致しない場合、デフォルトの通知ポリシーは一致するポリシーです。
**通知を設定するには**
1. 通知のルーティング方法を変更するには、ラベルを追加します。
ドロップダウンから既存のキーと値のペアを選択してカスタムラベルを追加するか、新しいキーまたは値を入力して新しいラベルを追加します。
1. アラートインスタンスのルーティング設定をプレビューします。
追加されたラベルに基づいて、アラートインスタンスは表示された通知ポリシーにルーティングされます。
各通知ポリシーを展開して、詳細を表示します。
1. **[詳細を表示]** を選択して、アラートルーティングの詳細とプレビューを表示します。
[注釈](v10-alerting-overview-labels.md#v10-alerting-overview-labels-annotations)を追加して、アラート通知メッセージにアラートに関するコンテキストをさらに提供できます。
注釈は、アラート通知メッセージのアラートに関する詳細情報を提供するメタデータを追加します。例えば、アラートが発生した値や発生したサーバーを示す**サマリー**注釈を追加します。
**注釈を追加するには**
1. [オプション] 概要を追加します。
何が起こったのか、その理由の簡単な概要。
1. (オプション) 説明を追加します。
アラートルールの動作の説明。
1. [オプション] ランブック URL を追加します。
アラートのランブックを保持するウェブページ
1. [オプション] カスタム注釈を追加します
1. [オプション] ダッシュボードとパネルリンクを追加します。
アラートをダッシュボードのパネルにリンクします。
1. **[ルールを保存]** を選択します。
**1 次元ルールと多次元ルール**
Grafana マネージドアラートの場合、従来の条件を使用してルールを作成することも、多次元ルールを作成することもできます。
+ **クラシック条件のルール**
従来の条件式を使用して、条件が満たされたときに単一のアラートを発射するルールを作成します。複数のシリーズを返すクエリの場合、Grafana は各シリーズのアラート状態を追跡しません。そのため、複数のシリーズでアラート条件が満たされた場合でも、Grafana が送信するアラートは 1 件のみです。
+ **多次元ルール**
シリーズごとに個別のアラートを生成するには、多次元ルールを作成します。`Math`、`Reduce`、または `Resample` 式を使用して、多次元ルールを作成します。例:
+ 各クエリの `Reduce` 式を追加して、選択した時間範囲の値を 1 つの値に集計します ([数値データを使用するルール](v10-alerting-overview-numeric.md)には必要ありません)。
+ ルールの条件を含む `Math` 式を追加します。クエリまたは縮小式が、ルールが発射されない場合に `0` を、発射すべき場合は正の数を返すのならば不要です。例: B クエリ/式が 70 を超える時に発射する場合は `$B > 70`。B の値が C の値に 100 を掛けた時に発射する場合は `$B < $C * 100`。比較対象のクエリの結果に複数のシリーズがある場合、異なるクエリのシリーズが同じラベルを持っているか、一方が他方のサブセットである場合に一致します。
**注記**
Grafana は、テンプレート変数を使用したアラートクエリはサポートしていません。詳細については、[https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514](https://community.grafana.com/t/template-variables-are-not-supported-in-alert-queries-while-setting-up-alert/2514) を参照してください。
**データなしまたはエラー処理の設定**
アラートルールの評価がデータなしまたはエラーを返すアラートルール評価時のアラート行動を設定します。
**注記**
評価がデータなしまたはエラーを返したときに発射するように設定されているアラートルールは、評価期間全体が終了したときにのみ発動します。つまり、アラートルール条件に違反した場合にすぐに発射するのではなく、アラートルールは **For** フィールドとして設定された時間が終了するまで待機してから発車することで、アラートノイズを減らし、一時的なデータ可用性の問題を回避します。
アラートルールの評価でデータなしが返される場合は、次のようにアラートルールの状態を設定できます。
| データなし | 説明 |
| --- | --- |
| データなし | アラートルールの名前と UID、およびラベルとしてデータを返さないデータソースの UID を使用した新しいアラート DatasourceNoData を作成します。 |
| [アラート] | アラートルールの状態を Alerting に設定します。アラートルールは、For フィールドで設定された時間が終わるまで待機してから発射します。 |
| OK | アラートルールの状態を Normal に設定します。 |
評価でエラーが返された場合は、アラートルールの状態を次のように設定できます。
| エラー | 説明 |
| --- | --- |
| エラー | アラートルールの名前と UID、およびラベルとしてデータを返さないデータソースの UID を使用したアラートインスタンス DatasourceError を作成します。 |
| [アラート] | アラートルールの状態を Alerting に設定します。アラートルールは、For フィールドで設定された時間が終わるまで待機してから発射します。 |
| OK | アラートルールの状態を Normal に設定します。 |
**古いアラートインスタンスを解決する**
アラートインスタンスのディメンションまたはシリーズが 2 つの評価間隔でクエリ結果から完全に消えた場合、アラートインスタンスは「古い」と見なされます。
`Alerting`/`NoData`/`Error` 状態にある古いアラートインスタンスは、自動的に `Resolved` とマークされ、`grafana_state_reason` 注釈が理由 `MissingSeries` でアラートインスタンスに追加されます。
**パネルからアラートを作成する**
任意のパネルタイプからアラートを作成します。つまり、パネル内のクエリを再利用し、それに基づいてアラートを作成できます。
1. ダッシュボードセクションの**[ダッシュボード]** に移動します。
1. パネルの右上隅で、3 つのドット (楕円) を選択します。
1. ドロップダウンメニューから、**[More...]** (その他...) を選択し、**[新しいアラートルール]** を選択します。
これにより、アラートルールフォームが開き、現在のパネルのクエリーに基づいてアラートを設定および作成できます。
# データソースマネージドアラートルールを設定する
****
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。
Ruler API が有効になっている外部 Grafana Mimir または Loki インスタンスのアラートルールを作成します。これらは、データソースマネージドアラートルールと呼ばれます。
**注記**
外部 Grafana Mimir または Loki インスタンスのアラートルールは、エディタまたは管理者ロールを持つユーザーが編集または削除できます。
UI で作成されたアラートリソースを削除すると、そのリソースを取得できなくなります。設定のバックアップを作成し、削除されたアラートリソースを復元できるようにするには、Terraform またはアラート API を使用してアラートリソースを作成します。
**前提条件**
+ Prometheus または Loki データソースへの書き込みアクセス権限があることを確認します。それ以外の場合、Grafana Mimir 管理のアラートルールを作成または更新することはできません。
+ Grafana Mimir および Loki データソースの場合、それぞれのサービスを設定して Ruler API を有効にします。
+ **Loki** - Loki データソースのデフォルトである `local` ルールストレージタイプは、ルールの表示のみをサポートしています。ルールを編集するには、他のルールストレージタイプのいずれかを設定します。
+ **Grafana Mimir** - `/prometheus` プレフィックスを使用します。Prometheus データソースは Grafana Mimir と Prometheus の両方に対応しており、Grafana は[クエリ API](https://grafana.com/docs/mimir/latest/operators-guide/reference-http-api/#querier--query-frontend) と [Ruler API](https://grafana.com/docs/mimir/latest/operators-guide/reference-http-api/#ruler) の両方が同じ URL にあることを想定しています。Ruler API に別の URL を指定することはできません。
**注記**
特定の Loki または Prometheus データソースのアラートルールを管理しない場合は、その設定に移動し、**[Manage alerts via alerting UI]** (アラート UI 経由でアラートを管理する) チェックボックスをオフにします。
次の手順では、データソースマネージドアラートルールを作成するプロセスについて説明します。
データソース管理のアラートルールを作成するには、ワークスペース内のアラート作成フローを使用し、以下の手順に従います。
**アラートルール名の設定方法**
1. **[アラート]** -> **[アラートルール]** -> **[\$1 新しいアラートルール]** を選択します。
1. アラートルールを識別する名前を入力します。
この名前はアラートルールリストに表示されます。またこの名前は、このルールから作成されるすべてのアラートインスタンスの `alertname` ラベルにもなります。
測定するデータと、アラートルールを起動する前に満たす必要がある条件を取得するクエリを定義します。
**クエリと条件の定義方法**
1. すべてのアラートルールは、デフォルトで Grafana が管理します。データソースマネージドアラートルールに切り替えるには、**[データソースマネージドアラートルールに切り替える]** を選択します。
1. ドロップダウンリストからデータソースを選択する。
**[高度なデータソースピッカーを開く]** を選択して、データソースの追加 (管理者のみ可能) など、その他のオプションを表示することもできます。
1. PromQL または LogQL クエリを入力します。
1. **[アラートのプレビュー]** を選択します。
アラートルールの評価を使用して、アラートルールを評価する頻度と状態の変更速度を決定します。
**アラート評価の動作の設定方法**
1. 名前空間を選択するか、**[\$1 新しい名前空間]** を選択します。
1. 評価グループを選択するか、**[\$1 新しい評価グループ]** を選択します。
新しい評価グループを作成するには、グループの間隔を指定します。
同じグループ内のすべてのルールは、同じ時間間隔で順番に評価されます。
1. 保留期間を入力します。
保留期間は、アラートルールが発射するまで条件に違反している可能性がある期間です。
条件が満たされると、アラートは `Pending` 状態に入ります。指定された期間、条件がアクティブなままの場合、アラートは `Firing` 状態に移行します。アクティブでない場合は `Normal` 状態に戻ります。
アラートルールにラベルを追加して、発射アラートインスタンスを処理する通知ポリシーを設定します。
ラベルに関係なく、すべてのアラートルールとインスタンスはデフォルトの通知ポリシーと一致します。ネストされたポリシーがない場合、またはネストされたポリシーがアラートルールまたはアラートインスタンスのラベルと一致しない場合、デフォルトの通知ポリシーは一致するポリシーです。
**通知の設定**
+ 通知のルーティング方法を変更するには、ラベルを追加します。
ドロップダウンから既存のキーと値のペアを選択してカスタムラベルを追加するか、新しいキーまたは値を入力して新しいラベルを追加します。
[注釈](v10-alerting-overview-labels.md#v10-alerting-overview-labels-annotations)を追加して、アラート通知にアラートに関するコンテキストをさらに提供できます。
注釈は、アラート通知のアラートに関する詳細情報を提供するメタデータを追加します。例えば、アラートが発生した値や発生したサーバーを示す `Summary` 注釈を追加します。
**注釈を追加するには**
1. [オプション] 概要を追加します。
何が起こったのか、その理由の簡単な概要。
1. (オプション) 説明を追加します。
アラートルールの動作の説明。
1. [オプション] ランブック URL を追加します。
アラートのランブックを保持するウェブページ
1. [オプション] カスタム注釈を追加します
1. [オプション] ダッシュボードとパネルリンクを追加します。
アラートをダッシュボードのパネルにリンクします。
1. **[ルールを保存]** を選択します。
# 記録ルールを設定する
****
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。
外部 Grafana Mimir または Loki インスタンスの記録ルールを作成および管理することができます。記録ルールは、頻繁に必要になる式や計算負荷の高い式を事前に計算し、その結果を新しい時系列セットとして保存します。この新しい時系列のクエリは、特にダッシュボードでは、ダッシュボードが更新されるたびに同じ式をクエリするため、より高速になります。
**注記**
記録ルールはインスタンスルールとして実行され、10 秒ごとに実行されます。
**前提条件**
+ Prometheus または Loki データソースへの書き込みアクセス権限があることを確認します。データソースでアラートルールを作成または更新します。
+ Grafana Mimir および Loki データソースの場合、それぞれのサービスを設定して Ruler API を有効にします。
+ **Loki** - Loki データソースのデフォルトである `local` ルールストレージタイプは、ルールの表示のみをサポートしています。ルールを編集する場合、他のストレージタイプを設定してください。
+ **Grafana Mimir** – `/prometheus` プレフィックスを使用します。Prometheus データソースは Grafana Mimir と Prometheus の両方に対応しており、Grafana はクエリ API と Ruler API の両方が同じ URL にあることを想定しています。Ruler API に別の URL を指定することはできません。
**注記**
特定の Loki または Prometheus データソースのアラートルールを管理しない場合は、その設定に移動し、**[アラート UI 経由でアラートを管理する]** チェックボックスをオフにします。
**記録ルールを作成するには**
1. Grafana コンソールの Grafana メニューで、**[アラート]**、**[アラートルール]** を選択します。
1. **[新しい記録ルール]** を選択します。
1. ルール名を設定します。
記録ルール名は Prometheus メトリクス名で、空白を含まない必要があります。
1. クエリの定義
+ Loki または Prometheus データソースを選択します。
+ クエリを入力します。
1. 名前空間とグループを追加します。
+ **[名前空間]** ドロップダウンから、既存のルール名前空間を選択するか、新しいルール名前空間を追加します。名前空間には 1 つ以上のルールグループを含めることができます。これは、組織的な目的を持たせるためのみに使用します。
+ **[グループ]** ドロップダウンから、選択した名前空間内の既存のグループを選択するか、新しいものを作成します。新しく作成されたルールは、グループの末尾に追加されます。グループ内のルールは、同じ評価時間で一定の間隔で順番に実行されます。
1. ラベルを追加します。
+ ドロップダウンから既存のキーと値のペアを選択してカスタムラベルを追加するか、新しいキーまたは値を入力して新しいラベルを追加します。
1. **[ルールを保存]** を選択してルールを保存するか、**[ルールを保存して終了]** を選択してルールを保存し、アラートページに戻ります。
# コンタクトポイントの設定
****
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。
コンタクトポイントを使用して、アラートルールが発生したときにコンタクトに通知する方法を定義します。
**注記**
Grafana で管理されるアラートの通知先 (コンタクトポイント) は、作成および編集が可能です。データソース管理アラートのコンタクトポイントは読み取り専用です。
## コンタクトポイント (通知先) の使用
次の手順では、通知先 (コンタクトポイント) を追加、編集、削除、テストする方法について説明します。
**コンタクトポイントの追加方法**
1. 左側のメニューで、**[アラート]** を選択します。
1. **[コンタクトポイント]** を選択します。
1. **[アラートマネージャーの選択]** ドロップダウンから、アラートマネージャーを選択します。デフォルトでは、Grafana アラートマネージャーが選択されています。
1. **[コンタクトポイント]** タブで、 **[\$1 コンタクトポイントの追加]** を選択します。
1. コンタクトポイントの** [名前]** を入力します。
1. **[統合]** からタイプを選択し、そのタイプに基づいて必須フィールドを入力します。例えば、Slack を選択した場合は、Slack チャネルと通知先となるユーザーを入力します。
1. 選択したコンタクトポイントで利用可能な場合は、任意の**オプション設定**を選択して追加の設定を指定します。
1. **[通知設定]**で**[解決済みメッセージの無効化]**を選択すると、アラートが解決した際に通知を受け取らないようにすることができます (任意)。
1. 別のコンタクトポイント統合を追加するには、**[コンタクトポイント統合を追加]** を選択し、必要なコンタクトポイントタイプごとにステップを繰り返します。
1. 変更内容を保存します。
**コンタクトポイントの編集方法**
1. 左側のメニューで、**[アラート]** を選択します。
1. **[コンタクトポイント]**を選択すると、現在設定されているコンタクトポイントのリストが表示されます。
1. 編集する連絡先を選択し、**[編集]** を選択します。
1. 連絡先を更新し、変更を保存します。
使用されていないコンタクトポイントは、通知ポリシーで削除できます。
**連絡先の削除方法**
1. 左側のメニューで、**[アラート]** を選択します。
1. **[コンタクトポイント]** を選択して、現在設定されているコンタクトポイントのリストを開きます。
1. **コンタクトポイント** で、削除するコンタクトポイントを選択し、**[詳細]**、**[削除]** を選択します。
1. 確認ダイアログボックスで、**[はい、削除]** を選択します。
**注記**
コンタクトポイントが通知ポリシーで使用されている場合、コンタクトポイントを削除する前に、通知ポリシーを削除するか、別のコンタクトポイントを使用するように編集する必要があります。
コンタクトポイントを作成したら、テスト通知を送信して、正しく設定されていることを確認します。
**テスト通知の送信方法**
1. 左側のメニューで、**[アラート]** を選択します。
1. **[コンタクトポイント]** を選択して、現在設定されているコンタクトポイントのリストを開きます。
1. **コンタクトポイント** で、テストするコンタクトポイントを選択し、**[編集]** を選択します。必要に応じて、新しいコンタクトポイントを作成することもできます。
1. **[テスト]** を選択して、コンタクトポイントテストダイアログを開きます。
1. 事前定義されたテスト通知を送信するか、**[カスタム]** を選択してテスト通知に独自の注釈とラベルを追加するかを選択します。
1. **[テスト通知を送信]**を選択して、指定されたコンタクトポイント宛にアラートをテストします。
## コンタクトポイント統合の設定
アラートルールの発射時に通知を受信するための優先通信チャネルを選択するように Grafana でコンタクトポイント統合を設定します。各統合には、独自の設定オプションとセットアッププロセスがあります。ほとんどの場合、これには API キーまたは Webhook URL の提供が含まれます。
設定が完了すると、コンタクトポイントの一部として統合を使用して、アラートの状態が変化するたびに通知を受け取ることができます。このセクションでは、PagerDuty を例として使用して統合を設定する基本的な手順について説明します。これにより、リアルタイムアラートの受信を開始し、モニタリングデータを常に把握できます。
**サポートされている統合のリスト**
次の表に、Grafana でサポートされているコンタクトポイントのタイプを示します。
| 名前 | タイプ |
| --- | --- |
| Amazon SNS | `sns` |
| OpsGenie | `opsgenie` |
| Pager Duty | `pagerduty` |
| Slack | `slack` |
| VictorOps | `victorops` |
**アラート用の PagerDuty の設定**
PagerDuty を設定するには、統合キーを指定する必要があります。次の詳細情報を入力します：
| 設定 | 説明 |
| --- | --- |
| 統合キー | PagerDuty の統合キー |
| 緊急度 | 動的通知のレベル。デフォルトは critical です。 |
| カスタムの詳細 | イベントに関するその他の詳細 |
`CustomDetails` フィールドは、任意のキーと値のペアを含むオブジェクトです。ユーザー定義の詳細が、デフォルトで使用されている詳細とマージされます。
`CustomDetails` のデフォルト値は次のとおりです。
```
{
"firing": `{{ template "__text_alert_list" .Alerts.Firing }}`,
"resolved": `{{ template "__text_alert_list" .Alerts.Resolved }}`,
"num_firing": `{{ .Alerts.Firing | len }}`,
"num_resolved": `{{ .Alerts.Resolved | len }}`,
}
```
キーが重複している場合、ユーザー定義の詳細がデフォルトのキーを上書きします。
# 通知ポリシーを設定する
****
このドキュメントのトピックは、**Grafana バージョン 10.x** をサポートする Grafana ワークスペース向けです。
Grafana バージョン 9.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 9 での作業](using-grafana-v9.md)」を参照してください。
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。
通知ポリシーでは、アラートがコンタクトポイント (通知先) にどのように配信されるかを指定します。
ポリシーにはツリー構造があり、1 つ以上のネストされたポリシーを各ポリシーに含めることができます。デフォルトポリシーを除く各ポリシーは、特定のアラートラベルと一致させることもできます。
各アラートは、デフォルトのポリシーによって評価され、それに続き、ネストされた各ポリシーによって評価されます。
ネストされたポリシーの `Continue matching subsequent sibling nodes` オプションを有効にすると、1 つ以上一致があった後も評価が続行されます。子ポリシーのいずれとも一致しない場合、親ポリシーの設定とコンタクトポイント (通知先) の情報によってアラートの動作が制御されます。デフォルトのポリシーは、ネストされたポリシーと一致しないアラートを管理します。
これらの通知ポリシーの詳細については、「[通知](v10-alerting-explore-notifications.md)」を参照してください。
以下に、通知ポリシーを作成および管理するための手順を紹介します。
**デフォルトの通知ポリシーの編集方法**
1. 左側のメニューで、**[アラート]** を選択します。
1. **[通知ポリシー]** を選択します。
1. **[アラートマネージャーの選択]** ドロップダウンから、編集するアラートマネージャーを選択します。
1. **[デフォルトポリシー]** セクションで、 **[...]**、**[編集]** を続けて選択します。
1. **[デフォルトのコンタクトポイント]** で、アラートルールが特定のポリシーと一致しない場合に通知を送信するコンタクトポイント (通知先) を更新します。
1. **[グループ化]** で、アラートをグループ化するラベルを選択します。このポリシーに複数のアラートが一致すると、それらのアラートはこれらのラベルでグループ化されます。グループごとに通知が送信されます。フィールドが空 (デフォルト) の場合、すべての通知は 1 つのグループで送信されます。特別なラベル `...` を使用して、すべてのラベルでアラートをグループ化します (グループ化を効果的に無効にします）。
1. **[タイミングオプション]** で、以下のいずれかを選択します。
+ **[グループ待機]** – 同じグループのアラートをバッファリングしてから、最初の通知を送信するまでの待機時間。デフォルト値は 30 秒です。
+ **[グループ間隔]** – グループ内の 2 つの通知の最小時間間隔。デフォルト値は 5 分です。
+ **[繰り返し間隔]** – グループに新しいアラートが追加されなかった場合に、通知を再送信するまでの最小時間間隔。デフォルトは 4 時間です。
1. **[保存]** を選択して変更を保存します。
新しい通知ポリシーを作成するには、ツリー構造を考慮する必要があります。ツリーのトランクに作成された新しいポリシー (デフォルトポリシー) は、ツリーブランチです。各ブランチには、独自のネストされたポリシーを含めることができます。そのため、デフォルトのポリシーまたは既にネストされたポリシーのいずれかで、常に新しい**ネストされた**ポリシーを追加します。
**新しいネストされたポリシーを追加するには**
1. 左側のメニューで、**[アラート]** を選択します。
1. **[通知ポリシー]** を選択します。
1. **[アラートマネージャーの選択]** ドロップダウンから、編集するアラートマネージャーを選択します。
1. 最上位の特定のポリシーを追加するには、[特定のルーティング] セクション (デフォルトポリシー、または新しいネストされたポリシーを追加する既存の別のポリシーのいずれか) に移動し、**[\$1 新しいネストされたポリシー]** を選択します。
1. 一致するラベルセクションで、アラートラベルを照合するための 1 つ以上のルールを追加します。
1. **[コンタクトポイント]** ドロップダウンで、アラートがこの特定のポリシーのみに一致し、ネストされたポリシーのいずれにも一致しない場合に通知を送信するコンタクトポイントを選択します。
1. オプションで、アラートが現在のポリシーと一致した後でも、**[後続の兄弟ノードを照合し続ける]** を有効にして、兄弟ポリシーの照合を続行します。このオプションを有効にすると、1 つのアラートに対して複数の通知を取得できます。
1. オプションで、**[グループ化の上書き]** を有効にして、デフォルトポリシーと同じグループ化を指定します。オプションが有効になっていない場合、デフォルトのポリシーグループが使用されます。
1. オプションで、**[一般的なタイミングの上書き]** を有効にして、グループ通知ポリシーで設定されているタイミングオプションを上書きします。
1. **[Save policy(ポリシーの保存]** を選択して変更を保存します。
**ネストされたポリシーを編集するには**
1. 左側のメニューで、**[アラート]** を選択します。
1. **[通知ポリシー]** を選択します。
1. 編集するポリシーを選択したら、**[...]**、**[編集]** を続けて選択します。
1. 変更を加えます (ネストされたポリシーを追加する場合と同様)。
1. 変更内容を保存します。
**ポリシーの検索**
ポリシーのツリー内では、*ラベルマッチャー*または*コンタクトポイント*で検索できます。
+ コンタクトポイントで検索するには、**[コンタクトポイントで検索]** フィールドにコンタクトポイントの部分的な名前または完全な名前を入力します。そのコンタクトポイントを使用するポリシーは、ユーザーインターフェイスで強調表示されます。
+ ラベルで検索するには、**[ラベルマッチャーによる検索]** 入力フィールドに有効なラベルマッチャーを入力します。複数のマッチャーをカンマで区切って入力できます。有効なマッチャー入力の例は `severity=high, region=~EMEA|NA` です。
**注記**
ラベルで検索する場合、一致するすべてのポリシーは完全一致になります。部分一致と正規表現形式の一致はサポートされていません。