memc_upstream_fail_timeout

指定在上游 memcached 服务器不可用时进行故障转移尝试的超时时间。

语法memc_upstream_fail_timeout time;
默认值10s
上下文http, server, location
参数1

说明

在 NGINX 配置中,memc_upstream_fail_timeout 指令用于定义处理上游 memcached 服务器故障的超时时间。该指令在可能出现连接问题的场景中至关重要;它确保 NGINX 服务器在对先前失败的上游服务器再次尝试连接之前等待指定的持续时间,从而更有效地管理故障转移。通过设置此超时,您可以让 NGINX 尝试其他上游服务器,避免因快速重复重试而淹没系统,从而导致性能下降或资源耗尽。

memc_upstream_fail_timeout 的参数以时间值形式结构化,可以用多种格式指定(例如以秒为单位,或使用诸如 'm' 表示分钟的时间后缀)。当上游服务器被标记为失败时,NGINX 会在再次考虑该服务器进行连接尝试之前遵守此超时。这有助于在瞬时故障期间平衡负载并有效管理请求。通过提供受控的重试策略,管理员可以将临时服务器停机对用户体验的影响降到最低。

配置示例

location /memcached {
    set $memc_key $arg_key;
    memc_pass 127.0.0.1:11211;
    memc_upstream_fail_timeout 5s;
}

将超时时间设置得过低可能导致频繁的故障切换和不必要的重试,从而影响性能。

确保在适当的上下文中(http、server 或 location)设置此指令,否则不会生效。

← 返回所有指令