Fehlermeldungen dokumentieren: ein hilfreiches Support-Protokoll erstellen

Ein gutes Support-Protokoll trennt Beobachtungen von Vermutungen. Halte Fehlertext, Zeitpunkt, Umgebung und sichere Wiederholungsschritte fest, ohne vertrauliche Daten weiterzugeben. Diese Anleitung ist unabhängig vom Betriebssystem; die Bezeichnungen der Versionsdialoge unterscheiden sich je nach Programm.

1. Den Vorfall festhalten

Notiere Datum, Uhrzeit und Zeitzone sowie die betroffene Anwendung und ihre genaue Version. Ergänze Betriebssystemversion, Gerätetyp und den letzten bekannten funktionierenden Zeitpunkt. Schreibe bei unbekannten Angaben ausdrücklich „unbekannt“, statt Werte zu raten. Beschreibe die Auswirkung: Betrifft der Fehler eine Datei, einen Benutzer oder mehrere Arbeitsplätze?

2. Fehler und Schritte präzise beschreiben

1. Kopiere den vollständigen Fehlertext samt Fehlercode, sofern dies möglich ist. Andernfalls fertige einen Screenshot an und schreibe den Text zusätzlich ab. Übersetze oder verkürze den Fehlercode nicht.
2. Liste die Handlungen bis zum Fehler nummeriert auf: Ausgangszustand, geöffnete Datei oder Funktion, konkrete Schaltfläche und Ergebnis. Nutze für Dateinamen bei Bedarf neutrale Platzhalter.
3. Trenne erwartetes Ergebnis und tatsächlich beobachtetes Ergebnis. Formuliere „Speichern zeigt Fehler X“ statt „Der Server ist kaputt“, solange die Ursache nicht nachgewiesen ist.
4. Gib an, ob der Fehler immer, gelegentlich oder nur einmal auftrat. Wiederhole nur sichere Schritte mit Testdaten oder einer Kopie. Zahlungen, Löschvorgänge und Aktionen mit Datenverlustrisiko nicht zum Nachstellen erneut ausführen.

3. Belege und bisherige Versuche

Ergänze bekannte Änderungen kurz vor dem Fehler und bereits getestete Maßnahmen mit ihrem jeweiligen Ergebnis. Ändere nicht mehrere Einstellungen gleichzeitig. Bewahre das Originalprotokoll geschützt auf; teile nur die benötigten Auszüge aus dem passenden Zeitfenster. Ein zeitgleiches Ereignis ist ein Hinweis, noch kein Ursachenbeweis.

4. Vor dem Versand prüfen

Entferne Passwörter, Sitzungstoken, persönliche Daten und vertrauliche Dokumentinhalte aus der Versandkopie. Prüfe auch Browseradresszeile, Dateipfade und Screenshot-Hintergrund. Ein darübergelegtes Rechteck in einer bearbeitbaren Datei reicht nicht zur sicheren Entfernung. Öffne den endgültigen Anhang erneut und kontrolliere das Ergebnis. Nutze den vorgesehenen Supportkanal und kontrolliere Empfänger und Anhänge; veröffentliche keine ungeprüften vollständigen Diagnosepakete in einem Forum.

Kopiervorlage

• Kurztitel und Auswirkung:
• Datum, Uhrzeit, Zeitzone:
• Anwendung/Version, Betriebssystem/Version, Gerät:
• Ausgangszustand und nummerierte Schritte:
• Erwartet / tatsächlich beobachtet:
• Vollständiger Fehlertext und Code:
• Häufigkeit, zuletzt erfolgreich, bekannte Änderungen:
• Bereits versucht / jeweiliges Ergebnis:
• Geprüfte, bereinigte Anhänge:

Abschlusskontrolle: Eine andere Person sollte den Ablauf verstehen können, ohne Rückfragen zu grundlegenden Schritten stellen zu müssen. Mehrere unabhängige Probleme gehören in getrennte Meldungen.

Quelle

Mozilla: Bug Writing Guidelines – Grundlage für präzise Schritte, klare Ergebnisse und getrennte Fehlerberichte; die Datenschutzkontrolle ergänzt den allgemeinen Supportablauf.