Lorixen.
DE

Fehler sauber melden: Konsole und HAR-Datei für Entwickler

Kurz gesagt: „Die Seite geht nicht“ ist für Ihre Agentur oder Ihren Entwickler die schwierigste Fehlermeldung. Mit zwei Dingen aus dem Browser wird daraus ein lösbarer Fall: den Meldungen aus der Konsole und einem Mitschnitt der Netzwerkanfragen als HAR-Datei. Beides lässt sich in Chrome in wenigen Minuten speichern. Laut Chrome-Dokumentation exportiert der Browser die HAR-Datei standardmäßig in einer bereinigten Fassung, ohne Cookie-, Set-Cookie- und Authorization-Kopfzeilen. Verschicken Sie nur diese bereinigte Fassung. Ergänzt um eine kurze Beschreibung, was Sie getan haben und was Sie erwartet hätten, spart ein solcher Bericht oft Stunden an Rückfragen.

Warum Screenshots allein nicht reichen

Ein Screenshot zeigt, was auf dem Bildschirm zu sehen war, aber nicht, warum. Ob ein Skript abgestürzt ist, eine Schnittstelle nicht geantwortet hat oder ein Formular einen Fehler vom Server bekam, steht an anderer Stelle: in der Konsole und im Netzwerkprotokoll des Browsers. Ohne diese Informationen muss der Entwickler den Fehler erst nachstellen, und genau das gelingt oft nicht, weil er nur bei bestimmten Kunden, Geräten oder Daten auftritt.

Was in einen guten Fehlerbericht gehört

Bevor Sie zu den technischen Mitschnitten kommen, sammeln Sie die Grundlagen:

  • Wann ist der Fehler aufgetreten, mit Datum und Uhrzeit?
  • Wo: die genaue Adresse der Seite.
  • Wer: welches Gerät, welcher Browser, angemeldet oder nicht, welches Kundenkonto oder welche Bestellnummer.
  • Was haben Sie Schritt für Schritt getan?
  • Was haben Sie erwartet, und was ist stattdessen passiert?
  • Wie oft: einmal, immer, nur manchmal?

Diese sechs Punkte sind in vielen Fällen schon die halbe Diagnose.

Schritt 1: Die Konsole sichern

Die Konsole zeigt Fehlermeldungen von Skripten, Warnungen und Hinweise zu blockierten Anfragen. So sichern Sie sie in Chrome:

  1. Öffnen Sie die Entwicklerwerkzeuge, etwa über die Taste F12 oder per Rechtsklick und „Untersuchen“.
  2. Wechseln Sie zum Reiter „Console“.
  3. Aktivieren Sie in den Einstellungen der Konsole „Preserve log“, damit Meldungen beim Neuladen oder Seitenwechsel nicht verschwinden.
  4. Führen Sie die Schritte aus, die zum Fehler führen.
  5. Klicken Sie mit der rechten Maustaste in die Konsole und wählen Sie „Save as…“.

Laut Chrome-Dokumentation speichert „Save as…“ alle aktuellen Meldungen als einfache Textdatei mit der Endung .log. Alternativ kopiert „Copy console“ alle Meldungen in die Zwischenablage. Rote Einträge sind Fehler, gelbe Warnungen. Schicken Sie trotzdem die ganze Datei, nicht nur die rote Zeile, denn oft ist eine Warnung davor der eigentliche Hinweis.

Schritt 2: Den Netzwerkverkehr als HAR speichern

Eine HAR-Datei enthält alle Anfragen, die der Browser beim Aufruf einer Seite gestellt hat, mit Adressen, Statuscodes, Zeiten und Antworten. Laut Chrome-Dokumentation ist HAR ein JSON-Format, das viele Werkzeuge zur Analyse von HTTP-Sitzungen verstehen.

So erstellen Sie die Datei:

  1. Öffnen Sie in den Entwicklerwerkzeugen den Reiter „Network“.
  2. Aktivieren Sie „Preserve log“. Laut Dokumentation speichert der Browser dann alle Anfragen, auch über Seitenwechsel hinweg.
  3. Leeren Sie die Liste mit dem Symbol zum Löschen, damit nur der Fehlerablauf enthalten ist.
  4. Führen Sie die Schritte aus, die zum Fehler führen.
  5. Klicken Sie in der Leiste oben auf „Export HAR (sanitized)…“ oder klicken Sie mit der rechten Maustaste auf eine Anfrage und wählen Sie die bereinigte Speicheroption.

Datenschutz: Was in einer HAR-Datei steckt

Eine HAR-Datei kann sensible Daten enthalten, etwa Inhalte von Formularen, Kundennamen, Adressen oder Antworten mit persönlichen Daten. Chrome exportiert laut Dokumentation standardmäßig eine bereinigte Fassung ohne die Kopfzeilen Cookie, Set-Cookie und Authorization. Das schützt vor dem versehentlichen Weitergeben von Anmeldedaten, die jemand anderem Zugriff auf Ihr Konto geben könnten.

Trotzdem gilt:

  • Exportieren Sie nur die bereinigte Fassung, außer der Entwickler bittet ausdrücklich um mehr und Sie wissen, warum.
  • Verwenden Sie für den Test möglichst ein Testkonto oder Testdaten.
  • Schicken Sie die Datei nur an die Person, die den Fehler bearbeitet, und nicht in große Gruppen oder öffentliche Foren.
  • Löschen Sie die Datei, wenn der Fehler behoben ist.

Schritt 3: Alles zusammen verschicken

Packen Sie die Beschreibung, die Konsolen-Datei, die HAR-Datei und gegebenenfalls einen Screenshot in eine Nachricht. Benennen Sie die Dateien sprechend, etwa mit Datum und Kurzbeschreibung. Wenn Ihr Dienstleister ein Ticketsystem nutzt, hängen Sie alles an ein einziges Ticket statt an mehrere Mails.

Fehler, die nur bei Kunden auftreten

Manchmal tritt ein Fehler nur bei einem Kunden auf, nicht bei Ihnen. Kunden mit Entwicklerwerkzeugen zu überfordern, ist selten eine gute Idee. Bitten Sie stattdessen um die Grundlagen: Gerät, Browser, Uhrzeit, Bestell- oder Kundennummer und einen Screenshot. Mit Uhrzeit und Kundennummer findet Ihr Dienstleister den Vorgang oft im Serverprotokoll. Versuchen Sie dann, den Fehler mit denselben Angaben selbst auszulösen und den Mitschnitt zu erstellen.

Eine Vorlage für Ihr Team

Halten Sie eine kurze Vorlage bereit, die jede Person im Team ausfüllen kann:

  • Datum und Uhrzeit:
  • Adresse der Seite:
  • Gerät und Browser:
  • Angemeldet als:
  • Schritte:
  • Erwartet:
  • Tatsächlich:
  • Anhänge: Konsole, HAR, Screenshot

Wer diese Vorlage einmal genutzt hat, merkt schnell, wie viel weniger Rückfragen kommen. Legen Sie sie dort ab, wo das Team sie findet, etwa im gemeinsamen Postfach als Textbaustein oder im internen Wiki.

Beispiel aus der Praxis

Ein Reisebüro in Mainz meldete seiner Agentur, dass Buchungsanfragen manchmal nicht abgeschickt würden. Nach mehreren Mails ohne Ergebnis schickte die Büroleiterin eine bereinigte HAR-Datei und die Konsole mit. Darin zeigte sich, dass das Formular bei Reisen mit mehr als vier Personen eine Antwort mit Status 500 erhielt. Die Agentur fand den Fehler im Code am selben Tag. Das Beispiel ist illustrativ.

Häufige Fragen

Ist eine HAR-Datei gefährlich?

Sie kann sensible Daten enthalten. Die bereinigte Fassung von Chrome lässt laut Dokumentation Cookie-, Set-Cookie- und Authorization-Kopfzeilen weg. Verschicken Sie sie trotzdem nur gezielt.

Funktioniert das auch in anderen Browsern?

Ja, auch Firefox, Edge und Safari haben Entwicklerwerkzeuge mit Konsole und Netzwerkprotokoll. Die Bezeichnungen der Menüs unterscheiden sich etwas.

Warum muss ich „Preserve log“ aktivieren?

Sonst werden Meldungen und Anfragen beim Neuladen oder Seitenwechsel gelöscht, und genau der Moment des Fehlers fehlt im Mitschnitt.

Brauche ich das auch für Fehler in Apps?

Für native Apps gibt es eigene Wege, etwa Absturzberichte. Für Web-Apps im Browser sind Konsole und HAR der beste Anfang.

Wenn Fehlerberichte zwischen Ihnen und Ihrer Agentur zu oft im Kreis laufen, richten wir gerne einen klaren Ablauf mit Ihnen ein: Fehlermeldung besprechen.

Quellen

WhatsAppTermin buchen