--- title: Sessions untersuchen und Nutzung verfolgen url: https://platform.claude.com/docs/de/managed-agents/session-observability description: Untersuche eine Session in der Claude Console, lies ihre Token-Nutzung und Listenkosten ab und debugge unerwartetes Agentenverhalten. featureMetadata: topic: title: Managed Agents url: https://platform.claude.com/docs/en/managed-agents/overview status: beta betaHeader: managed-agents-2026-04-01 --- Verwende den Session-Viewer in der Claude Console, um zu untersuchen, was ein Agent in einer Session getan hat, ohne Code schreiben zu müssen. Verwende die `usage` (csharp, go: `Usage`)-Summen der Session, um zu sehen, was diese Arbeit verbraucht hat. ## Eine Session in der Console untersuchen Der Session-Viewer ist nur für Developer und Admins zugänglich. Um ihn zu öffnen, gehe in der Claude Console zur Seite [Sessions](https://platform.claude.com/sessions) (`platform.claude.com/sessions`). Die Liste zeigt jede Session im Workspace mit ihrem Status, Agenten, ihrer Token-Nutzung, ihren Kosten und ihrem Erstellungszeitpunkt. Wähle eine Session aus, um sie zu öffnen. Der Session-Viewer zeigt: * **Timeline-Minimap:** Eine zoombare Übersicht über die Aktivität der Session im Zeitverlauf, mit einer Spur pro Thread in [Multiagent](https://platform.claude.com/docs/de/managed-agents/multiagent-orchestration)-Sessions. Wähle eine Spur aus, um diesen Thread anzuzeigen, oder wähle eine Markierung aus, um zu ihrem Event zu springen. * **Transkript:** Die Konversation gruppiert nach Modellanfrage, einschließlich Nachdenken, Tool-Aufrufen mit ihren Eingaben und Ergebnissen sowie Nachrichtentext, während er gestreamt wird. Du kannst die Events filtern und sie als JSON kopieren oder herunterladen. * **Inspector:** Ein in der Größe veränderbares Seitenpanel mit Details zur Session, in fünf Tabs. | Inspector-Tab | Was er zeigt | | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Session** | Die Details und Metadaten der Session, ihre kumulativen Kosten im Zeitverlauf und die Ausgaben im Verhältnis zum [Budget](https://platform.claude.com/docs/de/managed-agents/budgets) der Session, sofern eines festgelegt ist. | | **Events** | Jedes rohe Event im aktuellen Thread, in der Reihenfolge, in der der Server es gesendet hat. Wähle ein Event aus, um sein JSON zu sehen. Eine Nachricht, die gestreamt wurde, während die Seite geöffnet war, hat außerdem eine **Deltas**-Ansicht ihrer [Event-Deltas](https://platform.claude.com/docs/de/managed-agents/event-deltas). | | **Tools** | Die Tools, mit denen die Agenten der Session konfiguriert sind, zusammen mit Aufrufzahlen, Fehlschlägen und medianer Dauer. Wähle ein Tool aus, um seine Aufrufe zu sehen und zu einem davon im Transkript zu springen. | | **Resources** | Eingebundene [Dateien](https://platform.claude.com/docs/de/managed-agents/files), [Repositories](https://platform.claude.com/docs/de/managed-agents/github) und [Memory Stores](https://platform.claude.com/docs/de/managed-agents/memory) an ihren Container-Pfaden, einschließlich der Memories in jedem Store und der Änderungen, die diese Session daran vorgenommen hat. Listet außerdem Dateien auf, die der Agent nach `/mnt/session/outputs` geschrieben hat, sowie die [Skills](https://platform.claude.com/docs/de/managed-agents/skills), die an die Agenten der Session angehängt sind. | | **Threads** | Jeder Thread mit seinem Status, seiner Kontextgröße und seinen Kosten. Wähle einen Thread aus, um seine Details anzuzeigen, etwa den Agenten, das Modell, die Kontextnutzung und die Kosten. | Hänge `?event={event_id}` an eine Session-URL an, um die Session bei einem bestimmten Event zu öffnen. Mit `ant beta:sessions connect` kannst du denselben Viewer über die `ant`-CLI öffnen oder die Session in deinem Terminal verfolgen. Siehe [Von deinem Terminal aus eine Verbindung zu einer Managed-Agents-Session herstellen](https://platform.claude.com/docs/de/cli-sdks-libraries/cli/sessions-connect). ## Nutzung verfolgen Das Session-Objekt enthält ein Feld `usage` mit der kumulierten Nutzung der Session: Token-Zählungen, Server-Tool-Nutzung, aktive Zeit und die nachverfolgten Listenkosten. Rufe die Session ab, nachdem sie in den Leerlauf gegangen ist, um die neuesten Gesamtwerte zu lesen. ```json { "id": "sesn_01...", "status": "idle", "usage": { "input_tokens": 5000, "output_tokens": 3200, "cache_read_input_tokens": 20000, "cache_creation": { "ephemeral_5m_input_tokens": 2000, "ephemeral_1h_input_tokens": 0 }, "list_cost": { "amount": "187", "currency": "USD" }, "active_seconds": 342.5, "server_tool_use": { "web_search_requests": 3, "web_fetch_requests": 0 } } } ``` | Feld | Beschreibung | | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `input_tokens` | Nicht gecachte Eingabe-Token über alle Modellaufrufe in der Session hinweg. | | `output_tokens` | Gesamte Ausgabe-Token über alle Modellaufrufe in der Session hinweg. | | `cache_read_input_tokens` | Aus dem Prompt-Cache gelesene Token. | | `cache_creation` | Token für die Cache-Erstellung, aufgeschlüsselt nach Cache-Lebensdauer (`ephemeral_5m_input_tokens` und `ephemeral_1h_input_tokens`). | | `list_cost` | Der kumulative Verbrauch der Session, bepreist zu öffentlichen Listenpreisen, als ganze Zahl von Cent in einem String, mit einem Währungscode. | | `active_seconds` | Die kumulative Zeit, in der in der Session mindestens ein Thread lief. Überlappende Aktivität gleichzeitiger Threads wird einmal gezählt. Die Laufzeitkosten der Session werden auf Basis dieser Dauer berechnet. | | `server_tool_use` | Anzahl der serverseitig ausgeführten Tool-Anfragen, für die Preisberechnung. Websuche-Anfragen fließen pro Anfrage in die Listenkosten ein. Web-Fetch-Anfragen verursachen keine Gebühr pro Anfrage und werden nicht gemessen, daher zeigt `web_fetch_requests` den Wert `0`. | Cache-Einträge verwenden standardmäßig eine TTL von 5 Minuten, sodass direkt aufeinanderfolgende Turns innerhalb dieses Zeitfensters von Cache-Lesevorgängen profitieren, die die Kosten pro Token senken. Das `stats`-Objekt der Session hat ein eigenes `active_seconds`, das die eigene aktive Zeit jedes Threads summiert, anstatt überlappende Aktivität einmal zu zählen. ### Nutzung pro Thread Auch das eigene `usage` jedes [Session-Threads](https://platform.claude.com/docs/de/managed-agents/session-threads) enthält `list_cost` und `active_seconds`. Die Werte pro Thread werden unabhängig gerundet und schließen die Laufzeitkosten der Session aus, sodass sie sich nicht exakt zum `list_cost` der Session summieren. Der Wert der Session ist der maßgebliche. ### Nutzung aus dem Stream lesen Du musst die Session nicht abfragen, um diese Summen zu beobachten. Das `session.usage`-Event enthält denselben kumulierten Snapshot im Session-Stream und im Event-Verlauf. Der Snapshot enthält das `usage` (csharp, go: `Usage`)-Objekt sowie das `budget` (csharp, go: `Budget`) der Session, falls die Session eines hat. Das Event wird bei Übergängen in den Leerlauf ausgegeben, nicht nach einem Timer: * Die Session gibt eines unmittelbar aus, bevor sie in den Leerlauf wechselt, unabhängig vom Stop-Grund. * Die Session gibt eines aus, wenn ein Thread bei einem [Session-Budget](https://platform.claude.com/docs/de/managed-agents/budgets) pausiert. ### Ein Ausgabenlimit durchsetzen Um ein Ausgabenlimit durchzusetzen, lege ein Session-Budget fest, anstatt die Nutzung abzufragen und die Session selbst zu stoppen. Die Plattform bepreist den Verbrauch der Session kontinuierlich und pausiert jeden Thread vor seiner nächsten Modellanfrage, sobald die Listenkosten die Obergrenze erreichen. Siehe [Wenn eine Sitzung ihr Budget erreicht](https://platform.claude.com/docs/de/managed-agents/budgets#when-a-session-reaches-its-budget), um zu sehen, wie das im Stream aussieht. ## Tipps zum Debugging * **Session-Events prüfen:** Die Session meldet Fehler über [`session.error`](https://platform.claude.com/docs/de/managed-agents/reference#event-types)-Events. * **Tool-Ergebnisse überprüfen:** Fehlschläge bei der Tool-Ausführung erklären oft unerwartetes Agentenverhalten. Der **Tools**-Tab des Inspectors zeigt die Fehlschläge jedes Tools. * **System-Prompts verwenden:** Füge dem System-Prompt Logging-Anweisungen hinzu, damit der Agent zusammenfasst, was er getan und was er gefunden hat. * **Fehlerbehebung bei Vorschauen:** Wenn sich ein Stream, der Event-Deltas aktiviert, nicht wie erwartet verhält, siehe [Fehlerbehebung bei Vorschauen](https://platform.claude.com/docs/de/managed-agents/event-deltas#troubleshoot-previews). ## Nächste Schritte Sende Events, streame Antworten und unterbrich oder lenke deine Session während der Ausführung um. Begrenze die Ausgaben einer Session mit einem festen Dollar-Budget, das zu öffentlichen Listenpreisen durchgesetzt wird.