mcpbeat

Observability Edot Java Instrument

elastic/observability-edot-java-instrument

> Instrument a Java application with the Elastic Distribution of OpenTelemetry (EDOT) Java agent for automatic tracing, metrics, and logs. Use when adding observability to a Java service that has no existing APM agent.

457 tokens
context cost
the whole folder, loaded on every use
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
546
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository 
npx skills add https://github.com/elastic/agent-skills --skill observability-edot-java-instrument

The instruction itself

3 sections, as written by the author

EDOT Java Instrumentation

Read the setup guide before making changes:

Guidelines

  • Use elastic-otel-javaagent.jar (download from

Maven Central, not a Maven/Gradle

compile dependency)

  • Attach via -javaagent:/path/to/elastic-otel-javaagent.jar or

JAVA_TOOL_OPTIONS="-javaagent:/path/to/elastic-otel-javaagent.jar" — without this the agent does nothing

  • Set exactly three required environment variables:
  • OTEL_SERVICE_NAME
  • OTEL_EXPORTER_OTLP_ENDPOINT — must be the managed OTLP endpoint or EDOT Collector URL. Never use an APM

Server URL (no apm-server, no :8200, no /intake/v2/events)

  • OTEL_EXPORTER_OTLP_HEADERS — "Authorization=ApiKey <key>" or "Authorization=Bearer <token>"
  • Do NOT set OTEL_TRACES_EXPORTER, OTEL_METRICS_EXPORTER, or OTEL_LOGS_EXPORTER — the defaults are already

correct

  • Never run both classic Elastic APM agent and EDOT agent on the same JVM

Examples

See the EDOT Java setup guide for complete

Dockerfile and docker-compose examples.

How to use it

Copy the folder

Take elastic/observability-edot-java-instrument from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.