如何用OpenTelemetry实现AWS ECS与Lambda Java代码埋点及上下文链路连续

核心问题是ECS生产者的trace上下文未在调用链中正确传递到Lambda消费者，导致链路断裂。以下是针对性修复步骤：

一、ECS生产者：确保Lambda调用携带Trace上下文 #

自动埋点默认可能未覆盖AWS Lambda调用的上下文注入，需做以下配置：

• 依赖配置：若使用AWS SDK v2调用Lambda，必须引入opentelemetry-instrumentation-aws-sdk-2.2依赖（SDK v1对应opentelemetry-instrumentation-aws-sdk），该工具会自动将trace上下文注入到AWS服务调用的请求头中。
• 手动调用场景：若直接通过HTTP客户端调用Lambda API/API Gateway，需手动提取当前Span的上下文并添加请求头：

  // 获取当前Span的W3C Trace上下文
  Map<String, String> headers = new HashMap<>();
  W3CTraceContextPropagator.getInstance().inject(
      Context.current(),
      headers,
      (carrier, key, value) -> carrier.put(key, value)
  );
  // 调用Lambda时携带headers中的traceparent和tracestate
  

• Collector验证：确认ECS的OpenTelemetry Collector已正确配置OTLP exporter，trace数据能正常上报到后端（如Jaeger、AWS X-Ray）。

二、Lambda消费者：正确提取Trace上下文 #

Lambda的自动埋点需适配触发方式，确保从请求中提取上下文：

• 使用OTel Layer（推荐）：为Lambda添加兼容当前Java runtime的OpenTelemetry Layer，同时配置环境变量：
  • OTEL_PROPAGATORS=tracecontext,baggage
  • OTEL_TRACES_EXPORTER=otlp（或xray若用AWS原生追踪）
  • OTEL_EXPORTER_OTLP_ENDPOINT：对应你的Collector地址
• 手动集成SDK：若自行集成OTel SDK，需注册W3C追踪上下文传播器：

  OpenTelemetrySdk.builder()
      .setPropagators(ContextPropagators.create(W3CTraceContextPropagator.getInstance()))
      .buildAndRegisterGlobal();
  

• 触发器适配：
  • API Gateway触发：确保网关未过滤traceparent和tracestate请求头；
  • SQS触发：ECS生产者需将trace上下文存入消息属性，Lambda侧从属性中提取（需手动处理，或依赖AWS SDK instrumentation自动注入/提取）。

三、排查验证步骤 #

• 检查ECS侧调用日志/追踪数据，确认请求中包含traceparent header；
• 查看Lambda初始化日志，确认OTel传播器加载正常，无报错；
• 对比ECS调用Span与Lambda根Span的trace_id，若一致则上下文传递成功；
• 确保ECS与Lambda使用的OTel版本兼容，避免版本差异导致解析失败。

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