关于 observability-edot-java-migrate
此技能指导将 Java 应用从经典 Elastic APM 迁移到 EDOT。它面向负责 JVM 遥测的开发者，说明如何替换旧 Agent、通过 Java Agent 参数启用新 Agent，并配置 OTLP 导出。
主要功能
- 01移除经典 APM Agent 和配置
- 02使用 elastic-otel-javaagent.jar
- 03通过 -javaagent 或 JAVA_TOOL_OPTIONS 加载 Agent
- 04配置 OTLP 端点和授权头
- 05避免在同一 JVM 同时运行两种 Agent
适用场景
- 01将 Java 服务从经典 Elastic APM 迁移到 EDOT
- 02配置 JVM 加载 EDOT Java Agent
- 03设置遥测服务名、端点和认证
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/observability-edot-java-migrate确认已加载。
详细介绍
EDOT Java 迁移
进行更改前，请阅读迁移指南：
指南
- 移除所有经典 APM 引用：
elastic-apm-agent.jar、elasticapm.properties、所有ELASTIC_APM_*环境变量，以及任何co.elastic.apmMaven/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"挂载——否则 Agent 不会执行任何操作 - 设置恰好三个必需的环境变量：
OTEL_SERVICE_NAME（替代ELASTIC_APM_SERVICE_NAME）OTEL_EXPORTER_OTLP_ENDPOINT——必须是托管 OTLP 端点或 EDOT Collector URL。不要重用旧的ELASTIC_APM_SERVER_URL值。切勿使用 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 Agent 和 EDOT Agent
示例
完整示例请参阅 EDOT Java 迁移指南。
评论
支持 Markdown