データソースマネージドアラートルールを設定する

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

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

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

ルーラー 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 は Query API と Ruler API の両方が同じ URL にあることを想定しています。ルーラー API に別の URL を指定することはできません。

注記

特定の Loki または Prometheus データソースのアラートルールを管理したくない場合は、その設定に移動し、アラート UI によるアラートの管理チェックボックスをオフにします。

次の手順では、データソース管理アラートルールを作成するプロセスについて説明します。

データソース管理のアラートルールを作成するには、ワークスペース内のアラート作成フローを使用し、以下のステップに従います。

アラートルール名を設定するには

1. アラートと IRM -> アラートルール -> + 新しいアラートルール を選択します。

2. アラートルールを識別する名前を入力します。

   この名前はアラートルールリストに表示されます。また、このルールから作成されるすべてのアラートインスタンスのalertnameラベルでもあります。

クエリを定義して、測定するデータと、アラートルールが発生する前に満たす必要がある条件を取得します。

クエリと条件を定義するには

1. すべてのアラートルールは、デフォルトで Grafana によって管理されます。データソース管理のアラートルールに切り替えるには、データソース管理のアラートルールに切り替える を選択します。

2. ドロップダウンリストからデータソースを選択します。

   Open advanced data source picker を選択して、データソースの追加 (管理者のみ) など、その他のオプションを表示することもできます。

3. PromQL または LogQL クエリを入力します。

4. アラートのプレビュー を選択します。

アラートルール評価を使用して、アラートルールを評価する頻度と、その状態を変更する速度を決定します。

アラート評価の動作を設定するには

1. 名前空間を選択するか、+ 新しい名前空間 を選択します。

2. 評価グループを選択するか、+ 新しい評価グループ を選択します。

   新しい評価グループを作成する場合は、グループの間隔を指定します。

   同じグループ内のすべてのルールは、同じ時間間隔で順番に評価されます。

3. 保留中の期間を入力します。

   保留期間は、アラートルールが起動するまで条件に違反している可能性がある期間です。

   条件が満たされると、アラートは Pending状態になります。指定された期間、条件がアクティブなままの場合、アラートは Firing状態に移行し、アクティブでない場合は Normal状態に戻ります。

アラートルールにラベルを追加して、発射アラートインスタンスを処理する通知ポリシーを設定します。

すべてのアラートルールとインスタンスは、ラベルに関係なく、デフォルトの通知ポリシーと一致します。ネストされたポリシーがないか、アラートルールまたはアラートインスタンスのラベルに一致するネストされたポリシーがない場合、デフォルトの通知ポリシーは一致するポリシーです。

通知の設定

• 通知のルーティング方法を変更する場合は、ラベルを追加します。

  ドロップダウンから既存のキーと値のペアを選択してカスタムラベルを追加するか、新しいキーまたは値を入力して新しいラベルを追加します。

注釈を追加して、アラート通知のアラートに関するコンテキストを追加します。

アノテーションはメタデータを追加して、アラート通知のアラートに関する詳細情報を提供します。例えば、どの値でアラートが起動したか、どのサーバーで発生したかを示すSummary注釈を追加します。

注釈を追加するには

1. 〔オプション] 概要を追加します。

   何が起こったのか、その理由の簡単な概要。

2. 〔オプション] 説明を追加します。

   アラートルールの動作の説明。

3. 〔オプション] ランブック URL を追加します。

   アラートのランブックを保持するウェブページ

4. 〔オプション] カスタム注釈を追加する

5. 〔オプション] ダッシュボードとパネルリンクを追加します。

   アラートをダッシュボードのパネルにリンクします。

6. [Save rule] (ルールを保存) を選択します。