Upstream Queue#
Coloca em fila as requisições a grupos de servidores do módulo HTTP Upstream quando nenhum servidor pode atendê-las na primeira tentativa. A diretiva do módulo é definida no bloco upstream.
Guias relacionados
Balanceamento de carga: enfileiramento no limite
max_conns.
Exemplo de configuração#
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;
}
Diretivas#
queue (PRO)#
Se não for possível atribuir um servidor proxy a uma requisição na primeira tentativa (por exemplo, durante uma breve interrupção de serviço ou quando há um pico de carga atingindo o limite max_conns), a requisição não é rejeitada; em vez disso, o Angie tenta enfileirá-la para processamento.
O parâmetro number da diretiva define o número máximo de requisições
na fila para um processo worker.
Se a fila estiver cheia,
um erro 502 (Bad Gateway) é retornado ao cliente.
Nota
A lógica da diretiva proxy_next_upstream também se aplica a requisições enfileiradas. Especificamente, se um servidor foi selecionado para uma requisição mas ela não pode ser entregue a ele, a requisição pode ser retornada à fila.
Se um servidor não for selecionado para processar uma requisição enfileirada
dentro do tempo definido por timeout
(padrão é 60 segundos),
um erro 502 (Bad Gateway) é retornado ao cliente.
Requisições de clientes que fecham prematuramente a conexão também são removidas da fila;
há contadores para os estados de requisições passando pela fila na API.
O tempo que uma requisição passou na fila é armazenado na variável
$upstream_queue_time
do módulo HTTP Upstream.
Aviso
A diretiva queue deve ser usada após todas as diretivas que definem o
método de balanceamento de carga; caso contrário, não funcionará.