Upstream Feedback#

该模块为 HTTP Upstream 模块的服务器组实现基于反馈的负载均衡: 服务器权重根据服务器报告的指标(例如在响应头中)进行调整。 该模块的指令设置在 upstream 块中。

相关指南

配置示例#

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

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

每台服务器在 X-Capacity 响应头字段中报告其剩余容量; 报告值越高的服务器获得的请求份额越大。

指令#

feedback (PRO)#

语法

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

默认值

—

上下文

upstream

在 upstream 中设置基于反馈的负载均衡机制。 它通过将每个代理服务器的权重乘以平均反馈值来动态调整均衡决策, 该值会根据 variable 的值随时间变化, 并受可选条件的约束。

可以指定以下参数:

variable

从中获取反馈值的变量。 它应该表示性能或健康指标; 假定服务器在响应头或其他方式中提供该值。

该值在服务器的每个响应中进行评估, 并根据 inverse 和 factor 设置 纳入移动平均值。

inverse

如果设置了该参数,则反馈值将被反向解释: 较低的值表示更好的性能。

factor

计算平均值时考虑反馈值的因子。 有效值为 0 到 99 之间的整数。 默认值为 90。

平均值使用 指数平滑 公式计算。

因子越大,新值对平均值的影响越小; 如果指定为 90,则将采用 90% 的先前值 和仅 10% 的新值。

account

指定一个条件变量, 用于控制在计算中考虑哪些响应。 仅当该响应的条件变量 不等于 "" 或 "0" 时, 才会使用该响应的反馈值更新平均值。

备注

默认情况下, 主动检查 期间的响应 不包含在计算中; 将 $upstream_probe 变量 与 account 结合使用可以包含这些响应 或甚至排除其他所有响应。

last_byte

允许在接收到完整响应后处理来自代理服务器的数据, 而不仅仅是响应头。

示例:

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";
}

此配置根据响应头字段中的特定分数 按反馈级别对服务器响应进行分类, 并在 $upstream_probe 上添加条件, 仅考虑来自 high_priority 主动检查的响应 或对常规客户端请求的响应。