Traces und Sessions

Sehen Sie einen Agentenlauf als Zeitleiste und ein ganzes Gespräch als eine Session: welche Aufrufe parallel liefen, wo die Zeit hinging, was fehlschlug und was es gekostet hat.

In der Seitenleiste der Konsole (erscheint, sobald die Funktion für Ihr Konto gilt): Traces Öffnen ↗

Schritte

Senden Sie X-Trace-Id bei jedem Aufruf eines Laufs (einer Nutzeranfrage, einer Agentenaufgabe), X-Span-Id als Name des einzelnen Aufrufs und X-Session-Id bei jedem Aufruf eines Gesprächs. Tools mit eigenen Trace- oder Session-Headern wie Claude Code werden ohne Änderungen gruppiert.
Öffnen Sie Traces. Traces und Sessions der letzten 7 Tage stehen dort mit Aufrufen, Dauer und Kosten, die jüngste Anfrage zuerst; ein Klick auf eine Spaltenüberschrift sortiert die Liste danach. Mit Umbenennen auf der Seite eines Traces oder einer Session vergeben Sie einen Namen, den der ganze Workspace sieht. Die Suche nimmt eine vollständige ID oder einen beliebigen Teil eines Namens.
Öffnen Sie eine Trace für ihr Wasserfalldiagramm: ein Balken je Aufruf, zeitlich angeordnet, und die Abschnitte, in denen Ihr eigener Code lief, als Ihre App. Parallele Aufrufe überlappen sich. Ein fehlgeschlagener Aufruf ist schraffiert und zeigt seinen Statuscode; wählen Sie einen Aufruf für Latenz, Tokens und Kosten.
Öffnen Sie eine Session für Summen, Modelle, Fehler nach Statuscode und Aufrufe im Zeitverlauf. Aufrufe in Protokollen ansehen listet jede Anfrage der Session.

Grenzen und Fallstricke

Traces und Sessions entstehen aus Ihrem Anfrageprotokoll und umfassen daher dieselben 90 Tage und dieselben Aufrufe.
Ein fehlgeschlagener Aufruf zeigt den Statuscode, den Ihr Code bekommen hat, auch wenn der Fehler vom Anbieter kam.
Die IDs bestimmen Sie: je bis zu 128 druckbare ASCII-Zeichen. Sie kommen in der Antwort zurück und gehen nie an den Anbieter.
Wenn ein Coding-Agent seine Sub-Agents kenntlich macht, listet eine Sitzung ihre Agents mit Aufrufen und Kosten auf, und ein Trace markiert Komprimierungen und Nebenaufrufe und nennt die Tools, die zwischen zwei Aufrufen liefen.
Eine Anfrage, die das Gateway mehrfach versuchen musste, führt ihre Versuche im Detail auf: Modell, Status und Dauer jedes Versuchs. Im Wasserfall bilden die fehlgeschlagenen Versuche den schraffierten Anfang ihres Balkens.

API-Referenz zum selben Thema: Request-Header