Go语言Prometheus监控接入_Golang指标采集与告警配置-Golang-PHP中文网

Go服务/metrics为空因指标未注册，默认注册表为空；须显式调用MustRegister(NewGoCollector())及自定义指标，且不可在handler中重复注册；Counter不显示常因label不匹配或未调用Inc()；Prometheus target为DOWN多因网络配置错误，如监听地址应为:9091而非127.0.0.1:9091。

go语言prometheus监控接入_golang指标采集与告警配置

Go 服务暴露 `/metrics` 端点为什么返回空？

不是 handler 没挂上，是指标根本没注册进默认注册表。promhttp.Handler() 只吐已注册的指标，而默认只带空注册表——运行时指标（如 go_goroutines）也不会自动出现。

必须显式调用 prometheus.MustRegister(prometheus.NewGoCollector())，通常放在 init() 或 main() 开头
自定义指标（如 http_requests_total）也要在同一阶段注册，不能等到第一个请求才创建+注册，否则首次抓取永远为空
别在 HTTP handler 里反复调用 NewCounter() + MustRegister()，会 panic 报 “duplicate metrics collector registration attempted”
如果用了 prometheus.NewRegistry() 自定义注册表，就得用 promhttp.HandlerFor(reg, ...)，否则 promhttp.Handler() 仍查默认表，你的指标看不见

Counter 在 `/metrics` 里始终不显示？检查 label 和调用链

Counter 默认不输出零值，这是设计行为，不是 bug。但更常见的“不显示”其实是 label 不匹配或调用遗漏。

NewCounterVec(..., []string{"method", "status"}) 定义了两个 label，调用时就必须传两个非空字符串：.WithLabelValues("GET", "200").Inc()；传 "GET", "" 或少传一个，会 panic
label 名称大小写和顺序必须完全一致：定义是 status，就不能在 WithLabelValues 里传 "statusCode"，指标虽存但 Prometheus 查询不到
确保业务 handler 真的执行到了 .Inc() 或 .Add() ——比如中间件提前 return、panic、或路由没匹配上，计数器就永远不会被触发
用 curl -s http://localhost:9091/metrics | grep http_requests_total 直接验证，避免被 Grafana 缓存或查询语法误导

Prometheus targets 显示 DOWN？先盯住网络和监听地址

90% 的 DOWN 状态和 Go 代码无关，而是网络层或配置错位。Prometheus 日志里若出现 server returned HTTP status 404 Not Found 或 context deadline exceeded，基本可排除指标逻辑问题。

Golang Uber Dig

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

下载

Go 服务监听地址别写 127.0.0.1:9091，要写 :9091（即绑定 ""），否则容器外、宿主机或 Kubernetes Service 无法访问
scrape_configs.targets 别填 localhost:9091 ——这是 Prometheus 自己的 localhost，不是你 Go 服务的；Docker Desktop 用 host.docker.internal:9091，K8s 用 Service DNS 名如 my-service.default.svc.cluster.local:9091
确认防火墙/安全组放行了目标端口；telnet your-go-app 9091 能通，才是网络层 OK
scrape timeout 默认 10s，若 /metrics 响应慢（比如同步读 DB），先临时设成 scrape_timeout: 5s 并观察日志

报警规则 `for: 2m` 一直不 firing？注意 `scrape_interval` 和评估频率

for: 2m 不是“持续两分钟”，而是“连续满足条件的评估次数 ≥ ceil(2m / scrape_interval)”。这个细节被大量忽略。

若 scrape_interval: 30s，则 for: 2m 要求连续 4 次抓取都满足条件才会触发；中间任何一次不满足，计数清零
规则中用 OFFSET（如 http_requests_total OFFSET 5m）时，Prometheus 必须能回溯到 5 分钟前的数据——如果 retention 时间太短或历史数据被清理，表达式直接返回空，不会告警
rate() 类函数对采样点敏感：若 scrape_interval 太大（如 2m），rate(http_requests_total[5m]) 可能因点太少而计算失败；建议保持 scrape_interval ≤ 30s，range vector 至少覆盖 4×interval
在 Prometheus 表达式浏览器里直接输入规则表达式（如 http_requests_total{job="my-service"} ），看是否真有数据返回，再加 FOR 和 OFFSET