Nginx stub_status 怎么读:为什么 Active 不等于并发请求数

22次阅读
没有评论

共计 1661 个字符,预计需要花费 5 分钟才能阅读完成。

把 stub_status 页上的 Active connections 当成并发请求数,会混淆连接口径与请求口径。Active connections 包含等待请求的空闲连接,不能直接当作正在处理的请求数。排查时应同时看 Reading、Writing 和 Waiting,再把当前连接状态与累计请求数分开分析。 ↗

先分清当前值与累计值

官方定义中,Reading 是正在读取请求头的连接数,Writing 是正在向客户端写响应的连接数,Waiting 是等待请求的空闲客户端连接数。Active connections 明确包含 Waiting。这些字段描述当前状态,不能直接替代某一时间段的请求量。 ↗

字段 读取方式 不能据此认定
Active connections 当前客户端连接规模,含空闲等待 所有连接都在处理请求
Reading 正在读取请求头的连接 请求已经进入上游应用
Writing 正在向客户端写响应的连接 后端一定慢或客户端一定慢
Waiting 空闲且等待请求的连接 空闲连接一定是故障

accepts、handled 和 requests 则是累计项,分别表示接受的客户端连接总数、处理的连接总数和客户端请求总数。文档指出,handled 一般与 accepts 相同,触及资源限制时可能出现差异,例如 worker_connections 限制。 ↗

遇到活动连接升高,按什么顺序判断

  1. 先看 Waiting 是否也高。它表示空闲等待,不能把这部分连接当成正在处理的请求。
  2. 再看 Reading 与 Writing 的变化,区分请求头读取阶段和响应写出阶段。
  3. 单独观察累计 requests 的变化。累计请求总数与当前连接数不是同一统计量,不要直接相减后赋予并发含义。
  4. 对照 accepts 与 handled;若持续出现差距,将文档列出的资源限制作为核查方向,再找日志和配置证据。

这些定义提供的是排查线索,不是故障归因。仅凭 Reading 高不能判定遭到攻击,单看 Writing 高也不能确定耗时来自应用还是客户端。需要进一步定位时,应另外采集请求耗时、错误日志和上游状态;这里是建议增加的观测步骤,并非本页计数已经证明的结论。 ↗

一个隔离的状态页配置示例

模块默认不编译,需要构建时启用 --with-http_stub_status_module。stub_status 指令可用于 server 或 location 上下文。先检查实际安装是否包含模块,再使用对应版本的语法。 ↗

官方文档说明,1.7.5 之前的版本需要给 stub_status 指令增加参数,例如 stub_status on。 ↗

下面是用于隔离实验的完整配置文件,监听回环地址;端口和目录是本篇自定义示例值。将其保存为独立实验目录下的 nginx.conf,同目录创建 logs 子目录。不要用它覆盖生产配置,也不要把状态端口直接暴露到公网。

pid logs/nginx.pid;
error_log logs/error.log notice;
events {}
http {
    access_log off;
    server {
        listen 127.0.0.1:18081;
        server_name localhost;
        location = /basic_status {
            stub_status;
        }
    }
}

先在实验目录运行语法检查,并使用实际安装的 Nginx 程序路径。下面的命令只检查这份独立配置,不会重载正在运行的服务。

nginx -t -p "$PWD/" -c "$PWD/nginx.conf"

本次编辑仅做了隔离配置语法检查,没有启动该配置做访问或压力测试。读者如继续实验,应先确认监听端口未占用,再在测试环境验证状态页;检查失败则停止,不对生产实例执行重载。

该怎样保留判断边界

需要当前等待连接数时,直接读取 Waiting;不要把用其他字段推导出的算式冒充官方保证的精确关系。观察趋势时保持采样对象与间隔一致,避免将不同实例或不同时刻的数据放在一起比较。这是观测方法建议,不能代替对本机配置和日志的核对。 ↗

原始资料:Nginx stub_status 模块官方文档。本文按字段定义组织排查方法,未声称进行过线上实测。

常见问题

Waiting 多就代表故障吗?

不能单凭它判断。Waiting 表示等待请求的空闲连接,需要结合连接余量、业务预期和其他证据。

引用资料

资料链接仅表示正文使用了该素材,不代表所有结论已独立核验。

正文完
 0
沐小悠
版权声明:本站原创文章,由 沐小悠 于2026-11-18发表,共计1661字。
转载说明:除特殊说明外本站文章皆由CC-4.0协议发布,转载请注明出处。
评论(没有评论)