ajp_upstream_max_fails

设置在将失败的服务器从 AJP 上游组中移除之前允许的最大失败尝试次数。

语法ajp_upstream_max_fails number;
默认值1
上下文http, server, location
参数1

说明

ajp_upstream_max_fails 指令定义了在将上游 AJP 服务器标记为失败之前,NGINX 在连接该服务器时允许的最大不成功尝试次数。该指令对于使用 AJP 协议的应用来说至关重要,它有助于避免将过多负载转发到故障的上游服务器,从而维护高可用性和性能。

当达到指定的失败次数时,NGINX 会暂时将该服务器从负载均衡池中移除,阻止后续请求被路由到该服务器,直到根据配置的健康检查机制该服务器被认为恢复健康为止。该参数在上游服务器动态变化的环境中特别有用,例如由容器管理平台编排的场景,其中服务器可用性可能经常波动。

该指令可以根据应用需求和运行环境进行调整——例如,在高度动态的系统中,较低的最大失败次数有助于更快地对故障服务器做出反应;而在较为稳定的部署中,较高的次数可以在短暂异常期间维持更好的容错性。

配置示例

upstream my_ajp_backends {
    server 127.0.0.1:8009;
    ajp_upstream_max_fails 3;
}

ajp_upstream_max_fails 设置得过低可能导致暂时宕机的服务器被频繁移除。

确保健康检查配置得当,以便在服务器被标记为失败后将其恢复。

← 返回所有指令