非SpringBoot环境下，如何为Java AWS Lambda配置OpenTelemetry自动插桩？

OpenTelemetry SpringBoot Starter的自动插桩本质是封装了Java Agent动态字节码注入或Instrumentation库的自动配置逻辑，不用Starter的话，直接用下面两种方式就能实现相同效果：

1. 使用OpenTelemetry Java Agent（推荐，最省心） #

这是和Starter自动插桩效果完全一致的方式，Agent会在JVM启动时自动为HTTP、AWS SDK、JDBC等常用库生成Span，无需修改业务代码。

操作步骤： #

• 下载与你的OTel SDK版本匹配的opentelemetry-javaagent.jar（可从Maven中央仓库获取）
• 将Agent包和Lambda代码打包在一起，或者上传到Lambda层（层的默认路径为/opt/）
• 在Lambda的JVM启动参数中添加：

  -javaagent:/path/to/opentelemetry-javaagent.jar
  

  若使用Lambda层，参数即为-javaagent:/opt/opentelemetry-javaagent.jar
• 用环境变量配置遥测（和你之前用SDK的配置兼容）：
  • OTEL_SERVICE_NAME：设置服务标识
  • OTEL_EXPORTER_OTLP_ENDPOINT：遥测数据导出地址
  • OTEL_TRACES_SAMPLER：采样策略

2. 手动引入Instrumentation库（适合需要自定义插桩逻辑的场景） #

如果不想用Java Agent，可以手动引入对应组件的Instrumentation依赖，然后初始化这些组件的遥测支持。

步骤1：添加Instrumentation依赖 #

在pom.xml或build.gradle中加入需要的组件依赖（版本需与OTel SDK保持一致）：

<!-- OkHttp 3.x 插桩 -->
<dependency>
  <groupId>io.opentelemetry.instrumentation</groupId>
  <artifactId>opentelemetry-okhttp-3.0</artifactId>
  <version>1.28.0</version>
</dependency>

<!-- Apache HttpClient 4.5+ 插桩 -->
<dependency>
  <groupId>io.opentelemetry.instrumentation</groupId>
  <artifactId>opentelemetry-apache-httpclient-4.5</artifactId>
  <version>1.28.0</version>
</dependency>

<!-- AWS SDK v2 插桩 -->
<dependency>
  <groupId>io.opentelemetry.instrumentation</groupId>
  <artifactId>opentelemetry-aws-sdk-2.2</artifactId>
  <version>1.28.0</version>
</dependency>

<!-- JDBC 插桩 -->
<dependency>
  <groupId>io.opentelemetry.instrumentation</groupId>
  <artifactId>opentelemetry-jdbc</artifactId>
  <version>1.28.0</version>
</dependency>

步骤2：初始化Instrumentation #

在你创建OpenTelemetrySdk的代码中，注册对应的插桩组件：

public static OpenTelemetrySdk autoconfiguredSdk() {
    OpenTelemetrySdk openTelemetrySdk = AutoConfiguredOpenTelemetrySdk.initialize().getOpenTelemetrySdk();
    
    // 激活OkHttp插桩
    OkHttpTelemetry.builder(openTelemetrySdk).build().install();
    
    // 激活Apache HttpClient插桩
    ApacheHttpClientTelemetry.builder(openTelemetrySdk).build().install();
    
    // 激活AWS SDK v2插桩
    AwsSdkTelemetry.builder(openTelemetrySdk).build().install();
    
    // JDBC插桩：需要用Telemetry包装原始数据源
    DataSource originalDataSource = getYourOriginalDataSource(); // 替换为你的数据源获取逻辑
    DataSource tracedDataSource = JdbcTelemetry.builder(openTelemetrySdk).build().wrap(originalDataSource);
    // 后续业务代码使用tracedDataSource获取数据库连接
    
    return openTelemetrySdk;
}

3. AWS Lambda环境的额外注意事项 #

• 使用Java Agent时，优先用Lambda层挂载Agent，避免部署包过大
• Java Agent会自动捕获Lambda的入口Span（比如API Gateway、SQS触发的请求），无需额外配置
• 如果手动配置插桩，需确保Lambda触发事件中的上下文能被正确提取（Agent会自动处理这一步，手动实现需参考OTel的上下文传播API）

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