debug_connection
Директива `debug_connection` указывает, какие клиентские подключения должны регистрироваться для целей отладки при использовании NGINX в режиме отладки. — NGINX Core
Описание
Директива `debug_connection` позволяет указать IP addresses, из которых входящие подключения будут записываться в debug log. Эта директива необходима при устранении неполадок в экземпляре NGINX, так как она предоставляет подробное представление о обработке запросов от назначенных клиентов. По умолчанию, без этой директивы, никакие IPs не получат расширенного логирования, что критично для эффективной отладки. При использовании этой директивы указанный IP может быть одиночным IP address или задан в CIDR notation для подсетей, что делает её гибкой в различных сетевых сценариях. Директива должна быть размещена в контексте `events` конфигурации NGINX, поскольку она связана с обработкой подключений. Детальные логи будут содержать не только стандартную информацию о запросах, но и дополнительные отладочные сведения, которые помогают системным администраторам выявлять неверные настройки или аномалии в подключениях. Важно учитывать, что большое количество debug connections может приводить к образованию больших файлов логов, которые потребуют управленческих мер при включении в рабочей среде. Поэтому эта директива обычно используется временно при диагностике конкретных проблем для ограниченного круга пользователей, а не для всего входящего трафика. В заключение, директива `debug_connection` предоставляет мощный инструмент для выборочного усиления логирования для конкретных клиентских подключений, что позволяет более эффективно выполнять отладку и мониторинг системы.
Пример конфига
events {
debug_connection 192.168.1.0/24;
}Убедитесь, что NGINX скомпилирован с поддержкой debug, иначе эта директива не будет иметь эффекта.
Будьте осторожны с уровнями логирования и размерами файлов журналов, так как включение debug-логирования может быстро заполнить дисковое пространство.
Не используйте эту директиву в рабочей среде для всех соединений, так как это может привести к избыточному логированию и проблемам с производительностью.