PodMonitor [monitoring.coreos.com/v1]

attachMetadata

对象

attachMetadata 定义了添加到已发现目标的附加元数据。

这需要 Prometheus >= v2.37.0。

bodySizeLimit

字符串

如果定义，bodySizeLimit 指定 Prometheus 将接受的未压缩响应正文大小的作业级别限制。

这需要 Prometheus >= v2.28.0。

jobLabel

字符串

用于检索作业名称的标签。jobLabel 从关联的 Kubernetes Pod 对象中选择标签，该标签将用作所有指标的 job 标签。

例如，如果 jobLabel 设置为 foo，并且 Kubernetes Pod 对象用 foo: bar 标记，则 Prometheus 将 job="bar" 标签添加到所有摄取的指标。

如果此字段的值为空，则指标的 job 标签默认为 PodMonitor 对象的命名空间和名称（例如：<namespace>/<name>）。

keepDroppedTargets

整数

每次抓取时，由重新标记删除的目标数量的限制将保留在内存中。0 表示没有限制。

这需要 Prometheus >= v2.47.0。

labelLimit

整数

每次抓取时，将为样本接受的标签数量的限制。

这需要 Prometheus >= v2.27.0。

labelNameLengthLimit

整数

每个抓取操作对样本中接受的标签名称长度的限制。

这需要 Prometheus >= v2.27.0。

labelValueLengthLimit

整数

每个抓取操作对样本中接受的标签值长度的限制。

这需要 Prometheus >= v2.27.0。

namespaceSelector

对象

选择器，用于选择从中发现 Kubernetes Pods 对象的命名空间。

podMetricsEndpoints

数组

此 PodMonitor 的端点列表。

podMetricsEndpoints[]

对象

PodMetricsEndpoint 定义了一个端点，用于提供 Prometheus 将要抓取的指标。

podTargetLabels

数组 (字符串)

podTargetLabels 定义从关联的 Kubernetes Pod 对象传输到已摄取指标的标签。

sampleLimit

整数

sampleLimit 定义每个抓取操作对将要接受的已抓取样本数量的限制。

scrapeClass

字符串

要应用的抓取类。

scrapeProtocols

数组 (字符串)

scrapeProtocols 定义在抓取期间要协商的协议。它告诉客户端 Prometheus 支持的协议以及它们的优先级顺序（从最优先到最不优先）。

如果未设置，Prometheus 将使用其默认值。

需要 Prometheus >= v2.49.0。

selector

对象

标签选择器，用于选择 Kubernetes Pod 对象。

targetLimit

整数

targetLimit 定义对将要接受的已抓取目标数量的限制。

节点

布尔值

设置为 true 时，Prometheus 必须对 Nodes 对象具有 get 权限。

任意

布尔值

布尔值，描述是否选择了所有命名空间，而不是限制它们的列表。

matchNames

数组 (字符串)

要从中选择的命名空间名称列表。

授权

对象

authorization 配置在抓取目标时要使用的授权头凭据。

不能同时与 basicAuth 或 oauth2 一起设置。

basicAuth

对象

basicAuth 配置在抓取目标时要使用的基本身份验证凭据。

不能同时与 authorization 或 oauth2 一起设置。

bearerTokenSecret

对象

bearerTokenSecret 指定一个密钥，该密钥指向包含用于抓取目标的 bearer 令牌的 Secret。该 Secret 需要与 PodMonitor 对象位于同一个命名空间中，并且可被 Prometheus Operator 读取。

已弃用：请改用 authorization。

enableHttp2

布尔值

enableHttp2 可用于在抓取目标时禁用 HTTP2。

filterRunning

布尔值

设置为 true 时，在目标发现过程中将丢弃未运行的 Pod（例如，处于“失败”或“成功”状态的 Pod）。

如果未设置，则启用过滤。

更多信息：https://kubernetes.ac.cn/docs/concepts/workloads/pods/pod-lifecycle/#pod-phase

followRedirects

布尔值

followRedirects 定义抓取请求是否应遵循 HTTP 3xx 重定向。

honorLabels

布尔值

设置为 true 时，honorLabels 会在指标的标签与目标的标签冲突时保留指标的标签。

honorTimestamps

布尔值

honorTimestamps 控制 Prometheus 是否保留目标公开的时间戳。

interval

字符串

Prometheus 从目标抓取指标的间隔。

如果为空，Prometheus 将使用全局抓取间隔。

metricRelabelings

数组

metricRelabelings 配置应用于摄取前样本的重新标记规则。

metricRelabelings[]

对象

RelabelConfig 允许动态重写目标、警报、已抓取样本和远程写入样本的标签集。

更多信息：https://prometheus.ac.cn/docs/prometheus/latest/configuration/configuration/#relabel_config

oauth2

对象

oauth2 配置在抓取目标时要使用的 OAuth2 设置。

需要 Prometheus >= 2.27.0。

不能同时与 authorization 或 basicAuth 一起设置。

params

对象

params 定义可选的 HTTP URL 参数。

params{}

数组 (字符串)

path

字符串

从中抓取指标的 HTTP 路径。

如果为空，Prometheus 将使用默认值（例如 /metrics）。

port

字符串

此端点引用的 Pod 端口的名称。

它优先于 targetPort。

proxyUrl

字符串

proxyURL 配置在抓取目标时要使用的 HTTP 代理 URL（例如，“http://proxyserver:2195”）。

relabelings

数组

relabelings 配置应用于目标元数据标签的重新标记规则。

操作员会自动为一些标准 Kubernetes 字段添加重新标记。

原始抓取作业的名称可通过 __tmp_prometheus_job_name 标签获得。

更多信息：https://prometheus.ac.cn/docs/prometheus/latest/configuration/configuration/#relabel_config

relabelings[]

对象

RelabelConfig 允许动态重写目标、警报、已抓取样本和远程写入样本的标签集。

更多信息：https://prometheus.ac.cn/docs/prometheus/latest/configuration/configuration/#relabel_config

scheme

字符串

用于抓取的 HTTP 方案。

除非通过重新标记重写 scheme 标签，否则预期值为 http 和 https。

如果为空，Prometheus 将使用默认值 http。

scrapeTimeout

字符串

Prometheus 将抓取视为失败的超时时间。

如果为空，Prometheus 将使用全局抓取超时，除非它小于目标的抓取间隔值，在这种情况下将使用后者。

targetPort

整数或字符串

Service 后面 Pod 对象的目标端口的名称或编号，必须使用容器端口属性指定端口。

已弃用：请改用“port”。

tlsConfig

对象

在抓取目标时要使用的 TLS 配置。

trackTimestampsStaleness

布尔值

trackTimestampsStaleness 定义 Prometheus 是否跟踪在已抓取数据中存在显式时间戳的指标的陈旧性。如果 honorTimestamps 为 false，则无效。

需要 Prometheus >= v2.48.0。

凭据

对象

选择命名空间中包含身份验证凭据的 Secret 的密钥。

类型

字符串

定义身份验证类型。该值不区分大小写。

“Basic”不是受支持的值。

默认值：“Bearer”

密钥

字符串

要从中选择的密钥的密钥。必须是有效的密钥。

名称

字符串

引用的名称。此字段实际上是必需的，但由于向后兼容性，允许为空。此类型的实例在此处为空值几乎肯定是错误的。待办事项：添加其他有用的字段。 apiVersion、kind、uid？更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#names 待办事项：当 controller-gen 不需要时删除 kubebuilder:default https://github.com/kubernetes-sigs/kubebuilder/issues/3896。

可选

布尔值

指定是否必须定义 Secret 或其密钥

密码

对象

password 指定包含身份验证密码的 Secret 的密钥。

用户名

对象

username 指定包含身份验证用户名 Secret 的密钥。

密钥

字符串

要从中选择的密钥的密钥。必须是有效的密钥。

名称

字符串

引用的名称。此字段实际上是必需的，但由于向后兼容性，允许为空。此类型的实例在此处为空值几乎肯定是错误的。待办事项：添加其他有用的字段。 apiVersion、kind、uid？更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#names 待办事项：当 controller-gen 不需要时删除 kubebuilder:default https://github.com/kubernetes-sigs/kubebuilder/issues/3896。

可选

布尔值

指定是否必须定义 Secret 或其密钥

密钥

字符串

要从中选择的密钥的密钥。必须是有效的密钥。

名称

字符串

引用的名称。此字段实际上是必需的，但由于向后兼容性，允许为空。此类型的实例在此处为空值几乎肯定是错误的。待办事项：添加其他有用的字段。 apiVersion、kind、uid？更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#names 待办事项：当 controller-gen 不需要时删除 kubebuilder:default https://github.com/kubernetes-sigs/kubebuilder/issues/3896。

可选

布尔值

指定是否必须定义 Secret 或其密钥

密钥

字符串

要从中选择的密钥的密钥。必须是有效的密钥。

名称

字符串

引用的名称。此字段实际上是必需的，但由于向后兼容性，允许为空。此类型的实例在此处为空值几乎肯定是错误的。待办事项：添加其他有用的字段。 apiVersion、kind、uid？更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#names 待办事项：当 controller-gen 不需要时删除 kubebuilder:default https://github.com/kubernetes-sigs/kubebuilder/issues/3896。

可选

布尔值

指定是否必须定义 Secret 或其密钥

操作

字符串

基于正则表达式匹配执行的操作。

Uppercase 和 Lowercase 操作需要 Prometheus >= v2.36.0。DropEqual 和 KeepEqual 操作需要 Prometheus >= v2.41.0。

默认值：“Replace”

模数

整数

源标签值的哈希取模。

仅当操作为HashMod时适用。

正则表达式

字符串

与提取的值匹配的正则表达式。

替换值

字符串

如果正则表达式匹配，则执行替换操作的替换值。

支持正则表达式捕获组。

分隔符

字符串

分隔符是连接的SourceLabels之间的字符串。

源标签

数组 (字符串)

源标签从现有标签中选择值。它们的内容使用配置的分隔符连接，并与配置的正则表达式匹配。

目标标签

字符串

将结果字符串写入替换操作的目标标签。

对于Replace、HashMod、Lowercase、Uppercase、KeepEqual和DropEqual操作是必须的。

支持正则表达式捕获组。

客户端ID

对象

clientId指定包含OAuth2客户端ID的Secret或ConfigMap的键。

客户端密钥

对象

clientSecret指定包含OAuth2客户端密钥的Secret的键。

端点参数

对象 (字符串)

endpointParams配置要添加到令牌URL的HTTP参数。

作用域

数组 (字符串)

scopes定义用于令牌请求的OAuth2作用域。

令牌URL

字符串

tokenURL配置用于获取令牌的URL。

ConfigMap

对象

包含目标数据使用的ConfigMap。

Secret

对象

包含目标数据使用的Secret。

密钥

字符串

要选择的键。

名称

字符串

引用的名称。此字段实际上是必需的，但由于向后兼容性，允许为空。此类型的实例在此处为空值几乎肯定是错误的。待办事项：添加其他有用的字段。 apiVersion、kind、uid？更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#names 待办事项：当 controller-gen 不需要时删除 kubebuilder:default https://github.com/kubernetes-sigs/kubebuilder/issues/3896。

可选

布尔值

指定是否必须定义ConfigMap或其键。

密钥

字符串

要从中选择的密钥的密钥。必须是有效的密钥。

名称

字符串

引用的名称。此字段实际上是必需的，但由于向后兼容性，允许为空。此类型的实例在此处为空值几乎肯定是错误的。待办事项：添加其他有用的字段。 apiVersion、kind、uid？更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#names 待办事项：当 controller-gen 不需要时删除 kubebuilder:default https://github.com/kubernetes-sigs/kubebuilder/issues/3896。

可选

布尔值

指定是否必须定义 Secret 或其密钥

密钥

字符串

要从中选择的密钥的密钥。必须是有效的密钥。

名称

字符串

引用的名称。此字段实际上是必需的，但由于向后兼容性，允许为空。此类型的实例在此处为空值几乎肯定是错误的。待办事项：添加其他有用的字段。 apiVersion、kind、uid？更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#names 待办事项：当 controller-gen 不需要时删除 kubebuilder:default https://github.com/kubernetes-sigs/kubebuilder/issues/3896。

可选

布尔值

指定是否必须定义 Secret 或其密钥

操作

字符串

基于正则表达式匹配执行的操作。

Uppercase 和 Lowercase 操作需要 Prometheus >= v2.36.0。DropEqual 和 KeepEqual 操作需要 Prometheus >= v2.41.0。

默认值：“Replace”

模数

整数

源标签值的哈希取模。

仅当操作为HashMod时适用。

正则表达式

字符串

与提取的值匹配的正则表达式。

替换值

字符串

如果正则表达式匹配，则执行替换操作的替换值。

支持正则表达式捕获组。

分隔符

字符串

分隔符是连接的SourceLabels之间的字符串。

源标签

数组 (字符串)

源标签从现有标签中选择值。它们的内容使用配置的分隔符连接，并与配置的正则表达式匹配。

目标标签

字符串

将结果字符串写入替换操作的目标标签。

对于Replace、HashMod、Lowercase、Uppercase、KeepEqual和DropEqual操作是必须的。

支持正则表达式捕获组。

CA证书

对象

验证服务器证书时使用的证书颁发机构。

客户端证书

对象

进行客户端身份验证时要提供的客户端证书。

不安全跳过验证

布尔值

禁用目标证书验证。

密钥Secret

对象

包含目标客户端密钥文件的Secret。

服务器名称

字符串

用于验证目标的主机名。

ConfigMap

对象

包含目标数据使用的ConfigMap。

Secret

对象

包含目标数据使用的Secret。

密钥

字符串

要选择的键。

名称

字符串

引用的名称。此字段实际上是必需的，但由于向后兼容性，允许为空。此类型的实例在此处为空值几乎肯定是错误的。待办事项：添加其他有用的字段。 apiVersion、kind、uid？更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#names 待办事项：当 controller-gen 不需要时删除 kubebuilder:default https://github.com/kubernetes-sigs/kubebuilder/issues/3896。

可选

布尔值

指定是否必须定义ConfigMap或其键。

密钥

字符串

要从中选择的密钥的密钥。必须是有效的密钥。

名称

字符串

引用的名称。此字段实际上是必需的，但由于向后兼容性，允许为空。此类型的实例在此处为空值几乎肯定是错误的。待办事项：添加其他有用的字段。 apiVersion、kind、uid？更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#names 待办事项：当 controller-gen 不需要时删除 kubebuilder:default https://github.com/kubernetes-sigs/kubebuilder/issues/3896。

可选

布尔值

指定是否必须定义 Secret 或其密钥

ConfigMap

对象

包含目标数据使用的ConfigMap。

Secret

对象

包含目标数据使用的Secret。

密钥

字符串

要选择的键。

名称

字符串

引用的名称。此字段实际上是必需的，但由于向后兼容性，允许为空。此类型的实例在此处为空值几乎肯定是错误的。待办事项：添加其他有用的字段。 apiVersion、kind、uid？更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#names 待办事项：当 controller-gen 不需要时删除 kubebuilder:default https://github.com/kubernetes-sigs/kubebuilder/issues/3896。

可选

布尔值

指定是否必须定义ConfigMap或其键。

密钥

字符串

要从中选择的密钥的密钥。必须是有效的密钥。

名称

字符串

引用的名称。此字段实际上是必需的，但由于向后兼容性，允许为空。此类型的实例在此处为空值几乎肯定是错误的。待办事项：添加其他有用的字段。 apiVersion、kind、uid？更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#names 待办事项：当 controller-gen 不需要时删除 kubebuilder:default https://github.com/kubernetes-sigs/kubebuilder/issues/3896。

可选

布尔值

指定是否必须定义 Secret 或其密钥

密钥

字符串

要从中选择的密钥的密钥。必须是有效的密钥。

名称

字符串

引用的名称。此字段实际上是必需的，但由于向后兼容性，允许为空。此类型的实例在此处为空值几乎肯定是错误的。待办事项：添加其他有用的字段。 apiVersion、kind、uid？更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names/#names 待办事项：当 controller-gen 不需要时删除 kubebuilder:default https://github.com/kubernetes-sigs/kubebuilder/issues/3896。

可选

布尔值

指定是否必须定义 Secret 或其密钥

匹配表达式

数组

matchExpressions是标签选择器需求列表。这些需求是与关系。

matchExpressions[]

对象

标签选择器需求是一个包含值、键和关联键和值的运算符的选择器。

匹配标签

对象 (字符串)

matchLabels是{key,value}对的映射。matchLabels映射中的单个{key,value}等效于matchExpressions的一个元素，其key字段为“key”，运算符为“In”，而values数组仅包含“value”。这些需求是与关系。

密钥

字符串

key是选择器应用到的标签键。

运算符

字符串

operator表示键与一组值的关系。有效的运算符包括In、NotIn、Exists和DoesNotExist。

值

数组 (字符串)

values是字符串值的数组。如果运算符为In或NotIn，则values数组必须非空。如果运算符为Exists或DoesNotExist，则values数组必须为空。此数组在策略性合并修补程序期间会被替换。

200 - OK

PodMonitorList模式

401 - 未授权

空

200 - OK

Status模式

401 - 未授权

空

200 - OK

PodMonitorList模式

401 - 未授权

空

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的dryRun指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有dry run阶段

fieldValidation

字符串

fieldValidation指示服务器如何处理请求(POST/PUT/PATCH)中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略任何被对象静默丢弃的未知字段，并将忽略解码器遇到的最后一个重复字段以外的所有重复字段。这是v1.23之前的默认行为。- Warn：这将通过标准警告响应报头为每个从对象中删除的未知字段以及遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍将成功，并且仅会持久化任何重复字段中的最后一个。这是v1.23+中的默认值- Strict：如果任何未知字段将从对象中删除，或者存在任何重复字段，这将导致请求失败并返回BadRequest错误。服务器返回的错误将包含遇到的所有未知和重复字段。

body

PodMonitor模式

200 - OK

PodMonitor模式

201 - 已创建

PodMonitor模式

202 - 已接受

PodMonitor模式

401 - 未授权

空

名称

字符串

PodMonitor的名称

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的dryRun指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有dry run阶段

200 - OK

Status模式

202 - 已接受

Status模式

401 - 未授权

空

200 - OK

PodMonitor模式

401 - 未授权

空

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的dryRun指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有dry run阶段

fieldValidation

字符串

fieldValidation指示服务器如何处理请求(POST/PUT/PATCH)中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略任何被对象静默丢弃的未知字段，并将忽略解码器遇到的最后一个重复字段以外的所有重复字段。这是v1.23之前的默认行为。- Warn：这将通过标准警告响应报头为每个从对象中删除的未知字段以及遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍将成功，并且仅会持久化任何重复字段中的最后一个。这是v1.23+中的默认值- Strict：如果任何未知字段将从对象中删除，或者存在任何重复字段，这将导致请求失败并返回BadRequest错误。服务器返回的错误将包含遇到的所有未知和重复字段。

200 - OK

PodMonitor模式

401 - 未授权

空

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的dryRun指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有dry run阶段

fieldValidation

字符串

fieldValidation指示服务器如何处理请求(POST/PUT/PATCH)中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略任何被对象静默丢弃的未知字段，并将忽略解码器遇到的最后一个重复字段以外的所有重复字段。这是v1.23之前的默认行为。- Warn：这将通过标准警告响应报头为每个从对象中删除的未知字段以及遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍将成功，并且仅会持久化任何重复字段中的最后一个。这是v1.23+中的默认值- Strict：如果任何未知字段将从对象中删除，或者存在任何重复字段，这将导致请求失败并返回BadRequest错误。服务器返回的错误将包含遇到的所有未知和重复字段。

body

PodMonitor模式

200 - OK

PodMonitor模式

201 - 已创建

PodMonitor模式

401 - 未授权

空