Skip to main content
hc
Submit
skillsSource-backedReview first Safety ✓ Privacy ✓

Claude Agent SDK OpenTelemetry Observability Capability Pack Skill

Expert capability pack for Agent SDK OpenTelemetry export using CLAUDE_CODE_ENABLE_TELEMETRY, OTLP exporters, and monitoring-usage reference variables documented for Claude Code CLI subprocesses.

by kiannidev·added 2026-06-16·
Claude CodeCodexWindsurfGeminiCursorCLI
HarnessClaude CodeCodexWindsurfGeminiCursorCLI
Level:expertType:capability-packVerified:validated
Review first — review before installing

Open the source and read safety notes before installing.

Safety notes

  • OTEL_LOG_* opt-ins can export prompts and tool payloads—enable only with approved pipelines.
  • Do not use console exporter through the SDK per observability doc warning.

Privacy notes

  • Default telemetry is structural; opt-in variables add user content to exports.

Prerequisites

  • Agent SDK query() deployment with access to environment or options.env.
  • OTLP collector reachable from the host running the SDK.

Schema details

Install type
package
Reading time
9 min
Difficulty score
76
Troubleshooting
Yes
Breaking changes
No
Source repository stats
Scope
Source repo
Package metadata
Skill and platform metadata
Skill type
capability-pack
Skill level
expert
Verification
validated
Verified at
2026-06-16
Retrieval sources
https://code.claude.com/docs/en/agent-sdk/observabilityhttps://code.claude.com/docs/en/monitoring-usagehttps://code.claude.com/docs/en/agent-sdk/overviewhttps://github.com/anthropics/claude-codehttps://developers.google.com/search/docs/fundamentals/creating-helpful-content
Tested platforms
Claude CodeClaudeCursorGeneric AGENTS
PlatformSupportInstall path
claude-codeNative.claude/skills/<skill-name>/SKILL.md
codexNative.agents/skills/<skill-name>/SKILL.md
windsurfNative.windsurf/skills/<skill-name>/SKILL.md
geminiNative.gemini/skills/<skill-name>/SKILL.md or .agents/skills/<skill-name>/SKILL.md
cursorAdapter.cursor/rules/<skill-name>.mdc
cliManualAGENTS.md or tool-specific context file
Full copyable content
# Trigger
"Apply the Claude Agent SDK OpenTelemetry observability capability pack."

# Required output
1) Signal plan (metrics, logs, traces beta)
2) Documented env var checklist
3) OTLP endpoint review
4) Sensitive export opt-in decision
5) Privacy-safe summary

About this resource

Knowledge Freshness

Grounded in agent-sdk/observability and monitoring-usage docs verified 2026-06-16. Tracing remains beta—confirm live docs before dashboard dependencies.

Retrieval Sources

Source Verification Notes

Verified on 2026-06-16:

Signal Enable with Doc page
All telemetry CLAUDE_CODE_ENABLE_TELEMETRY=1 Observability
Metrics OTEL_METRICS_EXPORTER=otlp Observability
Log events OTEL_LOGS_EXPORTER=otlp Observability
Traces (beta) OTEL_TRACES_EXPORTER=otlp + CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1 Observability
Span names claude_code.interaction, claude_code.llm_request, claude_code.tool Observability

Monitoring-usage cross-links additional CLI telemetry variables and security guidance.

Scope Note

Community review skill applying documented environment variables for Agent SDK hosts running the Claude Code CLI subprocess—not an Anthropic productized skill pack.

Core Workflow

  1. Pick signals needed (metrics, logs, traces beta).
  2. Set CLAUDE_CODE_ENABLE_TELEMETRY=1 and per-signal OTEL_*_EXPORTER values.
  3. Configure OTEL_EXPORTER_OTLP_* for the collector.
  4. Pass env via deployment shell or options.env (spread process.env in TypeScript).
  5. Review OTEL_LOG_* opt-ins with security stakeholders.
  6. Publish privacy-safe observability summary.

Capability Scope

  • SDK OTLP enablement checklist.
  • Trace span naming awareness.
  • Sensitive export opt-in review.
  • Short-lived process export interval tuning.

Production Rules

  • Never commit OTLP bearer tokens.
  • Keep OTEL_LOG_* unset unless approved.
  • Avoid console exporter values in SDK runs.

Review Matrix

Check Pass Doc
Enabled CLAUDE_CODE_ENABLE_TELEMETRY=1 Observability
Traces beta ENHANCED_TELEMETRY_BETA set Observability
OTLP endpoint + protocol configured Observability
Sensitive OTEL_LOG_* justified Observability

Output Contract

  1. Signal plan.
  2. Env checklist.
  3. OTLP review.
  4. Sensitive opt-in log.
  5. Privacy-safe summary.

Duplicate Check

Distinct from opentelemetry-trace-analysis-agent and claude-code-analytics-adoption-capability-pack.

Editorial Disclosure

Independent entry by kiannidev from public Agent SDK observability and monitoring-usage docs.

#agent-sdk#opentelemetry#observability#capability-pack

Source citations

Add this badge to your README

Show that Claude Agent SDK OpenTelemetry Observability Capability Pack Skill is listed on HeyClaude. Paste this Markdown into your README — it renders the badge and links back to this page.

Listed on HeyClaude
[![Listed on HeyClaude](https://heyclau.de/badge/skills/claude-agent-sdk-opentelemetry-observability-capability-pack.svg)](https://heyclau.de/entry/skills/claude-agent-sdk-opentelemetry-observability-capability-pack)

How it compares

Claude Agent SDK OpenTelemetry Observability Capability Pack Skill side by side with 3 alternatives on trust, install, platform support, and disclosed safety notes — all from reviewed registry metadata.

FieldClaude Agent SDK OpenTelemetry Observability Capability Pack Skill

Expert capability pack for Agent SDK OpenTelemetry export using CLAUDE_CODE_ENABLE_TELEMETRY, OTLP exporters, and monitoring-usage reference variables documented for Claude Code CLI subprocesses.

Open dossier 		Claude Agent SDK Custom Tool Authoring Capability Pack Skill

Expert Claude Agent SDK custom tool authoring capability pack for designing typed in-process tools with createSdkMcpServer, allowedTools scoping, isError handling, and privacy-safe rollout checklists aligned to official custom-tools documentation.

Open dossier 		Claude Agent SDK MCP Integration Capability Pack Skill

Expert Claude Agent SDK MCP integration capability pack for designing, reviewing, and rolling out Agent SDK MCP integration with source-backed checklists, production rules, and privacy-safe output contracts.

Open dossier 		Claude Agent SDK Session Storage Capability Pack Skill

Expert Claude Agent SDK session storage capability pack for designing, reviewing, and rolling out Agent SDK session storage with source-backed checklists, production rules, and privacy-safe output contracts.

Open dossier
Trust
Install riskReview firstReview firstReview firstReview first
Notes Safety ✓ Privacy ✓ Safety ✓ Privacy ✓ Safety ✓ Privacy ✓ Safety ✓ Privacy ✓
Categoryskillsskillsskillsskills
Sourcesource-backedsource-backedsource-backedsource-backed
Authorkiannidevkiannidevkiannidevkiannidev
Added2026-06-162026-06-162026-06-142026-06-14
Platforms
Claude CodeCodexWindsurfGeminiCursorCLI
Claude CodeCodexWindsurfGeminiCursorCLI
Claude CodeCodexWindsurfGeminiCursorCLI
Claude CodeCodexWindsurfGeminiCursorCLI
Source repo————
Safety notes✓OTEL_LOG_* opt-ins can export prompts and tool payloads—enable only with approved pipelines. Do not use console exporter through the SDK per observability doc warning.✓Tool descriptions and annotations are hints, not enforcement—validate destructive inputs in handlers. Wildcard mcp__server__* allowlists expand blast radius; prefer per-tool grants in production. Throwing from a handler stops the query; return isError for recoverable failures per custom-tools docs. In-process tools run inside your application whenever Claude calls them; gate writes explicitly.✓This skill plans Agent SDK MCP integration; it must not execute destructive changes without explicit approval. Browser, computer-use, and remote surfaces can access sensitive UI state; scope tests carefully. MCP and SDK integrations may exfiltrate data if tool scopes are too broad. The public `anthropics/claude-code` repository ships documentation links to code.claude.com for settings, security, and integration surfaces. Scheduled or autonomous workflows compound risk; cap blast radius in staging first.✓This skill plans Agent SDK session storage; it must not execute destructive changes without explicit approval. Browser, computer-use, and remote surfaces can access sensitive UI state; scope tests carefully. MCP and SDK integrations may exfiltrate data if tool scopes are too broad. The public `anthropics/claude-code` repository ships documentation links to code.claude.com for settings, security, and integration surfaces. Scheduled or autonomous workflows compound risk; cap blast radius in staging first.
Privacy notes✓Default telemetry is structural; opt-in variables add user content to exports.✓Tool schemas, inputs, and results enter model context each turn—never embed secrets in descriptions. Large tool sets increase context usage; defer rarely used tools via tool search when scaling. Structured outputs and logs may reach host telemetry—redact customer identifiers at handler boundaries. External APIs invoked by handlers may log request metadata governed by vendor retention policies.✓Reviews may expose integration tokens, customer metadata, and internal URLs related to Agent SDK MCP integration. Telemetry and analytics configs can include account emails; redact before sharing externally. Keep troubleshooting logs in internal channels unless explicitly sanitized. Third-party vendors remain outside Anthropic retention policies; document separately.✓Reviews may expose integration tokens, customer metadata, and internal URLs related to Agent SDK session storage. Telemetry and analytics configs can include account emails; redact before sharing externally. Keep troubleshooting logs in internal channels unless explicitly sanitized. Third-party vendors remain outside Anthropic retention policies; document separately.
Prerequisites
  • Agent SDK query() deployment with access to environment or options.env.
  • OTLP collector reachable from the host running the SDK.
  • Claude Agent SDK installed for TypeScript or Python with a working query loop.
  • Zod (TypeScript) or dict/JSON Schema (Python) for tool input contracts.
  • Written list of side effects each custom tool may perform and who approves them.
  • Staging environment to validate allowedTools, permissions, and error paths.
  • Access to Claude Code or Agent SDK environment where Agent SDK MCP integration will run.
  • Ability to read project, user, and managed settings relevant to the workflow.
  • Staging repository or sandbox account for safe validation.
  • Platform or security stakeholder available for policy-bound rollouts.
  • Access to Claude Code or Agent SDK environment where Agent SDK session storage will run.
  • Ability to read project, user, and managed settings relevant to the workflow.
  • Staging repository or sandbox account for safe validation.
  • Platform or security stakeholder available for policy-bound rollouts.
Install————
Config————
Citations
ClaimUnclaimedUnclaimedUnclaimedUnclaimed

Signals

Loading live community signals…

More like this, weekly

A short, calm digest of reviewed Claude resources. Unsubscribe any time.