一、模块介绍

The ngx_http_stub_status_module module provides access to basic status information.

This module is not built by default, it should be enabled with the --with-http_stub_status_module configuration parameter.

这个模块提供了访问的基本访问状态信息;

说明：状态信息包括活动连接数、server accepts已经接受的用户请求的总个数、server handled即nginx已经处理的连接数(一般情况server accepts和server handled是相同的，即为已经接受的用户请求个数和nginx已经处理完成的连接数是相同的)、server requests用户的请求总数。

这个模块默认情况下是没有安装的，可以在配置的时候即为通过源码安装时./configure命令加上 --with-http_stub_status_module这个参数这种方式启用该模块。

二、关于该模块的相关配置说明

配置实例

1 location /basic_status {2     stub_status;3 }

location配置

该配置可以在http的配置模块中启用，也可以在具体的虚拟主机中启用，一般情况下是在某个具体的虚拟主机中启用，其目的是统计对应的站点的实际访问情况。具体在哪里启用，看实际情况
This configuration creates a simple web page with basic status data which may look like as follows:

Active connections: 291 server accepts handled requests 16630948 16630948 31070465 Reading: 6 Writing: 179 Waiting: 106 
指令说明：
Syntax:     stub_status;
Default:     —
Context:     server, location
In versions prior to 1.7.5, the directive syntax required an arbitrary argument, for example, “stub_status on”.
在1.7.5版本之前，指令的语法需要一个任意参数，例如“stub_status on”
相关参数说明：

The following status information is provided:Active connections    The current number of active client connections including Waiting connections. 
　　当前的活动连接数的个数，包括正在等待的连接数accepts    The total number of accepted client connections. 
　　当前被接受的客户端连接总数handled    The total number of handled connections. Generally, the parameter value is the same as accepts unless some resource limits have been reached (for example, the worker_connections limit).
　　所有被处理的连接数总数。通常情况下，这个参数的值和当前被接受的客户端连接数是相同的(accepts)，除非nginx对用户的连接数做了限制。requests    The total number of client requests. 
　　客户端请求的个数Reading    The current number of connections where nginx is reading the request header. 
　　当前nginx正在读取请求头部信息的连接数的个数，也就是说这个连接连进来了并且正在被nginx读取请求的头部的连接数的个数Writing    The current number of connections where nginx is writing the response back to the client. 
　　当前nginx正在读取其主体的请求的个数，或者正在处理其请求内容的请求的个数，或者正在向客户端发送响应的个数 Waiting    The current number of idle client connections waiting for a request. 
　　长链接模式的保持连接的连接个数，即为正处于活动状态的连接，正常情况下为reading+wirting

Nginx-->进阶-->Module-->ngx_http_stub_status_module