stub_status

Директива 'stub_status' включает простую страницу мониторинга состояния для NGINX. — NGINX HTTP Core

stub_status
serverlocation
Синтаксисstub_status;
По умолчаниюnone
Контекстserver, location
МодульNGINX HTTP Core
Аргументыnone

Описание

Директива 'stub_status' предоставляет способ отображать базовую информацию о состоянии NGINX, включая активные соединения, количество принятых соединений, обработанные запросы и общее число запросов. Она требует location block в контексте server, где к ней можно получить доступ, обычно по определённому URI. Когда клиент обращается к настроенному URI, NGINX отвечает текущей информацией о состоянии в текстовом формате. Чтобы использовать 'stub_status', сначала необходимо определить location block внутри server block. Внутри этого location вы включаете 'stub_status' без дополнительных аргументов. Доступ к этой странице можно ограничить с помощью директив управления доступом, таких как 'allow' и 'deny', чтобы только определённые клиенты могли запрашивать страницу статуса. Когда включено, handler обрабатывает запросы к этому location и возвращает ответ с метриками, включая количество активных соединений, количество принятых соединений, обработанные запросы и общее число запросов, предоставляя ценные сведения для мониторинга и отладки производительности сервера NGINX.

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

server {
    listen 80;
    location /nginx_status {
        stub_status;
        allow 127.0.0.1;  # Only allow local requests
        deny all;         # Deny all other requests
    }
}

Убедитесь, что элементы управления доступом ('allow' и 'deny') правильно настроены; в противном случае страница статуса может быть доступна неавторизованным пользователям.

Подтвердите, что блок location для 'stub_status' настроен корректно и не переопределяется другими директивами location.

Отслеживайте показатели производительности сервера безопасно; доступ к stub statuses без ограничений может привести к утечке информации.