stream_server_traffic_status_display
Директива `stream_server_traffic_status_display` включает отображение статистики трафика для stream-серверов.
Описание
Директива stream_server_traffic_status_display является частью модуля NGINX stream server traffic status и облегчает мониторинг статистики трафика через HTTP. При включении она предоставляет конечную точку, которая возвращает информацию о потоке трафика, соединениях и уровне ошибок для TCP upstream серверов. Это особенно полезно для администраторов, которые хотят передавать показатели трафика в реальном времени в системы мониторинга или для пользователей, получающих доступ к серверу NGINX через веб-интерфейс.
Для корректного использования этой директивы она должна располагаться в контексте server или location в конфигурации NGINX. Явно поддерживается обработка HTTP-методов GET и HEAD, что позволяет получать данные статуса, тогда как другие методы могут возвращать соответствующие HTTP-ошибки. Модулю требуется инициализация shared memory, и если эта инициализация не удалась, запросы к статистике будут получать ответ Service Unavailable. В URI запроса можно включать управляющие команды для динамического изменения или сброса статусов трафика, что делает эту директиву гибким инструментом для эксплуатационных задач при управлении трафиком и анализе показателей производительности.
Пример конфига
server {
listen 8080;
location /status {
stream_server_traffic_status_display;
}
}Убедитесь, что разделяемая память настроена корректно, чтобы эта директива работала.
Запросы, использующие методы, отличные от GET или HEAD, не будут приняты, что приведёт к HTTP-ошибкам.
Если модуль не включён или не инициализирован, доступ к статусу приведёт к ошибке 501.