Prometheus监控：指标采集与自定义方法

本文深入剖析了Prometheus在Go微服务监控实践中最常遇到的四大痛点：指标采集失败的根本原因（如端点未暴露、配置错配、网络拦截）；如何正确集成promhttp暴露标准/metrics端点并规避中间件冲突；自定义指标命名必须遵循的严格规范（小写+下划线、后缀约定、标签克制）以确保可聚合与工具校验通过；以及Counter重置导致的历史断层问题——强调依赖Prometheus服务端函数自动处理翻转，而非客户端干预，并警惕Pushgateway误用。每一点都直击生产环境真实陷阱，提供可立即验证的诊断命令和配置要点，助你构建稳定、可观测、符合生态规范的微服务监控体系。

为什么 prometheus.yml 里加了 job 却没采集到指标？

根本原因通常是目标服务没暴露符合 Prometheus 要求的文本格式指标端点，或者抓取配置和实际服务地址/路径不匹配。

• scrape_configs 中的 static_configs.targets 必须写容器或 Pod 的真实可访问 IP+端口（K8s 环境下别直接写 localhost:8080）
• 被监控服务必须在 /metrics（默认路径）返回纯文本、每行一个 key{label=value} value timestamp 格式的响应；用 curl http://your-service:port/metrics 能直接看到内容才算合格
• 如果服务用了自定义路径（如 /actuator/prometheus），得在 metrics_path 字段显式指定，不能只改 target
• 注意防火墙、Service Mesh（如 Istio）sidecar 拦截、Pod readiness probe 未就绪导致 endpoint 未注入等隐性拦截点

Go 微服务怎么暴露 http.Handler 供 Prometheus 抓取？

别自己拼字符串写指标输出——用官方 promhttp 处理器，它自动处理 Content-Type、gzip、HEAD 请求和错误响应。

• 引入 github.com/prometheus/client_golang/prometheus/promhttp
• 在 HTTP 路由中注册：http.Handle("/metrics", promhttp.Handler())（Go 1.22+ 可用 http.HandleFunc + promhttp.Handler().ServeHTTP）
• 避免把 promhttp.Handler() 和其他中间件混用导致 header 冲突；尤其别在它前面加自定义 gzip 或 auth 中间件
• 如果服务用的是 Gin/Echo 等框架，需用对应适配器（如 ginprometheus.NewPrometheus），原生 promhttp.Handler() 无法直接挂载

自定义指标命名为什么总被 promtool check metrics 报错？

不是语法错，是违反 Prometheus 命名约定导致指标无法被正确识别或聚合。

• 名称必须全小写，用下划线分隔，不能含空格、点、破折号；http_request_total ✅，HttpRequestTotal ❌，http-request-total ❌
• 计数器（counter）必须以 _total 结尾；直方图（histogram）必须带 _bucket、_sum、_count 后缀；否则 rate()、histogram_quantile() 函数会失效
• 不要给同一个逻辑指标起多个名字（比如同时用 api_latency_seconds 和 service_response_time），聚合查询时没法统一
• 标签（label）值别塞 JSON 或长路径；高频变动的 label（如 request_id）会导致 series 爆炸，查 prometheus_tsdb_head_series 就能发现异常增长

微服务重启后历史指标断层，counter 类型重置怎么处理？

Counter 本身支持重置（比如进程 crash 后重启），但 Prometheus 的 rate() 和 increase() 函数能自动处理，前提是抓取间隔稳定、没有漏采。

• 确保 scrape_interval ≤ 30s（默认 1m），且 scrape_timeout 留足余量（建议设为 interval 的 90%）
• 别在客户端做“重置归零”逻辑；Counter 就该从 0 开始累加，靠服务端函数识别翻转
• 如果用了 Pushgateway，它是反模式：pushed 的 counter 不会自动处理重置，且无法反映实例生命周期，仅适用于批任务场景
• 验证是否真断层：查 changes(your_counter_total[1h])，结果为 0 表示完全没上报；查 resets(your_counter_total[1h]) 看是否频繁重置（正常重启应只有 1 次）

最常被忽略的是 target 的 relabel_configs 里误删了 __address__ 或改错了 __metrics_path__，导致 scrape 目标静默失败——它不会报错，只是 quietly 不采集。

好了，本文到此结束，带大家了解了《Prometheus监控：指标采集与自定义方法》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！