Upstream Queue#

当没有服务器能在第一次尝试时接收请求时,该模块将发往 HTTP Upstream 模块服务器组的请求放入队列。 该模块的指令设置在 upstream 块中。

相关指南

配置示例#

upstream backend {
    zone backend 1m;
    server backend1.example.com:8080 max_conns=100;
    server backend2.example.com:8080 max_conns=100;

    queue 50 timeout=10s;
}

指令#

queue (PRO)#

语法

queue number [timeout=time];

默认值

—

上下文

upstream

如果在第一次尝试时无法为请求分配代理服务器(例如,在短暂的服务中断期间或负载激增达到 max_conns 限制时),请求不会被拒绝;相反,Angie 会尝试将其排队等待处理。

该指令的 number 参数设置 工作进程 队列中的最大请求数。如果队列已满,则向客户端返回 502 (Bad Gateway) 错误。

备注

proxy_next_upstream 指令的逻辑也适用于排队的请求。具体来说,如果为请求选择了服务器但无法将其交给该服务器,则请求可能会返回队列。

如果在 timeout 设置的 时间 内(默认为 60 秒)未选择服务器来处理排队的请求,则向客户端返回 502 (Bad Gateway) 错误。过早关闭连接的客户端的请求也会从队列中删除;在 API 中有通过队列的请求状态的计数器。请求在队列中停留的时间保存在 HTTP Upstream 模块的 $upstream_queue_time 变量中。

警告

queue 指令必须在所有设置负载均衡方法的指令之后使用;否则它将不起作用。