View a markdown version of this page

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

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

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

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

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

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. [保存] を選択してルールを保存するか、[保存して終了] を選択してルールを保存し、[アラート] ページに戻ります。