InnerWeb
Przejdź do treści

Jak zgłosić błąd systemu dostawcy: poradnik

Dobre zgłoszenie błędu skraca czas naprawy, bo dostawca może odtworzyć problem od razu, bez serii pytań. Poradnik pokazuje, co opisać, jaką wersję podać, które błędy dostawca i tak widzi sam oraz jak odróżnić awarię od błędu użytkownika.

3
sytuacje do rozróżnienia: błąd jednego użytkownika, błąd powtarzalny, błąd w alarmie bezpieczeństwa
6
stałych elementów dobrego zgłoszenia (wersja, kto i kiedy, cel, kroki, efekty, dowód)

Zacznij od ustalenia, czy to w ogóle błąd systemu

Nie każdy komunikat na ekranie jest awarią. Wyjątki opisujące błędne dane wejściowe, jak brak dostępu, brak strony czy zły request, są wyłączone z raportowania jako nie-awarie. Jeśli operator widzi komunikat o braku uprawnień, najpierw należy sprawdzić rolę użytkownika, a dopiero potem zgłaszać błąd.

Warto też rozróżnić trzy sytuacje: błąd widoczny dla jednego użytkownika, błąd powtarzalny u wielu osób i błąd w alarmie bezpieczeństwa. Trzecia sytuacja ma najwyższy priorytet. Alarmy bezpieczeństwa pracy nie są wyciszane: jeśli alarm nie dotarł albo zadzwonił błędnie, zgłoś to od razu i podaj godzinę, żeby dostawca odnalazł zdarzenie w logu.

Jak opisać błąd krok po kroku

Zgłoszenie powinno być napisane tak, żeby osoba, która nie widziała Waszego ekranu, mogła ten błąd powtórzyć. Taki opis składa się z kilku stałych elementów.

  • Wersja systemu: skrót wydania widoczny w systemie. W raportach błędów wersja wydania to skrót commita wdrożonego obrazu, taki sam jak znacznik obrazu w rejestrze, więc błąd da się powiązać z konkretną zmianą.
  • Kto i kiedy: rola użytkownika i dokładny czas zdarzenia, najlepiej z godziną.
  • Co użytkownik chciał zrobić: jedno zdanie o celu, na przykład wydać zezwolenie na pracę.
  • Kroki: numerowana lista kliknięć od ekranu logowania do momentu błędu.
  • Efekt oczekiwany i efekt widziany: dwa krótkie zdania.
  • Dowód: zrzut ekranu z widocznym komunikatem i, jeśli to możliwe, godzina z zegara urządzenia.

Dlaczego numerowane kroki są ważniejsze niż opis ogólny

Testy przeglądarkowe E2E odtwarzają użytkownika krok po kroku: logowanie, panel administracyjny, planowanie prac, zezwolenia, zgłoszenia, dokumentację, mapy i analitykę. Dostawca zamienia dobry opis kroków na test, więc zgłoszenie z krokami ma szansę trafić do pakietu regresji i nie wrócić po następnej aktualizacji.

Priorytet zgłoszenia według sytuacji

Priorytet zgłoszenia według sytuacjiWykres słupkowy: priorytet 1 dla błędu jednego użytkownika, 2 dla powtarzalnego, 3 dla błędu w alarmie bezpieczeństwa.0123poziom (3 = najwyższy)Błąd jednego użytkownika: 1 poziom (3 = najwyższy)1Błąd jednego użytkownikaBłąd powtarzalny u wielu osób: 2 poziom (3 = najwyższy)2Błąd powtarzalny u wieluosóbBłąd w alarmie bezpieczeństwa: 3 poziom (3 = najwyższy)3Błąd w alarmiebezpieczeństwa
Źródło: Opracowanie InnerWeb na podstawie kart i

Co dostawca widzi sam i czego nie musisz opisywać

Wszystkie instancje zgłaszają niewychwycone wyjątki do jednego projektu monitoringu błędów. Oznacza to, że poważny błąd serwera dostawca zwykle widzi sam, jeszcze zanim ktoś go zgłosi. Zgłoszenie użytkownika wciąż jest potrzebne, bo wnosi kontekst: co robił operator i jaki skutek zobaczył.

Automatyczne testy przeglądarkowe kończą się błędem, gdy pojawi się nieprzechwycony wyjątek JavaScript albo błąd serwera. Z tego powodu takie błędy są w pierwszej kolejności wychwytywane przez automat, a zgłoszenie od człowieka najbardziej przydaje się przy problemach, które nie wyrzucają wyjątku: zły wynik, brakujący wpis, mylący ekran.

Jeśli ten sam błąd powtarza się u wielu osób albo w kilku miejscach systemu, napisz to w zgłoszeniu: powtarzalność i liczba osób pomagają dostawcy ocenić priorytet i zakres problemu. Sposób, w jaki dostawca grupuje błędy w jednym monitoringu, opisujemy w osobnym przypadku.

Dowód do audytu i śledzenie zgłoszenia

Dla działu bezpieczeństwa informacji liczy się ślad: kto zgłosił, kiedy, jaką wersję podał i kiedy dostał odpowiedź. Warto prowadzić rejestr zgłoszeń po stronie zakładu, z numerem zgłoszenia dostawcy, wersją, datą i statusem.

Gdy dostawca potwierdzi błąd, sprawdź w jego odpowiedzi, czy wskazał wersję, w której poprawka zostanie wydana. Pozwala to później zweryfikować, że po aktualizacji błąd zniknął, na przykład przez ponowne przejście kroków ze zgłoszenia. Szczegóły odbioru po aktualizacji opisujemy w checkliście odbioru aktualizacji.

Materiał wideo

Często zadawane pytania

Czy muszę zgłaszać błąd, skoro dostawca ma monitoring?

Tak, jeśli błąd nie wyrzuca wyjątku. Monitoring widzi niewychwycone wyjątki, ale nie widzi złego wyniku, brakującego wpisu ani mylącego ekranu.

Skąd wziąć wersję systemu do zgłoszenia?

Wersja wydania to skrót commita wdrożonego obrazu. Zapytaj administratora zakładu lub dostawcę, gdzie jest ona widoczna w Waszej instalacji.

Czy komunikat o braku dostępu to awaria?

Zwykle nie. Błędy dostępu są wyłączone z raportowania jako nie-awarie, więc najpierw sprawdź uprawnienia użytkownika.

Uzgodnij proces zgłoszeń

Pokażemy wzór zgłoszenia i ścieżkę obsługi w Waszym zakładzie. Umów rozmowę z InnerWeb.

Porozmawiajmy