翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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 管理の記録ルールを追加するには
-
Grafana コンソールの Grafana メニューで、[アラート] (ベル) アイコンを選択して [アラート] ページを開いて既存のアラートを一覧表示します。
-
[アラートルールの作成] を選択します。
-
ステップ 1 で、以下を参照してタイプ、ルール名、ストレージの場所を追加します。
-
Mimir または Loki の記録ルールオプションを選択します。
-
[ルール名] にわかりやすい名前を追加します。この名前はアラートルールリストに表示されます。またこの名前は、このルールから作成されるすべてのアラートインスタンスの
alertname
ラベルにもなります。 -
[データソース]の選択ドロップダウンから、Prometheus または Loki データソースを選択します。
-
[名前空間] ドロップダウンから、既存のルール名前空間を選択します。それ以外の場合は、[新規追加] を選択し、名前を入力します。名前空間には 1 つ以上のルールグループを含めることができます。これは、組織的な目的を持たせるためのみに使用します。詳細については、「Cortex または Loki ルールグループと名前空間」を参照してください。
-
[グループ] ドロップダウンから、選択した名前空間内の既存のグループを選択します。それ以外の場合は、[新規追加] を選択し、名前を入力します。新しく作成されたルールは、グループの末尾に追加されます。グループ内のルールは、同じ評価時間で一定の間隔で順番に実行されます。
-
-
ステップ 2 で、評価するクエリを追加します。
値は PromQL または LogQL 式で指定することができます。評価結果に 0 より大きい値を持つシリーズが 1 つ以上ある場合、ルールはアラートを発行します。アラートはシリーズごとに作成されます。
-
ステップ 3 で、ルールに関連するメタデータを追加します。
-
アラートメッセージのカスタマイズ時に使用する説明と概要を追加します。ガイドライン「アラートルールの注釈とラベル」を参照してください。
-
Runbook URL、パネル、ダッシュボード、アラート ID を追加します。
-
カスタムラベルを追加します。
-
-
[保存] を選択してルールを保存するか、[保存して終了] を選択してルールを保存し、[アラート] ページに戻ります。