Ausführungsüberwachung und Protokollierung
Ausführungsliste, Echtzeit-Event-Stream, Logs / Kosten / tokens, Fehlerlokalisierung — den Laufstatus im Blick behalten.
Sobald ein Workflow läuft, entscheidet die Frage, ob Sie nachvollziehen können, „was er eigentlich getan und wie viel er gekostet hat“, darüber, ob Sie ihn in die Produktion überführen. Diese Seite behandelt Ausführungsliste, Ausführungsdetails, Echtzeitereignisse, Token- und Kostenerfassung, Export und Daten-Dashboard.
Seite mit der Ausführungsliste
In der linken Navigation „Ausführungsverlauf“. Unterstützt eine Karten- und eine Tabellenansicht; läuft gerade eine Ausführung, aktualisiert sich die Liste automatisch (pausierbar). Filtern und Sortieren:
- Stichwortsuche — nach Ausführungs-ID oder Workflow-Name
- Statusfilter — PENDING / RUNNING / COMPLETED / FAILED / CANCELLED / INTERRUPTED
- Workflow-Filterung – Zeigen Sie nur den Verlauf eines bestimmten Workflows an
- Sortierung — Startzeit / Abschlusszeit / Dauer / Workflow / Status / Fortschritt
Am oberen Rand der Liste gibt es zudem eine Reihe von Schnellfiltern mit Zählern (Laufend / Fehlgeschlagen / Abgeschlossen / Unterbrochen), die per Klick umgeschaltet werden.
Für jeden Datensatz angezeigte Informationen
- Status-Badge + Ausführungs-ID + Workflow-Name
- Fortschrittsbalken und Anzahl abgeschlossener Schritte (z. B. 5/7)
- Startzeit (relative Zeit) und Dauer
- Datensätze im Status RUNNING zeigen zusätzlich den aktuell laufenden Schritt an
- Beendete Datensätze lassen sich direkt inline als JSON / YAML exportieren
Nach Mehrfachauswahl lassen sich laufende Ausführungen im Stapel abbrechen oder beendete Datensätze im Stapel löschen.
PENDING— Erstellt, aber noch nicht gestartet. Ausführungen, die die Parallelitätsobergrenze überschreiten, reihen sich zunächst in diesem Status ein und wechseln automatisch zu RUNNING, sobald vorherige Ausführungen abgeschlossen sind.RUNNING— Mindestens ein Schritt wird ausgeführt.COMPLETED— Alle Schritte sind durchgelaufen (einschließlich der wegen nicht erfüllter condition auf SKIPPED gesetzten Schritte).FAILED— Ein Schritt ist fehlgeschlagen, und die Ausführung endet mit Fehler.CANCELLED— Vom Nutzer manuell abgebrochen.INTERRUPTED— Durch Systemursachen wie einen Serviceneustart unterbrochen. Zum automatischen Fortsetzen siehe die Seite zum automatischen Fortsetzen unter „Nächster Schritt“ weiter unten.
Seite mit Ausführungsdetails
Ein Klick auf eine beliebige Ausführung führt zur Detailseite. Von oben nach unten:
- Kopfzeile — Abbrechen, Aktualisieren, Exportieren (JSON / YAML), Sprung zum zugehörigen Workflow-Editor
- Statuskarte — Status, Fortschritt, Dauer sowie eine Token-Schnellübersicht (gesendet / empfangen / gesamt)
- Tabs des Hauptbereichs (siehe Tabelle unten)
- Der Stream „Ausführungslog“ am Fuß — ein scrollendes Log aller Ereignisse, filterbar nach Level (debug / info / warn / error), nach Stichwort durchsuchbar, mit pausierbarem automatischem Scrollen
| Tabs | Inhalt |
|---|---|
| Schritte | Vertikale Zeitachse: Status, Dauer und Iterationsfortschritt jedes Schritts. Ein Klick öffnet die seitliche Schrittdetailleiste; nach Ende der Ausführung lässt sich ab einem angegebenen Schritt erneut ausführen. |
| Dialog | Fügt Agent-Beiträge, LLM-Ausgaben, Tool-Aufrufe und Systemnachrichten zeitlich zu einem Chatstream zusammen. |
| Externe Nachrichten | Zeigt nur die Sende-/Empfangsdatensätze der IM-Kanäle (Slack / Telegram usw.). |
| DAG | Ein nach Abhängigkeiten gezeichnetes Schrittdiagramm, dessen Laufstatus in Echtzeit eingefärbt wird. |
| Wiedergabe | Spielt den Ablauf dieser Ausführung entlang der Zeitachse erneut ab. |
| Argumentationskette | Der Zwischen-Reasoning-Inhalt des Agents. |
| Artefakt | Alle Artefaktdateien: Vorschau, Download, Einzeldatei-Freigabe oder die Erzeugung eines öffentlichen Links für das gesamte Verzeichnis. |
| Leistung | Die Daueranalyse nach Ende der Ausführung. |
| Debug | Erscheint, wenn ein Breakpoint gesetzt wurde oder eine Debug-Sitzung existiert. |
Seitliche Schrittdetailleiste
Ein Klick auf einen Schritt in der Zeitachse lässt rechts alle Informationen dieses Schritts einblenden: die Unterseiten Ausgabe, Ereignisse, Reasoning, Artefakte und Konversation (Iterations- / Interaktions- / Orchestrierungsschritte haben entsprechende zusätzliche Unterseiten) sowie Start- und Endzeit und die Schaltfläche „Ab diesem Schritt erneut ausführen“. Die Fehlermeldung und Wiederholungsanzahl eines fehlgeschlagenen Schritts sehen Sie ebenfalls hier.
Echtzeit-aktualisierung (WebSocket)
Während sich die Ausführung im Status RUNNING befindet, empfängt die Detailseite über WebSocket inkrementelle Aktualisierungen ohne manuelles Neuladen. Bei Verbindungsabbruch wird automatisch neu verbunden (exponentieller Backoff, höchstens 5 Mal); scheitert es weiterhin, wird automatisch auf Polling alle 2 Sekunden herabgestuft und darauf hingewiesen.
Push-nachrichtentypen
| Typ | Bedeutung |
|---|---|
full_status | Vollständiger Snapshot des Ausführungsstatus |
status_change | Änderung des Ausführungsstatus / Fortschritts |
step_update | Statusaktualisierung eines einzelnen Schritts |
new_event | Ein neues Ausführungsereignis (siehe Ereignistypen unten) |
artifact_found | Erzeugung einer neuen Artefaktdatei |
user_interaction_request | Ein Schritt fordert manuelle Eingabe an; auf der Konversationsseite erscheint ein Antwortfeld |
Liste der Ereignistypen
Der Ereignisstrom jedes Schritts unterscheidet die Ereignisart über das Feld type. Gängige Typen nach Familie aufgeführt:
| Ereignistyp | Bedeutung |
|---|---|
agent_starting / agent_completed / agent_failed | Der Lebenszyklus eines Agent-Schritts |
llm_call_starting / llm_call_completed | Ein LLM-Aufruf; das completed-Ereignis trägt die Token-Zählung dieses Aufrufs |
llm_streaming_starting / llm_streaming_completed / llm_streaming_failed | Streaming-LLM-Ausgabe |
tool_call_starting / tool_call_completed / tool_call_failed | Agent-Tool-Aufruf, inkl. Parameter und Ergebniszusammenfassung |
external_message / im_message / telegram_message | Nachrichtenaustausch der IM-Kanäle |
group_chat_started / group_chat_message / group_chat_summarizing / group_chat_completed | Der Mehr-Agent-Diskussionsverlauf eines group_chat-Schritts |
state_machine_started / state_machine_transition / state_machine_state_completed | Die Zustandsübergänge eines state_machine-Schritts |
agent_based_started / agent_based_completed | Der Delegationsverlauf eines agent_based-Orchestrierungsschritts |
user_interaction_request / user_interaction_message / user_interaction_timeout | Während der Ausführung eine Frage an den Nutzer, den Empfang der Antwort und die Zeitüberschreitung beim Warten |
claude_code_* | Die Streaming-Fortschrittsereignisse der Claude Code-Laufzeit |
Ein Ereignis trägt zugleich ein category-Feld (agent / llm / tool / message / strategy / user_interaction), nach dem der Kategoriefilter der Konversationsseite gruppiert.
Filter der Konversationsansicht
- Stichwortsuche — sucht im Nachrichteninhalt und beim Sprecher
- Nach Agent filtern — nur die Nachrichten eines bestimmten Agents oder Schritts anzeigen
- Kategoriefilter — Agent / LLM / Tool / Externe Nachricht / Strategie / Interaktion
- Auto-Scroll-Schalter — ob bei Eintreffen einer neuen Nachricht ans Ende gescrollt wird
Token und Kosten
- LLM-bezogene Ereignisse erfassen einzeln die input / output-Token; die Statuskarte summiert in Echtzeit und zeigt gesendet / empfangen / gesamt an.
- Nach Ende der Ausführung
GET /api/executions/{executionId}/costschätzt die Kosten dieser Ausführung anhand der Preise der verwendeten Modelle und gibt den Gesamtbetrag und die Aufschlüsselung je Schritt zurück. - Die Kosten werden im Nachhinein anhand des Token-Verbrauchs geschätzt; die Plattform bietet keine Vorab-Kostenschätzung.
Ausführungsprozess exportieren
„Exportieren“ in der Kopfzeile der Detailseite oder in einer Listenzeile exportiert eine Ausführung als JSON- oder YAML-Datei mit Ausführungsstatus, Ergebnis, Leistungskennzahlen sowie einem Snapshot der Workflow-Definition und dem YAML-Quellcode zum Exportzeitpunkt. Sensible Felder wie Passwörter, API Key und Webhook-Adressen werden automatisch durch [REDACTED] ersetzt. Der Dateiname hat die Form execution-process-79621f70-completed.json.
Die Workflow-Definition im Export ist die zum Exportzeitpunkt abgerufene aktuelle Version; wurde der Workflow nach dieser Ausführung geändert, kann sie von der Definition zum Ausführungszeitpunkt abweichen.
Daten-dashboard
Die ausführungsübergreifende Aggregatansicht befindet sich unter Analytics Dashboard: Gesamtzahl der Ausführungen, Erfolgsrate, durchschnittliche Dauer, Gesamt-Token-Verbrauch sowie Ausführungstrend, Statusverteilung und Top-Workflow-Rangliste, mit wählbarem Zeitraum 24 Stunden / 7 Tage / 30 Tage.
Fehlerort
Ist die Ausführung FAILED, suchen Sie zuerst in der Zeitachse den roten Schritt und öffnen die Schrittdetails: Die Fehlermeldung steht auf der Unterseite „Ausgabe“, die Prozessdetails auf der Unterseite „Ereignisse“ (auch das stderr eines code-Schritts steht hier). Wiederholte Schritte zeigen die Wiederholungsanzahl an.
Zum Umgang mit häufigen Fehlern siehe Fehlerbehebung.
Aufbewahrungsfrist
Ausführungsdatensätze (Status, Ergebnis, Ereignisse, Leistungsdaten) und Artefaktdateien werden standardmäßig 90 Tage aufbewahrt und nach Ablauf regelmäßig von der Plattform bereinigt; die genaue Frist richtet sich nach Ihrem Tarif oder Ihrer Deployment-Konfiguration, und eine noch laufende Ausführung wird nicht bereinigt.
Nächster Schritt
- Debuggen von Haltepunkten — Verwenden Sie es, wenn Sie „nicht verstehen können, warum Sie so laufen“
- Fehlerbehebung — Häufige Fehlermeldungen und die zugehörige Behebung
- Automatische Fortsetzung — Wie mit Ausführungen im Status INTERRUPTED umzugehen ist