Bugreport-Generator

Aus einer Aufnahme einen verwertbaren Bericht erstellen

Laden Sie die Bildschirmaufnahme des Fehlers. Spielen Sie sie ab, und markieren Sie jeden relevanten Moment. Der Zeitstempel wird erfasst, ein Frame aus dem Video an dieser Stelle aufgenommen und der Schritt in eine nummerierte Liste eingefügt.

Schreiben Sie die Zusammenfassung, was Sie erwartet haben und was stattdessen passiert ist. Kopieren Sie anschließend das Ganze als Markdown für GitHub, als Jira-Markup oder als reinen Text heraus. Die Browser- und Bildschirmdetails sind bereits vorausgefüllt.

Die Aufnahme verlässt niemals Ihren Computer. Sie wird aus einer lokalen Datei abgespielt und Frames werden direkt auf Ihrem Gerät gerendert - was besonders wichtig ist, wenn der Fehler in einem unveröffentlichten Build oder dem Konto eines Kunden auftritt.

Warum dies keine KI zur Berichterstellung verwendet

Ein Modell, das eine Bildschirmaufzeichnung beobachtet, kann beschreiben, was es sieht. Es kann nicht wissen, was Sie erwartet haben, und das ist die Hälfte eines Fehlerberichts, die darüber entscheidet, ob jemand darauf reagieren kann.

“Bestätigen geklickt, das Rechnungsfeld war leer” ist eine Beobachtung. Ob das ein Fehler ist, hängt ausschließlich davon ab, was dort hätte erscheinen sollen, und die einzige Person, die das weiß, sind Sie. Ein Tool, das erwartetes Verhalten aus einem Video generiert, rät und präsentiert die Vermutung als Ergebnis, was schlimmer ist, als das Feld leer zu lassen, da eine plausible falsche Erwartung einen Entwickler auf den falschen Weg führt.

Die Aufteilung hier ist also bewusst. Das Tool erledigt die mechanische Arbeit, die es genau ausführen kann: Zeitstempel, Frames, Umgebung, Formatierung, Nummerierung. Sie liefern die Beurteilung. Das dauert etwa eine Minute, und das Ergebnis ist ein Bericht, zu dem Sie niemand mehr befragen muss.

Die drei Dinge, die Berichte normalerweise übersehen

Nachdem ich viele magere Fehlerberichte gelesen habe, treten immer wieder dieselben Lücken auf, und alle drei sind eher mechanischer als schwieriger Natur.

Zeitstempel. Ein Bericht, der besagt “siehe das angehängte Video”, zwingt den Leser, vier Minuten lang zuzusehen, um den Moment zu finden. Ein Schritt, der angibt, dass es um 1:12 Uhr geschah, tut dies nicht.

Umgebung. Browser, Betriebssystem, Bildschirmgröße. Jeder weiß, dass es dazugehört, und fast niemand tut es, weil es bedeutet, ein Einstellungsfeld zu öffnen, während man gerade in Gedanken versunken ist. Es wird hier aus Ihrem Browser gelesen und ist bereits im Bericht ausgefüllt, und Sie können es korrigieren.

Standbilder. Ein Frame zum Zeitpunkt des Fehlers ist das, was in einer Liste von zwanzig Problemen gescannt wird. Frames manuell aus einem Video zu ziehen, ist mühsam genug, dass die Leute es überspringen, daher geschieht es automatisch bei jedem Schritt, den Sie markieren.

Was genau erfasst wird

Jeder markierte Schritt zeichnet die exakte Wiedergabezeit und einen JPEG-Frame aus dem Video zu diesem Zeitpunkt auf, verkleinert, um den Bericht leicht zu halten. Sie können die Frames herunterladen, um sie dem Problem anzuhängen.

Die Umgebung stammt vom Browser: dessen Name und Version, das Betriebssystem, die Bildschirmgröße mit ihrem Pixelverhältnis und die Größe des Viewports. Browser melden heute weniger über sich selbst als früher, sodass einige dieser Informationen unbekannt bleiben können, und jedes Feld ist bearbeitbar statt gesperrt.

Nichts wird aus den Pixeln abgeleitet. Das Tool versucht nicht, Fehlertext vom Bildschirm abzulesen oder zu erraten, welches Element Sie geklickt haben, denn dies unzuverlässig zu tun, ist schlimmer, als es nicht zu tun.

Die Struktur, die es ausfüllt

Die Ausgabe folgt der Form, auf die sich ein Fehlerbericht geeinigt hat, da Tracker und die Personen, die sie lesen, dies erwarten. Wenn Sie nach einer Vorlage für einen Fehlerbericht gesucht haben, ist dies eine, die bereits ausgefüllt ankommt, anstatt eine, die Sie einfügen und anstarren müssen.

Zuerst die Zusammenfassung, in einer einzigen Zeile, denn diese Zeile ist das, was jemand in einer Liste von dreißig Problemen scannt, und sie entscheidet, ob Ihr Problem heute geöffnet wird.

Dann nummerierte Schritte mit dem Zeitcode für jeden, erwartetes Verhalten, tatsächliches Verhalten und die Umgebung. Diese Reihenfolge ist keine Dekoration. Ein Leser prüft die Schritte, um zu sehen, ob es reproduzierbar ist, das erwartete und tatsächliche Paar, um zu sehen, ob es wirklich ein Fehler ist, und die Umgebung, um zu sehen, ob es deren ist. Das Vergraben einer dieser Informationen führt zu unnötigen Rückfragen.

Was eine leere Vorlage nicht kann, ist, sich selbst auszufüllen, was der Teil ist, der dazu führt, dass Leute sie überspringen. Hier kommen die Schritte, Zeitcodes, Frames und die Umgebung ausgefüllt an, und Sie schreiben die drei Felder, die ein Tool wirklich nicht wissen kann.

Vor der Aufnahme

Der Bericht ist nur so gut wie die Aufnahme - und zwei Gewohnheiten machen den Unterschied.

Starten Sie von einem definierten Zustand aus. Eine Aufnahme, die mitten in einer Sitzung beginnt, lässt den Leser im Unklaren darüber, was zuvor geschah; dadurch sind die Schritte nicht mehr reproduzierbar. Beginnen Sie auf einer Anmeldeseite, einer neu geladenen Seite oder einem klar beschriebenen Ausgangspunkt.

Bereinigen Sie den Bildschirm von allem, was nicht weitergegeben werden sollte. Tokens in der Adressleiste, der Name eines Kunden, eine unbeteiligte E-Mail in einem anderen Tab, ein API-Schlüssel in den Entwicklertools. Ein Fehlerbericht wird weitergeleitet, in Chats eingefügt und von Personen außerhalb des Teams gelesen - und eine Bildschirmaufnahme zeigt alles, was zu diesem Zeitpunkt auf dem Bildschirm zu sehen war. Dieses Tool lädt das Video niemals hoch, aber der Bericht und die Frames landen überall dort, wo Sie sie hinsenden.

Was das Tool nicht tut

Es erstellt das Ticket nicht für Sie. Es gibt keine Verbindung zu GitHub, Jira oder anderen Diensten; Sie kopieren den Bericht und fügen ihn dort ein, wo er hingehört. Das bedeutet auch, dass Sie ihn noch einmal gegenlesen können, bevor ihn andere sehen.

Es erfasst keine Logs, Netzwerkanfragen oder Konsolenausgaben. Diese befinden sich in Ihren Entwicklertools und sind bei manchen Fehlern enorm wichtig. Hängen Sie diese über den sicheren Weg an, den Ihr Team bereits nutzt, anstatt eine Konsole abzufilmen.

Und es stellt keine Diagnosen. Es sagt Ihnen nicht die Ursache, welche Komponente schuld ist oder ob es sich um ein Duplikat eines bestehenden Fehlers handelt. Es bringt die Belege in eine Form, mit der jemand arbeiten kann - und das ist die gesamte Aufgabe.

Den Bug überhaupt erst aufnehmen

Wenn Sie das Problem erst noch erfassen müssen: Der Bildschirm-Recorder nimmt einen Tab, ein Fenster oder den gesamten Bildschirm direkt im Browser auf. Für Fehler, die Sie beim Reproduzieren kommentieren müssen, nehmen Sie einfach mit Ton auf - so bleibt die Erklärung direkt mit dem Beleg verknüpft.

Zwei praktische Ergänzungen: Wenn Sie Einzelbilder statt eines Berichts benötigen, extrahiert der Video-Frame-Extractor Frames in festgelegten Intervallen. Und wenn die Aufnahme lang ist und Sie den gesprochenen Ablauf als Text benötigen, wandelt der Transkript-Generator das Gesagte in durchsuchbaren Text um.

Die Aufnahme zum Bug befragen

Die Überprüfung auf dieser Seite läuft vollständig auf Ihrem Gerät und erfordert kein Konto. Für Antworten darauf, was in der Aufnahme gesagt oder gezeigt wurde, laden Sie sie auf ScreenApp hoch. Klicken Sie auf eine Frage, um ScreenApp direkt mit der vorgefertigten Frage zu öffnen.

In ScreenApp Ein Klick auf einen Moment im Transkript springt den Player zu diesem Punkt in der Aufnahme, sodass Sie jede Antwort anhand der Aufnahme überprüfen können.

Was die einzelnen Tarife hier bieten

Das Tool auf dieser Seite ist kostenlos und bleibt es auch. Ein Konto wird für den Schritt davor oder den Schritt danach benötigt.