使用规则引擎按比例过滤用户请求

更新时间:
复制 MD 格式

规则引擎提供比例运算符,允许您基于请求的特定特征(如客户端 IP、HTTP 标头等),将指定百分比的流量路由到不同的处理逻辑。该功能是实现灰度发布和A/B 测试的理想工具,能够帮助您在将新功能或配置变更推送给所有用户之前,先在小范围流量中进行验证,从而有效降低线上风险。

使用场景

  • 灰度发布:在发布新版本的配置时,先将少量请求导向新版本配置,观察其稳定性和性能指标。确认无误后,再逐步扩大流量比例,直至 100% 全量发布。

  • A/B 测试:将用户流量按设定比例分配到两个或多个不同的版本(A 版和 B 版),通过对比不同版本的业务数据,来评估哪个版本效果更优。

  • 故障隔离与演练:在应急演练项目中,可以按比例将特定流量导向一个模拟故障的环境,以测试系统的容错和恢复能力,而不会影响大部分正常用户。

注意事项

  • 特征值为空的处理:当规则中指定的匹配字段在请求中不存在时(例如,请求未携带指定的 HTTP 标头或 Cookie),该规则将不生效,匹配结果为 false。例如,规则 percent(http.request.headers["X-Canary"], 10) 对于所有不包含 X-Canary 标头的请求都会匹配失败。

  • 流量的稳定性:该功能基于哈希算法实现。对于同一个特征值(如同一个客户端 IP),其请求会被稳定地分配到同一个分组中,确保了用户在会话期间的体验一致性。

  • 流量的随机性:该功能基于哈希算法实现。如果使用请求时间戳作为匹配字段,可以实现按请求的随机流量分配(同一个用户的不同请求也可能被分配至不同的比例分组)。

  • 比例的动态调整:修改规则中的百分比后,配置会立即生效。由于哈希算法的确定性,调整比例可能会导致部分用户的分组发生变化。例如,将流量从 10% 调整到 20% 时,一些原本在 10% 组内的用户可能会被划分到新的 10% 区间,而另一些则会保留在原组。

  • 支持的功能:除了安全相关的功能以外,其他支持规则引擎的功能都支持按比例过滤用户请求。

支持的匹配字段

只有以下字段支持“比例”运算符。

控制台字段

表达式中的字段

说明

标头

http.request.headers["example"]

根据指定的 HTTP 请求标头值进行哈希

客户端IP

ip.src

根据客户端的源 IP 地址进行哈希

Cookie 值

http.request.cookies["example"]

根据指定的 Cookie 值进行哈希

URI 指定查询字符串

http.request.uri.args["example"]

根据 URI 中指定的查询字符串参数值进行哈

请求时间戳

http.request.timestamp.sec

根据请求的时间戳进行哈希,可用于实现随时间变化的流量分配

配置步骤

  1. 在ESA控制台选择站点管理,在站点列单击目标站点。

  2. 新建或编辑规则,在当请求匹配以下规则时区域添加条件。

  3. 选择支持的匹配字段,然后从运算符列表选择比例,输入 1~100 的整数作为匹配值。

  4. 配置请求命中条件后要执行的规则动作即可。

配置示例

单一过滤条件

直接对某个请求特征按指定比例进行过滤,适用于简单的流量拆分。

  • 场景:将 10% 的请求流量(基于客户端 IP)导向一个特定的处理逻辑。

  • 规则表达式:(percent(ip.src, 10))

组合过滤条件

先通过一个条件筛选出特定的请求子集,再对这个子集按比例进行过滤。这种方式可以实现更精准的灰度控制。

  • 场景:将携带 X-Env: test 标头的请求中的 20% 流量导向新版本。

  • 规则表达式:(http.request.headers["x-env"] in {"test"} and percent(http.request.headers["x-env"], 20))