Celebrating 20 years of nginx! Read about our journey and milestones in the latest blog.

Модуль ngx_http_stub_status_module

Пример конфигурации Директивы      stub_status Данные Встроенные переменные

Модуль ngx_http_stub_status_module предоставляет доступ к базовой информации о состоянии сервера.

По умолчанию этот модуль не собирается, его сборку необходимо разрешить с помощью конфигурационного параметра --with-http_stub_status_module.

Пример конфигурации

location = /basic_status {
    stub_status;
}

В данной конфигурации создаётся простая веб-страница с основной информацией о состоянии, которая может выглядеть следующим образом:

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

Директивы

Информация о состоянии будет доступна из данного location.

До версии 1.7.5 синтаксис директивы требовал наличия произвольного аргумента, например “stub_status on”.

Данные

Доступна следующая информация:

Active connections

Текущее число активных клиентских соединений, включая Waiting-соединения.

accepts

Суммарное число принятых клиентских соединений.

handled

Суммарное число обработанных соединений. Как правило, значение этого параметра такое же, как accepts, если не достигнуто какое-нибудь системное ограничение (например, лимит worker_connections).

requests

Суммарное число клиентских запросов.

Reading

Текущее число соединений, в которых nginx в настоящий момент читает заголовок запроса.

Writing

Текущее число соединений, в которых nginx в настоящий момент отвечает клиенту.

Waiting

Текущее число бездействующих клиентских соединений в ожидании запроса.

Встроенные переменные

Модуль ngx_http_stub_status_module поддерживает следующие встроенные переменные (1.3.14):

$connections_active

то же, что и значение Active connections;

$connections_reading

то же, что и значение Reading;

$connections_writing

то же, что и значение Writing;

$connections_waiting

то же, что и значение Waiting.