Eine Fehlerbericht-Aufnahme sollte eine durchgehende Sequenz von der ersten Aktion bis zum Fehler zeigen, wobei die Versionsnummer, der Cursor und der exakte Fehlertext alle auf dem Bildschirm sichtbar sind. Nimm sie in einem Browser-Tab auf, halte den Clip unter einer Minute und sende keinen internen Bildschirm an einen Drittanbieter-Recorder-Dienst.
Der Clip ist ein Beweis, keine Demo, er muss also nur lang genug sein, um zu beweisen, dass der Fehler existiert, und anderen zu erlauben, ihn zu reproduzieren. Das sind meist 20 bis 45 Sekunden: Bildschirm öffnen, durch die zwei oder drei Schritte klicken, die das Problem auslösen, dann kurz beim Fehler verharren. Lass das Mikrofon an und kommentiere, was du tust, denn eine Stimme, die sagt, dass der Button den Dialog hätte schließen sollen, nimmt das Raten weg, das ein stummer Clip hinterlässt. Nach der Aufnahme kürze die Leerlaufzeit an beiden Enden und komprimiere die Datei, bevor du sie an das Ticket anhängst.
Ein Fehlerbericht-Video hat zwei Zielgruppen, die in entgegengesetzte Richtungen ziehen. Der Entwickler will jedes Detail, das den Fehler beweist, und die Person, die den Upload genehmigt, will keines der Kundendaten, die zufällig auf demselben Bildschirm sind. Ein guter Clip erfüllt beide, und er braucht etwa dreißig Sekunden Vorbereitung.
Bildschirmrecorder
Nimm einen Bildschirm, ein Fenster oder einen Browser-Tab mit deinem Mikrofon auf, vollständig im Browser-Tab. Nichts wird hochgeladen, und die Datei landet direkt in deinem Downloads-Ordner.
Was ein brauchbares Fehler-Reproduktionsvideo enthält
Ein Clip, der einen Fehler behoben bekommt, muss vier Fragen ohne Rückfrage beantworten: was du getan hast, was du erwartet hast, was tatsächlich passiert ist und auf welcher Version du warst. Eine stumme Aufnahme des ganzen Desktops beantwortet keine davon, weil die zuschauende Person raten muss, wo sie hinsehen soll.
| Element | Warum es in den Clip gehört |
|---|---|
| Die vollständige Klicksequenz | Zeigt die Ursache, nicht nur das Symptom |
| Build-Nummer oder Version | Bindet die Korrektur an ein Release |
| Der exakte Fehlertext | Kann durchsucht werden; eine Umschreibung nicht |
| Die URL oder der Dateipfad | Sagt, welche Umgebung und welche Daten |
| Ein sichtbarer Cursor | Beweist, wo der Klick tatsächlich gelandet ist |
Eine durchgehende Sequenz, in Reihenfolge
Nimm die Reproduktion ab dem ersten Klick auf, nicht ab dem Moment, in dem es bricht. Die Ursache liegt meist zwei oder drei Schritte vor dem Symptom, ein Clip, der am Fehlerbildschirm beginnt, lässt den Entwickler also nach dem fehlenden Teil fragen. Eine Datei, die von der ersten Aktion bis zum Fehler läuft, ist überzeugender als drei Clips, die jeweils mitten im Ablauf beginnen.
Die Version und Umgebung, auf dem Bildschirm
Öffne das Info-Fenster, die Fußzeile oder die Statusleiste, die die Build-Nummer zeigt, bevor du beginnst, und lass sie im Bild. "Es ist auf meiner Maschine kaputtgegangen" ist nicht umsetzbar; "es ist auf 4.11.2, Windows 11, Chrome 140 kaputtgegangen" ist es. Wenn es ein Debug-Overlay oder ein Umgebungs-Badge gibt, halte es für den ganzen Clip sichtbar.
Der exakte Fehlertext, nicht deine Zusammenfassung
Behalte die Konsole, den Toast oder die Inline-Fehlermeldung auf dem Bildschirm und halte eine Sekunde still. Ein Entwickler kann einen Stacktrace durchsuchen, aber nicht "es sagte etwas über ein Null". Wenn die Meldung in einer Entwicklerkonsole steht, öffne diese Konsole vor dem letzten Schritt, damit der Text auf die Kamera kommt, und scrolle ihn langsam ins Bild.
Cursor- und Klick-Feedback
Bewege den Zeiger bewusst und pausiere leicht vor jedem Klick. Eine Bildschirmaufnahme trägt keines des Klick-Feedbacks, das eine Live-Bildschirmfreigabe gibt, langsames, sichtbares Bewegen ist also der einzige Hinweis darauf, wo die Aktion gelandet ist. Ein ruhiges Tempo macht den Clip auch leichter zu kürzen.
Bevor du auf Aufnehmen drückst
Der größte Teil der Qualität eines Fehler-Clips wird in den dreißig Sekunden vor Beginn der Aufnahme entschieden. Zwei der Prüfungen unten betreffen die Lesbarkeit und zwei betreffen, nichts zu veröffentlichen, was du nicht veröffentlichen wolltest.
Schließe nicht zusammenhängende Fenster und stelle Benachrichtigungen stumm
Schalte Nicht stören ein, beende den Chat-Client und schließe die Tabs, die nicht Teil der Reproduktion sind. Ein Benachrichtigungsbanner, das über die Fehlermeldung gleitet, kann genau den Frame verbergen, den der Entwickler brauchte, und es ist der häufigste Grund, einen Clip erneut aufnehmen zu müssen. Eine Update-Aufforderung tut dasselbe.
Entscheide, was nicht im Bild sein darf
Betrachte den ganzen Bildschirm, wie es ein Fremder tun würde: Lesezeichenleisten, ein zweiter Monitor, eine offene E-Mail, die Zeile eines anderen Kunden in derselben Tabelle. Wenn der Fehler nur mit echten Kundendaten reproduziert wird, verwende den kleinsten Datensatz, der das Problem noch zeigt, oder ein Testkonto. Ein Video nachträglich zu schwärzen, ist viel mehr Arbeit, als ein sauberes Fenster zu wählen.
Dimensioniere das Fenster, bevor du es aufnimmst
Ändere die Größe des Browsers oder der Anwendung auf ein normales Fenster, statt auf einem großen Display den ganzen Bildschirm aufzunehmen. Eine 2560 Pixel breite Aufnahme verkleinert den Text bis unter die Lesbarkeit, sobald der Ticket-Betrachter ihn herunterskaliert, während ein 1280 Pixel breites Fenster im Inline-Player lesbar bleibt. Es hält die Rohdatei auch kleiner.
So nimmst du die Reproduktion auf
- Öffne den Recorder und wähle, was geteilt werden soll. Wähle den Browser-Tab oder das einzelne Fenster statt des gesamten Bildschirms, wenn der Fehler an einem Ort lebt, weil der Browser dann nur diese Fläche übergibt. Lass die Option "Mikrofon einschließen" an, damit dein Kommentar zusammen mit dem Video aufgenommen wird.
- Gehe die Reproduktion einmal langsam und laut durch. Nenne die Version, auf der du bist, sag, was du vor dem letzten Klick erwartest, und sag dann, was stattdessen passiert ist. Pausiere einmal beim Fehler, damit ein Frame zitiert werden kann, und stoppe mit der Stopptaste.
- Sieh dir die Vorschau an, bevor du herunterlädst. Der Recorder zeigt den fertigen Clip und seine Größe, sobald du stoppst, prüfe also, dass die Fehlermeldung tatsächlich lesbar ist, bevor du speicherst. Wenn eine Benachrichtigung den Take verdorben hat, nimm ihn erneut auf; ein zweiter Versuch ist billiger als ein Ticket-Hin und Her.
Du kannst auch mitten in der Aufnahme pausieren und fortsetzen, wenn ein Schritt einen Moment Vorbereitung braucht, der nicht in den Beweis gehört. Die Aufnahme wird so oder so als eine einzige Datei geschrieben, und der Browser stoppt sie automatisch, wenn du die Bildschirmfreigabe über die Freigabeleiste beendest.
Das Mikrofon ist das einzige Audio, das du bekommst
Dieser Recorder erfasst Video vom Bildschirm und, wenn du die Option aktiviert lässt, mischt er dein Mikrofon über eine separate Berechtigungsabfrage ein. Er erfasst kein Systemaudio: keine Anwendungstöne, kein Tab-Audio, keine der Glocken, die das Betriebssystem macht. Für einen Fehlerbericht ist das meist der richtige Standard, weil das Audio, das einem Entwickler hilft, deine Beschreibung des erwarteten Verhaltens ist und nicht der Lärm, den die Anwendung macht.
Was du laut sagen solltest
- Nenne die Version und die Umgebung am Anfang, auch wenn die Build-Nummer ebenfalls auf dem Bildschirm steht.
- Sag, was du erwartest, bevor der entscheidende Klick kommt: "das sollte speichern und den Dialog schließen".
- Sag gleich danach, was tatsächlich passiert ist: "es blieb offen und der Spinner hörte nie auf".
- Erwähne, wie oft es passiert: immer oder eines von fünf Malen.
Halte den Kommentar kurz und sachlich. Ein Entwickler, der schnell zusieht, sollte dem Clip auch ohne Ton folgen können und die Sequenz trotzdem verstehen, wobei die Stimme nur die Absicht hinter jedem Klick bestätigt.
Kürze und komprimiere, bevor du es anhängst
Eine Rohaufnahme ist fast immer länger und größer, als das Ticket braucht. Die ersten zwei Sekunden zeigen meist, wie du Fenster wechselst, um den Recorder zu erreichen, und die letzten paar zeigen, wie du nach der Stopptaste greifst. Beide Enden zu kürzen, kostet nichts.
Verwende Video-Zuschneider für den Schnitt. Der Schnelle Modus kopiert die Original-Streams ohne Neucodierung, der Schnitt ist also schnell und die Qualität bleibt unangetastet, obwohl der neue Startpunkt zum nächsten Keyframe springt. Der Präzise Modus codiert neu, sodass der Schnitt genau auf dem von dir gewählten Frame landet, was sich lohnt, wenn der erste Klick innerhalb einer Sekunde nach dem Start geschieht.
Führe dann das Ergebnis durch den Video-Kompressor Wenn die Datei für einen Tracker-Anhang noch zu schwer ist. Eine 1080p-Aufnahme auf 720p bei 30 fps zu senken, nimmt typischerweise 60 bis 80 Prozent der Größe weg, und Text auf dem Bildschirm bleibt bei dieser Auflösung lesbar, was das Einzige ist, was ein Fehler-Clip wirklich bewahren muss.
Video-Zuschneider
Schneide die Leerlaufzeit an beiden Enden ab. Der Schnelle Modus kopiert Streams, die Qualität bleibt also unangetastet; der Präzise Modus schneidet genau dort, wo du markiert hast.
Was dieser Recorder nicht macht
Liesenswert vor dem Start, denn das sind die Fälle, in denen ein anderer Ansatz die richtige Antwort ist.
- Kein System- oder Tab-Audio. Der Bildschirmstream wird nur als Video erfasst, und dein Mikrofon wird separat eingemischt. Das Tool kann den Ton, den eine Anwendung oder ein Browser-Tab abspielt, nicht aufnehmen.
- Die Ausgabe ist WebM. Browser codieren WebM nativ, das bekommst du also. Die Schaltfläche "In MP4 konvertieren" öffnet den Video-Konverter, der Weg zu einem MP4 für Tracker, die WebM nicht in der Vorschau anzeigen.
- Keine Anmerkung, keine Unschärfe und keine Cursor-Hervorhebung. Du kannst nicht auf dem Frame zeichnen oder einen Bereich nachträglich schwärzen, nimm also eine saubere Version auf, wenn ein Frame abgedeckt werden muss.
- Im Recorder wird nichts bearbeitet. Pausieren und Fortsetzen sind die einzigen Steuerelemente während der Aufnahme. Kürzen und Komprimieren geschehen danach in den Tools oben.
- Die Aufnahme lebt im Speicher, bis du stoppst. Eine lange Aufnahme in hoher Auflösung füllt den Seitenspeicher, halte Repro-Clips also kurz und schließe den Tab erst, nachdem du die Datei gespeichert hast.
- Kein Webcam-Overlay. Es gibt kein Bild-in-Bild für dein Gesicht. Wenn du eine Kameraaufnahme neben dem Bildschirm willst, nimm sie separat auf mit dem Webcam-Recorder.
Warum eine Fehler-Reproduktion nicht durch einen Drittanbieter-Recorder gehen sollte
Die offensichtliche Abkürzung ist ein Cloud-Recorder: Aufnehmen drücken, einen teilbaren Link bekommen, ihn in das Ticket einfügen. Dieser Link hat die falsche Form für einen Fehlerbericht, weil am anderen Ende ein interner Admin-Bildschirm, eine Kundenliste, eine Staging-URL oder ein unveröffentlichtes Feature wartet. Ein gehosteter Recorder speichert das auf der Festplatte eines anderen, unter einer Aufbewahrungsrichtlinie, die du nicht kontrollierst.
| Aihangsoft | Cloud-Recorder | |
|---|---|---|
| Wohin das Video geht | Bleibt im Browser-Tab | Auf deren Server hochgeladen |
| Wer es ansehen kann | Nur Personen, denen du die Datei sendest | Jeder mit dem Link, bis er abläuft |
| Aufbewahrung | Keine, es ist eine Datei auf deiner Festplatte | Ihre Richtlinie, die du nicht prüfen kannst |
| Konto | Nicht nötig | Meist erforderlich, um den Link am Leben zu halten |
| Kürzen und Komprimieren | Separate lokale Tools, kein Upload | Manchmal hinter einem bezahlten Tarif |
Du musst die Privatsphäre-Behauptung nicht auf Treu und Glauben annehmen. Öffne die Entwicklertools deines Browsers, wechsle zum Netzwerk-Panel und nimm einen kurzen Clip auf, während du die Anforderungsliste beobachtest. Keine Anfrage überträgt das Video, weil die Codierung in der Seite geschieht; der einzige Verkehr ist der Recorder-Code selbst, der einmal abgerufen wird.