limit_req_log_level

Директива `limit_req_log_level` задаёт уровень логирования для записей о лимитировании запросов в NGINX. — NGINX HTTP Core

limit_req_log_level
httpserverlocation
Синтаксисlimit_req_log_level level;
По умолчаниюerror
Контекстhttp, server, location
МодульNGINX HTTP Core
Аргументы1

Описание

Директива `limit_req_log_level` позволяет администраторам указать уровень серьёзности логирования, при котором нарушения лимитов запросов будут фиксироваться. Эта директива может быть определена в контекстах `http`, `server` или `location` и принимает один аргумент, задающий уровень логирования. Доступные уровни включают `error`, `warn`, `info`, `debug` и т.д. По умолчанию, если не настроено иначе, NGINX использует уровень логирования `error` для записей о лимитировании запросов. Когда лимиты запросов, определённые с помощью директивы `limit_req_zone`, превышаются, NGINX может логировать эти события согласно указанному уровню логирования. Это важно для мониторинга: позволяет настроить подробность логов в соответствии с оперативными требованиями или устранять проблемы, связанные с ограничением трафика. Особенно полезно в средах с высоким трафиком, где избыточное логирование может скрывать критически важную информацию. Механизм логирования интегрирован с возможностями логирования ошибок NGINX, поэтому вы можете просматривать эти журналы, чтобы выявлять закономерности и предпринимать соответствующие действия для оптимизации обработки запросов.

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

http {
    limit_req_zone $binary_remote_addr zone=one:10m rate=1r/s;
    limit_req_log_level warn;
}

Установка очень высокого уровня логирования, например debug, может привести к генерации чрезмерного объёма логов, что может быстро заполнить дисковое пространство.

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