共计 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 限制。 ↗
遇到活动连接升高,按什么顺序判断
- 先看 Waiting 是否也高。它表示空闲等待,不能把这部分连接当成正在处理的请求。
- 再看 Reading 与 Writing 的变化,区分请求头读取阶段和响应写出阶段。
- 单独观察累计 requests 的变化。累计请求总数与当前连接数不是同一统计量,不要直接相减后赋予并发含义。
- 对照 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 表示等待请求的空闲连接,需要结合连接余量、业务预期和其他证据。
引用资料
资料链接仅表示正文使用了该素材,不代表所有结论已独立核验。