Go应用在Kubernetes中监控失效，主因是未正确暴露/metrics端点：需监听0.0.0.0而非127.0.0.1，注册promhttp.HandlerFor包装的registry，Service与ServiceMonitor端口名对齐，RBAC授权services等资源，且metrics handler须无IO无锁。
Go 应用在 Kubernetes 中监控失效，八成不是 Prometheus 没配好，而是你的服务根本没暴露有效 /metrics 端点，或端口/路径/权限任一环节断了。
Go 代码里必须显式暴露 /metrics 并绑定 0.0.0.0
很多 Go 服务跑起来后 curl http://pod-ip:8080/metrics 直接 connection refused，根本不是 Prometheus 配置问题，而是应用压根没监听外部流量。
-
http.ListenAndServe(":8080", nil)默认监听127.0.0.1:8080，Kubernetes Pod 内部网络下，这等于只给自己听 —— kubelet 探针、Service、Prometheus 全都连不上 - 必须写成
http.ListenAndServe("0.0.0.0:8080", nil)，或更稳妥地从环境变量读取：PORT，再拼接"0.0.0.0:" + port -
/metrics路由必须注册到 HTTP mux，且 handler 必须用promhttp.HandlerFor()包装你自己的prometheus.Registry，别直接用默认 registry（否则自定义指标不出现） - 别把
/metrics放在非标准路径（如/admin/metrics），除非你明确改了 Prometheus 的metrics_path配置
Service 和 ServiceMonitor 的 port 名必须对齐
Prometheus Operator 环境下，ServiceMonitor 是自动发现的关键，但它不看 containerPort 数值，只认 service.port.name。
- 你的
ServiceYAML 里必须给 port 打上名字，比如：name: metrics，且该 port 的targetPort必须指向容器实际监听的端口（如8080） -
ServiceMonitor的endpoints.port字段必须和这个name完全一致，大小写敏感 - 如果 Service 没设
name，或ServiceMonitor写成port: "8080"（数值而非名字），自动发现就会静默失败，Prometheus targets 页面里根本看不到这个 endpoint - 验证方法：
kubectl get servicemonitor -o yaml看是否匹配；再进 Prometheus UI 的Status > Targets页面，确认 target 状态是 UP 且 labels 含有你的 service 名
RBAC 权限缺失会导致指标采集“看不见”但无报错
你的 Go 应用指标明明暴露了，curl 也能拿到数据，但 Prometheus targets 显示 connection refused 或 server returned HTTP status 403 —— 很可能不是网络问题，而是 ServiceAccount 权限不够。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- Pod 使用的
serviceAccountName对应的RoleBinding（或ClusterRoleBinding）必须允许对该 Service 的get和list操作 - 常见漏项：
resources: ["services"]缺失，或verbs: ["get"]没加；Prometheus Operator 组件本身也需要对应权限去读取ServiceMonitor和Pod对象 - 不要依赖
cluster-admin临时测试 —— 它掩盖真实权限缺陷；最小化授权：只给services、endpoints、serviceMonitors的get/list/watch - 快速验证：进 Prometheus Pod，执行
curl -v http://my-go-service:8080/metrics；如果返回 403，就是 RBAC 拦截；如果返回 200 但指标为空，再查 Go 应用日志是否 panic 或未初始化 registry
别在 Go 代码里“部署” kube-state-metrics
这是最常被误解的一点：kube-state-metrics 不是你 Go 项目要 import 或启动的东西，它是一个独立运行在集群里的 Deployment。
- 你在 Go 代码里
import "k8s.io/kube-state-metrics"？这个包不存在，Go modules 会报错 - 你在
main.go里调ksm.Start()？没有这个 API，kube-state-metrics 是一个完整二进制，不是 SDK - 你要做的只有一件事：确保你的 Go 应用自身暴露了
/metrics，然后让 Prometheus 去抓它；kube-state-metrics 的职责是把Pod、Deployment这些 K8s 对象状态转成指标，它不消费你的 Go 服务指标 - 如果你看到 Grafana 里缺
kube_pod_status_phase，问题出在 kube-state-metrics 自身的 RBAC 或 namespace 权限，和你的 Go 服务完全无关
真正容易被忽略的是：Prometheus 抓取超时默认是 10s，而 Go 应用若在 /metrics handler 里做了阻塞操作（比如同步查 DB、锁全局 registry），会导致整个 scrape 卡住 —— 表现为 targets 显示 DOWN，但 curl 手动调又正常。务必让 metrics handler 是纯内存计算、无 IO、无锁的。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
