mcpField
O
observability-edot-java-instrument

observability-edot-java-instrument

github.com/elastic云与 DevOps6022.7k 次安装今天更新
代码仓库

关于 observability-edot-java-instrument

用于配置 Elastic Distribution of OpenTelemetry（EDOT）Java 监测的技能，说明如何挂载 Agent、设置 OTLP 参数，并避免与传统 Elastic APM Agent 冲突。

主要功能

  1. 01挂载 Java Agent
  2. 02设置必需的 OTLP 环境变量
  3. 03使用托管 OTLP 端点或 EDOT Collector
  4. 04避免同时运行两种 Elastic Agent

适用场景

  1. 01为 Java 应用添加 EDOT 监测
  2. 02配置 Java 服务的遥测导出

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/elastic/agent-skills --skill observability-edot-java-instrument

安装后在 Claude Code 中输入/observability-edot-java-instrument确认已加载。

详细介绍

EDOT Java 插桩

进行更改前，请先阅读设置指南：

指南

  1. 使用 elastic-otel-javaagent.jar（从 Maven Central 下载，而不是将其作为 Maven/Gradle 编译依赖）
  2. 通过 -javaagent:/path/to/elastic-otel-javaagent.jar 或 JAVA_TOOL_OPTIONS="-javaagent:/path/to/elastic-otel-javaagent.jar" 挂载——不这样做，Agent 将不起作用
  3. 准确设置三个必需的环境变量：
    • 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>"
  4. 请勿设置 OTEL_TRACES_EXPORTER、OTEL_METRICS_EXPORTER 或 OTEL_LOGS_EXPORTER——默认值已经 正确
  5. 切勿在同一个 JVM 上同时运行经典 Elastic APM Agent 和 EDOT Agent

示例

完整的 Dockerfile 和 docker-compose 示例，请参阅 EDOT Java 设置指南。

评论

支持 Markdown