Envoy Gateway中Tracing采样率配置冲突问题解析

在Envoy Gateway项目的实际使用中，开发者发现了一个关于分布式追踪采样率配置的兼容性问题。该问题涉及EnvoyProxy自定义资源中telemetry.tracing配置项的两种采样率表示方式之间的冲突。

问题背景

Envoy Gateway提供了两种方式来配置追踪采样率：

1. samplingRate：简单百分比数值（0-100）
2. samplingFraction：分数形式表示（分子/分母）

在v1alpha1版本的API设计中，代码默认设置了samplingRate=100，同时通过CEL验证规则强制要求两种配置方式不能同时存在。这就导致用户无法单独使用samplingFraction配置项，因为系统总会存在默认的samplingRate值。

技术细节分析

这个问题暴露出三个层面的设计考虑：

1. API默认值机制：Kubernetes CRD的默认值会在对象创建时自动注入，这发生在所有验证之前
2. CEL验证规则：该规则检查时无法区分用户显式设置的值和系统默认值
3. 版本兼容性：直接移除默认值会导致已有配置的语义变化

解决方案探讨

经过社区讨论，确定以下解决方向：

1. 移除冲突的CEL验证规则，改为运行时逻辑处理：

   • 当两者都存在时，优先采用samplingFraction
   • 保持向后兼容性

2. 替代方案考虑：

   • 将默认值设置移到控制平面逻辑中而非CRD定义
   • 引入v1beta1版本API时修正这个问题

对用户的影响

这个问题的存在会导致：

• 用户无法使用分数形式的精确采样率配置
• 在需要非100%采样率时，只能使用整数百分比
• 高级追踪配置场景受到限制

最佳实践建议

在问题修复前，用户可以：

1. 通过修改CRD定义临时移除默认值（仅限测试环境）
2. 使用samplingRate进行近似配置
3. 关注项目版本更新，及时升级到包含修复的版本

该问题的讨论过程体现了开源社区处理兼容性问题的典型思路，平衡了功能完整性和版本稳定性之间的考量。