この文書は自動機械翻訳技術を使用して翻訳されています。正確な翻訳を提供するように努めておりますが、翻訳された内容の完全性、正確性、信頼性については一切保証いたしません。相違がある場合は、元の英語版英語が優先され、正式なテキストとなります。

PrometheusRulesの設定

PrometheusRuleは、Prometheusのアラートおよび/または記録ルールのグループを定義します。

このセクションは、監視コンポーネントがどのように連携して動作するかに精通していることを前提としています。詳細については、このセクションを参照してください。

Rancher UIでのPrometheusRulesの作成

前提条件:

監視アプリケーションをインストールする必要があります。

Rancher UIでルールグループを作成するには、

ルールグループを作成したいクラスターに移動します。Monitoring Advancedをクリックし、*Prometheus Rules*をクリックします。
［作成］をクリックします。
*グループ名*を入力してください。
ルールを設定します。RancherのUIでは、ルールグループにはアラートルールまたは記録ルールのいずれかが含まれることを期待していますが、両方は含まれません。フォームの記入に関するヘルプは、以下の設定オプションを参照してください。
［作成］をクリックします。

*結果:*アラートは、受信者に通知を送信するように構成できます。

PrometheusRuleカスタムリソースについて

ルール（PrometheusRuleリソースのRuleGroup内で宣言される）を定義する際に、ルール自体のspecには、Alertmanagerがこのアラートを受信すべきルートを特定するために使用するラベルが含まれています。例えば、ラベル`team: front-end`を持つアラートは、そのラベルに一致するすべてのルートに送信されます。

Prometheusルールファイルは、PrometheusRuleカスタムリソースに保持されます。PrometheusRuleを使用すると、1つ以上のRuleGroupを定義できます。各RuleGroupは、アラートルールまたは記録ルールを表すことができるRuleオブジェクトのセットで構成され、以下のフィールドを持ちます：

新しいアラートまたは記録の名前
新しいアラートまたは記録のためのPromQL式
アラートまたはレコードに添付されるべきラベル（例：クラスター名や重要度）
アラートの通知に表示する必要がある追加の重要な情報をエンコードする注釈（例：要約、説明、メッセージ、ランブックのURLなど）。このフィールドは、記録ルールには必須ではありません。

指定できるフィールドに関する詳細については、 Prometheus Operator spec.をご覧ください。

Prometheusオブジェクトのラベルセレクターフィールド ruleSelector を使用して、Prometheusにマウントしたいルールファイルを定義します。

例については、記録ルールおよびアラートルールに関するPrometheusのドキュメントを参照してください。

設定

ルールグループ

フィールド	説明
Group Name	グループの名前です。ルールファイル内で一意である必要があります。
グループ間隔のオーバーライド	グループ内のルールが評価される頻度の秒単位の期間。

フィールド

説明

Group Name

グループの名前です。ルールファイル内で一意である必要があります。

グループ間隔のオーバーライド

グループ内のルールが評価される頻度の秒単位の期間。

アラートルール

アラートルールを使用すると、PromQL（Prometheus Query Language）式に基づいてアラート条件を定義し、発火したアラートについて外部サービスに通知を送信できます。

フィールド	説明
アラート名	アラートの名前。有効なラベル値である必要があります。
発火までの待機時間	秒単位の期間。アラートは、この期間が経過すると発火したと見なされます。まだ十分に発火していないアラートは保留中と見なされます。
PromQL式	評価するためのPromQL式です。Prometheusは、すべての評価サイクルでこのPromQL式の現在の値を評価し、すべての結果のタイムシリーズが保留/発火アラートになります。詳細については、 Prometheusのドキュメントまたは私たちの例のPromQL式を参照してください。
ラベル	各アラートに追加または上書きするラベルです。
緊急度	有効にすると、ラベルはアラートまたはレコードに添付され、重大度レベルによって識別されます。
重大度ラベルの値	クリティカル、警告、またはなし
注釈	アノテーションは、アラートの説明やランブックのリンクなど、長い追加情報を保存するために使用できる情報ラベルのセットです。ランブックは、アラートの処理方法に関するドキュメントのセットです。アノテーションの値はテンプレート化できます。

フィールド

説明

アラート名

アラートの名前。有効なラベル値である必要があります。

発火までの待機時間

秒単位の期間。アラートは、この期間が経過すると発火したと見なされます。まだ十分に発火していないアラートは保留中と見なされます。

PromQL式

評価するためのPromQL式です。Prometheusは、すべての評価サイクルでこのPromQL式の現在の値を評価し、すべての結果のタイムシリーズが保留/発火アラートになります。詳細については、 Prometheusのドキュメントまたは私たちの例のPromQL式を参照してください。

ラベル

各アラートに追加または上書きするラベルです。

緊急度

有効にすると、ラベルはアラートまたはレコードに添付され、重大度レベルによって識別されます。

重大度ラベルの値

クリティカル、警告、またはなし

注釈

アノテーションは、アラートの説明やランブックのリンクなど、長い追加情報を保存するために使用できる情報ラベルのセットです。ランブックは、アラートの処理方法に関するドキュメントのセットです。アノテーションの値はテンプレート化できます。

記録ルール

記録ルールは、頻繁に必要とされるまたは計算コストの高いPromQL（Prometheus Query Language）式を事前に計算し、その結果を新しいタイムシリーズのセットとして保存できます。

フィールド	説明
タイムシリーズ名	出力するタイムシリーズの名前です。有効なメトリック名である必要があります。
PromQL式	評価するためのPromQL式です。Prometheusは、すべての評価サイクルでこのPromQL式の現在の値を評価し、その結果を’レコード’で指定されたメトリック名を持つ新しいタイムシリーズのセットとして記録します。式に関する詳細については、 Prometheusのドキュメントまたは私たちの例のPromQL式を参照してください。
ラベル	結果を保存する前に追加または上書きするラベルです。

フィールド

説明

タイムシリーズ名

出力するタイムシリーズの名前です。有効なメトリック名である必要があります。

PromQL式

評価するためのPromQL式です。Prometheusは、すべての評価サイクルでこのPromQL式の現在の値を評価し、その結果を’レコード’で指定されたメトリック名を持つ新しいタイムシリーズのセットとして記録します。式に関する詳細については、 Prometheusのドキュメントまたは私たちの例のPromQL式を参照してください。

ラベル

結果を保存する前に追加または上書きするラベルです。