ClaudeDevs kondigde op 14 oktober 2026 de publieke bèta aan van OpenTelemetry-traces voor Claude Platform: voor de Messages API, Claude Managed Agents en de Claude SDK’s. Traces zijn registraties van activiteiten binnen een verzoek; met de bèta kunnen ontwikkelaars die naar hun observability-platform sturen om applicatie- en API-gedrag te volgen. Anthropic beschrijft de bèta en het bereik ervan, terwijl ClaudeDevs de aankondiging op 14 oktober deed.
Twee routes, twee kanten van een verzoek
SDK-tracing legt spans vast vanuit je eigen toepassing. API-tracing voegt servergegevens toe over wat er binnen Claude Platform gebeurt. De SDK-route kan onder meer verzoeken aan de Messages API en activiteit van clienttools in de toolrunner volgen. Via API-tracing zijn ook afzonderlijke modelruns, beurten van Claude Managed Agents en tools die op de server draaien zichtbaar.
| Keuze | SDK-tracing | API-tracing via Console |
| Instellen | In de toepassing, met een tracer provider en de exporter van de toepassing | Door een observability-bestemming toe te voegen in Claude Console |
| Rechten | Geen speciale Console-rechten nodig | Een organisatiebeheerder moet bestemmingen toevoegen of wijzigen; ontwikkelaars kunnen ze bekijken |
| Zicht op activiteit | Spans vanuit de toepassing, waaronder clienttools van de toolrunner | Spans van individuele modelruns, Managed Agents-beurten en servertools |
De SDK-route past als je ook wilt zien wat de toepassing en haar tools doen. API-tracing is bedoeld voor zicht op model- en serveractiviteit binnen Claude Platform. Je kunt beide combineren: met doorgifte van tracecontext kunnen SDK- en API-spans voor ondersteunde Claude Platform-aanvragen in één trace samenkomen. Voor AWS beginnen API-spans afzonderlijke traces, omdat AWS traceparent nog niet ondersteunt.
SDK-tracing begint vóór de eerste aanvraag
Registreer de OpenTelemetry-tracer provider voordat je de eerste aanvraag doet die je wilt volgen. Als je dat later instelt, ontbreken eerdere aanvragen in deze route. Bij streaming eindigt een span wanneer de toepassing de stream volledig heeft gelezen of gesloten. In de modus voor volledige inhoud bevat de span responsgegevens wanneer je de stream leest met messages.stream(). Anthropics SDK-gids beschrijft de registratievolgorde en het streaminggedrag.
SDK-tracing staat volgens Anthropic in bèta voor Claude API, Claude Platform op AWS, Amazon Bedrock, Google Cloud en Microsoft Foundry. De bèta kan opties en spanschema’s veranderen; Anthropic raadt aan de SDK-versie vast te zetten om zelf te bepalen wanneer je wijzigingen overneemt.
Metadata of ook prompts en antwoorden
Metadata-only is de standaardinstelling. Full content kan ook modelprompts en antwoorden exporteren. Die keuze stel je afzonderlijk in per SDK-client en per Console-bestemming. Na aflevering gelden de toegangs- en bewaarbeleidsregels van de gekozen observability-provider.
Anthropic stelt standaard een maximum van 0,75 MB per span in. Grotere inhoud wordt ingekort en gemarkeerd met anthropic.content.truncated=true; afbeeldingen en documenten verschijnen alleen als hun type. Anthropic schat dat een context van 1 miljoen tokens ongeveer 4 MB nodig heeft, zodat die inhoud niet in één standaardspan past. De OpenTelemetry-uitleg van Anthropic behandelt de inhoudsmodi en beperkingen.
Voor organisaties met een HIPAA-, FERPA- of K-12-dataverwerkingsbeperking bij Anthropic exporteren Console-bestemmingen alleen metadata, ongeacht de ingestelde inhoudsmodus. Die beperking geldt niet voor SDK-spans. Bij zero data retention blijft volledige inhoud beschikbaar voor tracing van de Messages API; Anthropic bewaart geëxporteerde inhoud daarvoor alleen in het geheugen tot aflevering. Claude Managed Agents valt niet onder zero data retention en de bewaartermijn daarvoor verandert niet door OpenTelemetry.
Console-bestemming: formaat, limieten en aflevering
Voor API-tracing moet de bestemming OTLP/HTTP protobuf accepteren via HTTPS op poort 443. Claude Console voegt standaard /v1/traces toe aan de basis-URL; je kunt ook een afzonderlijk traces-endpoint instellen. Per organisatie zijn maximaal 10 bestemmingen mogelijk, met per bestemming maximaal 1.000 geselecteerde workspaces en 20 aanvraagheaders.
De TLS-handshake moet binnen 5 seconden zijn voltooid en de bestemming moet binnen 5 seconden antwoordheaders terugsturen. Voor elke aflevering geldt een totale time-out van 10 seconden. Anthropics API-gids bevat de vereisten voor bestemmingen en aflevering.
Aflevering is best effort en gebeurt ten minste één keer: spans kunnen ontbreken of dubbel binnenkomen. Daardoor vormen traces geen volledige gebruiksregistratie. Anthropic verwijst voor het bijhouden van API-sleutelgebruik naar de Usage API. Claude Code heeft een afzonderlijke telemetriedocumentatie; deze bèta gaat over Claude Platform, waaronder de Messages API en Claude Managed Agents (documentatie voor Claude Code-monitoring).
