InnerWeb
Zum Inhalt springen

Leitfaden: Systemfehler richtig an den Anbieter melden

Eine gute Fehlermeldung verkürzt die Behebungszeit, weil der Anbieter das Problem sofort nachstellen kann, ohne eine Reihe von Rückfragen. Der Leitfaden zeigt, was zu beschreiben ist, welche Version anzugeben ist, welche Fehler der Anbieter ohnehin selbst sieht und wie man eine Störung von einem Benutzerfehler unterscheidet.

3
Situationen zu unterscheiden: Fehler eines Benutzers, wiederkehrender Fehler, Fehler im Sicherheitsalarm
6
feste Elemente einer guten Meldung (Version, Wer und wann, Ziel, Schritte, Wirkung, Nachweis)

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

Priorität der Meldung nach SituationSäulendiagramm: Priorität 1 für den Fehler eines Benutzers, 2 für einen wiederkehrenden Fehler, 3 für einen Fehler im Sicherheitsalarm.0123Stufe (3 = höchste)Fehler eines Benutzers: 1 Stufe (3 = höchste)1Fehler eines BenutzersWiederkehrender Fehler bei vielen Personen: 2 Stufe (3 = höchste)2Wiederkehrender Fehler beivielen PersonenFehler im Sicherheitsalarm: 3 Stufe (3 = höchste)3Fehler im Sicherheitsalarm
Quelle: Eigene Zusammenstellung von InnerWeb auf Grundlage der und

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