registry.k8s.io/kube-state-metrics/kube-state-metrics:v2.7.0

kube-state-metrics 是 Kubernetes 生态中一款轻量但关键的监控组件，主要作用是将集群内各类资源对象的状态信息转化为可被监控系统抓取的指标数据。它通过持续监听 Kubernetes API Server，收集 Pod、Deployment、StatefulSet、Service、ConfigMap 等核心资源的元数据与运行状态，再按照 Prometheus 指标规范格式化输出，供监控系统进一步处理。

其核心价值在于填补了“资源状态监控”的空白。举例来说，它能暴露 Pod 的就绪/未就绪状态、Deployment 的期望副本数与当前可用副本数差异、StatefulSet 的序号分配情况、Node 的污点/容忍度配置，甚至包括 Job 的完成状态和 CronJob 的执行记录等。这些指标不同于 metrics-server 聚焦的“资源使用率”（如 CPU、内存），而是直接反映资源对象的“健康状态”与“配置一致性”——比如某个 Deployment 长期处于“副本不足”状态，或某个 Service 关联的 Endpoint 数量异常减少，这些信息往往是排查集群稳定性问题的关键线索。

在实际应用中，kube-state-metrics 通常与 Prometheus、Grafana 配合使用：Prometheus 定期抓取它输出的指标，Grafana 则基于这些数据构建状态监控面板。例如，运维人员可通过面板直观查看“所有 Namespace 下未就绪 Pod 占比”“Deployment 副本异常率”等聚合指标，快速定位资源调度故障或配置错误。部署时，它以 Deployment 形式运行在集群内，仅需通过 RBAC 配置赋予访问 API Server 的权限（如读取 pods、deployments 等资源），无需额外存储依赖，资源占用极低。

作为 Kubernetes 监控体系的“状态感知层”，kube-state-metrics 帮助用户从“资源对象维度”理解集群运行逻辑，是实现精细化运维、提前预警潜在风险的重要工具。无论是保障业务稳定性，还是优化资源配置，它都扮演着不可替代的角色。