Nginx中Stub-Status监控当前的并发连接数

 更新时间:2026年04月27日 09:05:48   作者:冷炫風刃  
Stub-Status 是 Nginx 内置轻量模块,用于暴露实时并发连接数等状态,本文就来介绍一下Nginx中Stub-Status监控当前的并发连接数,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧

在 Nginx 中,Stub-Status 是一个轻量级的内置模块(需编译时启用),用于暴露基本的运行时连接状态,其中就包括当前活跃的并发连接数。它不依赖外部工具,适合快速查看实时连接情况。

确认 stub_status 模块已启用

Nginx 默认可能未启用 ngx_http_stub_status_module。可通过以下命令验证:

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

若无输出,说明模块未编译进 Nginx,需重新编译并添加 --with-http_stub_status_module 参数。

配置 stub_status 接口位置

在任意 server 块(推荐使用本地访问的专用 location)中添加如下配置:

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

解析 stub_status 返回内容

访问 http://127.0.0.1/nginx-status(需 curl 或浏览器,且满足 allow 规则),返回类似:

Active connections: 12
server accepts handled requests
 1568 1568 2452
Reading: 0 Writing: 3 Waiting: 9
  • Active connections:当前所有活跃连接数(即你关心的“并发连接数”),包含正在读、写、等待的连接
  • Reading:Nginx 正在读取客户端请求头的连接数
  • Writing:Nginx 正在向客户端发送响应的连接数
  • Waiting:处于 keep-alive 状态、空闲等待新请求的连接数(属于 Active 的一部分)

三者关系为:Active = Reading + Writing + Waiting

结合脚本或监控系统采集

可使用简单命令提取并发数,例如:

curl -s http://127.0.0.1/nginx-status | awk '/Active connections/ {print $3}'

将该命令接入 Prometheus(通过 nginx-exporter 更稳妥)、Zabbix 或自建定时脚本,即可实现持续跟踪与告警。

到此这篇关于Nginx中Stub-Status监控当前的并发连接数的文章就介绍到这了,更多相关Nginx Stub-Status监控并发连接数内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

您可能感兴趣的文章:

相关文章

  • Nginx 过滤静态资源文件的访问日志的实现

    Nginx 过滤静态资源文件的访问日志的实现

    这篇文章主要介绍了Nginx 过滤静态资源文件的访问日志的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-10-10
  • Linux下安装配置nginx详解

    Linux下安装配置nginx详解

    本篇文章主要介绍了Linux下安装配置nginx,介绍了在Linux系统下安装配置Nginx的详细过程,具有一定的参考价值,有兴趣的可以了解一下。
    2017-01-01
  • Nginx配置文件详解

    Nginx配置文件详解

    这篇文章主要介绍了Nginx配置文件详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-08-08
  • 详解nginx安装过程并代理下载服务器文件

    详解nginx安装过程并代理下载服务器文件

    Nginx是一款轻量级的web服务器/反向代理服务器及电子邮件(IMAP/POP3)代理服务器,在BSD-like 协议下发行,这篇文章主要介绍了详解nginx安装过程并代理下载服务器文件,需要的朋友可以参考下
    2022-02-02
  • 使用supervisor管理nginx+tomcat容器的方法示例

    使用supervisor管理nginx+tomcat容器的方法示例

    这篇文章主要介绍了使用supervisor管理nginx+tomcat容器的方法示例,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-03-03
  • 使用Nginx中自带的模块配置缩略图功能的教程

    使用Nginx中自带的模块配置缩略图功能的教程

    Nginx的http_image_filter_module模块可以用来处理缩略图,这里我们就来看看使用Nginx中自带的模块配置缩略图功能的教程,需要的朋友可以参考下
    2016-06-06
  • Nginx安全防护与HTTPS部署实战

    Nginx安全防护与HTTPS部署实战

    文章介绍了Nginx安全加固与HTTPS部署,从编译安装、隐藏版本号、限制危险请求、请求限制、防盗链、动态黑名单、HTTPS部署等方面进行了详细说明,需要的朋友可以参考下
    2026-04-04
  • Nginx中报错:Permission denied与Connection refused的解决

    Nginx中报错:Permission denied与Connection refused的解决

    这篇文章主要给大家介绍了在Nginx中报错:13: Permission denied与111: Connection refused的解决方法,文中介绍的非常详细,相信对大家具有一定的参考价值,需要的朋友们下面来一起看看吧。
    2017-04-04
  • nginx添加nginx-sticky-module模块步骤的实现

    nginx添加nginx-sticky-module模块步骤的实现

    nginx-sticky-module模块是nginx实现负载均衡的一种方案,和ip_hash负载均衡算法会有区别的,本文主要介绍了nginx添加nginx-sticky-module模块步骤的实现,感兴趣的可以了解一下
    2023-08-08
  • nginx快速部署一个网站服务(多域名+多端口)

    nginx快速部署一个网站服务(多域名+多端口)

    本文主要介绍了nginx快速部署一个网站服务,并实现多域名和多端口,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-10-10

最新评论