SuperAPI AI 工具集

observability-edot-java-instrument

部署与运维

查看项目

更新于 10-16 05:07

技能介绍

用途:为 Java 应用接入 Elastic Distribution of OpenTelemetry(EDOT)Java 代理,自动采集追踪、指标和日志。使用前应先阅读 EDOT Java 安装指南、OpenTelemetry Java 代理说明与 EDOT Java 配置文档。

主要能力:通过 Java 代理实现自动埋点,无需修改业务代码即可上报可观测性数据。

使用方式:使用 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;OTEL_EXPORTER_OTLP_ENDPOINT,必须是托管 OTLP 端点或 EDOT Collector URL,绝不能使用 APM Server URL(不要 apm-server、不要 :8200、不要 /intake/v2/events);OTEL_EXPORTER_OTLP_HEADERS,格式为 "Authorization=ApiKey <key>" 或 "Authorization=Bearer <token>"。不要设置 OTEL_TRACES_EXPORTER、OTEL_METRICS_EXPORTER、OTEL_LOGS_EXPORTER,默认值已正确。

限制:绝不要在同一 JVM 上同时运行经典 Elastic APM 代理和 EDOT 代理。完整 Dockerfile 与 docker-compose 示例见 EDOT Java 安装指南。