Grafana Mimir または Loki 管理の記録ルールの作成 - Amazon Managed Grafana

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

Grafana Mimir または Loki 管理の記録ルールの作成

このドキュメントのトピックは、Grafana バージョン 9.x をサポートする Grafana ワークスペース向けです。

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

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

外部 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 メニューで、[アラート] (ベル) アイコンを選択して [アラート] ページを開いて既存のアラートを一覧表示します。

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

  3. ステップ 1 で、以下を参照してタイプ、ルール名、ストレージの場所を追加します。

    • Mimir または Loki の記録ルールオプションを選択します。

    • [ルール名] にわかりやすい名前を追加します。この名前はアラートルールリストに表示されます。またこの名前は、このルールから作成されるすべてのアラートインスタンスの alertname ラベルにもなります。

    • [データソース]の選択ドロップダウンから、Prometheus または Loki データソースを選択します。

    • [名前空間] ドロップダウンから、既存のルール名前空間を選択します。それ以外の場合は、[新規追加] を選択し、名前を入力します。名前空間には 1 つ以上のルールグループを含めることができます。これは、組織的な目的を持たせるためのみに使用します。詳細については、「Cortex または Loki ルールグループと名前空間」を参照してください。

    • [グループ] ドロップダウンから、選択した名前空間内の既存のグループを選択します。それ以外の場合は、[新規追加] を選択し、名前を入力します。新しく作成されたルールは、グループの末尾に追加されます。グループ内のルールは、同じ評価時間で一定の間隔で順番に実行されます。

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

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

  5. ステップ 3 で、ルールに関連するメタデータを追加します。

    • アラートメッセージのカスタマイズ時に使用する説明と概要を追加します。ガイドライン「アラートルールの注釈とラベル」を参照してください。

    • Runbook URL、パネル、ダッシュボード、アラート ID を追加します。

    • カスタムラベルを追加します。

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