<!-- review: finished -->

<a id="http-stub-status"></a>

# Stub Status

该模块提供对基本服务器状态信息的访问。

当从源代码中 [构建](https://cn.angie.software//angie/docs/installation/sourcebuild.md#sourcebuild) 时，
默认不会构建此模块；
应通过 `‑‑with‑http_stub_status_module`
[构建选项](https://cn.angie.software//angie/docs/installation/sourcebuild.md#configure) 来启用。

在来自 [我们的仓库](https://cn.angie.software//angie/docs/installation/index.md#install-packages) 的软件包和镜像中，
该模块已包含在构建中。

<a id="configuration-example-43"></a>

## 配置示例

```nginx
location = /basic_status {
    stub_status;
}
```

此配置创建了一个简单的网页，显示基本状态信息，如下所示：

```console
Active connections: 291
server accepts handled requests
 16630948 16630948 31070465
Reading: 6 Writing: 179 Waiting: 106
```

<a id="directives-46"></a>

## 指令

<a id="index-0"></a>

<a id="id3"></a>

### stub_status

| [语法](https://cn.angie.software//angie/docs/configuration/configfile.md#configfile)   | `stub_status`;   |
|--------------------------------------------------------------------------------------|------------------|
| 默认值                                                                                  | —                |
| [上下文](https://cn.angie.software//angie/docs/configuration/configfile.md#configfile)  | server, location |

状态信息将可从所在位置访问。

<a id="data"></a>

## 数据

提供以下状态信息：

<a id="samp-active-connections"></a>

### `Active connections`

当前活跃客户端连接数，包括等待连接。

<a id="samp-accepts"></a>

### `accepts`

接受的客户端连接总数。

<a id="samp-handled"></a>

### `handled`

处理的连接总数。通常，该参数值与accepts相同，除非达到某些资源限制（例如，[worker_connections](https://cn.angie.software//angie/docs/configuration/modules/core.md#worker-connections) 限制）。

<a id="samp-requests"></a>

### `requests`

客户端请求总数。

<a id="samp-reading"></a>

### `Reading`

当前正在读取请求头的连接数。

<a id="samp-writing"></a>

### `Writing`

当前正在向客户端写回响应的连接数。

<a id="samp-waiting"></a>

### `Waiting`

当前空闲等待请求的客户端连接数。

<a id="built-in-variables-13"></a>

## 内置变量

<a id="v-connections-active"></a>

### `$connections_active`

与 Active connections 的值相同。

<a id="v-connections-reading"></a>

### `$connections_reading`

与 Reading 的值相同。

<a id="v-connections-writing"></a>

### `$connections_writing`

与 Writing 的值相同。

<a id="v-connections-waiting"></a>

### `$connections_waiting`

与 Waiting 的值相同。
