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 число [timeout=время];

По умолчанию

—

Контекст

upstream

Если для запроса не удается назначить проксируемый сервер с первой попытки (например, при краткосрочном перебое в работе или всплеске нагрузки с достижением предела max_conns), запрос не отклоняется; вместо этого Angie пытается поставить его в очередь на обработку.

Численный параметр директивы задает максимальное количество запросов в очереди рабочего процесса. Если очередь целиком заполнена, клиенту отдается ошибка 502 (Bad Gateway).

Примечание

К запросам в очереди также применяется логика директивы proxy_next_upstream. В частности, если для запроса был выбран сервер, но передать его туда не удалось, то он может вернуться в очередь.

Если сервер для передачи запроса в очереди не был выбран за время timeout (по умолчанию — 60 секунд), клиенту отдается ошибка 502 (Bad Gateway). Еще из очереди удаляются запросы от клиентов, преждевременно закрывших соединение; в API есть счетчики состояний запросов, проходящих через очередь. Время, которое запрос провел в очереди, хранится в переменной $upstream_queue_time HTTP-модуля Upstream.

Предупреждение

Директива queue должна использоваться после всех директив, задающих тот или иной метод балансировки нагрузки, иначе она не будет работать.