OpenTelemetry对接X-Ray问题：追踪无层级关联

我用ADOT的OpenTelemetry AWS发行版为Lambda配置了OpenTelemetry，按照官方文档附加了javaagent + collector层，通过OpenTelemetry agent实现代码自动插桩。目前已生成三类追踪数据：

• Lambda上下文执行追踪
• S3访问追踪
• MongoDB访问追踪

但这些追踪在X-Ray控制台中彼此无关联。日志中生成的追踪信息如下：

[otel.javaagent 2024-04-24 07:59:05:633 +0000] [main] INFO io.opentelemetry.exporter.logging.LoggingSpanExporter - 'update espaidoc.document' : 6628bbc902c4d22192672fe5958a00cd eb8b0f340609ba59 CLIENT [tracer: io.opentelemetry.mongo-3.1:1.32.0-adot-lambda1-alpha] AttributesMap{data={db.operation=update, db.mongodb.collection=document, db.name=espaidoc, thread.id=1, thread.name=main, db.connection_string=mongodb://pe-0-endurance-mongodb-dev-cluster.r6c5pur.mongodb.net:27017, net.peer.name=pe-0-endurance-mongodb-dev-cluster.r6c5pur.mongodb.net, db.system=mongodb, net.peer.port=27017, db.statement={\"update\": \"document\", \"ordered\": \"?\", \"writeConcern\": {\"w\": \"?\"}, \"txnNumber\": \"?\", \"$db\": \"?\", \"$clusterTime\": {\"clusterTime\": \"?\", \"signature\": {\"hash\": \"?\", \"keyId\": \"?\"}}, \"lsid\": {\"id\": \"?\"}, \"updates\": [{\"q\": {\"_id\": \"?\"}, \"u\": {\"_id\": \"?\", \"logicId\": \"?\", \"location\": {\"location\": \"?\", \"type\": \"?\"}, \"status\": {\"state\": \"?\"}, \"md5Checksum\": \"?\", \"_class\": \"?\"}, \"upsert\": \"?\"}]}}, capacity=128, totalAddedValues=10}
[otel.javaagent 2024-04-24 07:59:05:620 +0000] [main] INFO io.opentelemetry.exporter.logging.LoggingSpanExporter - 'S3.HeadObject' : 6628bbc95db57510853694261956a4d1 4c10b44d043a4612 CLIENT [tracer: io.opentelemetry.aws-sdk-2.2:1.32.0-adot-lambda1-alpha] AttributesMap{data={aws.agent=java-aws-sdk, http.method=HEAD, aws.requestId=1Y3J5K61D9ZHSV5X, net.peer.name=s3.eu-west-1.amazonaws.com, rpc.method=HeadObject, net.peer.port=443, http.url=https://s3.eu-west-1.amazonaws.com/espaidoc-des/frontoffice-apigateway-0.0.1-SNAPSHOT-aws.jar, rpc.system=aws-api, thread.id=1, thread.name=main, http.status_code=200, aws.bucket.name=espaidoc-des, http.response_content_length=50984457, rpc.service=S3}, capacity=128, totalAddedValues=14}
XRAY TraceId: 1-6628bbc9-0439f53a54534f10181c6da0\tSegmentId: 0111f4aa09e348cc\tSampled: true

从日志可见，MongoDB、S3的Span TraceId与X-Ray的TraceId不匹配，核心是上下文传递失效，可按以下方向排查：

1. 检查ADOT Collector配置

   • 确保Collector启用xray exporter，且配置trace_id_generator: xray，让所有Span统一使用X-Ray格式的TraceId。
   • 确认Collector的service.name与Lambda函数名一致，避免追踪分组混乱。

2. 调整OpenTelemetry Agent环境变量

   • 设置OTEL_PROPAGATORS=xray,b3（至少包含xray），确保Agent能正确读取并传递X-Ray上下文。
   • 把OTEL_TRACES_EXPORTER设为otlp，让Span仅发送到ADOT Collector，关闭日志导出（当前日志中的logging exporter仅适合调试）。

3. 验证Lambda层版本兼容性

   • 保证javaagent层与collector层版本完全一致，ADOT官方要求两者版本匹配，避免版本差异导致上下文传递失败。
   • 替换当前的alpha版本agent（1.32.0-adot-lambda1-alpha）为ADOT稳定版层，alpha版本可能存在未修复的兼容性问题。

4. 确认Lambda上下文注入

   • 在代码中打印AWS_XRAY_TRACE_ID环境变量，确认其与日志中的X-Ray TraceId一致，确保Agent能读取到该上下文。

5. 排查第三方库插桩配置

   • 确认MongoDB、AWS SDK对应的OTel instrumentation库版本与ADOT agent兼容，比如AWS SDK 2.x的instrumentation需保证aws-sdk-2.2版本与agent匹配。

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