容器与云原生 / 系统课时

理解 Kubernetes 指标 API

理解 Kubernetes 指标 API

HPA 并不直接读取 Prometheus、云监控或应用进程,而是通过 Kubernetes API 聚合层读取标准化后的指标。本课把 Resource Metrics、Custom Metrics 与 External Metrics 三条路径拆开,并用 API 发现命令确认集群到底暴露了哪些指标接口。

学习目标

  • 区分三类指标 API 的职责、对象范围与常见数据来源。
  • 说明 metrics-server、指标适配器、API 聚合层和 HPA 之间的数据路径。
  • 用 kubectl 检查集群已注册的指标 API,并判断缺失接口会影响哪类 HPA 指标。

三类指标 API 解决不同问题

三类 API 的共同点是都通过 Kubernetes API Server 暴露,但它们不是同一个数据源,也不是同一种指标模型。

API 主要用途 常见来源 HPA 中的对应类型
metrics.k8s.io Pod、Node 的 CPU 与内存资源使用量 kubelet 采集,通常由 metrics-server 汇总 Resource、ContainerResource
custom.metrics.k8s.io 与 Kubernetes 对象关联的业务指标 Prometheus 等监控系统经 adapter 转换 Pods、Object
external.metrics.k8s.io 与某个 Kubernetes 对象无直接归属的外部指标 消息队列、云监控、SaaS 指标经 adapter 转换 External

Resource Metrics 刻意只覆盖自动伸缩和基础资源查看所需的 CPU、内存数据,它不是完整监控系统。Custom Metrics 适合“某组 Pod 的每秒请求数”或“某个 Ingress 的指标”这类能关联 Kubernetes 对象的信号;External Metrics 更适合队列积压、云服务事件数等集群外部信号。

HPA 通过聚合 API 读取指标

资源指标通常从 kubelet 进入 metrics-server,再由聚合层注册成 metrics.k8s.io;业务或外部指标则先进入监控后端,再由 adapter 以 custom.metrics.k8s.io 或 external.metrics.k8s.io 的形式注册。HPA Controller 最终面向的是这些 API,而不是后端监控产品的原生查询接口。

Kubernetes 三类指标 API 到 HPA 的数据路径

API 聚合层的作用是让扩展 API Server 看起来像 Kubernetes API 的一部分。对应的 APIService 未注册或不可用时,即使 Prometheus 本身有数据,HPA 也无法通过那条标准接口取得指标。

用 API 发现确认能力是否存在

先让 API Server 自己回答“有哪些指标 API”,比直接猜测 adapter 是否安装更可靠。下面命令只依赖 kubectl 和常见的 grep。

bash
kubectl api-versions | grep -E '(metrics\.k8s\.io|custom\.metrics\.k8s\.io|external\.metrics\.k8s\.io)/'

如果三类接口都已注册,预期输出类似如下;<VERSION> 取决于集群和指标实现,只有 metrics-server 的集群通常只会看到 metrics.k8s.io。

text
custom.metrics.k8s.io/<VERSION>
external.metrics.k8s.io/<VERSION>
metrics.k8s.io/<VERSION>

若命令没有任何输出,先检查 API 聚合层和相关 APIService。若只有 metrics.k8s.io,CPU/内存 HPA 可以工作,但声明 Pods、Object 或 External 指标的 HPA 会因为对应 API 不可用而无法取得指标。

从 HPA 配置反推它会查询哪条 API

看到一个 autoscaling/v2 HPA 时,可以先读 spec.metrics[].type 再定位数据路径,而不是先去监控后端盲查。Resource 和 ContainerResource 走资源指标 API,Pods 与 Object 走自定义指标 API,External 走外部指标 API;配置多个指标时,HPA 会分别计算建议副本数,再采用其中最大的扩容建议。

排查指标问题时按“HPA 指标类型 → 对应聚合 API → APIService 可用性 → adapter/metrics-server → 原始数据源”反向追踪,能快速区分是 HPA 配置错误、聚合接口缺失,还是监控后端根本没有产生数据。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

理解 Kubernetes 指标 API

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通