用途:帮助把 Java 应用从经典 Elastic APM Java 代理迁移到 EDOT(Elastic Distributions of OpenTelemetry)Java 代理。适用于需要从 elastic-apm-agent.jar 切换到 elastic-otel-javaagent.jar 的场景。
主要能力与要求: 清理旧引用:移除所有经典 APM 相关内容,包括 elastic-apm-agent.jar、elasticapm.properties、全部 ELASTIC_APM_* 环境变量,以及 co.elastic.apm 的 Maven/Gradle 依赖。 引入新代理:使用 elastic-otel-javaagent.jar,从 Maven Central 下载,而非作为 Maven/Gradle 编译依赖。 挂载代理:通过 -javaagent:/path/to/elastic-otel-javaagent.jar 或 JAVA_TOOL_OPTIONS="-javaagent:/path/to/elastic-otel-javaagent.jar" 挂载;不挂载则代理不生效。 设置三组必填环境变量:OTEL_SERVICE_NAME(替代 ELASTIC_APM_SERVICE_NAME);OTEL_EXPORTER_OTLP_ENDPOINT(必须为托管 OTLP 端点或 EDOT Collector 地址,不可复用旧的 ELASTIC_APM_SERVER_URL,不可使用 APM Server 地址、:8200 或 /intake/v2/events);OTEL_EXPORTER_OTLP_HEADERS("Authorization=ApiKey <key>" 或 "Authorization=Bearer <token>",替代 ELASTIC_APM_SECRET_TOKEN / API_KEY)。 无需设置 OTEL_TRACES_EXPORTER、OTEL_METRICS_EXPORTER、OTEL_LOGS_EXPORTER,默认值已正确。 限制与注意:切勿在同一 JVM 上同时运行经典 Elastic APM 代理和 EDOT 代理。迁移前应先阅读迁移指南,完整示例参见 EDOT Java 迁移指南。资料未提供具体环境变量取值、端点地址及版本号等信息。