Nginx+VTS实现虚拟主机级流量监控需三步：一是在http块声明vhost_traffic_status_zone，二是在每个server块启用vhost_traffic_status on，三是server内配置location /status；再通过filter_by_set_key按cid、国家或路径打标分组；排查时先验/status/format/json，检查Nginx版本兼容性（推荐1.20.2/1.22.1），并用静态upstream替代动态proxy_pass；生产建议关闭HTML，仅暴露JSON，配合nginx-vts-exporter与Prometheus+Grafana做可视化。
直接用 Nginx + VTS 模块做虚拟主机级流量监控，关键不在装得多快，而在数据“看得准、分得清、查得稳”。下面从配置逻辑、典型问题和真实可用的写法三方面展开，不绕弯子。
核心配置必须到位的三件事
VTS 不是加个模块就自动出数据，它依赖三个显式声明才能正确归集到 server_name 级别：
-
vhost_traffic_status_zone：必须在 http 块里声明，且建议带命名和内存大小，例如
vhost_traffic_status_zone shared:vts:10m;。不写 shared 名称，后续 upstream 或 filter 统计会失效。 - vhost_traffic_status on：放在每个 server 块开头，启用该虚拟主机的统计。没这句，这个 server 的所有请求都算进 default 或 unknown。
- location /status 必须在 server 块内：不能丢到 http 顶层。否则 vts 拿不到 host 上下文，页面上看到的全是“127.0.0.1”或空 host 列。
让流量按业务/租户/地区自动分组
靠默认的 server_name 分组太粗，实际要用 vhost_traffic_status_filter_by_set_key 打标：
- 按客户 ID（来自 URL 参数）：
vhost_traffic_status_filter_by_set_key $arg_cid client::$server_name;，JSON 接口里就会出现"client::api.example.com"这样的 zone 键名。 - 按国家（需配合 GeoIP）：
vhost_traffic_status_filter_by_set_key $geoip_country_code country::$server_name;，适合分析海外用户集中度。 - 按接口路径前缀：
set $route "$host:$request_uri"; vhost_traffic_status_filter_by_set_key $route route::$server_name;，可区分 /api/v1 和 /static 走量。
排查“看不到数据”的高频原因
浏览器打开 /status 是空白，或 JSON 返回空数组？先看这几处：
- 访问
/status/format/json—— 能返回 JSON 就说明模块已加载、路由生效；返回 404 才是 location 配置错位或拼写错误（注意不能多斜杠、不能加后缀）。 - 检查 Nginx 版本：VTS 官方明确不支持 1.25+，1.24 支持不稳定。推荐用 1.20.2 或 1.22.1，并严格匹配模块分支（如 nginx-1.22.x 就用 vts-1.22 分支）。
- 动态 proxy_pass 导致 upstream 显示为 unknown：不要写
proxy_pass http://$backend，改用静态 upstream 块，并在其中加同名 zone：upstream api_v1 { vhost_traffic_status_zone api_v1; }。
生产环境建议的轻量用法
别依赖 VTS 自带的 HTML 页面——上百个虚拟主机时会卡死。推荐组合：
- 关闭 HTML 展示：
vhost_traffic_status_display_format json;，只暴露 JSON 接口。 - 用 nginx-vts-exporter 抓取 JSON，转成 Prometheus metrics（端口默认 9913）。
- Grafana 直接查 Prometheus，按
vts_server_zone标签筛选域名，画 QPS 曲线、状态码热力图、响应时间 P95 分布。
