statsd_count
Директива `statsd_count` отправляет метрику счётчика на сервер StatsD, позволяя отслеживать появление конкретных событий.
Описание
Директива statsd_count используется в NGINX для увеличения указанного счётчика на заданное значение каждый раз, когда происходит определённое событие, например HTTP-запрос. Эта метрика отправляется на настроенный сервер StatsD, что позволяет осуществлять мониторинг и агрегацию метрик для приложений. Директива принимает 2–3 аргумента: первый — ключ метрики (строка), который идентифицирует счётчик в StatsD, второй — числовое значение для увеличения, и опциональный третий аргумент — условие, которое определяет, следует ли записывать этот подсчёт на основе указанной NGINX-переменной. Это даёт более детальный контроль над тем, какие события учитываются.
С точки зрения поведения, если предоставлен третий параметр, подсчёт будет отправлен только в том случае, если указанная NGINX-переменная оценивается как истинная (непустая или не равная 0). Эта возможность особенно полезна, когда нужно избежать увеличения счётчиков для случаев, которые считаются недействительными или неинформативными. В целом эта директива облегчает эффективный мониторинг метрик производительности приложений в рабочей среде.
Пример конфига
statsd_count "your_product.requests" 1; statsd_count "your_product.pages.index_requests" 1; statsd_count "your_product.pages.index_responses" 1 "$request_completion";
Убедитесь, что сервер StatsD правильно настроен и доступен из NGINX, чтобы избежать потери метрик.
Будьте осторожны с третьим аргументом; если переменная условия не определена или указана неверно, счётчик может не увеличиться, когда этого ожидают.