如何通过Nginx的Stub-Status模块实时监测并分析流量高峰与连接压力状况？

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

要通过Nginx的`stub_status`模块实时分析流量和连接压力，核心在于启动该模块、监控安全暴露状态端点，并结合高频采集与关键指标解读。具体来说，关注以下方面：

确认并启用 stub_status 模块

Nginx 默认编译时通常已包含 http_stub_status_module，可通过以下命令验证：

nginx -V 2>&1 | grep -o with-http_stub_status_module

若未出现输出，需重新编译 Nginx 并添加 --with-http_stub_status_module 参数。启用后，在任一 server 块中配置：

location /nginx-status { stub_status on; access_log off; allow 127.0.0.1; # 仅允许本地访问 deny all; }

重载配置：nginx -s reload，然后用 curl http://127.0.0.1/nginx-status 测试是否返回类似：

Active connections: 124 server accepts handled requests 2548 2548 5872 Reading: 3 Writing: 12 Waiting: 109

识别关键指标及其压力含义

Active connections：当前所有 TCP 连接数（含 idle、reading、writing 状态）。若持续高于 1000，且伴随高 Waiting 值，说明客户端连接积压，可能受 keepalive 超时、上游响应慢或客户端低速读取影响。

Waiting：处于 keepalive 空闲等待状态的连接数。突增往往意味着大量客户端保持长连接但无新请求（如移动端心跳、前端轮询），未必是攻击，但会占用 worker 连接资源。

Accepts / Handled / Requests：三者应基本相等（Handled ≈ Accepts，Requests ≥ Handled）。若 Accepts ，说明有连接复用（正常）；若 <code>Handled ≪ Accepts，可能因连接过早中断（如网络丢包、客户端主动断连）；若 Requests 短时飙升远超平时均值，即为典型流量突发。

实现轻量级实时监控与突变捕获

单纯手动 curl 不足以应对突发场景，建议用简单脚本每秒采集并比对变化：

• 用 curl -s http://127.0.0.1/nginx-status | awk 'NR==1 {print $3}' 提取 Active connections
• 记录最近 10 秒的值，计算滑动窗口内标准差或环比增长率（如 1 秒内 Active 连接增长 >30% 且绝对值 +200）
• 当 Waiting > 80% of worker_connections 或 Requests/second > 阈值（如 500），触发日志告警或调用 nginx -T 快照当前配置与连接详情

注意：避免高频请求冲击 Nginx 自身，采集间隔不低于 0.5 秒；生产环境务必限制 /nginx-status 访问 IP，禁用公网暴露。

关联分析提升判断准确性

stub_status 单独数据易误判，需结合：

• error.log 中的 connection refused / too many open files：确认是否达到系统文件描述符上限或 worker_connections 设置过低
• netstat -an | grep :80 | wc -l 对比，排除非 Nginx 进程干扰
• 同一时刻的 upstream 响应时间（如 proxy_next_upstream_tries 日志字段）：若 Active connections ↑ + upstream response time ↑，大概率是后端拖慢导致连接堆积

不复杂但容易忽略：Waiting 高 ≠ 有问题，但 Waiting 高 + Active connections 持续攀高 + Requests 增速平缓，大概率是客户端侧连接复用异常或存在慢连接扫描行为。