kube-state-metrics 是独立的 Go 编写服务，需确保其 RBAC 包含 namespaces 的 list/watch 权限、Pod 所在 namespace 可被监听、Prometheus relabel 未过滤关键标签，才能采集到 Golang 应用指标。

kube-state-metrics 不是 Golang 项目的一部分，也不是你“在 Golang 项目中部署”的组件——它本身就是一个用 Go 编写的独立服务，运行在 Kubernetes 集群里，为 Prometheus 提供指标。如果你的 Golang 项目跑在 K8s 上，想让它被 kube-state-metrics 监控到，关键不是“部署它到你的项目”，而是确保它已正确运行，并且你的 Pod/Deployment 等资源能被它发现。

---

为什么你的 Golang 应用没出现在 kube-state-metrics 指标里？

常见现象：curl http://kube-state-metrics:8080/metrics | grep kube_pod_status_phase 能看到指标，但查不到你应用的 Pod 名字；或者 Grafana 里 kube_pod_status_phase{pod=~"my-go-app.*"} 返回空。

• Pod 还没调度成功（状态是 Pending 或 Unknown），kube-state-metrics 只暴露已存在于 API Server 中的对象状态，不保证实时秒级同步
• 你的 Deployment 或 Pod 没打 label，而 kube-state-metrics 默认不做过滤，但 Prometheus 抓取时若用了 relabel_configs 误删了 pod 或 namespace 标签，会导致指标丢失
• kube-state-metrics 的 RBAC 权限不足，漏掉了你所在 namespace —— 它默认只监听全部 namespace，但如果用了自定义 ClusterRole，可能删了 namespaces 或 pods 的 list/watch

如何验证 kube-state-metrics 正在采集你的 Golang Pod？

直接查它的 metrics endpoint，别绕 Grafana 或 Prometheus：

• 先确认服务可访问：kubectl -n monitoring get service kube-state-metrics（假设装在 monitoring 命名空间）
• 端口转发本地调试：kubectl -n monitoring port-forward svc/kube-state-metrics 8080，然后浏览器打开 http://localhost:8080/metrics
• 搜索你 Pod 的名字：curl -s http://localhost:8080/metrics | grep 'kube_pod_status_phase{pod="my-go-app-.*"' | head -3
• 如果返回为空，但 kube_pod_info 有大量其他 Pod，说明它确实没“看到”你的资源 —— 重点检查你 Pod 所在 namespace 是否被 kube-state-metrics 的 ServiceAccount 有权访问

部署时最容易被忽略的权限坑：ClusterRole 缺少 namespaces 列表

很多精简版 YAML（比如某些博客贴出的 cluster-role.yaml）会删掉 namespaces 资源的权限，理由是“只监控工作负载”。但 kube-state-metrics 内部需要 list/watch namespaces 才能发现新 namespace 下的 Pod 和 Deployment —— 否则它根本不会开始监听那个 namespace。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

立即学习“go语言免费学习笔记（深入）”；

• 必须包含这一段（哪怕你只用 default 命名空间）：

  resources:
  - namespaces
  verbs:
  - list
  - watch

• 检查当前权限：kubectl get clusterrole kube-state-metrics -o yaml | yq '.rules[] | select(.resources[]? == "namespaces")'（用 yq）或手动 grep
• 如果缺失，补上并重启 Pod：kubectl -n monitoring rollout restart deploy/kube-state-metrics

你的 Golang 应用不需要改代码，但得配对 label 和命名空间

kube-state-metrics 不侵入业务逻辑，它只读 API。但你要让它指标可用，得让 Prometheus 能关联到你：

• Deployment 必须有稳定 label，例如：app: my-go-app，这样 kube_deployment_status_replicas_available{deployment="my-go-app"} 才能命中
• 避免用 generateName 创建无名 Pod —— kube_pod_status_phase 依赖 Pod metadata.name 字段，generateName 产生的名字带随机后缀，不利于告警和查询
• 如果你的应用 Pod 在 default namespace，而 kube-state-metrics 被限制在 monitoring namespace 里运行，这没问题；但它自己的 ClusterRoleBinding 必须绑定到 ClusterRole（不是 Role），否则跨 namespace 权限无效

真正卡住的地方往往不是镜像拉不下来，也不是端口不通，而是权限粒度太细、namespace 漏监听、或者 Prometheus 抓取时 relabel 把关键 label 删光了。盯住 /metrics 原始输出，比看 Grafana 面板更能快速定位问题。