

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# アラートルールの管理
<a name="v9-alerting-managerules"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

アラートルールは、アラートを起動するかどうかを決定する一連の評価基準です。アラートルールは、1 つ以上のクエリと式、条件、評価の頻度、およびオプションとしてその条件の持続時間で構成されます。

評価するデータセットを「クエリと式」で選択し、「条件」にアラートがアラートを発行するための基準 (しきい値) を設定します。間隔は、アラートルールが評価される頻度を指定します。「持続時間」を設定した場合、その条件下にある状態の継続時間を示します。また、アラートルールでは、データがない場合のアラート動作も設定できます。

**注記**  
Grafana マネージドアラートルールは、ルールを保存するフォルダの編集権限を持つユーザーのみが編集または削除できます。  
外部 Grafana Mimir または Loki インスタンスのアラートルールは、エディタまたは管理者ロールを持つユーザーが編集または削除できます。

**Topics**
+ [Grafana 管理のアラートルールの作成](v9-alerting-managerules-grafana.md)
+ [Grafana Mimir または Loki 管理のアラートルールの作成](v9-alerting-managerules-mimir-loki.md)
+ [Grafana Mimir または Loki 管理の記録ルールの作成](v9-alerting-managerules-mimir-loki-recording.md)
+ [Grafana Mimir または Loki ルールグループと名前空間](v9-alerting-managerules-mimir-loki-groups.md)
+ [アラートルールの表示と編集](v9-alerting-managerules-view-edit.md)

# Grafana 管理のアラートルールの作成
<a name="v9-alerting-managerules-grafana"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

Grafana では、1 つ以上のデータソースをクエリして結果を集約または変換して、それらを相互に比較したり、固定のしきい値と比較したりするアラートルールを作成することができます。これらを実行すると、Grafana はコンタクトポイント (通知先) に通知を送信します。

**Grafana 管理のルールの追加方法**

1. Grafana コンソールの Grafana メニューで、**[アラート]** (ベル) アイコンを選択して **[アラート]** ページを開いて既存のアラートを一覧表示します。

1. **[新しいアラートルール]** を選択します。

1. **ステップ 1** で、以下を参照してルール名、タイプ、ストレージの場所を追加します。
   + **[ルール名]** にわかりやすい名前を追加します。この名前はアラートルールリストに表示されます。またこの名前は、このルールから作成されるすべてのアラートインスタンスの `alertname` ラベルにもなります。
   + **[ルールタイプ]** ドロップダウンから、**[Grafana 管理のアラート]** を選択します。
   + **[フォルダ]** ドロップダウンから、ルールの保存先となるフォルダを選択します。フォルダを選択しない場合、ルールは `General` フォルダに保存されます。フォルダを作成する場合、ドロップダウンを選択し、新しいフォルダ名を入力します。

1. **ステップ 2** で、評価するクエリと式を追加します。
   + 名前はデフォルトのままでも構いませんが、変更する場合、カーソルを合わせて編集アイコンを選択します。
   + クエリの場合、ドロップダウンからデータソースを選択します。
   + 1 つ以上の[クエリまたは式](v9-panels-query-xform-expressions.md)を追加します。
   + 式ごとに **[クラシック条件]**を選択して単一のアラートルールを作成するか、**[Math]**、**[削減]**、**[リサンプリング]** オプションから選択して、各シリーズに個別のアラートを作成します。これらのオプションの詳細については、「[1 次元ルールと多次元ルール](#v9-alerting-single-multi-rule)」を参照してください。
   + **[Run queries]** (クエリの実行) を選択して、クエリが正しく動作すことを確認します。

1. **ステップ 3** で、条件を追加します。
   + **[条件]** ドロップダウンから、アラートルールを発動させるクエリまたは式を選択します。
   + **Evaluate every** (～ごとに評価する) には、評価の頻度を指定します。10 秒の倍数である必要があります。例えば、`1m` や `30s` などです。
   + **[評価対象]** には、アラートが発行されるために必要な条件の継続時間を指定します。
**注記**  
条件が違反すると、アラートは `Pending` 状態に入り、そのまま指定された期間条件の違反が継続するとアラートは `Firing` 状態に移行します。条件から外れた場合、`Normal` 状態に戻ります。
   + **[Configure no data and error handling]** (データがない場合の設定とエラー処理) で、データがない場合のアラート動作を設定します。「[データがない場合やエラーが発生した場合の対処](#v9-alerting-rule-no-data-error)」のガイドラインを参照してください。
   + **[アラートのプレビュー]** を選択してルールを評価し、生成されるアラートを確認します。プレビューでは、データとエラー処理条件は除外されます。

1. **ステップ 4** で、ルールに関連するメタデータを追加します。
   + アラートメッセージのカスタマイズ時に使用する説明と概要を追加します。ガイドライン「[ラベルと注釈](v9-alerting-explore-labels.md)」を参照してください。
   + Runbook URL、パネル、ダッシュボード、アラート ID を追加します。
   + カスタムラベルを追加します。

1. **[保存]** を選択してルールを保存するか、**[保存して終了]** を選択してルールを保存し、**[アラート]** ページに戻ります。

ルールを作成したら、ルールの通知を作成できます。通知の詳細については、「[アラート通知の管理](v9-alerting-managenotifications.md)」を参照してください。

## 1 次元ルールと多次元ルール
<a name="v9-alerting-single-multi-rule"></a>

Grafana 管理のアラートルールでは、従来の条件を使用してルールを作成することも、多次元ルールを作成することもできます。

**1 次元ルール (従来の条件)**

従来の条件式を使用して、条件が満たされたときに単一のアラートを発行するルールを作成します。複数のシリーズを返すクエリの場合、Grafana は各シリーズのアラート状態を追跡しません。そのため、複数のシリーズでアラート条件が満たされた場合でも、Grafana が送信するアラートは 1 件のみです。

式のフォーマット方法の詳細については、*Grafana ドキュメント*の「[式](https://grafana.com/docs/grafana/next/panels/query-a-data-source/)」を参照してください。

**多次元ルール**

クエリで返されるシリーズごとに個別のアラートインスタンスを生成するには、多次元ルールを作成します。

**注記**  
多次元ルールによって生成された各アラートインスタンスは、アラートの合計クォータにカウントされます。クォータに達すると、ルールは評価されなくなります。多次元ルールのクォータの詳細については、「[クォータ到達エラー](#v9-alerting-rule-quota-reached)」を参照してください。

1 つのルールから複数のインスタンスを作成するには、`Math`、`Reduce`、または `Resample` 式を使用して多次元ルールを作成します。例えば、以下のことが可能です:
+ 各クエリに `Reduce` 式を追加すると、選択した時間範囲の値が 1 つの値に集計されます。([数値データ を使用するルール](v9-alerting-explore-numeric.md)には必要ありません)。
+ ルールの条件を含む `Math` 式を追加します。もしクエリや reduce 式がすでにアラートを発行すべき場合は正の数、発行しない場合に 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)」を参照してください。



**多次元ルールのパフォーマンスに関する考慮事項**

各アラートインスタンスは、アラートのクォータ (上限数) にカウントされます。アラートの上限数を超えるインスタンスを作成する多次元ルールは評価されず、クォータエラーが返されます。詳細については、「[クォータ到達エラー](#v9-alerting-rule-quota-reached)」を参照してください。

多次元アラートは、Grafana ワークスペースや、Grafana がアラートルールを評価するためにクエリを実行するデータソースのパフォーマンスに大きな影響を与える可能性があります。監視システムのパフォーマンスを最適化したい場合、以下の考慮事項を参照してください。
+ **ルール評価の頻度** – アラートルールの **[Evaluate Every]** (～ごとに評価する) プロパティでルール評価の頻度を制御します。評価の頻度を許容可能な最小頻度に収めることをお勧めします。
+ **結果セットのカーディナリティ** – ルールで作成されるアラートインスタンスの数は直接そのパフォーマンスに影響します。例えば、すべての仮想マシン上の各 API パスごとに API 応答エラーを監視しているとします。このセットのカーディナリティは「パスの数 × 仮想マシンの数」になります。例えば、仮想マシンあたりのパスごとではなく、仮想マシンあたりの合計エラー数を監視することで、結果セットのカーディナリティを減らすことができます。
+ **クエリの複雑さ** – データソースが迅速に処理して応答できるクエリにするだけで、リソースの消費を大幅に抑えることができます。これは他の考慮事項よりは重要度が低いものの、他の点での最適化が十分に行われている場合、個別のクエリパフォーマンスの見直しが役立つ可能性があります。また、これらのルールの評価がデータソースに与える影響にも注意する必要があります。アラートクエリは、監視データベースで処理されるクエリの大部分を占めることが多いため、Grafana インスタンスにかかる負荷要因がデータソースにも同様に影響を与えます。

## クォータ到達エラー
<a name="v9-alerting-rule-quota-reached"></a>

1 つのワークスペース内に保持できるアラートインスタンスの数にはクォータ (上限) があります。この上限に達した場合、そのワークスペースにこれ以上新たにアラートルールを作成できなくなります。多次元アラートでは、アラートインスタンスの数は時間の経過とともに変動する場合があります。

以下に、アラートインスタンスを使用する際に覚えておくべき重要な点について紹介します。
+ 作成するのが 1 次元ルールのみの場合、ルールからはそれぞれ 1 つのアラートインスタンスが作成されます。1 つのワークスペースに作成できるルールの上限は、アラートインスタンスのクォータ数までとなります。
+ 多次元ルールからは複数のアラートインスタンスが作成されますが、その数は評価されるまでわかりません。例えば、Amazon EC2 インスタンスの CPU 使用率を追跡するアラートルールを作成した場合、最初は 50 台の EC2 インスタンスが対象となり、50 個のアラートインスタンスが作成されますが、1 週間後にさらに 10 台の EC2 インスタンスが追加された場合、次の評価時には 60 個のアラートインスタンスが存在することになります。

  アラートインスタンスの数は、多次元アラートを作成するときに評価され、アラートインスタンスのクォータをすぐに超えるインスタンスを作成することはできません。アラートインスタンスの数は変動する可能性があるため、ルール評価の都度クォータがチェックされます。
+ 評価時に、ルールがアラートインスタンスのクォータを超える場合、アラートルールが更新されアラートインスタンスの合計数がサービスクォータを下回るまで、そのルールは評価されません。この場合、クォータに達したことを通知するアラート通知を受け取ります (通知は評価対象のルールの通知ポリシーを基に送信されます)。通知には、`QuotaReachedError` 値を含む `Error` 注釈が含まれています。
+ `QuotaReachedError` を引き起こすルールは、評価されなくなります。評価は、更新が行われ、更新後の評価が `QuotaReachedError` を引き起こさなくなった場合にのみ再開されます。評価されていないルールは、Grafana コンソールに**クォータ到達**エラーが表示されます。
+ アラートインスタンスの数を減らすには、アラートルールを削除するか、複数次元のアラートを編集してアラートインスタンスを減らします (例えば、仮想マシン内の API ごとに 1 個のアラートではなく、仮想マシンごとの 1 件のエラーに対して 1 個のアラートを持つようにします)。
+ 評価を再開するには、アラートを更新して保存します。アラートインスタンスの数を減らすように更新することもできますし、インスタンス数を減らすために他の変更を加えた場合、変更なしで保存しても構いません。再開可能な場合、評価が再開されます。さらに別の `QuotaReachedError` を引き起こす結果となった場合、保存することはできません。
+ アラートが保存され、アラートクォータを超えることなく評価が再開された場合、Grafana コンソールにはしばらくの間**クォータ到達**エラーが (次の評価間隔まで) 表示され続けることがありますが、アラートルール評価が開始され、ルールのしきい値に達するとアラートが送信されます。
+ アラートのクォータおよびその他のクォータの詳細については、「[Amazon Managed Grafana のサービスクォータ](AMG_quotas.md)」を参照してください。

## データがない場合やエラーが発生した場合の対処
<a name="v9-alerting-rule-no-data-error"></a>

データがない場合やエラーが発生した場合のアラート動作の処理方法を選択します。

データがない場合に選択できる処理方法を、以下の表に照会します。


| データがない場合の選択肢 | 行動 | 
| --- | --- | 
|  データなし  |  アラートルールの名前と UID、およびラベルとしてデータを返さないデータソースの UID を使用したアラート `DatasourceNoData` を作成します。  | 
|  [アラート]  |  アラートルールの状態を `Alerting` に設定します。  | 
|  OK  |  アラートルールの状態を `Normal` に設定します。  | 

エラーが発生した場合に選択できる処理方法を、以下の表に照会します。


| エラーまたはタイムアウト時の選択肢 | 行動 | 
| --- | --- | 
|  [アラート]  |  アラートルールの状態を `Alerting` に設定します  | 
|  OK  |  アラートルールの状態を `Normal` に設定します  | 
|  エラー  |  アラートルールの名前と UID、およびラベルとしてデータを返さないデータソースの UID を使用したアラート `DatasourceError` を作成します。  | 

# Grafana Mimir または Loki 管理のアラートルールの作成
<a name="v9-alerting-managerules-mimir-loki"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

Grafana では、外部の Grafana Mimir または Loki インスタンスのアラートルールを作成することができます。

**注記**  
Grafana Mimir は、Amazon Managed Service for Prometheus および Prometheus データソースに接続できます。

**前提条件**
+ Prometheus データソースへの書き込みアクセス権限があることを確認します。アクセス権限がない場合、Cortex 管理のアラートルールを作成または更新することはできません。
+ Grafana Mimir および Loki データソースの場合、それぞれのサービスを設定して Ruler API を有効にします。
  + **Loki** - Loki データソースのデフォルトである `local` ルールストレージタイプは、ルールの表示のみをサポートしています。ルールを編集する場合、他のストレージタイプを設定してください。
  + **Grafana Mimir** – `/prometheus` ではなく、レガシー `/api/prom` プレフィックスを使用します。Prometheus データソースは Grafana Mimir と Prometheus の両方に対応しており、Grafana はクエリ API と Ruler API の両方が同じ URL にあることを想定しています。Ruler API に別の URL を指定することはできません。

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

**Grafana Mimir または Loki 管理のアラートルールを追加するには**

1. Grafana コンソールの Grafana メニューで、**[アラート]** (ベル) アイコンを選択して **[アラート]** ページを開いて既存のアラートを一覧表示します。

1. **[アラートルールの作成]** を選択します。

1. **ステップ 1** で、次のようにルールタイプと詳細を選択します。
   + **Mimir または Loki アラート**を選択します。
   + **[ルール名]** にわかりやすい名前を追加します。この名前はアラートルールリストに表示されます。またこの名前は、このルールから作成されるすべてのアラートインスタンスの `alertname` ラベルにもなります。
   + **[データソース]の選択**ドロップダウンから、Prometheus または Loki データソースを選択します。
   + **[名前空間]** ドロップダウンから、既存のルール名前空間を選択します。それ以外の場合は、**[新規追加]** を選択し、名前を入力します。名前空間には 1 つ以上のルールグループを含めることができます。これは、組織的な目的を持たせるためのみに使用します。詳細については、「[Cortex または Loki ルールグループと名前空間](alert-rules.md#alert-rule-groups)」を参照してください。
   + **[グループ]** ドロップダウンから、選択した名前空間内の既存のグループを選択します。それ以外の場合は、**[新規追加]** を選択し、名前を入力します。新しく作成されたルールは、グループの末尾に追加されます。グループ内のルールは、同じ評価時間で一定の間隔で順番に実行されます。

1. **ステップ 2** で、評価するクエリを追加します。

   値は PromQL または LogQL 式で指定することができます。評価結果に 0 より大きい値を持つシリーズが 1 つ以上ある場合、ルールはアラートを発行します。アラートはシリーズごとに作成されます。

1. **ステップ 3** で、アラート評価間隔を指定します。

   条件の **[For]** テキストボックスに、アラートが発行されるために必要な条件の継続時間を指定します。例えば `5m` を指定した場合、条件が 5 分間継続した場合にアラートが発行されます。
**注記**  
条件が満たされると、アラートは `Pending` 状態に入り、そのまま指定された期間条件が継続するとアラートは `Firing` 状態に移行します。条件から外れた場合、`Normal` 状態に戻ります。

1. **ステップ 4** で、ルールに関連するメタデータを追加します。
   + アラートメッセージのカスタマイズ時に使用する説明と概要を追加します。ガイドライン「[ラベルと注釈](v9-alerting-explore-labels.md)」を参照してください。
   + Runbook URL、パネル、ダッシュボード、アラート ID を追加します。
   + カスタムラベルを追加します。

1. **[アラートのプレビュー]** を選択してルールを評価し、生成されるアラートを確認します。各アラートの状態と値を含むアラートのリストが表示されます。

1. **[保存]** を選択してルールを保存するか、**[保存して終了]** を選択してルールを保存し、**[アラート]** ページに戻ります。

ルールを作成したら、ルールの通知を作成できます。通知の詳細については、「[アラート通知の管理](v9-alerting-managenotifications.md)」を参照してください。

# Grafana Mimir または Loki 管理の記録ルールの作成
<a name="v9-alerting-managerules-mimir-loki-recording"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

外部 Grafana Mimir または Loki インスタンスの記録ルールを作成および管理することができます。記録ルールは、頻繁に必要になる式や計算負荷の高い式を事前に計算し、その結果を新しい時系列セットとして保存します。この新しい時系列のクエリは、特にダッシュボードでは、ダッシュボードが更新されるたびに同じ式をクエリするため、より高速になります。

**前提条件**

Grafana Mimir および Loki データソースの場合、それぞれのサービスを設定して Ruler API を有効にします。
+ **Loki** - Loki データソースのデフォルトである `local` ルールストレージタイプは、ルールの表示のみをサポートしています。ルールを編集する場合、他のストレージタイプを設定してください。
+ **Grafana Mimir** – Grafana Mimir を指定するようにデータソースを設定するときは、`/prometheus` ではなくレガシー `/api/prom` プレフィックスを使用します。Prometheus データソースは Grafana Mimir と Prometheus の両方に対応しており、Grafana はクエリ API と Ruler API の両方が同じ URL にあることを想定しています。Ruler API に別の URL を指定することはできません。

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

**Grafana Mimir または Loki 管理の記録ルールを追加するには**

1. Grafana コンソールの Grafana メニューで、**[アラート]** (ベル) アイコンを選択して **[アラート]** ページを開いて既存のアラートを一覧表示します。

1. **[アラートルールの作成]** を選択します。

1. **ステップ 1** で、以下を参照してタイプ、ルール名、ストレージの場所を追加します。
   + **Mimir または Loki の記録ルール**オプションを選択します。
   + **[ルール名]** にわかりやすい名前を追加します。この名前はアラートルールリストに表示されます。またこの名前は、このルールから作成されるすべてのアラートインスタンスの `alertname` ラベルにもなります。
   + **[データソース]の選択**ドロップダウンから、Prometheus または Loki データソースを選択します。
   + **[名前空間]** ドロップダウンから、既存のルール名前空間を選択します。それ以外の場合は、**[新規追加]** を選択し、名前を入力します。名前空間には 1 つ以上のルールグループを含めることができます。これは、組織的な目的を持たせるためのみに使用します。詳細については、「[Cortex または Loki ルールグループと名前空間](alert-rules.md#alert-rule-groups)」を参照してください。
   + **[グループ]** ドロップダウンから、選択した名前空間内の既存のグループを選択します。それ以外の場合は、**[新規追加]** を選択し、名前を入力します。新しく作成されたルールは、グループの末尾に追加されます。グループ内のルールは、同じ評価時間で一定の間隔で順番に実行されます。

1. **ステップ 2** で、評価するクエリを追加します。

   値は PromQL または LogQL 式で指定することができます。評価結果に 0 より大きい値を持つシリーズが 1 つ以上ある場合、ルールはアラートを発行します。アラートはシリーズごとに作成されます。

1. **ステップ 3** で、ルールに関連するメタデータを追加します。
   + アラートメッセージのカスタマイズ時に使用する説明と概要を追加します。ガイドライン「[アラートルールの注釈とラベル](alert-rules.md#alert-rule-labels)」を参照してください。
   + Runbook URL、パネル、ダッシュボード、アラート ID を追加します。
   + カスタムラベルを追加します。

1. **[保存]** を選択してルールを保存するか、**[保存して終了]** を選択してルールを保存し、**[アラート]** ページに戻ります。

# Grafana Mimir または Loki ルールグループと名前空間
<a name="v9-alerting-managerules-mimir-loki-groups"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

ルールは整理することができます。ルールはルールグループ内に作成され、ルールグループは名前空間に整理されます。ルールグループ内のルールは、一定の間隔で順次実行されます。デフォルトの間隔は 1 分です。また、Grafana Mimir または Loki の名前空間とルールグループの名前を変更したり、ルールグループの評価間隔を編集することができます。

**ルールグループまたは名前空間の編集方法**

1. Grafana コンソールの Grafana メニューで、**[アラート]** (ベル) アイコンを選択して **[アラート]** ページを開きます。

1. 編集するルールグループまたは名前空間内のルールに移動します。

1. **[編集]** (ペン) アイコンを選択します。

1. ルールグループまたは名前空間に変更を加えます。
**注記**  
名前空間では、名前のみを編集できます。ルールグループの場合、名前、またはグループ内のルールの評価間隔を変更します。たとえば、ルールを 1 分ごとに評価する場合は `1m` を選択し、30 秒ごとに評価する場合は `30s` を選択します。

1. **[変更の保存]** をクリックします。

# アラートルールの表示と編集
<a name="v9-alerting-managerules-view-edit"></a>

****  
このドキュメントのトピックは、**Grafana バージョン 9.x** をサポートする Grafana ワークスペース向けです。  
Grafana バージョン 10.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 10 での作業](using-grafana-v10.md)」を参照してください。  
Grafana バージョン 8.x をサポートする Grafana ワークスペースについては、「[Grafana バージョン 8 での作業](using-grafana-v8.md)」を参照してください。

**[アラート]** ページには、アラートルールが一覧表示されます。デフォルトでは、ルールはデータソースの種類ごとにグループ化されます。**Grafana** セクションには Grafana によって管理されるルールが一覧表示され、**Cortex/Loki** セクションには Prometheus 互換データソースのルールが一覧表示されます。Prometheus 互換データソースのアラートルールは表示できますが、編集することはできません。

Mimir/Cortex/Loki ルールセクションには、Mimir、Cortex、または Loki データソースのすべてのルールが一覧表示されます。クラウドアラートルールもこのセクションに表示されます。

大量のアラートを管理する場合、拡張アラートルール検索機能を使用して、フォルダ、評価グループ、ルールをフィルタリングできます。さらに、ラベル、状態、タイプ、正常性などのプロパティでアラートルールをフィルタリングできます。

**注記**  
プロビジョニングされたアラートのクエリ定義は表示することはできますが、編集はできません。これらを表示できるため、ルール定義のプロビジョニングリポジトリに戻ることなく、クエリとルール定義が正しいことを確認できます。

## アラートルールの表示
<a name="v9-alerting-managerules-view"></a>

Grafana アラートを使用すると、すべてのアラートを 1 ページに表示できます。

**アラートの詳細を表示するには**

1. Grafana コンソールの Grafana メニューで、**[アラート]** (ベル) アイコンを選択して **[アラート]** ページを開きます。デフォルトでは、ルールはデータソースの種類ごとにグループ化して表示されます。各アラートの現在の状態別に表示することもできます (詳細については後述します)。

1. **[表示形式]** では、グループビューと状態ビューを切り替えることができます。

1. 行の横にある矢印を選択すると、その行の詳細が表示されます。ルールの詳細には、ルールのラベル、注釈、データソース、クエリ、およびルールから生成されたアラートインスタンスのリストが含まれます。

**注記**  
アラートの詳細については、「[アラートルールの状態と正常性](v9-alerting-explore-state.md)」を参照してください。

**グループビュー**

グループビューには、フォルダ別にグループ化された Grafana アラートルールと、`namespace` \$1 `group` 別にグループ化された Loki または Prometheus アラートルールが表示されます。これは、ルールの管理を目的としたデフォルトのルールリストビューです。各グループを展開すると、そのグループ内のルールのリストが表示されます。さらにルールを展開すると、その詳細を見ることができます。また、ルールから生成されたアクションボタンとアラートを展開して、詳細を表示することもできます。

**状態ビュー**

状態ビューには、アラートルールが状態ごとグループ化されて表示されます。このビューを使用すると、各ルールがどの状態にあるかを一目で確認できます。各ルールは展開して詳細を表示することがでます。アクションボタンとこのルールによって生成されたアラート、および各アラートをさらに展開して詳細を表示することができます。

**アラートルールのフィルター**

**[アラート]** ページに表示されるアラートルールは、いくつかの方法でフィルタリングできます。
+ 特定のデータソースを使用するルールだけを表示するには **[データソースの選択]** でフィルタリングするデータソースを選択します。
+ また、**[ラベルで検索]** から検索条件を選択して、ラベルでフィルタリングすることもできます。例えば、`environment=production,region=~US|EU,severity!=warning` と入力して、米国と欧州の本番稼働警告をフィルタリングできます。
+ 特定の状態のルールだけを表示するには **[状態でアラートをフィルタリング]** で表示する状態を選択します。

## アラートルールの編集または削除
<a name="v9-alerting-managerules-edit"></a>

Grafana管理のアラートルールの編集または削除は、ルールが保存されているフォルダに対する編集権限を持つユーザーのみが行うことができます。外部 Mimir または Loki インスタンスのアラートルールの編集または削除は、エディタまたは管理者ロールを持つユーザーが行うことができます。

**ルールを編集または削除するには**

1. **表示**、**編集**、**削除**のルールコントロールが表示されるまでルールを展開します。

1. **[編集]** を選択してルールの作成ページを開きます。更新方法はルール作成方法と同じです。詳細については、「[Grafana 管理のアラートルールの作成](v9-alerting-managerules-grafana.md)」または「[Grafana Mimir または Loki 管理のアラートルールの作成](v9-alerting-managerules-mimir-loki.md)」の手順を参照してください。

1. 削除する場合は **[削除]** を選択してルールを削除します。

## アラートルールのエクスポート
<a name="v9-alerting-managerules-export"></a>

Export を選択すると、Grafana ワークスペースの YAML または JSON にルールを**[エクスポート]**できます。これにより、新しいルールを定義してからエクスポートするオプションが提供されます。UI を使用してルールを作成し、プロビジョニング API または terraform スクリプトで使用するためにエクスポートできます。

**注記**  
これは、Grafana ワークスペースとプロビジョニングインターフェイスの両方でサポートされています。