93 pages for trace.

SEP-414: Document OpenTelemetry Trace Context Propagation Conventions Model Context Protocol · title seps/414-request-meta Or, for the model with the same capabilities and no access approval requirement: Claude Developer Platform · in the page about-claude/models/migration-guide …against the new baseline. 4. **Built-in progress updates in agentic traces:** Claude Opus 4.7 provides more regular, higher-quality updates to the user throughout long agentic traces. If you've adde… browser-use-sdk Claude Developer Platform · in the page agents-and-tools/tool-use/browser-use-sdk …/browser-use-sdk#quick-start) serves three members, so the following `TracedBrowser` offers Claude members it can't serve. Turn those members off with `configs` before you use it. <CodeGroup exclude=… Log at info level Claude Developer Platform · in the page agents-and-tools/tool-use/tool-runner …ption's message (in Python, its type and message), not the full stack trace. What the SDK logs is language-specific. The Python SDK logs the full exception, including its stack trace, through the sta… Telemetry Destinations Claude Developer Platform · in the page api/beta/organization/telemetry_destinations …such as `/otlp`, is allowed. Don't include the per-signal path (`/v1/traces`), because the API appends it on delivery. If your collector takes traces on another path, also set `traces.endpoint_url`.… Create a Telemetry Destination Claude Developer Platform · in the page api/beta/organization/telemetry_destinations/create …such as `/otlp`, is allowed. Don't include the per-signal path (`/v1/traces`), because the API appends it on delivery. If your collector takes traces on another path, also set `traces.endpoint_url`.… List Telemetry Destinations Claude Developer Platform · in the page api/beta/organization/telemetry_destinations/list …as registered. The API appends the per-signal path, such as `/v1/traces`, on delivery, unless `traces.endpoint_url` is set. - `header_names: array of string` Names of the registered reque… Retrieve a Telemetry Destination Claude Developer Platform · in the page api/beta/organization/telemetry_destinations/retrieve …as registered. The API appends the per-signal path, such as `/v1/traces`, on delivery, unless `traces.endpoint_url` is set. - `header_names: array of string` Names of the registered reque… Update a Telemetry Destination Claude Developer Platform · in the page api/beta/organization/telemetry_destinations/update …nge of the endpoint's hostname or port removes. Only `display_name`, `traces`, `traces.endpoint_url`, `traces.content_mode`, `traces.max_content_bytes`, and individual `headers` values accept `null`.… routines-fire Claude Developer Platform · in the page api/claude-code/routines-fire …on/json" \ -d '{"text": "Sentry alert SEN-4521 fired in prod. Stack trace attached."}' ``` ```yaml GitHub Actions - if: failure() env: ROUTINE_FIRE_URL: ${{ secrets.ROUTINE_FIRE_URL }} RO… spans Claude Developer Platform · in the page api/opentelemetry/spans …e the following attributes. A session's spans can be in more than one trace, so to assemble a view of the session, such as a transcript, [group its spans by these IDs](https://platform.claude.com/docs… prompting-claude-opus-4-8 Claude Developer Platform · in the page build-with-claude/prompt-engineering/prompting-claude-opus-4-8 …e regular, higher-quality updates to the user throughout long agentic traces. If you've added scaffolding to force interim status messages ("After every 3 tool calls, summarize progress"), try removin… prompting-claude-sonnet-5 Claude Developer Platform · in the page build-with-claude/prompt-engineering/prompting-claude-sonnet-5 …s regular, higher-quality updates to the user throughout long agentic traces. If you've added scaffolding to force interim status messages ("After every 3 tool calls, summarize progress"), try removin… refusals-and-fallback Claude Developer Platform · in the page build-with-claude/refusals-and-fallback …the model fills in before it answers * A `reasoning`, `thinking`, or `trace` field in JSON output or in a tool input * The model's private notes, or a running log of its reasoning * Reasoning asked fo… thinking Claude Developer Platform · in the page build-with-claude/thinking …oncatenating deltas yourself. <Accordion title="Full streaming event trace"> ```text Output event: message_start data: {"type": "message_start", "message": {"id": "msg_01...", "type": "message"… inference-hooks Claude Developer Platform · in the page manage-claude/inference-hooks …cs/en/manage-claude/compliance-activity-feed). The following diagram traces one example (a Cowork request where Claude also calls an O365 tool) to illustrate which parts of the flow are hooked. The h… opentelemetry Claude Developer Platform · in the page manage-claude/opentelemetry …/platform.claude.com/docs/en/manage-claude/opentelemetry description: Trace your Messages API requests, tool uses, and Managed Agents sessions with OpenTelemetry spans from the Claude SDK and the Clau… api Claude Developer Platform · in the page manage-claude/opentelemetry/api …iption: Add a destination in the Claude Console to send OpenTelemetry traces of your Messages API requests and Managed Agents sessions to your observability platform. featureMetadata: topic: tit… sdk Claude Developer Platform · in the page manage-claude/opentelemetry/sdk …tform.claude.com/docs/en/manage-claude/opentelemetry/sdk description: Trace each request that the Claude SDK sends and each tool that its tool runner runs, and send the spans to your observability pla… sessions Claude Developer Platform · in the page managed-agents/sessions …ify the agent and version the overrides are applied to. This lets you trace a session back to its base agent. The following example starts a session that overrides the model and clears the system pro… migration-guide Claude Developer Platform · in the page models/opus-5-5/migration-guide …ffect code or scaffolding: 1. **Built-in progress updates in agentic traces:** Claude Opus 4.7 provides more regular, higher-quality updates to the user throughout long agentic traces. If you've adde… overview Claude Developer Platform · in the page release-notes/overview …m.claude.com/docs/en/manage-claude/opentelemetry) in beta, so you can trace Messages API requests and Claude Managed Agents sessions in your observability platform. The Claude SDK emits spans in Pytho… Hosting the Agent SDK Claude Code CLI · in the page agent-sdk/hosting …e signals. `CLAUDE_CODE_ENHANCED_TELEMETRY_BETA` is required only for traces; omit it if you export metrics and logs alone. ```bash title=".env" theme={null} CLAUDE_CODE_ENABLE_TELEMETRY=1 CLAUDE_COD… Observability with OpenTelemetry Claude Code CLI · in the page agent-sdk/observability # Observability with OpenTelemetry > Export traces, metrics, and events from the Agent SDK to your observability backend using OpenTelemetry. When you run agents in production, you need visibility i… Champion kit Claude Code CLI · in the page champion-kit …he test in @tests/scheduler.test.ts is flaky, figure out why," and it traced two unjoined promises in the scheduler. Try the same phrasing on your test. ``` ### Point at the feature rather than the d… Claude Code changelog Claude Code CLI · in the page changelog …etry tracing guidance to the `claude-api` skill, including setting up trace destinations with the `ant` CLI * Added the `%` motion to vim mode: jump to the matching bracket, alone or with d/c/y * Adde… Channels reference Claude Code CLI · in the page channels-reference …s a dependency or import error in your server file. To see the stderr trace, restart with `claude --debug --dangerously-load-development-channels server:webhook` and check the debug log at `~/.claude/… Claude apps gateway for Amazon Bedrock, Claude Platform on AWS, Google Cloud, and Microsoft Foundry Claude Code CLI · in the page claude-apps-gateway …n counts, model, user identity, and latency by default, with logs and traces as per-destination opt-ins. * **Upstream routing**: clients speak the Anthropic Messages API to the gateway, and the gatewa… Claude apps gateway configuration Claude Code CLI · in the page claude-apps-gateway-config …cy. ### `telemetry` The CLI sends metrics, logs, and, when enabled, traces to the gateway, which relays them verbatim to each configured destination. The exports use OpenTelemetry Protocol (OTLP) ov… Claude apps gateway deployment and operations Claude Code CLI · in the page claude-apps-gateway-deploy …onfigured upstream | | Telemetry (OTLP metrics, plus [opt-in logs and traces](/docs/en/claude-apps-gateway-config#telemetry)) | CLI → gateway → your collector | Never | | Identity (email, groups, sub)… Deploy Claude apps gateway on AWS Claude Code CLI · in the page claude-apps-gateway-on-aws …ion. Claude Code emits OpenTelemetry (OTLP) metrics, logs, and opt-in traces; [Monitoring usage](/docs/en/monitoring-usage) covers everything the CLI reports. In sessions signed in through `/login`, t… Explore the .claude directory Claude Code CLI · in the page claude-directory …`gh issue view $ARGUMENTS\` Investigate and fix the issue above. 1. Trace the bug to its root cause 2. Implement the fix 3. Write or update tests 4. Summarize what you changed and why` }]… Let Claude coordinate ongoing work with Projects Claude Code CLI · in the page claude-projects …u instead: * **Send work to one place**: paste a bug report, a stack trace, or a list of tasks into the conversation whenever one comes up. Claude starts a thread for each piece of work or passes it… Configure cloud environments Claude Code CLI · in the page cloud-environments …, ask Claude to set it on the command it runs, for example `LOG_LEVEL=trace npm test`, or start a new session. A cloud session also sets some variables itself when it starts. For [`CLAUDE_AUTOCOMPACT… Common workflows Claude Code CLI · in the page common-workflows …``` **3. Understand the execution flow** ```text wrap theme={null} trace the login process from front-end to database ``` > [!TIP] > > Tips: > > * Be specific about what you're looking for > * Use… Communications kit Claude Code CLI · in the page communications-kit …/ship skill that runs tests and lint before commit" | | Debug a stack trace | "here's the stack trace, find the root cause, don't just paper over it" | > [!TIP] > > Claude Code ships frequently. Veri… Manage costs effectively Claude Code CLI · in the page costs …**Unexpectedly high spend on an API or cloud-provider plan**: usually traces back to long sessions that were never cleared or to Opus left as the default model. The highest-impact habits to share are… Data usage Claude Code CLI · in the page data-usage …TELEMETRY=1` to opt out. **Error reports**: error messages and stack traces from Claude Code's own internals, sent to a third-party error tracking service over TLS. Claude Code redacts known patterns… Debug your configuration Claude Code CLI · in the page debug-your-config …oubleshooting). ## Check common causes Most configuration surprises trace back to a small set of location and syntax rules. Check these before assuming a bug: | Symptom | Cause | Fix | | :- | :- |… Environment variables Claude Code CLI · in the page env-vars …| OTLP endpoint for [detailed beta tracing](/docs/en/monitoring-usage#traces-beta): with `ENABLE_BETA_TRACING_DETAILED=1`, logs and traces go there instead of to the configured exporters. Set it in yo… Monitoring Claude Code CLI · in the page monitoring-usage …col, events via the logs/events protocol, and optionally [distributed traces via OpenTelemetry](#traces-beta). > [!NOTE] > > For the Claude API or Managed Agents, see [OpenTelemetry for the Claude AP… Overview Claude Code CLI · in the page overview …For bugs, paste an error message or describe the symptom. Claude Code traces the issue through your codebase, identifies the root cause, and implements a fix. See [common workflows](/docs/en/common-wo… Choose a permission mode Claude Code CLI · in the page permission-modes …es Claude Code v2.1.257 or later. A command the shell parser can't trace, such as one that changes directory more than once or runs a subshell, prompts the same way even when it names no outside pa… Test plugins with evals Claude Code CLI · in the page plugin-evals …ast_message` | Claude's final response text. This is the default | | `trace` | The session as JSON, one message per line. A `regex` grader sees every message; an `llm` judge sees the first 12 and the… Plugin loading reference Claude Code CLI · in the page plugins/loading # Plugin loading reference > Trace where Claude Code loads each plugin from, which settings file decides whether it loads, and why an update changed nothing. Use this page when a plugin didn't load,… Troubleshoot a mod Claude Code CLI · in the page plugins/mods/troubleshoot …ker thread. The worker stopped responding or crashed, and Claude Code traced that to this mod and unloaded it. A hook that blocks the thread, such as a loop that never awaits, is one cause. Fix the h… Prompt library Claude Code CLI · in the page prompt-library …retryWithBackoff helper' }, src: 'workflows' }, { id: 'trace-how-code-evolved', sdlc: 'discover', cat: 'Understand', roles: [], prompt: 'look through the commit history… Automate work with scheduled tasks Claude Code CLI · in the page routines …e to investigate the alert in the fire payload, so it pulls the stack trace and correlates it with recent commits in the repository. It then opens a draft pull request with a proposed fix and a link b… Verify session identity in self-hosted environments Claude Code CLI · in the page self-hosted-environments-identity …`ccr:session_id` and `jti` alongside the creator identity so you can trace actions back to a specific session. ## Related environment variables The creator identity also appears in plain environmen… All settings Claude Code CLI · in the page settings-reference …t a sandboxed command can read A Bash command the shell parser can't trace, such as one that changes directory more than once or runs a subshell, prompts you even in auto mode and `bypassPermissions`…