第4章 PodMonitor [monitoring.coreos.com/v1]
- 説明
- PodMonitor は、一連の Pod の監視を定義します。
- 型
-
object
- 必須
-
spec
-
4.1. 仕様
プロパティー | 型 | 説明 |
---|---|---|
|
| apiVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。 |
|
| kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できる場合があります。これは更新できません。CamelCase を使用します。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。 |
| 標準オブジェクトのメタデータ。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。 | |
|
| Prometheus によるターゲット発見のための望ましい Pod 選択の仕様。 |
4.1.1. .spec
- 説明
- Prometheus によるターゲット発見のための望ましい Pod 選択の仕様。
- 型
-
object
- 必須
-
podMetricsEndpoints
-
selector
-
プロパティー | 型 | 説明 |
---|---|---|
|
| ノードメタデータを検出されたターゲットにアタッチします。ロール:pod についてのみ有効です。Prometheus バージョン 2.26.0 以降でのみ有効です。 |
|
| ジョブ名の取得に使用するラベル。 |
|
| サンプルに受け入れられるラベルの数のスクレープごとの制限。Prometheus バージョン 2.27.0 以降でのみ有効です。 |
|
| サンプルで受け入れられるラベル名の長さのスクレープごとの制限。Prometheus バージョン 2.27.0 以降でのみ有効です。 |
|
| サンプルに受け入れられるラベル値の長さのスクレープごとの制限。Prometheus バージョン 2.27.0 以降でのみ有効です。 |
|
| Endpoints オブジェクトが検出される名前空間を選択するためのセレクター。 |
|
| この PodMonitor の一部として許可されているエンドポイントのリスト。 |
|
| PodMetricsEndpoint は、Prometheus メトリックを提供する KubernetesPod のスクレイプ可能なエンドポイントを定義します。 |
|
| PodTargetLabels は、KubernetesPod のラベルをターゲットに転送します。 |
|
| SampleLimit は、受け入れられるスクレイプされたサンプルの数に対するスクレイプごとの制限を定義します。 |
|
| Pod オブジェクトを選択するためのセレクター。 |
|
| TargetLimit は、受け入れられるスクレイプされたターゲットの数の制限を定義します。 |
4.1.2. .spec.attachMetadata
- 説明
- ノードメタデータを検出されたターゲットにアタッチします。ロール:pod についてのみ有効です。Prometheus バージョン 2.26.0 以降でのみ有効です。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| true に設定すると、Prometheus にはノードを取得するパーミッションが必要です。 |
4.1.3. .spec.namespaceSelector
- Description
- Endpoints オブジェクトが検出される名前空間を選択するためのセレクター。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| それらを制限するリストとは対照的に、すべての namespace が選択されているかどうかを説明するブール値。 |
|
| 選択する namespace 名のリスト。 |
4.1.4. .spec.podMetricsEndpoints
- Description
- この PodMonitor の一部として許可されているエンドポイントのリスト。
- タイプ
-
array
4.1.5. .spec.podMetricsEndpoints[]
- Description
- PodMetricsEndpoint は、Prometheus メトリックを提供する KubernetesPod のスクレイプ可能なエンドポイントを定義します。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| このエンドポイントの承認セクション |
|
| BasicAuth を使用すると、エンドポイントは基本認証を介して認証できます。詳細: https://prometheus.io/docs/operating/configuration/#endpoint |
|
| ターゲットをスクレイピングするためのベアラトークンを読み取るためにマウントする秘密。シークレットは Pod モニターと同じ名前空間にあり、PrometheusOperator からアクセスできる必要があります。 |
|
| HTTP2 を有効にするかどうか。 |
|
| 実行されていない Pod を削除する。(Failed、Succeeded)。デフォルトでは有効です。詳細: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#pod-phase |
|
| FollowRedirects は、収集リクエストが HTTP 3xx リダイレクトされるかどうかを設定します。 |
|
| HonorLabels は、ターゲットラベルとの衝突時にメトリックのラベルを選択します。 |
|
| HonorTimestamps は、Prometheus がスクレイピングされたデータに存在するタイムスタンプを尊重するかどうかを制御します。 |
|
| 指定されていない場合に Prometheus のグローバルスクレイプ間隔が使用される場合にスクレイプする間隔。 |
|
| 取り込み前にサンプルに適用する MetricRelabelConfigs。 |
|
|
RelabelConfig を使用すると、取り込み前にサンプルに適用されたラベルセットの動的な書き換えが可能になります。Prometheus 設定の |
|
| URL の OAuth2。Prometheus バージョン 2.27.0 以降でのみ有効です。 |
|
| オプションの HTTPURL パラメーター |
|
| |
|
|
メトリックをスクレイプするための HTTP パス。空の場合、Prometheus はデフォルト値 (例: |
|
| このエンドポイントが参照する Pod ポートの名前。targetPort と相互に排他的です。 |
|
| ProxyURL 例: http://proxyserver:2195 このエンドポイントを介してスクレイプをプロキシーに送信します。 |
|
|
スクレイピングする前にサンプルに適用する RelabelConfigs。Operator は、いくつかの標準 Kubernetes フィールドのラベルの再設定を自動的に追加します。元のスクレイプジョブの名前は、 |
|
|
RelabelConfig を使用すると、取り込み前にサンプルに適用されたラベルセットの動的な書き換えが可能になります。Prometheus 設定の |
|
| スクレイピングに使用する HTTP スキーム。 |
|
| スクレイプが終了した後のタイムアウト(指定されていない場合)は、Prometheus グローバルスクレイプ間隔が使用されます。 |
|
| 非推奨: 代わりに port を使用してください。 |
|
| エンドポイントをスクレイピングするときに使用する TLS 設定。 |
4.1.6. .spec.podMetricsEndpoints[].authorization
- Description
- このエンドポイントの承認セクション
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| リクエストのクレデンシャルを含むシークレットのキー |
|
| 認証タイプを設定します。デフォルトは Bearer で、Basic はエラーを引き起こします |
4.1.7. .spec.podMetricsEndpoints[].authorization.credentials
- Description
- リクエストのクレデンシャルを含むシークレットのキー
- タイプ
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
4.1.8. .spec.podMetricsEndpoints[].basicAuth
- Description
- BasicAuth を使用すると、エンドポイントは基本認証を介して認証できます。詳細: https://prometheus.io/docs/operating/configuration/#endpoint
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 認証用のパスワードを含むサービスモニター名前空間のシークレット。 |
|
| 認証用のユーザー名を含むサービスモニター名前空間のシークレット。 |
4.1.9. .spec.podMetricsEndpoints[].basicAuth.password
- Description
- 認証用のパスワードを含むサービスモニター名前空間のシークレット。
- タイプ
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
4.1.10. .spec.podMetricsEndpoints[].basicAuth.username
- Description
- 認証用のユーザー名を含むサービスモニター名前空間のシークレット。
- タイプ
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
4.1.11. .spec.podMetricsEndpoints[].bearerTokenSecret
- Description
- ターゲットをスクレイピングするためのベアラトークンを読み取るためにマウントする秘密。シークレットは Pod モニターと同じ名前空間にあり、PrometheusOperator からアクセスできる必要があります。
- タイプ
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
4.1.12. .spec.podMetricsEndpoints[].metricRelabelings
- Description
- 取り込み前にサンプルに適用する MetricRelabelConfigs。
- 型
-
array
4.1.13. .spec.podMetricsEndpoints[].metricRelabelings[]
- Description
-
RelabelConfig を使用すると、取り込み前にサンプルに適用されたラベルセットの動的な書き換えが可能になります。Prometheus 設定の
<metric_relabel_configs>
セクションを定義します。詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#metric_relabel_configs - タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 正規表現のマッチングに基づいて実行するアクション。デフォルトは置換です。大文字および小文字のアクションには、Prometheus >= 2.36 が必要です。 |
|
| ソースラベル値のハッシュを取得するためのモジュラス。 |
|
| 抽出された値が一致する正規表現。デフォルトは (.*) です。 |
|
| 正規表現が一致する場合に正規表現置換が実行される置換値。正規表現キャプチャグループが利用可能です。デフォルトは $1 です。 |
|
| 連結されたソースラベル値の間に配置されたセパレータ。デフォルトは ';' です。 |
|
| ソースラベルは、既存のラベルから値を選択します。それらのコンテンツは、設定されたセパレーターを使用して連結され、置換、保持、および削除アクションの設定された正規表現と照合されます。 |
|
| 結果の値が置換アクションで書き込まれるラベル。置換アクションには必須です。正規表現キャプチャグループが利用可能です。 |
4.1.14. .spec.podMetricsEndpoints[].oauth2
- Description
- URL の OAuth2。Prometheus バージョン 2.27.0 以降でのみ有効です。
- 型
-
object
- 必須
-
clientId
-
clientSecret
-
tokenUrl
-
プロパティー | 型 | 説明 |
---|---|---|
|
| OAuth2 クライアント ID を含むシークレットまたは設定マップ |
|
| OAuth2 クライアントシークレットを含むシークレット |
|
| トークン URL に追加するパラメーター |
|
| トークンリクエストに使用される OAuth2 スコープ |
|
| トークンをフェッチする URL |
4.1.15. .spec.podMetricsEndpoints[].oauth2.clientId
- Description
- OAuth2 クライアント ID を含むシークレットまたは設定マップ
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ターゲットに使用するデータを含む ConfigMap。 |
|
| ターゲットに使用するデータを含むシークレット。 |
4.1.16. .spec.podMetricsEndpoints[].oauth2.clientId.configMap
- 説明
- ターゲットに使用するデータを含む ConfigMap。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
4.1.17. .spec.podMetricsEndpoints[].oauth2.clientId.secret
- 説明
- ターゲットに使用するデータを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
4.1.18. .spec.podMetricsEndpoints[].oauth2.clientSecret
- Description
- OAuth2 クライアントシークレットを含むシークレット
- タイプ
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
4.1.19. .spec.podMetricsEndpoints[].params
- Description
- オプションの HTTPURL パラメーター
- タイプ
-
object
4.1.20. .spec.podMetricsEndpoints[].relabelings
- Description
-
スクレイピングする前にサンプルに適用する RelabelConfigs。Operator は、いくつかの標準 Kubernetes フィールドのラベルの再設定を自動的に追加します。元のスクレイプジョブの名前は、
\__tmp_prometheus_job_name
ラベルから取得できます。詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config - 型
-
array
4.1.21. .spec.podMetricsEndpoints[].relabelings[]
- Description
-
RelabelConfig を使用すると、取り込み前にサンプルに適用されたラベルセットの動的な書き換えが可能になります。Prometheus 設定の
<metric_relabel_configs>
セクションを定義します。詳細: https://prometheus.io/docs/prometheus/latest/configuration/configuration/#metric_relabel_configs - タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| 正規表現のマッチングに基づいて実行するアクション。デフォルトは置換です。大文字および小文字のアクションには、Prometheus >= 2.36 が必要です。 |
|
| ソースラベル値のハッシュを取得するためのモジュラス。 |
|
| 抽出された値が一致する正規表現。デフォルトは (.*) です。 |
|
| 正規表現が一致する場合に正規表現置換が実行される置換値。正規表現キャプチャグループが利用可能です。デフォルトは $1 です。 |
|
| 連結されたソースラベル値の間に配置されたセパレータ。デフォルトは ';' です。 |
|
| ソースラベルは、既存のラベルから値を選択します。それらのコンテンツは、設定されたセパレーターを使用して連結され、置換、保持、および削除アクションの設定された正規表現と照合されます。 |
|
| 結果の値が置換アクションで書き込まれるラベル。置換アクションには必須です。正規表現キャプチャグループが利用可能です。 |
4.1.22. .spec.podMetricsEndpoints[].tlsConfig
- Description
- エンドポイントをスクレイピングするときに使用する TLS 設定。
- 型
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ターゲットに使用する CA 証明書を含む構造体。 |
|
| ターゲットのクライアント証明書ファイルを含む構造体。 |
|
| ターゲット証明書の検証を無効にします。 |
|
| ターゲットのクライアントキーファイルを含むシークレット。 |
|
| ターゲットのホスト名を確認するために使用されます。 |
4.1.23. .spec.podMetricsEndpoints[].tlsConfig.ca
- Description
- ターゲットに使用する CA 証明書を含む構造体。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ターゲットに使用するデータを含む ConfigMap。 |
|
| ターゲットに使用するデータを含むシークレット。 |
4.1.24. .spec.podMetricsEndpoints[].tlsConfig.ca.configMap
- 説明
- ターゲットに使用するデータを含む ConfigMap。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
4.1.25. .spec.podMetricsEndpoints[].tlsConfig.ca.secret
- 説明
- ターゲットに使用するデータを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
4.1.26. .spec.podMetricsEndpoints[].tlsConfig.cert
- Description
- ターゲットのクライアント証明書ファイルを含む構造体。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| ターゲットに使用するデータを含む ConfigMap。 |
|
| ターゲットに使用するデータを含むシークレット。 |
4.1.27. .spec.podMetricsEndpoints[].tlsConfig.cert.configMap
- 説明
- ターゲットに使用するデータを含む ConfigMap。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するキー。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid |
|
| ConfigMap かそのキーを定義する必要があるかどうかを指定します。 |
4.1.28. .spec.podMetricsEndpoints[].tlsConfig.cert.secret
- 説明
- ターゲットに使用するデータを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
4.1.29. .spec.podMetricsEndpoints[].tlsConfig.keySecret
- 説明
- ターゲットのクライアントキーファイルを含むシークレット。
- 型
-
object
- 必須
-
key
-
プロパティー | 型 | 説明 |
---|---|---|
|
| 選択するシークレットのキー。有効な秘密鍵でなければなりません。 |
|
| 参照先の名前。詳細: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: その他の便利なルール度を追加。apiVersion、kind、uid |
|
| シークレットかそのキーを定義する必要があるかどうかを指定します。 |
4.1.30. .spec.selector
- Description
- Pod オブジェクトを選択するためのセレクター。
- タイプ
-
object
プロパティー | 型 | 説明 |
---|---|---|
|
| matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。 |
|
| ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。 |
|
| matchLabels は、{key,value} ペアのマップです。matchLabels マップの 1 つの {key,value} は matchExpressions の要素と同じで、キーフィールドには "key"、演算子には "In"、値配列には "value" のみが含まれます。要件は AND で結合されます。 |
4.1.31. .spec.selector.matchExpressions
- 説明
- matchExpressions はラベルセレクターの要件のリストです。要件は AND で結合されます。
- 型
-
array
4.1.32. .spec.selector.matchExpressions[]
- 説明
- ラベルセレクター要件は、値、キー、およびキーと値を関連付ける Operator を含むセレクターです。
- 型
-
object
- 必須
-
key
-
operator
-
プロパティー | 型 | 説明 |
---|---|---|
|
| key は、セレクターの適用先のラベルキーです。 |
|
| operator はキーと値のセットの関係を表します。有効な演算子は In、NotIn、Exists、および DoesNotExist です。 |
|
| values は文字列値の配列です。operator が In または NotIn の場合には、values 配列を空白にできません。operator が Exists または DoesNotExist の場合には、values 配列は空白でなければなりません。この配列は、ストラテジーに基づいたマージパッチの適用中に置き換えられます。 |