直接通过API获取Nginx实时状态数据需按版本选择方案：开源版用vts模块（/status?format=json），Plus版用内置api模块（/api/5/http/upstreams），Unit用/status接口，日志+Exporter为无侵入备选。
直接通过 API 获取 Nginx 实时状态数据，关键在于选用匹配的模块和正确调用对应端点。开源版和 Plus 版能力差异明显，需先确认环境，再选择合适路径。
开源版 Nginx：用 vts 模块暴露 JSON 状态
nginx-module-vts 是最成熟、轻量且广泛部署的方案，无需重启即可获取 per-server 级别指标。
- 确保已编译并启用 vts 模块，在 http 块中添加：vhost_traffic_status on;
- 配置一个受保护的 location，例如：
location /status {
vhost_traffic_status_display;
vhost_traffic_status_display_format json;
allow 127.0.0.1;
deny all;
} - 访问 GET /status?format=json 即可获得结构化数据，包含 upstream zones、各 server 的 active 连接数、request 总数、response 时间、字节数等字段
- 支持控制类操作，如重置统计：GET /status/control?cmd=reset&group=upstream&zone=api_backend
Nginx Plus：用内置 api 模块读写 upstream 状态
仅限商业版 Nginx Plus（R20+ 推荐），提供更强的运行时控制能力，尤其适合自动扩缩容场景。
- 在 http 或 server 块中启用：api write=on;，并严格限制 IP 或启用 JWT 鉴权
- 典型访问路径：GET /api/5/http/upstreams/api_backend，返回每个成员的 state、requests、response_time、weight、max_conns、keepalive 等实时值
- 支持 PATCH 修改 upstream 成员状态，例如将某节点设为 down：
PATCH /api/5/http/upstreams/api_backend/servers/0
{"state": "down"} - 建议轮询间隔设为 5–15 秒，聚合计算错误率、平均响应时间、连接饱和度等衍生指标
NGINX Unit：统一 RESTful 接口获取服务级统计
如果你用的是 NGINX Unit（非传统 Nginx），其状态监控是原生集成的，接口简洁、语义清晰。
- 直接请求 GET /status（默认监听 8443 或配置端口），返回 YAML/JSON 格式整体运行状态
- 响应中包含：connections.accepted、connections.active、requests.total、requests.active，以及各应用进程的 running/idle 数量
- 也可用命令行工具获取：unitctl status -t json，便于脚本集成
日志 + Exporter：间接但灵活的指标采集方式
当无法修改 Nginx 编译或配置时，可通过日志解析生成 Prometheus 可采集的指标。
- 自定义 log_format，显式记录 upstream_status、request_time、uri、status 等字段
- 部署 nginx-prometheus-exporter 或 nginxlog-exporter，配置其定期 tail 日志并正则提取字段
- 例如暴露指标：nginx_upstream_status_count{code="502", upstream="auth"}，用于构建错误率告警
- 该方式不依赖模块，但有延迟（秒级）、增加 I/O 开销，适合补位而非主力方案
