Zum Hauptinhalt springen

Das Protokoll lesen

Die Schaltfläche Protokoll (Log) in der Kopfzeile einer Detailseite für Ausführungen öffnet ein Popover, das alles anzeigt, was der Runner während der Ausführung Ihrer Tests aufgezeichnet hat. Dies ist Ihre erste Anlaufstelle, wenn etwas nicht wie erwartet funktioniert hat – das Protokoll sagt Ihnen, was der Runner getan hat, in welcher Reihenfolge und was die KI-Agenten darüber gedacht haben.

Im Protokoll können Sie auch einen ausführlichen Rerun (Verbose Rerun) für den Support auslösen und das resultierende Paket herunterladen.

Das Protokoll öffnen

Die Protokoll-Schaltfläche befindet sich im rechten Bereich der Kopfzeile der Ausführungsdetails (Artikelsymbol). Sie ist nur aktiviert, wenn im linken Bereich ein Testfall ausgewählt ist – die meisten Protokolleinträge beziehen sich auf einen bestimmten Test, daher öffnet sich das Popover immer mit dem Fokus auf einen Test gleichzeitig.

Das Popover schwebt über der Seite und wird durch Klicken außerhalb geschlossen. Es kann geöffnet bleiben, während Sie durch den Rest der Ausführung klicken: Das Auswählen eines anderen Schritts in der Zeitleiste aktualisiert die für diesen Schritt angezeigten Protokolleinträge.

Die zwei Registerkarten

Innerhalb des Popovers sind die Einträge in zwei Registerkarten unterteilt.

Test

Schritt-für-Schritt-Einträge für den aktuell ausgewählten Testfall. Jede Zeile zeigt:

  • Schrittnummer — der Index des Schritts im Test (stimmt mit den Nummern im linken Bereich und der Schritt-Zeitleiste überein).
  • Zeit — Sekunden seit Beginn der Ausführung (damit Sie sehen können, wie lange jeder Schritt gedauert hat).
  • Nachricht — die Protokollzeile. Das Symbol auf der linken Seite zeigt den Schweregrad an.

Schweregrad-Symbole:

SymbolEbeneWann es erscheint
ℹ️InfoDie normalen Kommentare des Runners – "Element X gefunden", "Cache-Treffer", "Assertion bestanden".
⚠️WarnungEtwas Ungewöhnliches, aber Behebbares – mehrere passende Elemente, ein erneuter Versuch, ein Fallback-Modell wurde verwendet.
FehlerDer Schritt ist fehlgeschlagen oder etwas Fatales ist passiert.
🔧DebugBesonders ausführliche interne Ereignisse. Normalerweise nur vorhanden, wenn der Lauf im ausführlichen Modus gestartet wurde.

Ausführung

Einträge, die nicht an einen einzelnen Schritt gebunden sind – Warteschlangenereignisse, Vorbereitung, Abschluss, Abbruch, durch ein externes System ausgelöste Wiederholungen, Browser-Prozessprotokolle. Die Spalten hier sind einfach Zeit, Typ, Nachricht.

Wenn ein Lauf nie gestartet wurde (z. B. weil er in der Warteschlange hing und abgebrochen wurde), befinden sich alle nützlichen Informationen auf der Registerkarte Ausführung und die Registerkarte Test kann leer sein.

Symbolleiste

Das Popover verfügt über eine eigene Symbolleiste.

SteuerelementWas es bewirkt
Tab-UmschalterWechseln zwischen Test- und Ausführungsansicht.
Schrittfilter (nur Test-Tab)Trichter-Symbol. Öffnet eine Checkliste aller Schritte im Test; deaktivieren Sie Schritte, um deren Protokollzeilen auszublenden. Nützlich, wenn ein Test 30+ Schritte hat und Sie nur einige wenige betrachten möchten.
Dev ConsoleNur sichtbar, während die Ausführung läuft. Öffnet oder fokussiert das Fenster der Entwicklerkonsole.
In die Zwischenablage kopierenKopiert die aktuell sichtbaren Protokolleinträge als Markdown-Tabelle. Das Format ist portabel: Fügen Sie es direkt in eine Confluence-Seite, eine Slack-Nachricht, ein GitHub-Issue oder ein Support-Ticket ein.
AktualisierenLädt das Protokoll vom Backend neu. Das Protokoll-Popover aktualisiert sich nicht automatisch; wenn die Ausführung noch läuft, verwenden Sie Aktualisieren, um neue Einträge zu sehen.
Support-Informationen sammelnLöst einen ausführlichen Rerun aus. Nur sichtbar, wenn die Mandantenrichtlinie dies zulässt.
Support-Informationen herunterladenSichtbar, nachdem ein ausführlicher Rerun abgeschlossen ist – lädt das Paket herunter.

Eine Protokollzeile lesen

Protokolle werden für menschliche Leser geschrieben, nicht für maschinelles Parsen. Jede Zeile beschreibt in der Regel eine Entscheidung oder eine Aktion: Welches Modell wurde aufgerufen, was hat es zurückgegeben, welches Element wurde ausgewählt, wurde ein Cache-Eintrag verwendet, wurde ein erneuter Versuch ausgelöst. Es gibt kein formales Schema, aber die Muster sind konsistent genug, dass Sie nach ein paar Ausführungen wissen, worauf Sie achten müssen.

Ein typischer Schritt in einem erfolgreichen Lauf könnte etwa so aussehen:

Step 2 0.21s ℹ Resolved step description: "Click on the 'Save' button"
Step 2 0.34s ℹ Element search: 'Save button' → 3 candidates, picked highest-rated
Step 2 0.41s ℹ Cache hit (semantic match) for element 'Save button'
Step 2 0.55s ℹ Click executed
Step 2 0.62s ℹ Step PASSED

Wenn etwas schief geht, deutet der umgebende Kontext normalerweise auf die Ursache hin:

Step 5 1.10s ℹ Element search: 'Order total' → 0 candidates
Step 5 1.32s ⚠ No candidates found; retrying with relaxed selector
Step 5 1.78s ℹ Element search (relaxed): 'Order total' → 4 candidates
Step 5 2.05s ⚠ Picked candidate with quality 0.42 (below comfortable threshold)
Step 5 2.31s ❌ Assertion FAILED: expected number, got empty string

Meistens benötigen Sie nicht jede Protokollzeile – öffnen Sie das Protokoll, scrollen Sie zum fehlgeschlagenen Schritt (oder verwenden Sie den Filter, um nur diesen Schritt anzuzeigen) und lesen Sie die letzten Zeilen vor dem Fehler.

Kopieren für den Support

Die Schaltfläche In die Zwischenablage kopieren erzeugt eine Markdown-Tabelle, die ungefähr so aussieht:

| Step | Time | Severity | Message |
|------|--------|----------|----------------------------------------|
| 2 | 0.21s | INFO | Resolved step description: ... |
| 2 | 0.34s | INFO | Element search: 'Save button' → ... |
...

Das Einfügen in ein Ticket oder Chat-Tool behält die Spaltenausrichtung bei. Verwenden Sie dies, wenn Sie bestimmte Protokollinhalte mit einem Kollegen teilen möchten, aber nicht die gesamte Ausführung erfassen wollen.

Wenn Sie das vollständige Bild benötigen (Screenshots, KI-Kommunikation, Seiten-HTML, …), verwenden Sie stattdessen den unten beschriebenen Ablauf für Support-Informationen – das Markdown-Kopieren erfasst nur die Protokollzeilen.

Ausführlicher Rerun (Verbose Rerun)

Die Schaltfläche Support-Informationen sammeln ist die empfohlene Methode, um ein Problem mit dem Support-Team zu teilen. Sie führt den Test mit ausführlicher Protokollierung erneut aus und erfasst weitaus mehr Details als ein normaler Lauf.

Wenn Sie auf die Schaltfläche klicken, fragt ein Dialog, welche Kategorien von zusätzlichen Daten erfasst werden sollen:

  • KI-Kommunikation — jede an die KI gesendete Eingabeaufforderung und jede Antwort. Die nützlichste Kategorie, um zu debuggen, warum die KI getan hat, was sie getan hat.
  • HTTP-Kommunikation — jede Netzwerkanfrage, die der Browser gestellt hat (Anfrage-URL, Methode, Header, Status, Body). Nützlich, wenn der Testfehler eher browserseitig oder backendseitig als KI-seitig aussieht.
  • HTML-Inhalt — vollständige HTML-Snapshots der Seite bei jedem Schritt. Nützlich, wenn ein Element nicht gefunden wurde und Sie überprüfen möchten, ob es tatsächlich vorhanden war.
  • Speicher-Snapshot — Laufzeit-Speicherzustand. Nützlich zur Diagnose von Speicherlecks oder übermäßigem Ressourcenverbrauch.

Wählen Sie die Kategorien aus, die zu Ihrem vermuteten Problem passen, bestätigen Sie, und der Runner startet eine neue Ausführung mit den gewählten Kategorien. Die ursprüngliche Ausführung bleibt davon unberührt.

Wenn der ausführliche Rerun abgeschlossen ist (bestanden oder fehlgeschlagen – beides ist nützlich), ersetzt die Schaltfläche Support-Informationen herunterladen die "Sammeln"-Schaltfläche in der Symbolleiste. Klicken Sie darauf, um ein ZIP-Paket herunterzuladen. Siehe Hilfe erhalten, was das Paket enthält und wie Sie es teilen können.

tipp

Lösen Sie den ausführlichen Rerun so schnell wie möglich nach einem Fehler aus – vorzugsweise während sich die zu testende Anwendung noch im selben Zustand befindet, der den Fehler verursacht hat. Lange Verzögerungen zwischen dem ursprünglichen Fehler und dem ausführlichen Rerun verringern die Chance, genau das gleiche Problem zu reproduzieren.

hinweis

Die Schaltfläche Support-Informationen sammeln erscheint nur, wenn der Mandant Detailed Service Request aktiviert hat und der Administrator Zugriff gewährt hat. Wenn Sie sie nicht sehen, bitten Sie Ihren Mandantenadministrator, sie unter Mandanteneinstellungen zu aktivieren.

Tipps

  • Lesen Sie das Protokoll neben den Screenshots. Viele Probleme sind leichter zu erkennen, wenn Sie eine Protokollzeile („Kandidat mit Qualität 0.42 ausgewählt“) mit dem Screenshot korrelieren, den der Runner an diesem Punkt gesehen hat.
  • Verwenden Sie den Schrittfilter bei langen Tests. Ein Test mit 60 Schritten erzeugt viele Protokollzeilen; das Trichter-Symbol lässt Sie auf den fehlgeschlagenen Schritt plus einige Kontextschritte fokussieren.
  • Aktualisieren Sie während der Laufzeit. Das Popover streamt keine Updates von selbst – für eine Live-Ansicht klicken Sie regelmäßig auf Aktualisieren.
  • Schweregrad ≠ Grundursache. Eine Warnung geht oft dem Fehler voraus, der den Schritt tatsächlich fehlschlagen lässt. Lesen Sie zuerst die Warnzeilen um einen Fehler herum.
  • null-Protokollzeilen sind normal. Der Runner zeichnet einige Ereignisse auf, die keinen Nachrichtentext haben (z. B. Screenshot gemacht). Sie erscheinen nur mit einem Schweregrad-Symbol und einer Zeitangabe.