Upstream Feedback#

Implementa o balanceamento de carga baseado em feedback para grupos de servidores do módulo HTTP Upstream: os pesos dos servidores são ajustados por uma métrica que os próprios servidores informam, por exemplo em cabeçalhos de resposta. A diretiva do módulo é definida no bloco upstream.

Guias relacionados

Exemplo de configuração#

upstream backend {
    zone backend 1m;
    feedback $upstream_http_x_capacity;

    server backend1.example.com;
    server backend2.example.com;
}

Cada servidor informa sua capacidade ociosa no campo de cabeçalho de resposta X-Capacity; um servidor que informa um valor maior recebe uma parcela maior das requisições.

Diretivas#

feedback (PRO)#

Sintaxe

feedback variable [inverse] [factor=number] [account=condition_variable] [last_byte];

Padrão

—

Contexto

upstream

Configura um mecanismo de balanceamento de carga baseado em feedback no upstream. Ele ajusta dinamicamente as decisões de balanceamento multiplicando o peso de cada servidor proxy pelo valor médio de feedback, que muda ao longo do tempo dependendo do valor da variable e está sujeito a uma condição opcional.

Os seguintes parâmetros podem ser especificados:

variable

A variável da qual o valor de feedback é obtido. Ela deve representar uma métrica de desempenho ou saúde; assume-se que o servidor a forneça em cabeçalhos ou de outra forma.

O valor é avaliado com cada resposta do servidor e é considerado na média móvel de acordo com as configurações inverse e factor.

inverse

Se o parâmetro for definido, o valor de feedback é interpretado inversamente: valores menores indicam melhor desempenho.

factor

O fator pelo qual o valor de feedback é considerado ao calcular a média. Valores válidos são inteiros de 0 a 99. O padrão é 90.

A média é calculada usando a fórmula de suavização exponencial.

Quanto maior o fator, menos os novos valores afetam a média; se 90 for especificado, então 90% do valor anterior e apenas 10% do novo valor serão considerados.

account

Especifica uma variável de condição que controla quais respostas são consideradas no cálculo. O valor médio é atualizado com o valor de feedback da resposta apenas se a variável de condição dessa resposta não for igual a "" ou "0".

Nota

Por padrão, respostas durante verificações ativas não são incluídas no cálculo; combinar a variável $upstream_probe com account permite incluir essas respostas ou até mesmo excluir todo o resto.

last_byte

Permite processar dados do servidor proxy após receber a resposta completa, não apenas o cabeçalho.

Exemplo:

upstream backend {

    zone backend 1m;

    feedback $feedback_value factor=80 account=$condition_value;

    server backend1.example.com;
    server backend2.example.com;
}

map $upstream_http_custom_score $feedback_value {
    "high"                      100;
    "medium"                    75;
    "low"                       50;
    default                     10;
}

map $upstream_probe $condition_value {
    "high_priority" "1";
    "low_priority"  "0";
    default         "1";
}

Esta configuração categoriza respostas do servidor por níveis de feedback baseados em pontuações específicas dos campos de cabeçalho de resposta, e também adiciona uma condição em $upstream_probe para considerar apenas respostas da verificação ativa high_priority ou respostas a requisições regulares de clientes.