cgi_stderr

Директива `cgi_stderr` настраивает обработку вывода стандартного потока ошибок CGI-скриптов в NGINX.

Синтаксисcgi_stderr level;
По умолчаниюwarn
Контекстserver, location
Аргументы1-2

Описание

Директива cgi_stderr задаёт уровень логирования для вывода стандартного потока ошибок, генерируемого CGI-скриптами, выполняемыми NGINX. Эта опция полезна, когда нужно контролировать подробность журналов ошибок CGI-скриптов. Она принимает одно из нескольких значений уровня логирования (например, off, stderr, или конкретный уровень, такой как info, warn, error, crit и т.д.). При установке в stderr ошибки направляются в поток стандартных ошибок, который обычно логируется процессом NGINX. Настройка уровня логирования позволяет администраторам отфильтровывать менее критичную информацию и фиксировать только те записи, которые имеют значение для отладки или мониторинга работы приложения.

Директиву можно применить в контекстах server или location в файле конфигурации NGINX. Значение по умолчанию для cgi_stderrwarn, что означает, что будут логироваться все ошибки на уровне предупреждения и выше. При установке пользовательского уровня логирования следует проявлять осторожность, поскольку чрезмерно подробные логи могут привести к большим файлам журналов и осложнить поиск важных проблем. Значения и поведение этой директивы влияют на то, насколько полно фиксируются ошибки приложения и насколько просто или сложно их устранять в производственной среде.

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

location /cgi-bin/ {
    cgi_pass /path/to/cgi;
    cgi_stderr info;
}

Установка cgi_stderr на уровень, который захватывает слишком много сообщений журнала, может привести к огромным файлам логов.

Отсутствие указания конкретного уровня логирования может привести к пропуску критических сообщений об ошибках, если значения по умолчанию настроены неправильно.

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