vhost_traffic_status_histogram_buckets

Директива "vhost_traffic_status_histogram_buckets" задаёт размеры интервалов гистограммы для отслеживания трафика в модуле состояния трафика виртуальных хостов NGINX.

Синтаксисvhost_traffic_status_histogram_buckets value1 value2 ...;
По умолчаниюnone
Контекстhttp, server, location
Аргументы1+

Описание

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

Эта директива особенно полезна в средах с высокой нагрузкой, где понимание распределения продолжительности запросов критично для настройки производительности и анализа. Каждый интервал соответствует определённому диапазону продолжительностей запросов, что позволяет получить более детализированное представление о характеристиках производительности приложений за NGINX. Директива принимает несколько аргументов, где каждое значение представляет верхнюю границу интервала, а обработка этих интервалов обычно выполняется во время сбора метрик трафика.

При внедрении этой директивы убедитесь, что размеры интервалов выбраны с учётом ожидаемого профиля производительности ваших приложений. Слишком большое количество интервалов может создать ненужные накладные расходы, тогда как слишком малое число не позволит зафиксировать необходимую детализацию в характеристиках трафика. Гибкость в указании аргументов также означает, что вы можете легко изменить детализацию гистограммы в соответствии с меняющимися потребностями вашей стратегии мониторинга.

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

vhost_traffic_status_histogram_buckets 100ms 500ms 1s 5s;

Убедитесь, что указанные значения находятся в порядке возрастания, поскольку немонотонные значения могут привести к некорректному поведению гистограммы.

Использование слишком большого числа бакетов может привести к ухудшению производительности из-за увеличения объёма обработки при сборе метрик трафика.

Если значения бакетов не соответствуют характеру трафика, это может привести к вводящей в заблуждение статистике.

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