如何在opentelemetry-java-instrumentation中生成AWS格式Trace ID

问题根本原因 #

AWS X-Ray对Trace ID格式有强制要求，必须符合 1-<8位Unix时间戳十六进制值>-<24位随机十六进制字符> 结构，而OpenTelemetry Java Instrumentation默认生成的是32位全随机十六进制Trace ID，不符合规范所以触发导出报错。

你之前的配置仅启用了X-Ray链路上下文传播器，传播器只负责跨服务的链路上下文传递，不会修改Trace ID的生成逻辑，所以配置后没有生效。

1.7.0版本生效配置步骤 #

你已经完成了扩展包引入和传播器配置，只需要补充X-Ray专用ID生成器的配置即可：

1. 新增如下环境变量：

OTEL_TRACES_ID_GENERATOR: xray

如果通过JVM系统参数配置，对应参数为：

-Dotel.traces.id.generator=xray

2. 保留你已有的正确配置：

OTEL_PROPAGATORS: xray,tracecontext,b3
OTEL_JAVAAGENT_EXTENSIONS: /path/opentelemetry-extension-aws-1.7.0.jar

验证规则 #

配置生效后生成的Trace ID会符合 1-xxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxx 结构，此时再通过aws-xray exporter导出就不会触发格式错误。

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