最可靠方式是调用 metrics-server 的 /apis/metrics.k8s.io/v1beta1/nodes API 获取节点 CPU(millicores)和内存(bytes)瞬时用量,需确保 metrics-server 运行正常、RBAC 授权 nodes/metrics 权限,并用 k8s.io/metrics SDK 解析 NodeMetricsList,注意 Cpu().Value() 返回毫核·秒/秒,需除以节点总逻辑核数得利用率。

直接调用 metrics-server API 是最可靠的方式
Go 程序在集群内获取节点资源使用率,核心路径是访问 /apis/metrics.k8s.io/v1beta1/nodes 这个 REST endpoint。这不是自定义指标,而是 metrics-server 提供的标准资源指标 API。它返回的是每个节点的瞬时 CPU 和内存用量,单位与 kubectl top node 一致(CPU(cores)、MEMORY(bytes))。
实操前务必确认:
- metrics-server 已部署且处于 Running 状态:
kubectl get pods -n kube-system | grep metrics-server -
kubectl top node能正常返回数据——这是最简单的连通性验证,失败就别写 Go 代码了 - Go 客户端使用的 ServiceAccount 需有
nodes/metrics的get权限(RBAC 中需绑定system:metrics-readerClusterRole 或等效权限)
用 k8s.io/metrics SDK 解析响应最省事
硬解析 JSON 很容易出错(比如字段嵌套深、空值、类型不一致),推荐直接使用官方维护的 k8s.io/metrics 包。它提供 NodeMetricsList 类型,能自动解码 metrics-server 返回结构。
关键步骤:
- 导入
k8s.io/metrics/pkg/client/clientset/versioned,传入rest.Config初始化 clientset - 调用
clientset.MetricsV1beta1().NodeMetricses().List(ctx, metav1.ListOptions{}) - 遍历
items,每个NodeMetrics的Usage字段含Cpu和Memory——注意它们是*resource.Quantity类型,不是原始字符串 - 用
q.AsInt64()或q.Value()提取数值,避免手动 parse"123m"或"800Mi"
示例片段:
nodeMetrics, err := clientset.MetricsV1beta1().NodeMetricses().List(ctx, metav1.ListOptions{})
if err != nil {
return err
}
for _, m := range nodeMetrics.Items {
cpu := m.Usage.Cpu().Value() // 单位:纳秒/秒 → 换算为 millicores 需除以 1e6
mem := m.Usage.Memory().Value() // 单位:字节
log.Printf("node %s: cpu=%d mCores, mem=%d bytes", m.Name, cpu/1e6, mem)
}
注意采样延迟和权限边界
metrics-server 默认只保留最近 2 分钟的指标,且每 10–30 秒抓取一次 cAdvisor 数据。这意味着:
- 刚启动的节点或新扩容的节点,
NodeMetrics可能为空,不是 bug,是数据还没上来 - 如果程序运行在非 default 命名空间的 Pod 内,
rest.InClusterConfig()获取的 token 默认无集群级 metrics 权限,必须显式绑定 RBAC - 不要尝试从
/sys/fs/cgroup/读节点级资源——那是容器视角,节点整体 CPU/Mem 不在此处暴露;cgroup 只对本容器进程有效
最易被忽略的一点:NodeMetrics 的 Cpu().Value() 返回的是“毫核·秒/秒”,即实际是 millicores 数值(例如 123m → 返回 123000000),不是百分比。它表示该节点当前被占用的 CPU 等效毫核数,要换算成利用率需除以节点总逻辑核数(可通过 Node.Status.Capacity.Cpu() 获取)。这个换算逻辑不在 metrics-server 里,得自己补。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











