Skip to content

docs(integrations): Claude Managed Agents tracing through an OpenTelemetry Collector (TH-8267) - #986

Draft
nik13 wants to merge 9 commits into
mainfrom
feat/th-8267-claude-managed-agents
Draft

nik13 wants to merge 9 commits into
mainfrom
feat/th-8267-claude-managed-agents

Conversation

@nik13

@nik13 nik13 commented Oct 16, 2026 •

Copy link
Copy Markdown
Contributor

What

Draft native OpenTelemetry telemetry-destination route for Claude Managed Agents. The collector stamps project_name, maps agent/model/tool/outcome spans, forwards with Future AGI keys and keeps content off by default using a metadata allowlist. Full-content mode sends one span per downstream request to avoid count-based batches exceeding the receiver limit.

The same-host Docker example binds plaintext OTLP to loopback behind TLS, exports keys and the destination token before launch, and scopes the Admin API example to a selected workspace. The offline acceptance harness now requires verification and exits nonzero for failed delivery or verification. Customer-facing setup omits internal qualification prose; beta/privacy warnings remain.

Validation

Offline synthetic fixture/delivery tests: 37 passed against pinned Anthropic SDK 1.15.0 and latest installed 2.4.0, including failing-first setup/security checks and stubbed delivery/verification exit regressions. Collector 0.162.0 configuration previously validated with synthetic credentials; this update only changes a comment in that configuration. Docs registry/type checks (23 passed) and full Astro/Pagefind site build passed. Synthetic selected-workspace JSON passed. This is not a live Anthropic session or hosted Future AGI acceptance test.

Publication gate

Keep this PR draft and do not merge until a real deployed Managed Agents session reaches a Console telemetry destination and the hosted Future AGI endpoint, and project/session/token mapping, privacy, gzip, and request size have been verified. Requires an Anthropic organization admin and a Managed Agents-enabled API key with billing. There is no approval or access to those credentials in this run.

🤖 Generated with Claude Code

…TH-8267)

Updated deferral page: Anthropic now exports OpenTelemetry traces for Managed
Agents (API tracing destinations and SDK tracing). Documents why Future AGI
cannot accept them as sent (project_name resource attribute, public HTTPS
endpoint, unmapped turn/session/content attributes, spend), what was tested
locally with stand-ins, privacy default and opt-in, and troubleshooting.

examples/integrations/claude-managed-agents: STANDIN spike (synthetic API-span
payload + delivery emulator; real anthropic 1.15.0 SDK tracing against a local
Sessions API stub), run_e2e.sh, offline tests, decision record. No relay,
collector config or package.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
@nik13 nik13 changed the title docs(integrations): Claude Managed Agents tracing not supported yet (TH-8267) docs(integrations): Claude Managed Agents tracing through an OpenTelemetry Collector (TH-8267) Oct 21, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants