Golang服务通过集成Prometheus暴露指标、实现/healthz健康检查，并对接Alertmanager发送告警，结合OpenTelemetry增强观测性，构建完整监控体系。
服务监控与告警是保障系统稳定运行的关键环节。在 Golang 云原生实践中，结合 Prometheus、Gin、OpenTelemetry 等工具，可以高效实现指标采集、健康检查和异常告警。下面介绍如何使用 Golang 构建一个具备基础监控与告警能力的服务。
集成 Prometheus 实现指标暴露
要让 Golang 服务支持监控，第一步是暴露可被 Prometheus 抓取的指标。Prometheus 提供了官方的 Go 客户端库 prometheus/client_golang，用于记录计数器、直方图、仪表盘等常用指标。
示例：在 Gin 框架中注册 Prometheus 中间件：
func prometheusMiddleware() gin.HandlerFunc {counter := prometheus.NewCounterVec(
prometheus.CounterOpts{Name: "http_requests_total", Help: "Total HTTP requests"},
[]string{"method", "path", "code"},
)
prometheus.MustRegister(counter)
return func(c *gin.Context) {
start := time.Now()
c.Next()
duration := time.Since(start).Seconds()
histogram.WithLabelValues(c.Request.Method, c.FullPath()).Observe(duration)
counter.WithLabelValues(c.Request.Method, c.FullPath(), fmt.Sprintf("%d", c.Writer.Status())).Inc()
}
}
// 暴露 /metrics 接口
r.GET("/metrics", gin.WrapH(promhttp.Handler()))
启动后，Prometheus 可通过访问 /metrics 获取指标数据。
实现服务健康检查
健康检查接口是监控系统判断服务是否可用的基础。通常通过暴露 /healthz 接口返回状态码来实现。
简单实现方式：
r.GET("/healthz", func(c *gin.Context) {db := getDB().Ping()
redis := getRedis().Ping()
if db == nil && redis.Err() == nil {
c.JSON(200, gin.H{"status": "ok"})
} else {
c.JSON(500, gin.H{"status": "unhealthy"})
}
})
Prometheus 或 Kubernetes 可定期请求该接口判断服务状态。
对接 Alertmanager 实现告警通知
Prometheus 本身不负责发送告警，而是将触发的规则转发给 Alertmanager。你需要在 Prometheus 配置文件中定义告警规则，并设置 Alertmanager 地址。
例如，在 prometheus.yml 中配置：
alerting:alertmanagers:
- static_configs:
- targets: ['alertmanager:9093']
rule_files:
- "rules/*.yml"
编写告警规则（如 cpu_usage_high.yml）：
groups:- name: example
rules:
- alert: HighRequestLatency
expr: histogram_quantile(0.9, rate(http_request_duration_seconds_bucket[5m])) > 1
for: 10m
labels:
severity: warning
annotations:
summary: "HTTP 请求延迟过高"
description: "90% 的请求延迟超过 1 秒，持续 10 分钟。"
Alertmanager 收到告警后，可通过邮件、钉钉、企业微信等方式通知运维人员。
使用 OpenTelemetry 增强可观测性
除了 Prometheus 的指标，还可以引入 OpenTelemetry 实现日志、链路追踪一体化监控。
Golang 中可通过 otel SDK 自动收集 gRPC 或 HTTP 调用链路：
import ("go.opentelemetry.io/otel"
"go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp"
)
handler := otelhttp.NewHandler(router, "my-service")
http.ListenAndServe(":8080", handler)
配合 Jaeger 或 Tempo，即可查看完整的调用链。
基本上就这些。Golang 服务通过暴露指标、健康检查、接入 Prometheus 和 Alertmanager，再辅以 OpenTelemetry 增强观测能力，就能满足大多数云原生场景下的监控需求。不复杂但容易忽略的是告警阈值设置和多维度标签设计，这直接影响告警准确性和排查效率。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
