规则引擎提供比例运算符,允许您基于请求的特定特征(如客户端 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 请求标头值进行哈希 |
客户端IP |
| 根据客户端的源 IP 地址进行哈希 |
Cookie 值 |
| 根据指定的 Cookie 值进行哈希 |
URI 指定查询字符串 |
| 根据 URI 中指定的查询字符串参数值进行哈 |
请求时间戳 |
| 根据请求的时间戳进行哈希,可用于实现随时间变化的流量分配 |
配置步骤
配置示例
单一过滤条件
直接对某个请求特征按指定比例进行过滤,适用于简单的流量拆分。
场景:将 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))