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

attachMetadata

object

将节点元数据附加到发现的目标。需要 Prometheus v2.35.0 及更高版本。

jobLabel

字符串

用于从中检索作业名称的标签。

labelLimit

整数

对示例接受的标签数的 per-scrape 限制。仅在 Prometheus 版本 2.27.0 及更新版本中有效。

labelNameLengthLimit

整数

对示例接受的标签名称长度的 per-scrape 限制。仅在 Prometheus 版本 2.27.0 及更新版本中有效。

labelValueLengthLimit

整数

对示例接受的标签值长度的 per-scrape 限制。仅在 Prometheus 版本 2.27.0 及更新版本中有效。

namespaceSelector

对象

从中发现 Endpoints 对象的选择器，以选择要从中发现 Endpoints 对象的选择器。

podMetricsEndpoints

array

作为此 PodMonitor 的一部分允许的端点列表。

podMetricsEndpoints[]

对象

PodMetricsEndpoint 定义 Kubernetes Pod 提供 Prometheus 指标的可提取端点。

podTargetLabels

数组（字符串）

PodTargetLabels 将 Kubernetes Pod 上的标签传送到目标。

sampleLimit

整数

SampleLimit 对将接受的提取示例数量定义 per-scrape 限制。

selector

对象

选择 Pod 对象的选择器。

targetLimit

整数

TargetLimit 定义了接受的提取目标数量的限制。

node

布尔值

当设置为 true 时，Prometheus 必须有权限才能获取节点。

any

布尔值

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

matchNames

数组（字符串）

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

授权

对象

此端点的授权部分

basicAuth

对象

basicAuth 允许端点通过基本身份验证进行身份验证。更多信息： https://prometheus.io/docs/operating/configuration/#endpoint

bearerTokenSecret

对象

要挂载以读取用于提取目标的 bearer 令牌的机密。secret 需要与 pod 监视器位于同一个命名空间中，并可以被 Prometheus Operator 访问。

enableHttp2

布尔值

是否启用 HTTP2。

filterRunning

布尔值

丢弃没有运行的 pod。(failed, Succeeded)。默认启用此选项。更多信息： https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/#pod-phase

followRedirects

布尔值

FollowRedirects 配置提取请求是否遵循 HTTP 3xx 重定向。

honorLabels

布尔值

HonorLabels 选择指标的标签与目标标签冲突。

honorTimestamps

布尔值

honorTimestamps 控制 Prometheus 是否遵循提取数据中存在的时间戳。

interval

string

如果使用了 Prometheus 的全局提取间隔，则应提取指标的时间间隔。

metricRelabelings

array

MetricRelabelConfigs 在 ingestion 前应用到示例。

metricRelabelings[]

object

RelabelConfig 允许为目标、警报、提取示例和远程写入示例动态重写标签。更多信息： https://prometheus.io/docs/prometheus/latest/configuration/configuration/#relabel_config

oauth2

对象

URL 的 OAuth2。仅在 Prometheus 版本 2.27.0 及更新版本中有效。

params

对象

可选的 HTTP URL 参数

params{}

数组（字符串）

path

字符串

提取指标的 HTTP 路径。如果为空，Prometheus 将使用默认值（如 /metrics）。

port

字符串

此端点引用的 pod 端口的名称。与 targetPort 相互排斥。

proxyUrl

字符串

proxyUrl eg http://proxyserver:2195 Directs scrapes to proxy via this endpoint.

重新标记

array

在提取前，重新labelConfigs 应用到示例。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

字符串

用于提取的 HTTP 方案。HTTP 和 https 是预期的值，除非您通过重新标记重写 scheme 标签。如果为空，Prometheus 将使用默认值 http。

scrapeTimeout

string

如果没有指定提取结束超时，会使用 Prometheus 全局提取间隔。

targetPort

integer-or-string

deprecated: 使用 'port' 替代。

tlsConfig

对象

提取端点时使用的 TLS 配置。

credentials

object

选择命名空间中包含用于身份验证的凭证的 Secret 的键。

type

string

定义身份验证类型。该值不区分大小写。"basic"不是受支持的值。默认："Bearer"

key

字符串

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

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否需要定义 Secret 还是其密钥

password

对象

服务监控器命名空间中的 secret，其中包含用于身份验证的密码。

username

对象

服务监控器命名空间中的 secret，其中包含用于身份验证的用户名。

key

字符串

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

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否需要定义 Secret 还是其密钥

key

字符串

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

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否需要定义 Secret 还是其密钥

key

字符串

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

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否需要定义 Secret 还是其密钥

action

string

根据正则表达式匹配要执行的操作。大写 和低 大小 操作需要 Prometheus >= v2.36.0。DropEqual 和 KeepEqual 操作需要 Prometheus >= v2.41.0。默认："Replace"

modulus

整数

modulus 采用 source 标签值的哈希。仅在操作为 HashMod 时适用。

regex

字符串

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

替换

string

如果正则表达式匹配，则执行 replace 操作的替换值。正则表达式捕获组可用。

分隔符

string

分隔符是串联的 SourceLabels 之间的字符串。

sourceLabels

数组（字符串）

source 标签从现有标签中选择值。其内容使用配置的 Separator 连接，并与配置的正则表达式匹配。

targetLabel

string

生成的字符串写入替换标签。对于 替换,HashMod,Lowercase,Uppercase,KeepEqual 和 DropEqual 操作是必须的。正则表达式捕获组可用。

clientId

对象

包含 OAuth2 客户端 ID 的 secret 或 configmap

clientSecret

对象

包含 OAuth2 客户端 secret 的 secret

endpointParams

对象（字符串）

附加到令牌 URL 的参数

scopes

数组（字符串）

用于令牌请求的 OAuth2 范围

tokenUrl

字符串

从中获取令牌的 URL

configMap

对象

包含用于目标的数据的 ConfigMap。

secret

对象

包含用于目标的数据的 secret。

key

字符串

要选择的密钥。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否必须定义 ConfigMap 还是其键

key

字符串

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

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否需要定义 Secret 还是其密钥

key

字符串

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

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否需要定义 Secret 还是其密钥

action

string

根据正则表达式匹配要执行的操作。大写 和低 大小 操作需要 Prometheus >= v2.36.0。DropEqual 和 KeepEqual 操作需要 Prometheus >= v2.41.0。默认："Replace"

modulus

整数

modulus 采用 source 标签值的哈希。仅在操作为 HashMod 时适用。

regex

字符串

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

替换

string

如果正则表达式匹配，则执行 replace 操作的替换值。正则表达式捕获组可用。

分隔符

string

分隔符是串联的 SourceLabels 之间的字符串。

sourceLabels

数组（字符串）

source 标签从现有标签中选择值。其内容使用配置的 Separator 连接，并与配置的正则表达式匹配。

targetLabel

string

生成的字符串写入替换标签。对于 替换,HashMod,Lowercase,Uppercase,KeepEqual 和 DropEqual 操作是必须的。正则表达式捕获组可用。

ca

object

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

cert

object

执行 client-authentication 时要出现的客户端证书。

insecureSkipVerify

布尔值

禁用目标证书验证。

keySecret

对象

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

serverName

字符串

用于验证目标的主机名。

configMap

对象

包含用于目标的数据的 ConfigMap。

secret

对象

包含用于目标的数据的 secret。

key

字符串

要选择的密钥。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否必须定义 ConfigMap 还是其键

key

字符串

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

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否需要定义 Secret 还是其密钥

configMap

对象

包含用于目标的数据的 ConfigMap。

secret

对象

包含用于目标的数据的 secret。

key

字符串

要选择的密钥。

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否必须定义 ConfigMap 还是其键

key

字符串

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

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否需要定义 Secret 还是其密钥

key

字符串

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

name

字符串

引用的名称。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names TODO: 添加其他有用的字段。apiVersion、kind、uid？

optional

布尔值

指定是否需要定义 Secret 还是其密钥

matchExpressions

array

matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。

matchExpressions[]

对象

标签选择器要求是一个选择器，其中包含与键和值相关的值、键和值。

matchLabels

对象（字符串）

matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素，其 key 字段是 "key"，运算符是 "In"，值数组仅包含 "value"。要求的逻辑关系是 AND。

key

字符串

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

operator

字符串

运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。

值

数组（字符串）

值是字符串值的数组。如果运算符是 In 或 NotIn，则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist，则值数组必须为空。这个数组会在策略性合并补丁中被替换。