dynamic_limit_req_log_level

指令 `dynamic_limit_req_log_level` 指定因速率限制而导致的请求处理失败和延迟的日志级别。

语法dynamic_limit_req_log_level level;
默认值notice
上下文http, server, location
参数1

说明

指令 dynamic_limit_req_log_level 用于 NGINX 的动态 IP 限制模块,用来定义在请求因超过配置的速率限制而被拒绝或被延迟时应记录多少信息。该指令接受单个参数,用于从预定义的日志级别集合中确定记录的严重性级别,例如 'info'、'notice'、'warn' 和 'error'。

该指令的行为是:这里配置的日志级别会明确应用于因速率限制而被完全拒绝的请求,而与速率限制相关的任何处理延迟则会以比配置的拒绝级别低一级的级别记录。例如,如果为拒绝选择 'warn',则被延迟的请求将以 'error' 记录。这样的结构化日志有助于明确发生的问题类型——是处理延迟还是完全拒绝——从而有利于对应用性能进行有效的故障排查和监控。

该指令可以在 HTTP、server 或 location 上下文级别配置,允许管理员根据其应用或服务的具体需求灵活设置不同的日志级别。充足的日志有助于评估速率限制的运行情况,并可为扩展决策或对速率限制逻辑的修改提供依据。

配置示例

http {
    dynamic_limit_req_log_level warn;
}
server {
    location / {
        dynamic_limit_req_log_level info;
    }
}

确保指定的日志级别受支持;否则将使用默认级别。

请记住,延迟请求日志的记录级别低于拒绝级别,如果没有妥善记录,可能会令人困惑。

该指令必须在适当的上下文中设置才能生效;在不受支持的上下文中使用会导致错误。

← 返回所有指令