容器与云原生 / 系统课时
资源指标采集
资源指标采集
本课将部署 Metrics Server,打通 Kubelet、聚合 API 与 kubectl top 的资源指标链路,并完成节点、Pod 和容器级 CPU、内存数据的查看与故障验证。
学习目标
- 说明 Metrics Server 在资源指标链路中的位置与边界。
- 完成组件部署,并验证
metrics.k8s.ioAPI 可用。 - 使用
kubectl top解读节点、Pod 与容器的即时资源数据。
采集链路与组件部署
Metrics Server 是集群级资源指标组件。它周期性访问各节点 Kubelet 的 Summary API,汇总 CPU 与内存数据,并通过 API 聚合层暴露 metrics.k8s.io。kubectl top 查询的是这组即时指标,而不是直接登录节点读取操作系统数据。

部署前应确认节点处于 Ready,控制面启用了 API 聚合层,并且 Metrics Server 能访问各节点 Kubelet 的 HTTPS 端口。生产环境还应保证 Kubelet 服务端证书可被集群信任,避免依赖跳过证书校验的临时参数。
下面使用 Metrics Server 官方发布入口安装组件,并等待 Deployment 完成滚动发布。该地址会指向当前稳定清单,执行环境需要能够访问 GitHub。
kubectl apply -f https://github.com/kubernetes-sigs/metrics-server/releases/latest/download/components.yaml
kubectl -n kube-system rollout status deployment/metrics-server --timeout=120s
kubectl get apiservice v1beta1.metrics.k8s.io预期输出
<RESOURCE>/metrics-server created
...
deployment "metrics-server" successfully rolled out
v1beta1.metrics.k8s.io kube-system/metrics-server True <TIME><RESOURCE> 代表清单创建的 ServiceAccount、Service、Deployment 等对象,具体行数会随版本变化;关键验收点是滚动发布成功,并且 APIService 的 AVAILABLE 为 True。
查看并解释资源指标
组件就绪后,可分别查看节点、全部命名空间中的 Pod,以及单个 Pod 内各容器的使用量。
kubectl top nodes
kubectl top pods -A --sort-by=cpu
kubectl top pod <POD> -n <NAMESPACE> --containers预期输出
NAME CPU(cores) CPU% MEMORY(bytes) MEMORY%
<NODE> <CPU> <PCT> <MEMORY> <PCT>
NAMESPACE NAME CPU(cores) MEMORY(bytes)
<NAMESPACE> <POD> <CPU> <MEMORY>
POD NAME CPU(cores) MEMORY(bytes)
<POD> <CONTAINER> <CPU> <MEMORY><NODE>、<POD>、<NAMESPACE> 和各数值需替换为实际结果。CPU 的 100m 表示约 0.1 个核心;内存通常反映工作集近似值。这里看到的是近期使用量,不等同于 Pod 声明的 requests 或 limits,也不能用于长期趋势分析。
验证与失败处理
出现 Metrics API not available 时,先检查 APIService 条件,再查看 Metrics Server 日志。不要一开始就修改 Deployment 参数,否则容易掩盖网络、DNS 或证书根因。
kubectl describe apiservice v1beta1.metrics.k8s.io
kubectl -n kube-system logs deployment/metrics-server --tail=80预期结果
Status:
Conditions:
- Type: Available
Status: True若状态不是 True,日志中常见线索包括 Kubelet 地址不可达、证书校验失败或响应超时。实验环境可临时使用 --kubelet-insecure-tls 验证是否为证书问题,但生产环境应修复 Kubelet 服务端证书和信任链。新建 Pod 也可能需要等待一个采集周期后才出现在 kubectl top 中。