OpenTelemetry in Java — Javaagent zero-code instrumentation, Spring Boot Starter, manual autoconfigure SDK, declarative YAML configuration, BOM dependency management, sensitive-data capture and…

Apache-2.0Auto-check passedDevOps & Cloud

Install Otel Java

skills CLI
$ npx skills add ollygarden/opentelemetry-agent-skills --skill otel-java -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ollygarden/opentelemetry-agent-skills otel-java --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ollygarden/opentelemetry-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/otel-java .claude/skills/otel-java && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
otel-java
GitHub stars
106
Token cost
~1.4k tokens
SKILL.md length
387 words
Files
3 (incl. references)
Skills in repo
19
Repo updated
First seen
Licence
Apache-2.0

At a glance

OpenTelemetry in Java — Javaagent zero-code instrumentation, Spring Boot Starter, manual autoconfigure SDK, declarative YAML configuration, BOM dependency management, sensitive-data capture and…

  • Works in 2 steps: WebFetch… → WebFetch that JSON URL — one…
  • Configuring OpenTelemetry in a Java service
  • SKILL.md covers References, Sources of Truth, What telemetry does an… and Cross-References
  • Calls gh; reaches explorer.opentelemetry.io and raw.githubusercontent.com

What it does

Otel Java is an agent skill from ollygarden/opentelemetry-agent-skills. OpenTelemetry in Java — Javaagent zero-code instrumentation, Spring Boot Starter, manual autoconfigure SDK, declarative YAML configuration, BOM dependency management, sensitive-data capture and redaction (url.query, headers, request parameters, SQL sanitization). Use when adding, reviewing, or configuring OpenTelemetry in a Java service. Triggers on "setup otel in java", "java telemetry", "javaagent", "Spring Boot otel", "GlobalOpenTelemetry", "AutoConfiguredOpenTelemetrySdk", "TracerProvider java", "url.query…

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/declarative-setup.md` and `references/sensitive-data-capture.md`).

It sits in DevOps & Cloud, covering Observability and Backend development. It works with OpenTelemetry, Java, Spring Boot and SQL. The repository describes itself as: Vendor-neutral OpenTelemetry skills for AI coding agents like Claude Code, Cursor, and Codex, grounded in upstream sources. The licence is Apache-2.0.

When your agent uses it

  • Configuring OpenTelemetry in a Java service
  • Setup otel in java
  • Spring Boot otel
  • GlobalOpenTelemetry

Example prompts

  • “setup otel in java”
  • “java telemetry”
  • “javaagent”
  • “/otel-java”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. WebFetch https://explorer.opentelemetry.io/agent/javaagent/index.md — table mapping display
  2. WebFetch that JSON URL — one self-contained record (a few KB): resolved configurations,

What it can do on your machine

Read from SKILL.md and the folder at commit 7cf0de9. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • gh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • explorer.opentelemetry.io
    • raw.githubusercontent.com
    • opentelemetry.io

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Otel Java loads about 1.4k tokens when it runs, and up to ~5.1k if it reads all its reference files. Until then it costs about 150 tokens; SKILL.md has 387 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~150
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ollygarden/opentelemetry-agent-skills at commit 7cf0de9, republished under its Apache-2.0 licence (© ollygarden). 387 words, ~1,375 tokens.

Download SKILL.mdSave it as .claude/skills/otel-java/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
otel-java
description
OpenTelemetry in Java — Javaagent zero-code instrumentation, Spring Boot Starter, manual autoconfigure SDK, declarative YAML configuration, BOM dependency management, sensitive-data capture and redaction (url.query, headers, request parameters, SQL sanitization). Use when adding, reviewing, or configuring OpenTelemetry in a Java service. Triggers on "setup otel in java", "java telemetry", "javaagent", "Spring Boot otel", "GlobalOpenTelemetry", "AutoConfiguredOpenTelemetrySdk", "TracerProvider java", "url.query redaction", "capture request headers", or any Java-related OTel question.

OpenTelemetry in Java

Entry point for OpenTelemetry mechanics in Java services. Load a reference below based on the task; each reference is self-contained.

References

FileUse when
references/declarative-setup.mdConfiguring the SDK via declarative YAML: Javaagent activation, Spring Boot Starter, autoconfigure SDK, BOM, agent-only properties, manual instrumentation entry points.
references/sensitive-data-capture.mdWhat HTTP instrumentation captures by default (query strings ON, headers/params OFF), query-parameter redaction (sensitive-query-parameters), header/servlet-parameter capture knobs, SQL sanitization.

Sources of Truth

For YAML schema details, fetch the upstream sources listed in the otel-declarative-config skill. For Java-specific facts:

FactFetch
Latest BOM (opentelemetry-bom)gh api repos/open-telemetry/opentelemetry-java/releases/latest -q '.tag_name'
Latest Javaagentgh api repos/open-telemetry/opentelemetry-java-instrumentation/releases/latest -q '.tag_name'
SDK declarative-config accepted and preferred file_format for a selected BOM tagWebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-java/<selected-sdk-tag>/sdk-extensions/declarative-config/src/main/java/io/opentelemetry/sdk/autoconfigure/declarativeconfig/OpenTelemetryConfigurationFactory.java
Javaagent declarative-config docs (current activation flag, supported file_format)WebFetch https://opentelemetry.io/docs/zero-code/java/agent/declarative-configuration/
Javaagent declarative-config smoke fixture (parser truth for selected agent tag)WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-java-instrumentation/<selected-agent-tag>/smoke-tests/src/test/resources/declarative-config.yaml
Javaagent CHANGELOG (when each schema rc landed)WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-java-instrumentation/<selected-agent-tag>/CHANGELOG.md
Generated Java instrumentation config reference (names, types, defaults, deprecations)WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-java-instrumentation/<selected-agent-tag>/docs/declarative-configuration-example.yaml
Spring Boot Starter declarative-config fixture (selected starter tag)WebFetch https://raw.githubusercontent.com/open-telemetry/opentelemetry-java-instrumentation/<selected-agent-tag>/smoke-tests-otel-starter/spring-boot-2/src/testDeclarativeConfig/resources/application.yaml
Spring Boot starter docsWebFetch https://opentelemetry.io/docs/zero-code/java/spring-boot-starter/
Per-instrumentation telemetry & config (resolved spans/attributes, metrics, config options, target versions)WebFetch https://explorer.opentelemetry.io/data/javaagent/instrumentations/<id>/<id>-<hash>.json — get <id> and the latest <hash> from the index (see below)
Show full SKILL.md (189 more words)Show less

What telemetry does an instrumentation emit?

For "what does the agent produce for library X" — which spans, attributes, metrics, or config knobs — use the OpenTelemetry Ecosystem Explorer, which fully maps the Java agent and exposes an agent-friendly surface (Markdown indexes and resolved JSON, no scraping). Do not answer from model memory.

Navigation:

  1. WebFetch https://explorer.opentelemetry.io/agent/javaagent/index.md — table mapping display name → id → the instrumentation's JSON data URL (the URL embeds the content <hash>).
  2. WebFetch that JSON URL — one self-contained record (a few KB): resolved configurations, telemetry (spans with span_kind + typed attributes, and metrics), javaagent_target_versions, semantic_conventions, and scope.

Version-specific or "what changed between releases": https://explorer.opentelemetry.io/agent/javaagent/versions.md lists versions and marks the latest; https://explorer.opentelemetry.io/data/javaagent/versions/<version>-index.json gives the id→hash map for a version — a differing hash for the same id across two versions means that instrumentation changed. Schema: https://explorer.opentelemetry.io/schemas/javaagent-instrumentation.schema.json; use /llms.txt for the agent-oriented index and /llms-full.txt for the full documentation.

Prefer this Explorer data over the raw ecosystem-registry YAML on GitHub: the Explorer applies upstream metadata corrections that the raw registry does not.

Cross-References

  • Schema-level facts: otel-declarative-config skill (language-agnostic YAML schema sources).
  • SDK version selection across languages: otel-sdk-versions skill.
  • Semantic conventions lookup: otel-semantic-conventions skill.

© ollygarden, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in skills/otel-java of ollygarden/opentelemetry-agent-skills.

  • SKILL.md
  • references/declarative-setup.md
  • references/sensitive-data-capture.md

Open the folder on GitHubat commit 7cf0de9

Compare with similar skills

Otel Java next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Otel Java compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Otel Java this skillollygarden/opentelemetry-agent-skills106—~1.4kAutomated safety check: PassApache-2.0
AI Observabilityrrezartprebreza/spring-boot-skills2981 repos~1.6kAutomated safety check: PassMIT
Production Observabilityrrezartprebreza/spring-boot-skills298—~615Automated safety check: PassMIT
Production Observabilityrrezartprebreza/spring-boot-skills298—~769Automated safety check: PassMIT
Spring Boot ObservabilityHoangNguyen0403/agent-skills-standard571—~501Automated safety check: PassMIT
Flycms Devsunkaifei/FlyCms656—~827Automated safety check: PassMIT

Similar skills

  • AI Observability

    rrezartprebreza/spring-boot-skills

    A skill your agent uses when adding Spring AI-specific model observations, token usage, latency, externally configured cost attribution, advisor telemetry, or protected prompt and completion logging.

    298 GitHub starsUsed in 1 repo~1.6k tokens
    DevOps & CloudAuto-check passed
  • Production Observability

    rrezartprebreza/spring-boot-skills

    A skill your agent uses when adding service-wide Spring Boot 3 Actuator, Micrometer metrics, distributed tracing, OpenTelemetry export, structured logging, health probes, dashboards, or alerts.

    298 GitHub stars~615 tokensUpdated 16 days ago
    DevOps & CloudAuto-check passed
  • Production Observability

    rrezartprebreza/spring-boot-skills

    A skill your agent uses when adding service-wide Spring Boot 4 Actuator, Micrometer Observation and Tracing, OpenTelemetry or OTLP export, structured logging, health probes, dashboards, or alerts.

    298 GitHub stars~769 tokensUpdated 16 days ago
    DevOps & CloudAuto-check passed
  • Spring Boot Observability

    HoangNguyen0403/agent-skills-standard

    Instrument Spring Boot with Micrometer metrics, distributed tracing, and structured logging.

    571 GitHub stars~501 tokensUpdated today
    Backend & APIsAuto-check passed
  • Flycms Dev

    sunkaifei/FlyCms

    FlyCms 项目(backend/ Spring Boot 4.1.1 + frontend/ vue-vben-admin v5)的架构地图与开发规范总纲。凡在本仓库做任何开发——写后端接口、新增/修改模块、管理页面、数据库变更、修 bug、重构——都要先加载本 skill 再动手,即使用户只说"改一下""加个功能";前端登录/菜单/权限专项另见…

    656 GitHub stars~827 tokensUpdated 5 days ago
    Backend & APIsAuto-check passed
  • Pi K8s Deploy

    rodrigorodrigues/microservices-design-patterns

    Check Docker Hub for a new :latest image on a managed service and roll it out to the home Pi k8s cluster, the same way authentication-service was deployed on 2026-08-29 (SSH + kubectl rollout…

    187 GitHub stars~1.6k tokensUpdated 19 days ago
    DevOps & CloudAuto-check passed

More from ollygarden/opentelemetry-agent-skills

All 19 skills in this repo
  • Otel Collector Builder

    ollygarden/opentelemetry-agent-skills

    Build custom OpenTelemetry Collector distributions with OCB (OpenTelemetry Collector Builder).

    106 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Otel Go

    ollygarden/opentelemetry-agent-skills

    OpenTelemetry in Go — SDK setup, API surface, breaking changes, contrib instrumentation libraries (otelhttp, otelgrpc, otelmongo), compile-time zero-code instrumentation (otelc), and performance…

    106 GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • Otel Ottl

    ollygarden/opentelemetry-agent-skills

    OpenTelemetry Transformation Language (OTTL) expert for writing and debugging telemetry transformations in the OpenTelemetry Collector.

    106 GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Otel Span Events To Logs Migration

    ollygarden/opentelemetry-agent-skills

    Migrate OpenTelemetry Span Events (AddEvent, RecordException, and language equivalents) to the Logs API following the accepted OTEP 4430 migration plan.

    106 GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Otel Telemetrygen

    ollygarden/opentelemetry-agent-skills

    Build safe, version-pinned telemetrygen commands for synthetic OTLP traces, metrics, and logs.

    106 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Otel Upgrade

    ollygarden/opentelemetry-agent-skills

    Assess OpenTelemetry package and Collector upgrades across ecosystems.

    106 GitHub stars~1.1k tokensUpdated today
    Auto-check passed

Questions about Otel Java

What does Otel Java do?

OpenTelemetry in Java — Javaagent zero-code instrumentation, Spring Boot Starter, manual autoconfigure SDK, declarative YAML configuration, BOM dependency management, sensitive-data capture and…. Otel Java is an agent skill from ollygarden/opentelemetry-agent-skills.query, headers, request parameters, SQL sanitization).

When should I use Otel Java?

Otel Java fits situations like: configuring OpenTelemetry in a Java service; setup otel in java; spring Boot otel; globalOpenTelemetry.

How do I install Otel Java in Claude Code?

Run `npx skills add ollygarden/opentelemetry-agent-skills --skill otel-java -a claude-code`. Or copy the skill folder (skills/otel-java in ollygarden/opentelemetry-agent-skills) into .claude/skills/otel-java in your project. Claude Code loads it when a task matches its description.

How do I install Otel Java in Codex?

Run `npx skills add ollygarden/opentelemetry-agent-skills --skill otel-java -a codex`. Or copy the skill folder (skills/otel-java in ollygarden/opentelemetry-agent-skills) into .agents/skills/otel-java in your project. Codex loads it when a task matches its description.

Can I use Otel Java in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ollygarden/opentelemetry-agent-skills --skill otel-java -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/otel-java, .gemini/skills/otel-java, .github/skills/otel-java and .opencode/skills/otel-java in your project.

What does Otel Java need to run?

Going by SKILL.md and its folder, Otel Java needs the command-line tools its instructions call (gh).

Does Otel Java access the network?

SKILL.md names 3 domains. In commands or code: explorer.opentelemetry.io, raw.githubusercontent.com and opentelemetry.io; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Otel Java safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Otel Java use?

Otel Java is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Otel Java use?

About 1.4k tokens (SKILL.md is roughly 5.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.7k tokens, read only when the agent opens those files.

What are the alternatives to Otel Java?

Skills that share tags, products or a category with Otel Java: AI Observability (rrezartprebreza/spring-boot-skills, 298 stars), Production Observability (rrezartprebreza/spring-boot-skills, 298 stars), Production Observability (rrezartprebreza/spring-boot-skills, 298 stars) and Spring Boot Observability (HoangNguyen0403/agent-skills-standard, 571 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Otel Java?

ollygarden (a GitHub organization) maintains it in ollygarden/opentelemetry-agent-skills, which has 106 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 7, 2026.

Source: ollygarden/opentelemetry-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.