{"slug":"otel-java","title":"otel-java","summary":"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,","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-10-16T16:29:05.933615Z","repo":{"url":"https://github.com/ollygarden/opentelemetry-agent-skills","stars":111,"forks":13,"license":"Apache-2.0","updatedAt":"2026-10-16T08:07:28Z"},"bodyHtml":"
\n

name: otel-java\ndescription: 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.

\n

OpenTelemetry in Java

\n

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

\n

References

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
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.
\n

Sources of Truth

\n

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

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
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)
\n

What telemetry does an instrumentation emit?

\n

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

\n

Navigation:

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

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

\n

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

\n

Cross-References

\n\n","files":[{"path":"references/declarative-setup.md","sizeBytes":8117,"isText":true},{"path":"references/sensitive-data-capture.md","sizeBytes":6906,"isText":true},{"path":"SKILL.md","sizeBytes":5518,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-10-16T16:32:57.858073Z","sha256":"A8FBD13FA6A30E3D8A2459E6ED8A1F4E1C0803D18CE5530C14268B2F9283D6CA","sizeBytes":7938},"review":null,"source":{"repositoryUrl":"https://github.com/ollygarden/opentelemetry-agent-skills","path":"skills/otel-java","license":"Apache-2.0","commit":"967179521de5e8dac365ae6fbc4fc64f427259f5","subtreeSha":"3C9EB21175D763D42F2F59726AC92509896EB106C70180FB4B52DF697A73BD92","lastSyncedAt":"2026-10-16T16:29:03.891055Z"},"reviewedAt":"2026-10-16T16:40:43.524315Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/ollygarden/opentelemetry-agent-skills/tree/main/skills/otel-java"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install ollygarden-opentelemetry-agent-skills@llmmart"},{"target":"git","command":"git clone https://github.com/ollygarden/opentelemetry-agent-skills.git"}]}