server_traffic_status_filter
Позволяет фильтровать данные статуса трафика stream server на основе определённых критериев.
Описание
Директива server_traffic_status_filter позволяет администраторам фильтровать данные, возвращаемые модулем stream server traffic status в NGINX. При включении эта директива помогает сузить статистику трафика до данных, релевантных для конкретных условий или требований. Это особенно полезно для оптимизации мониторинга производительности и аналитики, так как позволяет нацеливаться на определённые потоки или серверы без перегрузки пользователя нерелевантными данными.
Эту директиву можно добавить в контексты stream или stream server, что отражает её способность управлять статистикой трафика как на общем уровне stream, так и на уровне конкретного сервера. Приём флага в качестве аргумента указывает на то, что её можно включать и отключать, что предоставляет гибкость для администратора и позволяет вносить динамические изменения без необходимости полностью перезагружать конфигурации.
Поведение этой директивы тесно связано с другими stream status directives, где включение фильтров может работать в сочетании с конфигурированием конкретных ключей, ограничением типов учитываемых соединений или управлением тем, как данные агрегируются для отчётности. Используя этот фильтр, рекомендуется комбинировать его с другими директивами, чтобы гарантировать, что данные отражают то, что действительно необходимо для аналитических или мониторинговых задач, поддерживая упорядоченное представление статуса сервера.
Пример конфига
stream {
server {
listen 12345;
...
server_traffic_status_filter on;
}
}Убедитесь, что на сервере установлен основной модуль NGINX stream server traffic status; в противном случае эта директива не будет работать.
Избегайте комбинирования нескольких директив фильтрации, которые могут конфликтовать и приводить к несоответствиям в статистике трафика.
Будьте осторожны при использовании этой директивы в условиях высокой нагрузки, поскольку фильтрация может привести к дополнительным накладным расходам.