运行时匹配器（proto）

此扩展的限定名为 envoy.matching.matchers.runtime_fraction

注意

此扩展旨在对不可信的下游和上游流量都具有鲁棒性。

提示

此扩展扩展了以下扩展类别，并可与其一起使用

• envoy.matching.input_matchers

此扩展必须使用以下类型 URL 之一进行配置

• type.googleapis.com/envoy.extensions.matching.input_matchers.runtime_fraction.v3.RuntimeFraction

extensions.matching.input_matchers.runtime_fraction.v3.RuntimeFraction

[extensions.matching.input_matchers.runtime_fraction.v3.RuntimeFraction proto]

运行时分数匹配器从输入中计算出一个哈希值，如果运行时功能针对生成的哈希值启用，则匹配。每次考虑输入以进行匹配时，其哈希值都必须落在此字段指示的匹配百分比内。对于分数 N/D，将计算一个数字，作为输入在范围 [0,D) 内某个字段上的哈希值。如果该数字小于或等于分子 N 的值，则匹配器评估为 true。运行时分数输入匹配器可用于逐步推出匹配器更改，而无需进行完整的代码或配置部署。请注意，匹配结果的分布仅与输入之一一样好。

{
  "runtime_fraction": {...},
  "seed": ...
}

runtime_fraction

(config.core.v3.RuntimeFractionalPercent, REQUIRED) 使用给定的运行时键将输入与之匹配。如果键不存在于运行时配置中，则使用指定的默认值。

seed

(uint64) 通过哈希函数传递的可选种子。这允许在计算哈希值时使用更多信息：通过更改种子值，可以针对相同输入获得潜在不同的结果。