ngx_http_vts_module 本身不提供告警功能，但它能实时暴露各 upstream 的详细指标（如状态码分布、请求失败数、连接异常数），是构建错误率告警体系的关键数据源。要实现“针对不同后端集群的实时告警”，需将其与 Prometheus + Grafana + Alertmanager 链路打通，并在指标采集层做针对性重标和聚合。
1. 启用 vts 模块并按集群维度暴露指标
vts 默认将所有 upstream 统一汇总，必须通过 upstream 分组命名 + location 分离 实现集群粒度隔离。例如：
在 Nginx 配置中为每个后端集群定义独立 upstream 块，并使用语义化名称：
upstream cluster-api-prod { server 10.0.1.10:8080; server 10.0.1.11:8080;}<p>upstream cluster-payment-staging {server 10.0.2.5:8080;server 10.0.2.6:8080;}
再通过 vts 的 status_zone 指令绑定到 server 或 location 级别，并确保每个集群有唯一 zone 名：
server { listen 80; location /api/ { proxy_pass http://cluster-api-prod; status_zone cluster-api-prod; # 关键：zone 名即集群标识 }}<p>server {listen 80;location /pay/ {proxy_pass <a href="https://www.php.cn/link/73103ddd969c87aee1a6cfe805b7dbd4">https://www.php.cn/link/73103ddd969c87aee1a6cfe805b7dbd4</a>;status_zone cluster-payment-staging;}}
2. 用 Prometheus 抓取并重标为多维指标
nginx-vts-exporter（推荐使用 hnlq715 版本）负责把 /status/format/json 转为 Prometheus 格式。关键配置在于重标（relabel_configs），将 vts 的原始指标映射为带 upstream、code、state 标签的时序数据：
抓取 nginx_vts_upstream_requests_total，通过 __meta_vts_upstream 提取 zone 名作为 upstream 标签将 HTTP 状态码（如 2xx, 5xx）从指标名或 JSON 字段中提取为 code 标签对 5xx 类错误单独建模，例如：nginx_vts_upstream_requests_total{code="5xx", upstream="cluster-api-prod"}
这样就能在 PromQL 中直接按集群写表达式，比如过去 5 分钟 cluster-api-prod 的 5xx 错误率：
rate(nginx_vts_upstream_requests_total{code="5xx", upstream="cluster-api-prod"}[5m]) / rate(nginx_vts_upstream_requests_total{upstream="cluster-api-prod"}[5m])
3. 定义分集群、分阈值的告警规则
在 Prometheus rules 文件中，为每个重要集群设置独立告警项，支持差异化阈值：
# API 生产集群：5xx 错误率 > 0.5% 持续 2 分钟触发- alert: UpstreamAPIProdHigh5xxRate expr: | (rate(nginx_vts_upstream_requests_total{code="5xx", upstream="cluster-api-prod"}[2m]) / rate(nginx_vts_upstream_requests_total{upstream="cluster-api-prod"}[2m])) > 0.005 for: 2m labels: severity: critical cluster: cluster-api-prod annotations: summary: "High 5xx error rate on {{ $labels.upstream }}" description: "{{ $value | printf \"%.2f\" }}% of requests failed with 5xx"<h1>支付预发集群：容忍度更低，> 0.1% 即告警</h1><ul><li>alert: UpstreamPaymentStagingHigh5xxRateexpr: |(rate(nginx_vts_upstream_requests_total{code="5xx", upstream="cluster-payment-staging"}[2m])/ rate(nginx_vts_upstream_requests_total{upstream="cluster-payment-staging"}[2m]))<blockquote><p>0.001for: 2mlabels:severity: warningcluster: cluster-payment-staging
4. 告警降噪与根因辅助定位
仅看 5xx 率可能掩盖真实问题。建议补充两个协同指标提升判断精度：
连接级失败率：用 nginx_vts_upstream_connections_failed_total{upstream="xxx"} 判断是否是网络或后端宕机导致超时请求占比：vts 中 timeout 计数器可识别慢依赖拖垮整体稳定性Grafana 看板中将同一集群的「5xx 率」「失败连接数」「平均响应时间」放在同一行，便于横向比对
Alertmanager 可基于 cluster 标签做路由，把 cluster-api-prod 告警发给 API SRE 组，payment 相关告警路由至支付团队，避免告警错投。
评论(0)