vhost_traffic_status_display
Директива `vhost_traffic_status_display` включает отображение статуса трафика для виртуальных хостов в NGINX.
Описание
Директива vhost_traffic_status_display является частью модуля NGINX Virtual Host Traffic Status и используется для включения или отключения отображения статистики трафика для виртуальных хостов. Эту директиву можно разместить в контексте server или location конфигурации NGINX. Когда она включена, пользователи могут запрашивать информацию о состоянии трафика через конкретные URIs, что обычно используется для мониторинга и анализа закономерностей трафика на уровне веб‑сервера.
Директива не принимает аргументов и фактически активирует обработчик, ответственный за обработку таких запросов отображения. Соответствующий обработчик обеспечивает сбор информации из зон разделяемой памяти, предназначенных для статистики трафика, и поддерживает различные типы ответов, включая форматы JSON или HTML в зависимости от конфигурации. Обработчик отображения также может управлять управляющими командами, предоставляя возможности, такие как сброс или удаление статистики «на лету», что обеспечивает более интерактивный мониторинг.
Важно правильно настроить зону разделяемой памяти с соответствующими правами доступа и убедиться, что сбор статистики трафика включён для нужных объектов, иначе вывод отображения может не работать или показывать неполные данные. Используя эту директиву, администраторы могут получить ценную информацию о числе запросов, скоростях передачи данных и статусах ответов для виртуальных хостов, что значительно помогает при настройке производительности и управлении ресурсами.
Пример конфига
server {
listen 80;
server_name example.com;
location /status {
vhost_traffic_status_display;
}
}Убедитесь, что зона разделяемой памяти правильно настроена и назначена; без неё отображение не будет работать как задумано.
Эта директива не принимает параметров, поэтому такие конфигурации, как vhost_traffic_status_display on;, неверны и вызовут ошибки.
Если метод запроса не GET и не HEAD, отображение вернёт ошибку 405 Method Not Allowed.