如何通过 Prometheus 分析 Nginx 各路径响应时间分布曲线图？

本文共计678个文字，预计阅读时间需要3分钟。

要监控Nginx各个路径的响应时间分布，核心是让Prometheus能够收集到按URI（或location）维度划分的响应时间数据。原生Nginx不支持直接暴露这些指标，需要借助增强型监控模块和相应的配置。以下是简化的实现步骤：

---

✅ 必须启用 nginx-module-vts 模块

ngx_http_stub_status_module 只提供连接数、请求总数等基础统计，无法按路径拆分响应时间。真正支持路径级响应时间分布的是 nginx-module-vts（Virtual Host Traffic Status），它能暴露 /vts/status/format/prometheus 接口，其中包含：

• nginx_vts_upstream_response_time_seconds_bucket{host="example.com",path="/api/user",le="0.1",upstream="backend-api"}
• nginx_vts_server_request_seconds_bucket{server="default",path="/login",le="0.05"}

这些带 path 标签的直方图指标，正是绘制分布曲线的基础。

---

✅ 在 Nginx 配置中开启路径粒度统计

确保 vhost_traffic_status_zone 已启用，并在 server 或 location 块中显式启用统计：

http { vhost_traffic_status_zone; server { server_name api.example.com; location /api/ { vhost_traffic_status off; # 可选：关闭整个 location 的统计 } location /user/profile { vhost_traffic_status on; # 显式开启该路径统计 } location / { vhost_traffic_status on; # 默认开启根路径 } } }

VTS 会自动为每个 location 或匹配的 server_name + path 组合生成独立指标，Prometheus 抓取后即可按 path 标签聚合。

---

✅ Prometheus 抓取与 PromQL 可视化

在 Prometheus 中配置抓取 http://nginx-host/vts/status/format/prometheus（注意路径末尾格式）。

查看某路径的 P95 响应时间趋势：

histogram_quantile(0.95, sum(rate(nginx_vts_server_request_seconds_bucket{path="/login"}[5m])) by (le, path))

对比多路径的响应时间分布（直方图叠加）：

sum(rate(nginx_vts_server_request_seconds_bucket{path=~"/login|/order/submit|/api/data"}[5m])) by (le, path)

在 Grafana 中用「Histogram」或「Heatmap」面板渲染，即可直观看到各路径响应时间的分布密度与偏移。

---

✅ 补充建议：避免指标爆炸

路径若含动态参数（如 /user/123/profile），直接暴露会导致标签爆炸。推荐做法：

• 使用 map 指令归一化路径：

  map $request_uri $norm_path { ~^/user/\d+/profile$ "/user/{id}/profile"; ~^/api/v\d+/orders/\w+$ "/api/{version}/orders/{id}"; default $request_uri; }

• 在 VTS 配置中引用 $norm_path 替代原始 $request_uri（需自定义 patch 或使用支持该特性的 VTS 分支）

这样既能保留业务语义，又控制了时间序列数量。

不复杂但容易忽略