如何利用 ngx_http_vts_module 构建针对不同虚拟主机错误率的实时告警体系-Nginx-PHP中文网

需通过 ngx_http_vts_module 采集各 server 的 5xx 与总请求数，用增量差值计算滚动窗口错误率，并借助 Prometheus/Alertmanager 或脚本+Webhook 实现告警；须为每个 server 独立配置 vhost_traffic_status on、避免 server_name 冲突、以 server_name 为 key 解析指标。

如何利用 ngx_http_vts_module 构建针对不同虚拟主机错误率的实时告警体系

要基于 ngx_http_vts_module 构建针对不同虚拟主机（server）错误率的实时告警体系，核心在于：采集各 server 的 5xx 错误计数与总请求数，计算滚动窗口内的错误率，并通过外部工具触发告警。该模块本身不提供告警能力，需配合 Prometheus + Grafana + Alertmanager 或脚本轮询 + Webhook 实现。

1. 启用并配置 vts 模块按 server 维度暴露指标

ngx_http_vts_module 默认以 JSON 格式在 /status/format/json 提供聚合数据。要区分虚拟主机，必须确保每个 server 块启用 vhost_traffic_status on，且不共用同一 server_name 别名（否则统计合并）：

在全局 http 块中加载模块并开启基础统计：
vhost_traffic_status_zone;
在每个独立的 server 块内显式开启：
vhost_traffic_status on;
避免多个 server 使用相同 server_name（如都写 localhost），否则指标会归入同一 vhost 条目

2. 提取各虚拟主机的 5xx 错误率（需定时采集）

vts 的 JSON 输出中，每个 vhost 对应一个对象，其 responses.status.5xx 表示累计 5xx 总数，requests.total 表示总请求数。错误率需用滑动窗口计算（如最近 60 秒），不能直接用累计值——否则低流量站点误差极大。

推荐每 10 秒请求一次 /status/format/json，解析出各 vhost 的 5xx 和 total
本地缓存前一次采集值，用差值计算单位时间增量（例如：当前 5xx - 上次 5xx）
错误率 = Δ5xx / Δtotal（若 Δtotal == 0，则跳过或设为 0）
示例 Python 片段逻辑：
data = requests.get("http://nginx/status/format/json").json()
for vhost in data["servers"]["server"]:
  name = vhost["server_name"]
  curr_5xx = vhost["responses"]["status"]["5xx"]
  curr_total = vhost["requests"]["total"]
  # 计算增量并更新缓存

3. 接入监控与告警链路（两种轻量方案）

方案 A：Prometheus + 自定义 exporter
写一个简易 exporter（如 Python + Flask），定时抓取 vts JSON，将每个 vhost 的 vts_server_5xx_rate 作为 Gauge 暴露给 Prometheus。在 PromQL 中可直接写：
rate(vts_server_5xx_total[1m]) / rate(vts_server_requests_total[1m]) > 0.05
然后在 Alertmanager 配置邮件、钉钉等通知。

方案 B：Shell 脚本 + cURL + Webhook
用 crontab 每 30 秒执行脚本，当某 vhost 错误率连续 3 次 > 3% 时，调用企业微信/飞书机器人 Webhook 发送告警，含 vhost 名、错误率、时间戳。