go中实现Web请求监控需用中间件拦截http生命周期,通过ResponseWriter包装器捕获状态码与耗时,以sync.map和原子操作聚合路径/方法维度指标,并暴露prometheus格式/metrics端点,辅以采样日志与简易告警。

在 Go 中实现 Web 请求监控与统计,核心是拦截请求生命周期、采集关键指标(如响应时间、状态码、路径、错误率),并支持聚合与导出。不需要引入重型 APM 工具,用标准库 + 少量中间件即可快速落地。
使用中间件统一拦截 HTTP 请求
基于 http.Handler 构建可复用的监控中间件,包裹所有路由处理器。它能在请求开始前记录起始时间,响应写出后计算耗时并统计结果。
- 用
http.ResponseWriter包装器捕获实际写入的状态码和字节数 - 用
time.Now()和time.Since()精确计算处理耗时(纳秒级) - 提取
r.URL.Path、r.Method作为维度标签,便于后续分组
内存内实时统计:用 sync.Map + 原子操作聚合数据
高频请求下避免锁竞争,推荐用 sync.Map 存储按路径/方法组合的统计桶(如 "GET:/api/users"),每个桶内用 atomic 计数器维护:
-
total:总请求数(atomic.AddUint64) -
success:2xx 数量 -
Error:5xx 或 panic 次数 -
sumLatency:耗时总和(用于算平均值) -
maxLatency:记录单次最大延迟(用atomic.CompareAndSwapUint64更新)
暴露 Prometheus 格式指标端点
添加 /metrics 路由,将内存统计转换为标准 Prometheus 文本格式(plain text),无需额外 SDK:
立即学习“go语言免费学习笔记(深入)”;
- 每行以
# HELP/# TYPE开头说明指标含义与类型(如counter,gauge,summary) - 指标名如
http_request_duration_seconds_sum{method="GET",path="/api/users"} - 定期重置或保留滚动窗口(如只保留最近 5 分钟数据)需自行控制,Prometheus 客户端只负责暴露
可选增强:日志采样 + 异常告警
对慢请求(如 >1s)或错误响应(500、panic)做结构化日志记录,并通过 channel 异步发送到告警模块(如邮件、Webhook):
- 用
log/slog(Go 1.21+)或zap输出 jsON 日志,含 trace_id(可从 header 提取或自动生成) - 设置采样率(如 1% 的慢请求全量记录,100% 的 5xx 全记录)避免日志爆炸
- 简单告警可用 goroutine + timer 实现:每分钟检查 error rate > 5%,触发通知
基本上就这些。不复杂但容易忽略的是统计维度设计和并发安全——别直接用 map[String]Struct{} 计数,也别在 handler 里 fmt.printf 打点。保持轻量、可观测、可扩展,才是 Go 风格的监控实践。