ADOT Trace Collector更新go.mod后出现Schema版本不匹配问题

问题背景 #

共享go.mod大版本更新后，ADOT Trace Collector出现Schema URL冲突报错：

WARNING : 2024/07/01 18:15:09.469: Failed to connect to telemetry provider: conflicting Schema URL: https://opentelemetry.io/schemas/1.25.0 and https://opentelemetry.io/schemas/1.21.0

版本出处定位步骤 #

1. 应用侧依赖排查 #

• 检查更新后的go.mod文件，定位OpenTelemetry相关模块版本：

  grep -E "go.opentelemetry.io/otel" go.mod
  

  OTel SDK版本与Schema版本强绑定（比如SDK v1.25.0默认使用Schema 1.25.0），确认是否是go.mod升级后SDK版本跳转到了1.25.x。
• 检查应用代码，确认是否在初始化TracerProvider或MeterProvider时硬编码了Schema URL，比如：

  tp := trace.NewTracerProvider(
    trace.WithSchemaURL("https://opentelemetry.io/schemas/1.21.0"),
  )
  

2. ADOT Collector侧排查 #

• 查看EKS集群中ADOT Collector的镜像版本：

  kubectl get pods -n <your-namespace> -l app=aws-otel-collector -o jsonpath='{.items[0].spec.containers[0].image}'
  

  不同版本的ADOT Collector内置的OTel组件版本不同，比如v0.86.0及以上版本对应OTel SDK v1.25+，旧版本可能仍使用Schema 1.21.0。
• 检查Collector的ConfigMap配置，确认是否在processor或exporter中显式指定了旧版本Schema URL。

3. 中间链路组件排查 #

• 检查链路中的后端组件（如AWS X-Ray、Prometheus）及配套exporter版本，确认是否存在组件强制使用特定Schema版本的情况。
• 查看EKS中OTel Operator的版本，确认是否是Operator管控的Collector版本未同步升级。

版本对齐解决方案 #

• 应用侧主导对齐：如果go.mod升级后应用使用Schema 1.25.0，将ADOT Collector升级到支持该版本的镜像（比如public.ecr.aws/aws-observability/aws-otel-collector:v0.86.0及以上）。
• Collector侧主导对齐：如果需要保留Schema 1.21.0，回退应用侧OTel SDK版本到对应1.21.x的分支，或在Collector配置中显式指定Schema URL为1.21.0覆盖冲突。
• 全链路统一：确保应用OTel SDK、ADOT Collector、所有exporter/processor组件的OTel版本匹配，避免跨版本Schema不兼容。

内容的提问来源于stack exchange，提问作者ethrbunny