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

Grafana アラートルールの作成と管理

アラートルールは、アラートが開始されるかどうかを決定する一連の評価基準です。ルールは、1 つ以上のクエリと式、条件、評価の頻度、およびオプションで条件が満たされる期間で構成されます。

クエリと式が評価するデータセットを選択する間、条件はアラートを作成するためにアラートが満たす必要があるしきい値を設定します。間隔は、アラートルールが評価される頻度を指定します。期間を設定すると、条件を満たす必要がある期間を示します。ルールでは、データがない場合のアラート動作を定義することもできます。

以下のセクションでは、さまざまな種類の Grafana アラートルールの作成と管理について説明します。

Cortex または Loki マネージドアラートルールの作成

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

前提条件

Cortex または Loki が管理する録画ルールの作成

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

前提条件

Cortex および Loki データソースの場合は、それぞれのサービスを設定してルーラー API を有効にします。

Grafana マネージドアラートルールの作成

Grafana では、1 つ以上のデータソースをクエリし、結果を減少または変換して、相互に比較したり、しきい値を修正したりするアラートルールを作成できます。これらが処理されると、Grafana は連絡先に通知を送信します。

単一および多次元ルール

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

単一次元ルール (クラシック条件）

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

式のフォーマット方法の詳細については、Grafana ドキュメントの「式」を参照してください。

多次元ルール

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

1 つのルールから複数のインスタンスを作成するには、Math、Reduce、または Resample式を使用して多次元ルールを作成します。例えば、以下のことが可能です。

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

各アラートインスタンスは、アラートクォータにカウントされます。アラートクォータ内で対応できる数よりも多くのインスタンスを作成する多次元ルールは評価されず、クォータエラーを返します。詳細については、「クォータ到達エラー」を参照してください。

多次元アラートは、Grafana ワークスペースのパフォーマンスや、Grafana がアラートルールを評価するためにクエリを実行する際のデータソースのパフォーマンスに大きな影響を与える可能性があります。以下の考慮事項は、モニタリングシステムのパフォーマンスを最適化する際に役立ちます。

クォータ到達エラー

1 つのワークスペース内に保持できるアラートインスタンスの数にはクォータがあります。この数に達すると、そのワークスペースに新しいアラートルールを作成できなくなります。多次元アラートでは、アラートインスタンスの数は時間の経過とともに変化する可能性があります。

アラートインスタンスを使用する際に覚えておくべき重要な点は次のとおりです。

データまたはエラーケースなしの処理

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

データを処理しないためのオプションを次の表に示します。

エラーケースを処理するためのオプションを次の表に示します。

アラートルールの注釈とラベル

アノテーションとラベルは、アラートルール、データソースレスポンス、アラートルール評価の結果として発生したアラートに関連付けられたキーと値のペアです。アラート通知で直接使用することも、テンプレートやテンプレート関数で使用して、通知連絡先を動的に作成することもできます。

注釈

注釈は、アラートに関する追加情報を提供するキーと値のペアです。次の注釈を使用できます: description、summary、runbook_url、、alertIddashboardUid、および panelId。これらは UI のルールとアラートの詳細に表示され、コンタクトポイントメッセージテンプレートで使用できます。

ラベル

ラベルは、アラートに関する情報を含むキーと値のペアです。アラートのラベルセットは、アラートの評価と通知プロセスを通じて生成され、 に追加されます。これらは次の方法で使用されます。

注釈とラベルを展開する場合、次のテンプレート変数を使用できます。

アラートルールの管理

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

アラートルールを表示する

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

グループビュー

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

状態ビュー

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

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

アラートページに表示されるアラートルールは、いくつかの方法でフィルタリングできます。

アラートルールの編集または削除

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

Cortex または Loki ルールグループと名前空間

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