第9章 PrometheusRule [monitoring.coreos.com/v1]


説明

PrometheusRule カスタムリソース定義 (CRD) では、Prometheus または ThanosRuler オブジェクトによって評価される [アラート](https://prometheus.io/docs/prometheus/latest/configuration/alerting_rules/) および [記録](https://prometheus.io/docs/prometheus/latest/configuration/recording_rules/) のルールを定義します。

Prometheus および ThanosRuler オブジェクトは、ラベルセレクターと namespace セレクターを使用して PrometheusRule オブジェクトを選択します。

object
必須
  • spec

9.1. 仕様

プロパティー説明

apiVersion

string

apiVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。

kind

string

kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できる場合があります。これは更新できません。CamelCase を使用します。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。

metadata

ObjectMeta

標準オブジェクトのメタデータ。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。

spec

object

Prometheus に必要なアラートルール定義の仕様。

9.1.1. .spec

説明
Prometheus に必要なアラートルール定義の仕様。
object
プロパティー説明

groups

array

Prometheus ルールファイルの内容

groups[]

object

RuleGroup は、順次評価される記録およびアラートルールのリストです。

9.1.2. .spec.groups

説明
Prometheus ルールファイルの内容
array

9.1.3. .spec.groups[]

説明
RuleGroup は、順次評価される記録およびアラートルールのリストです。
object
必須
  • name
プロパティー説明

interval

string

interval は、グループ内のルールが評価される頻度を決定します。

limit

integer

アラートルールが生成できるアラート数と記録ルールが生成できるシリーズ数を制限します。limit は Prometheus 2.31 以降および Thanos Ruler 0.24 以降でサポートされます。

name

string

ルールグループの名前。

partial_response_strategy

string

PartialResponseStrategy は ThanosRuler でのみ使用され、Prometheus インスタンスでは無視されます。詳細情報: https://github.com/thanos-io/thanos/blob/main/docs/components/rule.md#partial-response

query_offset

string

この特定のグループのルール評価タイムスタンプを、指定期間だけ過去にオフセットすることを定義します。

Prometheus v2.53.0 以降が必要です。ThanosRuler ではサポートされていません。

rules

array

アラートルールおよび記録ルールのリスト。

rules[]

object

ルールとは、アラートまたは記録ルールを表します。Prometheus のドキュメントを参照してください: [alerting](https://www.prometheus.io/docs/prometheus/latest/configuration/alerting_rules/) ルール、または [recording](https://www.prometheus.io/docs/prometheus/latest/configuration/recording_rules/#recording-rules) ルール

9.1.4. .spec.groups[].rules

説明
アラートルールおよび記録ルールのリスト。
array

9.1.5. .spec.groups[].rules[]

説明
ルールとは、アラートまたは記録ルールを表します。Prometheus のドキュメントを参照してください: [alerting](https://www.prometheus.io/docs/prometheus/latest/configuration/alerting_rules/) ルール、または [recording](https://www.prometheus.io/docs/prometheus/latest/configuration/recording_rules/#recording-rules) ルール
object
必須
  • expr
プロパティー説明

alert

string

アラートの名前。有効なラベル値である必要があります。recordalert のいずれか 1 つのみ設定する必要があります。

annotations

object (string)

各アラートに追加するアノテーション。アラートルールに対してのみ有効です。

expr

integer-or-string

評価する PromQL 式。

for

string

ここで指定した時間を経過してアラートが返されると、アラートが発動したとみなされます。

keep_firing_for

string

KeepFiringFor は、アラートをトリガーした条件がクリアされた後、アラートの発動状態が継続する期間を定義します。

labels

object (string)

追加または上書きするラベル。

record

string

出力する時系列の名前。有効なメトリクス名である必要があります。recordalert のいずれか 1 つのみ設定する必要があります。

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat, Inc.