vhost_traffic_status_filter_by_host

Директива `vhost_traffic_status_filter_by_host` позволяет фильтровать статистику трафика по хосту.

Синтаксисvhost_traffic_status_filter_by_host on | off;
По умолчаниюoff
Контекстhttp, server, location
Аргументыflag

Описание

Директива vhost_traffic_status_filter_by_host является частью модуля статуса трафика виртуальных хостов NGINX. При включении она позволяет фильтровать статистику трафика по заголовку Host входящих запросов. Это особенно полезно в многопользовательских (multi-tenant) средах, где разные хосты могут обслуживаться одним и тем же экземпляром NGINX, позволяя отслеживать и анализировать метрики трафика по каждому хосту отдельно.

Директива принимает один аргумент, который может быть флаговым значением (обычно on или off). Когда установлено 'on', директива включает фильтрацию по хосту, и собираемая статистика трафика будет разделена по соответствующим именам хостов. В свою очередь установка 'off' отключит эту функцию, и вся статистика трафика будет агрегирована без разделения по хостам. Общее поведение этой директивы делает её важным инструментом для операторов, желающих получить видимость шаблонов трафика для разных виртуальных хостов, обслуживаемых экземпляром NGINX.

Эта директива может использоваться в контекстах http, server и location блоков, что обеспечивает гибкость в зависимости от требуемой детализации фильтрации трафика. Например, её можно задать глобально в http-блоке для всех серверов или переопределить в конкретных server или location блоках, чтобы добиться требуемого уровня контроля и точности отчётности для разных приложений.

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

http {
    vhost_traffic_status_zone;
    vhost_traffic_status_filter_by_host on;

    server {
        listen 80;
        server_name example.com;
    }

    server {
        listen 80;
        server_name another-example.com;
    }
}

Убедитесь, что директива vhost_traffic_status_zone правильно настроена и включена, так как она необходима.

Будьте осторожны при включении фильтрации в средах с высоким трафиком, так как показатели производительности могут измениться из‑за дополнительной обработки, требуемой для фильтрации.

При фильтрации по хосту убедитесь, что директивы server_name настроены правильно, чтобы избежать искажённой статистики.

← Ко всем директивам