For AI agents: the public content index is available at https://we0.ai/llms.txt, and the English article bundle is available at https://we0.ai/llms-full.txt.
For AI agents: the public content index is available at https://we0.ai/llms.txt, and the English article bundle is available at https://we0.ai/llms-full.txt.
For AI agents: the complete content index is available at https://we0.ai/llms.txt, the full English article bundle is available at https://we0.ai/llms-full.txt, and this page is available as Markdown at https://we0.ai/de/articles/claude-opentelemetry-tracing-api-and-sdk-4adbbb12.md.
Anthropic hat den OpenTelemetry-Trace-Export für Claude Managed Agents, die Messages API und Claude SDKs eingeführt. Die am 14. Oktober 2026...
Anthropic hat den OpenTelemetry-Trace-Export für Claude Managed Agents, die Messages API und Claude SDKs eingeführt. Die am 14. Oktober 2026 angekündigte Funktion befindet sich in der öffentlichen Beta und sendet standardisierte Tracing-Daten an Observability-Plattformen, die OTLP akzeptieren.
Das Ziel ist praktisch: Modellaufrufe und Tool-Aktivitäten eines Agenten lassen sich zusammen mit der Anwendung verfolgen, die ihn aufgerufen hat. Statt Latenz, Fehler und Token-Nutzung an getrennten Stellen zu untersuchen, kann ein Team die relevanten Spans in seinem bestehenden Observability-System prüfen.
Ein Trace zeichnet den Weg einer Anfrage durch ein System auf. Ein Span zeichnet einen einzelnen Vorgang innerhalb dieses Wegs auf, etwa einen Modellaufruf oder eine Tool-Ausführung. Claudes Spans folgen den GenAI-Semantikkonventionen von OpenTelemetry, wodurch kompatible Tools Daten über verschiedene Modellanbieter hinweg interpretieren können.
Quelle: Anthropic. Das Diagramm veranschaulicht die Trace-Struktur und Analyseabläufe, nicht gemessene Leistungsergebnisse.
Es gibt zwei sich ergänzende Wege, die Daten zu erfassen:
| Funktion | SDK-Tracing | API-Tracing |
|---|---|---|
| Konfiguration | Anwendungscode und Tracer Provider | Ziel in der Claude Console |
| Spezielle Claude-Berechtigung | Keine | Admin-Rolle zum Hinzufügen oder Ändern von Zielen |
| Modellläufe innerhalb einer Anfrage | Werden durch SDK-Tracing allein nicht einzeln offengelegt | Enthalten |
| Managed-Agents-Turns | Werden durch SDK-Tracing allein nicht offengelegt | Enthalten |
| Von der API ausgeführte Tools | Werden durch SDK-Tracing allein nicht offengelegt | Enthalten |
| Client-Tools, die vom SDK Tool Runner ausgeführt werden | Enthalten | Werden nicht allein durch API-Tracing erfasst |
| Tools in einer selbst gehosteten Sandbox | Über den unterstützten SDK-Worker enthalten | Werden nicht allein durch API-Tracing erfasst |
| Andere Client-API-Vorgänge, etwa Datei-Uploads | Enthalten | Werden nicht allein durch API-Tracing erfasst |
Beide Wege zeichnen Request-Spans und Token-Nutzung auf. Zusammen schaffen sie Transparenz über Client-Arbeit ebenso wie über Arbeit innerhalb der Claude API. Wenn beide Datenströme an dasselbe Backend gesendet werden, kann das Backend auch ihre Beziehung anzeigen.
API-Tracing erfordert keine Änderung des gewöhnlichen Request-Codes, um eigenständige API-Traces zu erhalten. Ein Administrator fügt ein Ziel hinzu, das festlegt, wohin Claude die Daten senden soll.
anthropic.test-Span eintrifft.service.name = claude-platform.Für ein benutzerdefiniertes Ziel gilt laut Dokumentation die Anforderung eines OTLP/HTTP-Endpunkts, der Protobuf über einen öffentlichen HTTPS-Hostnamen auf Port 443 akzeptiert. Ein Collector, der nur auf dem üblichen Port 4318 lauscht, benötigt eine geeignete HTTPS-Freigabe oder einen Reverse Proxy. Zugangsdaten gehören in Header-Werte.
Der Basisendpunkt lässt normalerweise /v1/traces weg, weil Claude diesen Pfad anhängt. Ein erweiterter Traces-Endpunkt kann den Pfad überschreiben, muss jedoch denselben Host verwenden. Endpunkte mit privaten Adressen und Weiterleitungen werden nicht als reguläre Zustellziele unterstützt.
SDK-Tracing beginnt mit der Installation eines aktuellen unterstützten Claude SDK und der Registrierung eines OpenTelemetry Tracer Providers vor dem ersten zu verfolgenden Aufruf. Die Anwendung stellt den Exporter bereit, der Spans an das Observability-Backend übermittelt. „Automatischer SDK-Export“ bedeutet daher nicht, dass eine neue Anwendung ohne Tracer Provider und Ziel-Exporter Daten an einen Ort sendet.
Ein Console Exporter kann helfen, die lokale Instrumentierung zu prüfen, bevor eine Remote-Plattform angebunden wird. Nach der Konfiguration erzeugt das SDK Request-Spans und Spans für Tools, die über seinen Tool Runner ausgeführt werden. Aufrufe innerhalb eines Application-Span können unter diesem Span verschachtelt werden.
Während der Beta können sich SDK-Optionen, Span-Namen und Attribute ändern. Anthropic empfiehlt, die SDK-Version festzuschreiben, damit Teams selbst entscheiden können, wann sie diese Änderungen übernehmen.
Das SDK propagiert den Trace-Kontext, sodass die Server-Spans der API unter den Client-Spans des SDK liegen können. Anfragen an die Claude Platform on AWS sind eine Ausnahme: API-Spans erscheinen in eigenen Traces, weil diese Plattform das gleiche Verhalten zur Trace-Kontext-Verknüpfung noch nicht unterstützt.
Managed-Agents-Sitzungen stellen Sessions-API-Request-Spans, Agent-Turn-Spans, Modellanfragen, von der API ausgeführte Tools und Outcome-Evaluierungen bereit. Eine Sitzung kann mehrere Traces und bei Multiagent-Betrieb mehrere Threads umfassen. Die Dokumentation empfiehlt, nach anthropic.session.id für eine Sitzung oder nach gen_ai.conversation.id für einen Thread zu gruppieren.
Claude Code, das Agent SDK und Cowork verfügen über eigene Monitoring-Dokumentationen. Die neue Plattformfunktion sollte nicht als Ersatz für die bestehenden Instrumentierungsanweisungen jedes Produkts verstanden werden.
Jedes Console-Ziel und jeder SDK-Client besitzt einen Inhaltsmodus. Der Standardmodus Metadata only umfasst Kennungen, Zeitangaben, Status, Token-Anzahlen und ausgewählte beschreibende Texte wie Tool-Namen, Tool-Beschreibungen und MCP-Servernamen. Modell-Prompts und Antworten werden ausgeschlossen, dies ist jedoch keine Zusage, dass jedes exportierte Feld frei von durch die Anwendung bereitgestelltem Text ist.
Full content umfasst zusätzlich Prompts und Antworten. Das ist hilfreich für das Debugging fehlgeschlagener Interaktionen und für den Aufbau von Evaluierungen aus echtem Traffic, überträgt jedoch Gesprächsinhalte in ein separates System mit eigenen Zugriffs- und Aufbewahrungseinstellungen.
Das Standardlimit für Inhalte beträgt 0,75 MB pro Span. Anthropic gibt an, dass dies ungefähr in einen englischen Kontext mit 200.000 Tokens passt und unter dem 1-MB-Anfragelimit bleibt, das viele Observability-Dienste und Proxys verwenden. Ein vollständiger Kontext mit einer Million Tokens kann etwa 4 MB benötigen; der Standard reicht also nicht aus, um jeden großen Prompt vollständig aufzubewahren.
Wenn ein Span sein Inhaltslimit überschreitet, kürzt das SDK oder die API ihn und setzt anthropic.content.truncated auf true. Request-Spans verwerfen zuerst den System-Prompt und die frühesten Nachrichten; Tool-Spans verwerfen Blöcke vom Ende des Tool-Ergebnisses. Bilder und Dokumente erscheinen nach Typ, nicht als vollständige Mediendaten.
Das SDK verwendet traces.max_content_bytes, um das Limit zu steuern. Console-Ziele stellen unter den erweiterten Einstellungen eine maximale Inhaltsgröße bereit, und aufgeführte Anbieter können einen anbieterspezifischen Standardwert haben.
Beschreibe deine Idee einmal, und We0 AI erstellt eine Showcase-Website, Seiten und ein CMS und hilft nach dem Launch bei Kunden und Traffic.
Eine komplette Projektgeneration zur kostenlosen Registrierung
Am besten geeignet, um einen vollständigen Generierungsablauf auszuprobieren und schnell einen ersten Projektentwurf zu sehen.
Organisationen mit HIPAA-, FERPA- oder K–12-Beschränkungen für die Datenverarbeitung bei Anthropic exportieren über API-Ziele unabhängig vom gewählten Inhaltsmodus nur Metadaten. Laut Dokumentation gilt diese Beschränkung nicht für SDK-Spans, sodass die SDK-Konfiguration weiterhin separat geprüft werden muss.
Ein Export vollständiger Inhalte kann mit berechtigten Messages-API-Anfragen mit Zero Data Retention verwendet werden, da die API Exportinhalte bis zur Zustellung im Speicher hält. Managed Agents sind nicht für Zero Data Retention berechtigt, und die Aktivierung von OpenTelemetry ändert deren Aufbewahrungsbedingungen nicht.
Eine Anfrage kann ihre Token-Nutzung auf mehreren Spans ablegen. Das Summieren aller Spans eines Trace kann die Nutzung daher überzeichnen.
Wenn für eine Messages-API-Anfrage sowohl SDK- als auch API-Spans vorhanden sind, verwenden Sie die API-Quelle. Addieren Sie innerhalb dieser Quelle entweder Request-Spans oder deren Modell-Request-Spans, nicht beide; berücksichtigen Sie Kompaktierungen nach den spezifischen Regeln der Dokumentation. Für Managed Agents sind die relevanten API-Spans Modellanfragen und Outcome-Evaluierungen.
Zustellungswiederholungen können ebenfalls doppelte Spans erzeugen. Deduplizieren Sie anhand der Trace-ID und Span-ID, sofern das Backend dies nicht bereits erledigt.
Exportierte Traces sind Debugging-Aufzeichnungen und kein garantiert vollständiges Abrechnungsbuch. Die Zustellung erfolgt nach Best Effort, und Sampling kann Anfragen auslassen. Anthropic verweist Teams, die eine vollständige Nutzungsverfolgung nach API-Key benötigen, auf die Usage API.
Anthropic nennt Grafana Cloud, Honeycomb, Sentry und Splunk, um Agent-Traces neben Anwendungslogs und Metriken anzuzeigen. Darüber hinaus werden Arize AI, Braintrust, Datadog, Langfuse, LangSmith, New Relic und PostHog für Workflows aufgeführt, die Traces mit Evaluierungen und Qualitätsverbesserungen verbinden. Databricks Unity Gateway wird für Transparenz auf Organisationsebene hervorgehoben.
Dies sind Beispiele und keine ausschließliche Kompatibilitätsliste. Andere Tools können die Daten empfangen, wenn sie den erforderlichen Standard-OTLP-Export akzeptieren.
Die Ankündigung enthält Kundenstatements von Foxglove, Ramp, Sterling Labs und FloQast. Deren Anwendungsfälle umfassen Robotik-Debugging, die Analyse von Markt-Agenten und das Tracing von Buchhaltungsabläufen.
Ramp beschreibt ein internes System namens Reflect, das Langfuse-Traces bewertet und Korrekturen vorschlägt. Laut einem Ingenieur des Unternehmens erzielten einige Agenten 10–20 % niedrigeren Token-Verbrauch und 30 % schnellere Sitzungen. Dies sind von Kunden berichtete Ergebnisse dieses Verbesserungsworkflows; sie sind keine Zusage, dass die bloße Aktivierung des Trace-Exports solche Gewinne erzeugt.
Er sendet standardisierte Spans, die Claude-API-Anfragen, Agent-Turns, Modellaufrufe und unterstützte Tool-Aktivitäten beschreiben, an ein Observability-Backend. Die Funktion befindet sich in der öffentlichen Beta und unterstützt getrennte Wege für API- und SDK-Tracing.
Sie benötigen die Admin-Rolle, um API-Tracing-Ziele in der Claude Console hinzuzufügen oder zu ändern. SDK-Tracing wird im Anwendungscode konfiguriert und benötigt keine besondere Claude-Organisationsberechtigung.
Nein, der Standardmodus ist Metadata only. Full content fügt Prompts und Antworten hinzu, vorbehaltlich der Inhaltslimits und der dokumentierten Beschränkungen für bestimmte Organisationen.
Ja, sofern das API-Ziel die dokumentierten Netzwerk- und Protokollanforderungen erfüllt. Insbesondere benötigt der API-Export einen OTLP/HTTP-Protobuf-Receiver, der über einen öffentlichen HTTPS-Hostnamen auf Port 443 erreichbar ist, und nicht nur einen privaten Collector-Listener.
Ja, wenn der Trace-Kontext propagiert wird und die Spans dasselbe Observability-Backend erreichen. API-Spans für Anfragen an die Claude Platform on AWS erscheinen derzeit stattdessen in eigenen Traces.
Nein, Traces können gesampelt werden, verloren gehen oder mehrfach zugestellt werden. Verwenden Sie für Analysen die dokumentierten Zählregeln und die Usage API, wenn Sie eine vollständige Nutzungsabrechnung benötigen.
Die OpenTelemetry-Beta von Claude verbindet Modellaufrufe und Agent-Tools mit den Tracing-Systemen, die Teams bereits verwenden. API-Tracing legt serverseitige Aktivität offen, während SDK-Tracing Client-Vorgänge und Tools ergänzt; ihre Kombination liefert dort, wo die Trace-Verknüpfung unterstützt wird, die klarste Zeitleiste der Anwendung.
Wählen Sie Inhaltsmodi bewusst, prüfen Sie Kürzungen und den Zustellungszustand und zählen Sie Tokens aus einer einzigen passenden Quelle. Tracing verbessert die Transparenz, doch vollständige Nutzungsabrechnung und Aufbewahrungskontrollen bleiben separate Verantwortlichkeiten.
Starte mit einem Satz und erhalte in wenigen Minuten eine vollständige Website.
