server_traffic_status_filter_check_duplicate

Директива `server_traffic_status_filter_check_duplicate` включает или отключает проверку дублирующихся ключей фильтра в статусе трафика stream-сервера NGINX.

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

Описание

Директива server_traffic_status_filter_check_duplicate позволяет настроить проверку дублирования ключей фильтра в модуле статуса трафика stream-сервера NGINX. При значении 'on' эта директива гарантирует, что ключи, используемые для статистики по пропускной способности и соединениям, являются уникальными; в противном случае наличие дубликатов может привести к неверной отчетности по метрикам. В основе логики лежит механизм сравнения, при котором каждый ключ фильтра оценивается, а найденные дубликаты отфильтровываются, сохраняя только уникальные ключи для точного мониторинга трафика.

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

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

stream {
    server {
        server_traffic_status;
        server_traffic_status_zone;
        server_traffic_status_filter_check_duplicate on;
        ... 
    }
}

Установка этой директивы в 'on' может потребовать тщательного планирования filter keys, чтобы избежать непреднамеренных пропусков в отчетных метриках.

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

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