第6章 PodMonitor [monitoring.coreos.com/v1]


説明
PodMonitor は、一連の Pod の監視を定義します。
object
必須
  • spec

6.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 によるターゲット発見のための望ましい Pod 選択の仕様。

6.1.1. .spec

説明
Prometheus によるターゲット発見のための望ましい Pod 選択の仕様。
object
必須
  • podMetricsEndpoints
  • selector
プロパティー説明

attachMetadata

object

ノードメタデータを検出されたターゲットにアタッチします。Prometheus v2.35.0 以降が必要です。

jobLabel

string

ジョブ名の取得に使用するラベル。

labelLimit

integer

サンプルに受け入れられるラベルの数のスクレープごとの制限。Prometheus バージョン 2.27.0 以降でのみ有効です。

labelNameLengthLimit

integer

サンプルで受け入れられるラベル名の長さのスクレープごとの制限。Prometheus バージョン 2.27.0 以降でのみ有効です。

labelValueLengthLimit

integer

サンプルに受け入れられるラベル値の長さのスクレープごとの制限。Prometheus バージョン 2.27.0 以降でのみ有効です。

namespaceSelector

object

Endpoints オブジェクトが検出される名前空間を選択するためのセレクター。

podMetricsEndpoints

array

この PodMonitor の一部として許可されているエンドポイントのリスト。

podMetricsEndpoints[]

object

PodMetricsEndpoint は、Prometheus メトリックを提供する KubernetesPod のスクレイプ可能なエンドポイントを定義します。

podTargetLabels

array (string)

PodTargetLabels は、KubernetesPod のラベルをターゲットに転送します。

sampleLimit

integer

SampleLimit は、受け入れられるスクレイプされたサンプルの数に対するスクレイプごとの制限を定義します。

selector

object

Pod オブジェクトを選択するためのセレクター。

targetLimit

integer

TargetLimit は、受け入れられるスクレイプされたターゲットの数の制限を定義します。

6.1.2. .spec.attachMetadata

説明
ノードメタデータを検出されたターゲットにアタッチします。Prometheus v2.35.0 以降が必要です。
object
プロパティー説明

ノード

boolean

true に設定すると、Prometheus にはノードを取得するパーミッションが必要です。

6.1.3. .spec.namespaceSelector

Description
Endpoints オブジェクトが検出される名前空間を選択するためのセレクター。
タイプ
object
プロパティー説明

any

boolean

それらを制限するリストとは対照的に、すべての namespace が選択されているかどうかを説明するブール値。

matchNames

array (string)

選択する namespace 名のリスト。

6.1.4. .spec.podMetricsEndpoints

Description
この PodMonitor の一部として許可されているエンドポイントのリスト。
タイプ
array

6.1.5. .spec.podMetricsEndpoints[]

Description
PodMetricsEndpoint は、Prometheus メトリックを提供する KubernetesPod のスクレイプ可能なエンドポイントを定義します。
タイプ
object
プロパティー説明

authorization

object

このエンドポイントの承認セクション

basicAuth

object

BasicAuth を使用すると、エンドポイントは基本認証を介して認証できます。詳細: https://prometheus.io/docs/operating/configuration/#endpoint

bearerTokenSecret

object

ターゲットをスクレイピングするためのベアラトークンを読み取るためにマウントする秘密。シークレットは Pod モニターと同じ名前空間にあり、PrometheusOperator からアクセスできる必要があります。

enableHttp2

boolean

HTTP2 を有効にするかどうか。

filterRunning

boolean

実行されていない Pod を削除する。(Failed、Succeeded)。デフォルトでは有効です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-phase

followRedirects

boolean

FollowRedirects は、収集リクエストが HTTP 3xx リダイレクトされるかどうかを設定します。

honorLabels

ブール値

HonorLabels は、ターゲットラベルとの衝突時にメトリックのラベルを選択します。

honorTimestamps

ブール値

HonorTimestamps は、Prometheus がスクレイピングされたデータに存在するタイムスタンプを尊重するかどうかを制御します。

interval

string

指定されていない場合に Prometheus のグローバルスクレイプ間隔が使用される場合にスクレイプする間隔。

metricRelabelings

array

取り込み前にサンプルに適用する MetricRelabelConfigs。

metricRelabelings[]

object

RelabelConfig を使用すると、ターゲット、アラート、スクレイピングされたサンプル、リモート書き込みサンプルのラベルセットを動的に書き換えることができます。詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config

oauth2

object

URL の OAuth2。Prometheus バージョン 2.27.0 以降でのみ有効です。

params

object

オプションの HTTPURL パラメーター

params{}

array (string)

 

path

string

メトリックをスクレイプするための HTTP パス。空の場合、Prometheus はデフォルト値 (例: /metrics) を使用します。

port

string

このエンドポイントが参照する Pod ポートの名前。targetPort と相互に排他的です。

proxyUrl

string

ProxyURL 例: http://proxyserver:2195 このエンドポイントを介してスクレイプをプロキシーに送信します。

relabelings

array

スクレイピングする前にサンプルに適用する RelabelConfigs。Prometheus Operator は、いくつかの標準の Kubernetes フィールドに自動的に再ラベル付けを追加します。元のスクレイプジョブの名前は、__tmp_prometheus_job_name ラベルから入手できます。詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config

relabelings[]

object

RelabelConfig を使用すると、ターゲット、アラート、スクレイピングされたサンプル、リモート書き込みサンプルのラベルセットを動的に書き換えることができます。詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config

scheme

string

スクレイピングに使用する HTTP スキーム。ラベルを再設定することで scheme ラベルを書き換えた場合を除き、httphttps は期待される値になります。空の場合、Prometheus はデフォルト値 http を使用します。

scrapeTimeout

string

スクレイプが終了した後のタイムアウト(指定されていない場合)は、Prometheus グローバルスクレイプ間隔が使用されます。

targetPort

integer-or-string

非推奨: 代わりに port を使用してください。

tlsConfig

object

エンドポイントをスクレイピングするときに使用する TLS 設定。

6.1.6. .spec.podMetricsEndpoints[].authorization

Description
このエンドポイントの承認セクション
object
プロパティー説明

credentials

object

認証の認証情報を含む、namespace 内の Secret のキーを選択します。

type

string

認証タイプを定義します。この値は大文字と小文字を区別しません。"Basic" はサポートされている値ではありません。デフォルト: "Bearer"

6.1.7. .spec.podMetricsEndpoints[].authorization.credentials

説明
認証の認証情報を含む、namespace 内の Secret のキーを選択します。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

任意

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

6.1.8. .spec.podMetricsEndpoints[].basicAuth

Description
BasicAuth を使用すると、エンドポイントは基本認証を介して認証できます。詳細: https://prometheus.io/docs/operating/configuration/#endpoint
object
プロパティー説明

password

object

認証用のパスワードを含むサービスモニター名前空間のシークレット。

username

object

認証用のユーザー名を含むサービスモニター名前空間のシークレット。

6.1.9. .spec.podMetricsEndpoints[].basicAuth.password

Description
認証用のパスワードを含むサービスモニター名前空間のシークレット。
タイプ
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

任意

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

6.1.10. .spec.podMetricsEndpoints[].basicAuth.username

Description
認証用のユーザー名を含むサービスモニター名前空間のシークレット。
タイプ
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

任意

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

6.1.11. .spec.podMetricsEndpoints[].bearerTokenSecret

Description
ターゲットをスクレイピングするためのベアラトークンを読み取るためにマウントする秘密。シークレットは Pod モニターと同じ名前空間にあり、PrometheusOperator からアクセスできる必要があります。
タイプ
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

任意

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

6.1.12. .spec.podMetricsEndpoints[].metricRelabelings

Description
取り込み前にサンプルに適用する MetricRelabelConfigs。
array

6.1.13. .spec.podMetricsEndpoints[].metricRelabelings[]

説明
RelabelConfig を使用すると、ターゲット、アラート、スクレイピングされたサンプル、リモート書き込みサンプルのラベルセットを動的に書き換えることができます。詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config
object
プロパティー説明

action

string

正規表現の一致に基づいて実行するアクション。Uppercase および Lowercase アクションには Prometheus v2.36.0 以降が必要です。DropEqual および KeepEqual アクションには Prometheus v2.41.0 以降が必要です。デフォルト: "Replace"

modulus

integer

ソースラベル値のハッシュを取得するためのモジュラス。アクションが HashMod の場合にのみ適用されます。

regex

string

抽出された値が一致する正規表現。

replacement

string

正規表現が一致する場合に置き換えアクションが実施される置換値。正規表現キャプチャグループが利用可能です。

separator

string

separator は連結された SourceLabel 間の文字列です。

sourceLabels

array (string)

ソースラベルは、既存のラベルから値を選択します。それらのコンテンツは、設定されたセパレータを使用して連結され、設定された正規表現と照合されます。

targetLabel

string

結果の文字列が置換で書き込まれるラベル。ReplaceHashModLowercaseUppercaseKeepEqualDropEqual アクションでは必須です。正規表現キャプチャグループが利用可能です。

6.1.14. .spec.podMetricsEndpoints[].oauth2

Description
URL の OAuth2。Prometheus バージョン 2.27.0 以降でのみ有効です。
object
必須
  • clientId
  • clientSecret
  • tokenUrl
プロパティー説明

clientId

object

OAuth2 クライアント ID を含むシークレットまたは設定マップ

clientSecret

object

OAuth2 クライアントシークレットを含むシークレット

endpointParams

object (string)

トークン URL に追加するパラメーター

scopes

array (string)

トークンリクエストに使用される OAuth2 スコープ

tokenUrl

string

トークンをフェッチする URL

6.1.15. .spec.podMetricsEndpoints[].oauth2.clientId

Description
OAuth2 クライアント ID を含むシークレットまたは設定マップ
タイプ
object
プロパティー説明

configMap

object

ターゲットに使用するデータを含む ConfigMap。

secret

object

ターゲットに使用するデータを含むシークレット。

6.1.16. .spec.podMetricsEndpoints[].oauth2.clientId.configMap

説明
ターゲットに使用するデータを含む ConfigMap。
object
必須
  • key
プロパティー説明

key

string

選択するキー。

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

任意

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

6.1.17. .spec.podMetricsEndpoints[].oauth2.clientId.secret

説明
ターゲットに使用するデータを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

任意

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

6.1.18. .spec.podMetricsEndpoints[].oauth2.clientSecret

Description
OAuth2 クライアントシークレットを含むシークレット
タイプ
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

任意

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

6.1.19. .spec.podMetricsEndpoints[].params

Description
オプションの HTTPURL パラメーター
タイプ
object

6.1.20. .spec.podMetricsEndpoints[].relabelings

Description
スクレイピングする前にサンプルに適用する RelabelConfigs。Prometheus Operator は、いくつかの標準の Kubernetes フィールドに自動的に再ラベル付けを追加します。元のスクレイプジョブの名前は、__tmp_prometheus_job_name ラベルから入手できます。詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config
array

6.1.21. .spec.podMetricsEndpoints[].relabelings[]

説明
RelabelConfig を使用すると、ターゲット、アラート、スクレイピングされたサンプル、リモート書き込みサンプルのラベルセットを動的に書き換えることができます。詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config
object
プロパティー説明

action

string

正規表現の一致に基づいて実行するアクション。Uppercase および Lowercase アクションには Prometheus v2.36.0 以降が必要です。DropEqual および KeepEqual アクションには Prometheus v2.41.0 以降が必要です。デフォルト: "Replace"

modulus

integer

ソースラベル値のハッシュを取得するためのモジュラス。アクションが HashMod の場合にのみ適用されます。

regex

string

抽出された値が一致する正規表現。

replacement

string

正規表現が一致する場合に置き換えアクションが実施される置換値。正規表現キャプチャグループが利用可能です。

separator

string

separator は連結された SourceLabel 間の文字列です。

sourceLabels

array (string)

ソースラベルは、既存のラベルから値を選択します。それらのコンテンツは、設定されたセパレータを使用して連結され、設定された正規表現と照合されます。

targetLabel

string

結果の文字列が置換で書き込まれるラベル。ReplaceHashModLowercaseUppercaseKeepEqualDropEqual アクションでは必須です。正規表現キャプチャグループが利用可能です。

6.1.22. .spec.podMetricsEndpoints[].tlsConfig

Description
エンドポイントをスクレイピングするときに使用する TLS 設定。
object
プロパティー説明

ca

object

サーバー証明書の検証に使用される認証局。

cert

object

クライアント認証を行うときに提示するクライアント証明書。

insecureSkipVerify

boolean

ターゲット証明書の検証を無効にします。

keySecret

object

ターゲットのクライアントキーファイルを含むシークレット。

serverName

string

ターゲットのホスト名を確認するために使用されます。

6.1.23. .spec.podMetricsEndpoints[].tlsConfig.ca

説明
サーバー証明書の検証に使用される認証局。
object
プロパティー説明

configMap

object

ターゲットに使用するデータを含む ConfigMap。

secret

object

ターゲットに使用するデータを含むシークレット。

6.1.24. .spec.podMetricsEndpoints[].tlsConfig.ca.configMap

説明
ターゲットに使用するデータを含む ConfigMap。
object
必須
  • key
プロパティー説明

key

string

選択するキー。

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

任意

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

6.1.25. .spec.podMetricsEndpoints[].tlsConfig.ca.secret

説明
ターゲットに使用するデータを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

任意

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

6.1.26. .spec.podMetricsEndpoints[].tlsConfig.cert

説明
クライアント認証を行うときに提示するクライアント証明書。
object
プロパティー説明

configMap

object

ターゲットに使用するデータを含む ConfigMap。

secret

object

ターゲットに使用するデータを含むシークレット。

6.1.27. .spec.podMetricsEndpoints[].tlsConfig.cert.configMap

説明
ターゲットに使用するデータを含む ConfigMap。
object
必須
  • key
プロパティー説明

key

string

選択するキー。

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

任意

boolean

ConfigMap かそのキーを定義する必要があるかどうかを指定します。

6.1.28. .spec.podMetricsEndpoints[].tlsConfig.cert.secret

説明
ターゲットに使用するデータを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

任意

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

6.1.29. .spec.podMetricsEndpoints[].tlsConfig.keySecret

説明
ターゲットのクライアントキーファイルを含むシークレット。
object
必須
  • key
プロパティー説明

key

string

選択するシークレットのキー。有効な秘密鍵でなければなりません。

name

string

参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid

任意

boolean

シークレットかそのキーを定義する必要があるかどうかを指定します。

6.1.30. .spec.selector

Description
Pod オブジェクトを選択するためのセレクター。
タイプ
object
プロパティー説明

matchExpressions

array

matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。

matchExpressions[]

object

ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。

matchLabels

object (string)

matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。

6.1.31. .spec.selector.matchExpressions

説明
matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
array

6.1.32. .spec.selector.matchExpressions[]

説明
ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
object
必須
  • key
  • operator
プロパティー説明

key

string

key は、セレクターの適用先のラベルキーです。

operator

string

operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。

values

array (string)

values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

Theme

© 2025 Red Hat