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

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)#

Sintaxe

queue number [timeout=time];

Padrão

—

Contexto

upstream

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á.