【Nginx】如何集成 Prometheus + Grafana 监控 Nginx？—— 从原理到生产落地的完整指南

如何集成 Prometheus + Grafana 监控 Nginx？—— 从原理到生产落地的完整指南

适用读者：已部署过基础 Nginx 服务、了解反向代理，但尚未系统掌握其可观测性建设的中高级后端或 SRE 工程师。
技术栈：Nginx 1.24+（开源版）、Prometheus 2.40+、Grafana 10+、Docker 24+

一、问题引入：为什么你需要监控 Nginx？

想象你是一家电商平台的 SRE，凌晨三点接到告警：“用户无法下单”。排查发现，Nginx 的 worker 进程因连接耗尽而拒绝新请求，但你没有任何实时指标能告诉你：

• 当前 QPS 是多少？
• 5xx 错误率是否突增？
• 后端 upstream 响应时间是否变慢？
• 缓存命中率是否下降？

没有监控的 Nginx 就像一辆没有仪表盘的跑车——跑得快，但随时可能翻车。

幸运的是，Nginx 开源版本身不直接暴露 Prometheus 指标，但我们可以通过官方推荐的nginx-prometheus-exporter或社区方案（如ngx_http_stub_status_module