InnerWeb
Přejít na obsah

Jak nahlásit chybu systému dodavateli: průvodce

Dobré hlášení chyby zkracuje dobu opravy, protože dodavatel může problém zreprodukovat hned, bez řady dotazů. Průvodce ukazuje, co popsat, jakou verzi uvést, které chyby dodavatel stejně vidí sám a jak odlišit výpadek od chyby uživatele.

3
situace k rozlišení: chyba jednoho uživatele, opakovatelná chyba, chyba v bezpečnostním alarmu
6
stálých prvků dobrého hlášení (verze, kdo a kdy, cíl, kroky, účinky, důkaz)

Nejdřív zjistěte, zda jde vůbec o chybu systému

Ne každé hlášení na obrazovce je výpadek. Výjimky popisující chybná vstupní data, jako je chybějící přístup, chybějící stránka nebo chybný požadavek, jsou z hlášení vyloučeny jako ne-výpadky. Pokud operátor vidí hlášení o nedostatku oprávnění, nejdřív zkontrolujte roli uživatele a teprve potom hlaste chybu.

Vyplatí se také rozlišit tři situace: chybu viditelnou pro jednoho uživatele, opakovatelnou chybu u více osob a chybu v bezpečnostním alarmu. Třetí situace má nejvyšší prioritu. Bezpečnostní alarmy práce nejsou vypínány: pokud alarm nedorazil nebo zazvonil chybně, nahlaste to okamžitě a uveďte hodinu, aby dodavatel událost našel v logu.

Jak popsat chybu krok za krokem

Hlášení má být napsáno tak, aby ho člověk, který neviděl vaši obrazovku, mohl chybu zopakovat. Takový popis se skládá z několika stálých prvků.

  • Verze systému: zkratka vydání viditelná v systému. V hlášeních o chybách je verzí vydání zkratka commitu nasazeného obrazu, stejná jako značka obrazu v registru, takže chybu lze přiřadit ke konkrétní změně.
  • Kdo a kdy: role uživatele a přesný čas události, nejlépe s hodinou.
  • Co chtěl uživatel udělat: jedna věta o cíli, například vystavit povolení k práci.
  • Kroky: číslovaný seznam kliknutí od přihlašovací obrazovky až po okamžik chyby.
  • Očekávaný a viditelný výsledek: dvě krátké věty.
  • Důkaz: snímek obrazovky s viditelným hlášením a případně hodina z hodin zařízení.

Proč jsou číslované kroky důležitější než obecný popis

Prohlížečové testy E2E napodobují uživatele krok za krokem: přihlášení, administrační panel, plánování prací, povolení, hlášení, dokumentaci, mapy a analytiku. Dodavatel převede dobrý popis kroků na test, takže hlášení s kroky má šanci skončit v sadě regresí a nevrátit se při další aktualizaci.

Priorita hlášení podle situace

Priorita hlášení podle situaceSloupcový graf: priorita 1 pro chybu jednoho uživatele, 2 pro opakovatelnou chybu a 3 pro chybu v bezpečnostním alarmu.0123úroveň (3 = nejvyšší)Chyba jednoho uživatele: 1 úroveň (3 = nejvyšší)1Chyba jednoho uživateleOpakovatelná chyba u více osob: 2 úroveň (3 = nejvyšší)2Opakovatelná chyba u víceosobChyba v bezpečnostním alarmu: 3 úroveň (3 = nejvyšší)3Chyba v bezpečnostním alarmu
Zdroj: Zpracování InnerWeb na základě karet a

Co dodavatel vidí sám a co nemusíte popisovat

Všechny instance hlásí neodchycené výjimky do jednoho projektu monitoringu chyb. To znamená, že vážnou chybu serveru dodavatel obvykle vidí sám, ještě než ji někdo nahlásí. Hlášení uživatele je přesto potřebné, protože přináší kontext: co operátor dělal a jaký účinek viděl.

Automatické prohlížečové testy skončí chybou, když se objeví neodchycená výjimka JavaScriptu nebo chyba serveru. Takové chyby proto nejdříve zachytí automat, a hlášení od člověka je nejvíce užitečné u problémů, které žádnou výjimku nevyhodí: špatný výsledek, chybějící záznam, matoucí obrazovka.

Pokud se stejná chyba opakuje u více osob nebo na více místech systému, napište to do hlášení: opakovatelnost a počet osob pomáhají dodavateli posoudit prioritu a rozsah problému. Způsob, jakým dodavatel seskupuje chyby v jednom monitoringu, popisujeme v samostatném případu.

Důkaz pro audit a sledování hlášení

Pro oddělení bezpečnosti informací je důležitá stopa: kdo nahlásil, kdy, jakou verzi uvedl a kdy dostal odpověď. Vyplatí se vést evidenci hlášení na straně provozovny, s číslem hlášení dodavatele, verzí, datem a stavem.

Pokud dodavatel chybu potvrdí, zkontrolujte v jeho odpovědi, zda uvedl verzi, ve které bude oprava vydána. Umožní to později ověřit, že po aktualizaci chyba zmizela, například opětovným projitím kroků z hlášení. Podrobnosti odběru po aktualizaci popisujeme v kontrolním seznamu přejímky aktualizací.

Videomateriál

Často kladené otázky

Musím chybu hlásit, když má dodavatel monitoring?

Ano, pokud chyba nevyhodí výjimku. Monitoring vidí neodchycené výjimky, ale nevidí špatný výsledek, chybějící záznam ani matoucí obrazovku.

Odkud vzít verzi systému do hlášení?

Verze vydání je zkratka commitu nasazeného obrazu. Zeptejte se správce provozovny nebo dodavatele, kde je ve vaší instalaci viditelná.

Je hlášení o nedostatku přístupu výpadek?

Obvykle ne. Chyby přístupu jsou vyloučeny z hlášení jako ne-výpadky, takže nejdřív zkontrolujte oprávnění uživatele.

Domluvte se na procesu hlášení

Ukážeme vzor hlášení a postup řešení ve vaší provozovně. Domluvte si schůzku s InnerWeb.

Pojďme si promluvit