Zum Inhalt springen

Instant Replay für Bug Reports: Sichere den Bug, der schon passiert ist

Aktualisiert

Mit Instant Replay in Midge meldest du einen Bug, nachdem er passiert ist. Ist die Funktion für eine Website eingeschaltet, hält Midge eine rollierende Aufzeichnung der letzten 30 bis 120 Sekunden der Seite, und ein Klick sichert dieses Zeitfenster als Bug Report mit angehängten Konsolen-Logs, Netzwerk-Requests und Nutzeraktionen. Die Funktion ist standardmäßig aus, und du schaltest sie pro Website oder für alle Websites ein.

Das übliche Problem mit sporadischen Bugs ist das Timing. Ein Dropdown flackert, ein Toast zeigt die falsche Meldung, eine Tabelle springt, und bis du einen Rekorder gestartet hast, ist alles vorbei. Mit Instant Replay musst du den Bug nicht nachstellen. Du hast ihn schon.

So funktioniert es

Instant Replay nimmt kein Video auf. Es zeichnet die Seite selbst auf: das DOM, also die Struktur aus Elementen und Text, die der Browser zeichnet. Midge speichert einen Snapshot der Seite und danach jede Änderung daran, etwa einen hinzugefügten Knoten, eine gewechselte Klasse oder aktualisierten Text, zusammen mit Scrollen und Klicks. Der Replay-Player baut die Seite aus dieser Aufzeichnung Schritt für Schritt wieder auf.

Du wählst, wie lang der Puffer ist, von 30 bis 120 Sekunden. Ältere Änderungen fallen hinten heraus, wenn neue hinzukommen, sodass der Speicherverbrauch begrenzt bleibt. Wenn du klickst, um ein Replay zu sichern, nimmt Midge den aktuellen Puffer, ergänzt die Konsolen- und Netzwerk-Logs aus demselben Zeitraum und lässt dich einen Report erstellen.

Warum kein durchgehendes Video?

Wir haben überlegt, den Bildschirm ständig aufzunehmen und die letzten zwei Minuten zu behalten. Aus zwei Gründen haben wir uns dagegen entschieden.

  1. Chrome zeigt eine Freigabe-Anzeige, solange eine Aufnahme läuft. Eine dauerhafte Leiste „Dieser Tab wird geteilt“ lenkt ab und gewöhnt Leute daran, eine Warnung zu ignorieren, die zu ihrem Schutz da ist.
  2. Video kostet CPU, Arbeitsspeicher und Akku. Ununterbrochen Frames auf jedem Tab zu kodieren, würde deinen Browser langsamer machen, und das ist das Gegenteil dessen, was ein Debugging-Tool tun sollte.

Die DOM-Aufzeichnung vermeidet beides. Sie ist trotzdem schwerer als die Log-Erfassung, weil sie eine Kopie des Seiteninhalts hält. Deshalb lassen wir sie aus, bis du dich dafür entscheidest.

Einschalten

Instant Replay ist standardmäßig aus. Du kannst es einschalten:

  • für alle Websites, wenn du den ganzen Tag viele verschiedene Apps testest, oder
  • pro Website, zum Beispiel nur auf staging.yourapp.com und localhost.

Die Liste für „niemals erfassen“ hat weiterhin Vorrang. Steht eine Website darauf, läuft Midge dort überhaupt nicht, auch kein Replay. Ein guter Start: Schalte Replay auf deinen Staging- und lokalen Entwicklungs-Hosts ein, lass es überall sonst aus und setz deine Bank und dein E-Mail-Postfach auf die Liste für „niemals erfassen“.

Was ein Replay-Report enthält

Ein gesichertes Replay ist ein vollständiger Midge-Report. Jede Aufnahme enthält Konsolen-Logs, Netzwerk-Requests, Nutzeraktionen und Geräteinfos. Ein Replay ist da keine Ausnahme. Wer den Link öffnet, sieht:

  • die wiedergegebene Seite in einem Player,
  • Konsolenmeldungen aus denselben 30 bis 120 Sekunden, inklusive nicht abgefangener Fehler (siehe Konsolen-Logs),
  • fetch-, XHR- und WebSocket-Traffic mit Bodies und Timings (siehe Netzwerk-Logs),
  • Klicks, Seitenwechsel und die Felder, in die du getippt hast, ohne den Text,
  • Browser, Betriebssystem, Fenstergröße und die URL der Seite.

Datenschutz in Replays

Weil ein Replay Seiteninhalt enthält, sind die Regeln hier strenger als bei einem Tab-Video:

  • Alle Eingabewerte werden maskiert. Was in ein Feld getippt wurde, erscheint nicht im Replay.
  • Text auf der Seite wird durchsucht, mit denselben Mustern wie bei den Logs: JWTs, Kartennummern, die den Luhn-Check bestehen, API-Keys und private Schlüssel werden entfernt, E-Mail-Adressen und internationale Telefonnummern werden zur Hälfte maskiert.
  • Auch die Logs werden geschwärzt. Passwörter, Kartennummern, Tokens und Cookies werden in deinem Browser geschwärzt, bevor irgendetwas dein Gerät verlässt.

Die Seite zur Schwärzung listet jede Regel auf. Die Schwärzung ist regelbasiert, ein ungewöhnliches Geheimnis, das als reiner Text auf dem Bildschirm steht, wird also womöglich nicht erkannt. Teams können eigene Feldnamen ergänzen.

Grenzen, die du kennen solltest

Ein DOM-Replay ist eine Rekonstruktion, keine Pixelkopie. Die meisten Seiten werden originalgetreu wiedergegeben, aber Inhalte, die nicht im DOM beschrieben sind, etwa Zeichnungen auf einem Canvas oder Medien, die in der Seite abgespielt werden, sehen womöglich nicht genau so aus wie vorher. Ist der Bug auf diese Weise visuell, nimm stattdessen eine Bildschirmaufnahme.

Außerdem deckt ein Replay nur die Zeit ab, in der es lief. Hast du es vor einer Minute für eine Website eingeschaltet, enthält der Puffer höchstens diese eine Minute.

Wann sich Instant Replay lohnt

  • Wackelige UI-Bugs, die du nicht auf Knopfdruck nachstellen kannst.
  • Exploratives Testen, bei dem du erst hinterher weißt, dass es ein Bug war.
  • Demos und Walkthroughs auf Staging, wenn vor einer Kollegin etwas kaputtgeht.

Für Bugs, die du jederzeit nachstellen kannst, reicht oft eine normale Aufnahme oder ein Screenshot mit Markierungen. Allgemeine Tipps, was in beiden Fällen hineingehört, findest du in So meldest du einen Bug. Und wenn du von einem Kollegen, der Midge nicht laufen hatte, nur die Netzwerkseite eines Vorfalls brauchst, bitte ihn um eine HAR-Datei und bereinige sie mit dem kostenlosen HAR Sanitizer, bevor sie in einem Ticket landet.

Midge ist kostenlos: unbegrenzte Aufnahmen, Videos bis 15 Minuten und kein Wasserzeichen.

Häufige Fragen

Ist Instant Replay ein Video?
Nein. Es zeichnet Änderungen an der Seitenstruktur (dem DOM) auf und baut sie in einem Replay-Player wieder auf. Das ist leichter als Video und vermeidet die dauerhafte Bildschirmfreigabe-Anzeige von Chrome.
Ist Instant Replay standardmäßig eingeschaltet?
Nein. Es ist aus, bis du es einschaltest, entweder für alle Websites oder nur für die, die du auswählst. Die Erfassung von Konsole und Netzwerk funktioniert auch ohne.
Wie weit reicht es zurück?
Du wählst ein Zeitfenster zwischen 30 und 120 Sekunden. Wenn du ein Replay sicherst, behält Midge so viele Sekunden vor dem Moment deines Klicks.
Zeichnet Instant Replay auf, was ich tippe?
Nein. Alle Eingabewerte werden im Replay maskiert, und der Text auf der Seite durchläuft dieselben Schwärzungsregeln wie die Logs. Tokens, Kartennummern und ähnliche Werte werden also entfernt.