Kubernetes 对象状态指标
kube-state-metrics,一个用于生成和暴露集群级指标的附加代理。
Kubernetes API 中 Kubernetes 对象的状态可以作为指标公开。 一个名为 kube-state-metrics 的附加代理可以连接到 Kubernetes API 服务器,并暴露一个 HTTP 端点,其中包含从集群中各个对象的状态生成的指标。它公开了关于对象状态的各种信息,如标签和注解、启动和终止时间、状态或对象当前所处阶段。例如,在 Pod 中运行的容器会创建一个 kube_pod_container_info
指标。这包括容器的名称、它所属的 Pod 的名称、Pod 运行所在的命名空间、容器镜像的名称、镜像 ID、容器规范中的镜像名称、正在运行的容器 ID 和 Pod ID 作为标签。
🛇 此项链接到不属于 Kubernetes 本身的第三方项目或产品。更多信息
一个能够抓取 kube-state-metrics 端点的外部组件(例如通过 Prometheus)现在可以用来启用以下用例。
示例:使用 kube-state-metrics 的指标来查询集群状态
kube-state-metrics 生成的指标序列有助于深入了解集群,因为它们可以用于查询。
如果您使用 Prometheus 或其他使用相同查询语言的工具,则以下 PromQL 查询会返回未就绪的 Pod 数量
count(kube_pod_status_ready{condition="false"}) by (namespace, pod)
示例:基于 kube-state-metrics 的告警
从 kube-state-metrics 生成的指标还可以用于集群中问题的告警。
如果您使用 Prometheus 或其他使用相同告警规则语言的工具,如果 Pod 处于 Terminating
状态超过 5 分钟,则会触发以下告警
groups:
- name: Pod state
rules:
- alert: PodsBlockedInTerminatingState
expr: count(kube_pod_deletion_timestamp) by (namespace, pod) * count(kube_pod_status_reason{reason="NodeLost"} == 0) by (namespace, pod) > 0
for: 5m
labels:
severity: page
annotations:
summary: Pod {{$labels.namespace}}/{{$labels.pod}} blocked in Terminating state.
此页面上的项目引用了提供 Kubernetes 所需功能的第三方产品或项目。 Kubernetes 项目作者不对这些第三方产品或项目负责。有关更多详细信息,请参阅 CNCF 网站指南。
在提出添加额外第三方链接的更改之前,您应该阅读内容指南。
上次修改时间为 2024 年 3 月 11 日下午 10:46 PST:添加有关 kube-state-metrics 的部分 (c1e7578efb)