Zuerst klären, ob es überhaupt ein Systemfehler ist
Nicht jede Meldung auf dem Bildschirm ist ein Ausfall. Ausnahmen mit fehlerhaften Eingabedaten, etwa fehlender Zugriff, fehlende Seite oder fehlerhafte Anfrage, sind von der Meldung als Nicht-Ausfälle ausgenommen. Sieht der Bediener eine Meldung über fehlende Berechtigungen, prüft er zuerst die Rolle des Benutzers und meldet den Fehler erst danach.
Es lohnt sich außerdem, drei Situationen zu unterscheiden: ein Fehler, der nur einen Benutzer betrifft, ein wiederkehrender Fehler bei vielen Personen und ein Fehler im Sicherheitsalarm. Die dritte Situation hat die höchste Priorität. Sicherheitsalarme im Arbeitsschutz werden nicht stummgeschaltet: Wenn ein Alarm nicht angekommen ist oder fälschlich ausgelöst hat, melden Sie das sofort und nennen Sie die Uhrzeit, damit der Anbieter das Ereignis im Protokoll findet.
So beschreiben Sie einen Fehler Schritt für Schritt
Die Meldung sollte so geschrieben sein, dass eine Person, die Ihren Bildschirm nicht gesehen hat, den Fehler wiederholen kann. Eine solche Beschreibung besteht aus einigen festen Elementen.
- Version des Systems: der im System sichtbare Kurzhash des Releases. In Fehlerberichten ist die Version der Kurzhash des Commits des bereitgestellten Images, derselbe wie das Image-Tag in der Registry, sodass der Fehler einer konkreten Änderung zugeordnet werden kann.
- Wer und wann: Rolle des Benutzers und genauer Zeitpunkt des Ereignisses, am besten mit Uhrzeit.
- Was der Benutzer erreichen wollte: ein Satz zum Ziel, zum Beispiel eine Arbeitsfreigabe erteilen.
- Schritte: nummerierte Liste der Klicks vom Anmeldebildschirm bis zum Moment des Fehlers.
- Erwartete und beobachtete Wirkung: zwei kurze Sätze.
- Nachweis: Screenshot mit der sichtbaren Meldung und, wenn möglich, die Uhrzeit der Geräteuhr.
Warum nummerierte Schritte wichtiger sind als eine allgemeine Beschreibung
Die E2E-Browsertests bilden den Benutzer Schritt für Schritt nach: Anmeldung, Administrationsbereich, Planung von Arbeiten, Freigaben, Meldungen, Dokumentation, Lagepläne und Auswertungen. Der Anbieter macht aus einer guten Schrittbeschreibung einen Test, sodass eine Meldung mit Schritten die Chance hat, in das Regressionspaket aufgenommen zu werden und nach dem nächsten Update nicht wiederzukehren.
Priorität der Meldung nach Situation
Was der Anbieter selbst sieht und was Sie nicht beschreiben müssen
Alle Instanzen melden unbehandelte Ausnahmen an ein gemeinsames Fehlerüberwachungsprojekt. Das bedeutet, dass der Anbieter einen schweren Serverfehler meist selbst sieht, noch bevor ihn jemand meldet. Die Meldung des Benutzers bleibt trotzdem nötig, denn sie liefert den Kontext: was der Bediener getan hat und welche Wirkung er gesehen hat.
Die automatischen Browsertests schlagen fehl, sobald eine unbehandelte JavaScript-Ausnahme oder ein Serverfehler auftritt. Deshalb werden solche Fehler zuerst vom Automaten erfasst. Die Meldung durch einen Menschen ist vor allem bei Problemen nützlich, die keine Ausnahme auslösen: falsches Ergebnis, fehlender Eintrag, irreführender Bildschirm.
Tritt derselbe Fehler bei mehreren Personen oder an mehreren Stellen des Systems auf, schreiben Sie das in die Meldung: Wiederkehr und Zahl der Betroffenen helfen dem Anbieter, Priorität und Umfang einzuschätzen. Wie der Anbieter Fehler in einer gemeinsamen Überwachung gruppiert, beschreiben wir in einem eigenen Fallbeispiel.
Nachweis für das Audit und Verfolgung der Meldung
Für die Abteilung Informationssicherheit zählt die Nachvollziehbarkeit: wer gemeldet hat, wann, welche Version angegeben wurde und wann die Antwort kam. Führen Sie auf Seiten des Werks ein Meldungsregister mit Nummer der Meldung beim Anbieter, Version, Datum und Status.
Bestätigt der Anbieter den Fehler, prüfen Sie in seiner Antwort, ob er die Version nennt, in der die Korrektur ausgeliefert wird. So können Sie nach dem Update überprüfen, dass der Fehler verschwunden ist, etwa indem Sie die Schritte aus der Meldung erneut durchlaufen. Details zur Abnahme nach dem Update beschreiben wir in der Checkliste zur Abnahme von Aktualisierungen.
Videomaterial
Häufig gestellte Fragen
Muss ich einen Fehler melden, wenn der Anbieter eine Überwachung hat?
Ja, wenn der Fehler keine Ausnahme auslöst. Die Überwachung sieht unbehandelte Ausnahmen, aber kein falsches Ergebnis, keinen fehlenden Eintrag und keinen irreführenden Bildschirm.
Woher nehme ich die Version des Systems für die Meldung?
Die Version des Releases ist der Kurzhash des Commits des bereitgestellten Images. Fragen Sie den Administrator des Werks oder den Anbieter, wo sie in Ihrer Installation sichtbar ist.
Ist eine Meldung über fehlenden Zugriff ein Ausfall?
Meist nicht. Zugriffsfehler sind von der Meldung als Nicht-Ausfälle ausgenommen. Prüfen Sie daher zuerst die Berechtigungen des Benutzers.
Vereinbaren Sie den Meldeprozess
Wir zeigen Ihnen ein Muster für eine Meldung und den Bearbeitungsweg in Ihrem Werk. Vereinbaren Sie ein Gespräch mit InnerWeb.
Sprechen wir