Skip to content
All posts

Agent Traces Are Becoming Portable. Accountability Still Has to Be Designed.

Claude's OpenTelemetry beta makes agent traces portable. Banks still need explicit coverage, careful data handling, and durable records of business actions.

Architecture6 min read

Editorial paper-model scene showing an engineer following a task through connected systems
AI-generated conceptual editorial illustration.

A bank's document-review assistant finishes late, consumes more model capacity than expected and returns an incomplete assessment. The application dashboard shows a successful HTTP request. The model console shows several calls. The document service shows downloads. None of those views explains which part of the business task failed.

This illustrative situation is familiar to anyone who has operated distributed software. Agents make it harder because the path is assembled during execution: another model turn, a tool call, a retry, perhaps a second worker. Observing individual components is necessary, but the operational question belongs to the workflow as a whole.

On 14 October 2026, Anthropic launched OpenTelemetry export in beta for Messages API requests and Claude Managed Agents sessions, alongside SDK instrumentation. The release makes provider activity available to an organization's observability backend. It is a concrete engineering change, not proof that an organization now has a complete record of its agents. Claude Platform release notes.

A shared trace needs a business root

The important architectural opportunity is to join provider activity to the request that caused it. Anthropic's setup documentation describes using W3C trace context to connect API spans to application traces, including propagation to MCP servers through request metadata. Without correlation, exported spans can remain a separate island. API tracing setup.

For a bank, the root should represent a bounded business operation: reviewing a defined document collection, preparing an architecture decision or investigating an incident. A business identifier can connect that operation to its task record. Technical trace identifiers connect the runtime steps. Those identifiers serve different purposes and should not be collapsed into a single conversational session identifier.

Consider an assessment that runs overnight and resumes after a reviewer supplies missing evidence. The business task remains the same, while execution may involve several requests and traces. The architecture needs a durable relationship between the task, attempts and resulting artifacts. Otherwise a dashboard may count the resumed run as another successful task while concealing the failed first attempt and its cost.

The inline diagram presents a conceptual design: application and provider spans feed an observability pipeline, while the business task retains links to outcomes and authoritative action records. It is a reference architecture, not a diagram of Anthropic's internal systems.

Conceptual reference design; not a vendor implementation.

Coverage depends on where the work runs

The provider's coverage table distinguishes SDK instrumentation from API instrumentation. Server-executed tools and model activity are visible through the API path; client tools run by the SDK tool runner require the client-side path. Exporting server spans alone does not instrument every custom service that an agent can reach. OpenTelemetry overview.

That distinction should shape the pilot. A tool that creates a Jira issue, reads a knowledge store or changes a customer-facing document needs its own operational instrumentation. The team should verify that the tool's attempt and actual outcome can be correlated, including timeouts where the caller does not know whether the remote operation completed.

A successful model response is not the same as a completed business action. If the destination rejects a write, the task record should remain incomplete even when the model produces a fluent summary. If a timeout occurs after the destination accepted the operation, a retry should avoid creating a duplicate. Observability helps diagnose those cases; the workflow still needs idempotency, explicit states and reconciliation.

Diagnostic traces are not an exhaustive action ledger

Anthropic documents best-effort delivery and possible duplicate spans. A lost span cannot be resent. Those are important operational limits: an absent span does not establish that no action occurred. Delivery and health documentation.

My architectural recommendation is to separate diagnostic evidence from authoritative records of external effects. Use traces to understand timing, errors and execution relationships. Use durable records at the system of effect to establish that an approved operation happened. Link them through identifiers, without making the existence of a sampled diagnostic event a prerequisite for remembering a payment, publication or access change.

For example, a proposed supplier-data update might have a task record, an approval bound to the proposed values, and a transaction record written by the destination when it accepts the change. A trace helps explain why the process took forty seconds or retried. It should not be the only place where the approved values and final outcome can be reconstructed. This is a reference design, not a claim about automatic features in the new beta.

Observability creates another data destination

The feature supports metadata-only and full-content modes. The latter can export prompts and responses; metadata can still contain descriptive names chosen by developers. Anthropic explicitly places exported data under the receiving platform's access and retention controls. Content modes.

That makes telemetry configuration a data-architecture decision. A bank should not assume that a log or tracing destination is harmless because it is categorized as operational tooling. Document excerpts, internal system descriptions and identifiers can be sensitive even when they do not resemble a full customer record.

A sensible starting design uses metadata sufficient to diagnose workflow behavior, controlled names that do not expose business content, and a clear owner for each destination. Full-content capture can be evaluated in a narrowly scoped environment with synthetic data before any broader use. Retention, access, incident investigation and deletion requirements should be considered for the receiving platform independently of the inference provider.

Normalize semantics without flattening meaning

Anthropic's span reference uses the OpenTelemetry GenAI conventions where available, alongside provider-specific attributes. It also identifies the conventions as still developing. Span reference.

For an open orchestration platform, this argues for preserving original attributes while maintaining a small, explicit cross-provider model. Task identity, attempt, model request, tool execution and business outcome should remain distinguishable. A universal label such as successful run becomes misleading if one backend means a completed request and another means an accepted asynchronous job.

Archy could evaluate a portable observability contract that carries those distinctions across providers and tools. This is a product direction to test, not a claim that Archy already supports this release. The value would be the ability to explain a complete workflow and change providers without losing operational meaning.

For Architech, the practical engagement is a single-workflow observability assessment. Instrument a bounded process, deliberately introduce a failed tool call and a timeout, and demonstrate how an operator identifies the failed business outcome. Measure reconciliation effort and diagnostic completeness alongside latency and model consumption.

Watch the beta's coverage, delivery behavior and evolving span conventions. The success criterion is not the number of spans collected. It is whether an operator can explain what happened, identify what remains uncertain and recover the business process without guessing.

Make your next piece count

Give good ideas a better way to ship.

Start with a brief. Keep the editorial decisions yours.

Part of the Archy AI Platform