| Termin | Definicja |
|---|---|
| Historia problemów | Historia problemów to zestawienie wcześniej zgłoszonych i rozwiązanych usterek oprogramowania. Historia problemów jako zapis doświadczeń z oprogramowaniemHistoria problemów to uporządkowany opis usterek, które wcześniej pojawiły się w programie, systemie operacyjnym albo określonym środowisku pracy, a następnie zostały przeanalizowane i usunięte. Taki zapis nie służy wyłącznie do odnotowania, że wystąpił błąd. Powinien również wyjaśniać, w jakich warunkach doszło do awarii, jakie objawy zostały zauważone, jakie działania podjęto oraz jaki rezultat przyniosła naprawa. Dzięki temu kolejne zgłoszenie o podobnym charakterze może zostać rozpoznane szybciej, bez rozpoczynania całego procesu od podstaw. W praktyce historia problemów może dotyczyć pojedynczego programu, całego komputera, konta użytkownika, urządzenia peryferyjnego albo zależności pomiędzy kilkoma elementami systemu. Warto rozróżniać błąd, jego skutek oraz przyczynę. Na przykład zamknięcie aplikacji może być skutkiem uszkodzonego pliku konfiguracyjnego, niezgodności po aktualizacji, braku wymaganej biblioteki lub konfliktu ustawień. Samo zapisanie komunikatu wyświetlonego na ekranie nie daje jeszcze pełnego obrazu sytuacji. Przydatne stają się informacje o czasie wystąpienia, powtarzalności, ostatnich zmianach i sposobie przywrócenia prawidłowego działania. Dobrze prowadzony zapis powinien być zrozumiały także po kilku tygodniach lub miesiącach. Zaleca się unikanie ogólnych określeń takich jak „program nie działa” i zastępowanie ich opisem możliwym do sprawdzenia. Warto podać, czy problem pojawia się przy uruchamianiu, zapisywaniu pliku, drukowaniu, logowaniu, pracy bez dostępu do sieci albo po wznowieniu komputera ze stanu uśpienia. Istotne jest również wskazanie, czy błąd występuje zawsze, tylko na określonym koncie, po konkretnym działaniu lub w połączeniu z wybranym urządzeniem. Historia problemów w kontekście diagnozy i porównańZnaczenie historii problemów najlepiej widać podczas porównywania bieżącego zdarzenia z wcześniejszymi przypadkami. Jeżeli podobny objaw został już opisany, można sprawdzić, czy przyczyna była identyczna, czy tylko rezultat wyglądał podobnie. Dwa przypadki zawieszania programu mogą mieć zupełnie różne źródła: jeden może wynikać z błędu konkretnej wersji aplikacji, a drugi z przeciążenia zasobów, wadliwego dodatku lub problemu z plikiem użytkownika. Porównanie dat, konfiguracji i wykonanych czynności pomaga uniknąć pochopnych wniosków. Historia problemów pełni także funkcję chronologiczną. Kolejne wpisy mogą pokazywać, że usterka zaczęła się po instalacji aktualizacji, zmianie sterownika, podłączeniu nowego sprzętu albo modyfikacji ustawień zabezpieczeń. Jeżeli po cofnięciu zmiany objaw znika, powstaje cenna wskazówka diagnostyczna. Nie oznacza to jednak, że każda zbieżność czasowa dowodzi związku przyczynowego. Dlatego przydatne jest odnotowanie nie tylko tego, co zmieniono, lecz także tego, jakie testy wykonano i jakie wyniki uzyskano. W dokumentacji można rozdzielić kilka poziomów informacji:
Takie rozdzielenie ogranicza ryzyko pomieszania faktów z interpretacją. Ułatwia również przekazanie sprawy innej osobie, ponieważ wiadomo, które elementy zostały sprawdzone, a które nadal wymagają potwierdzenia. Historia problemów a typowe problemy oprogramowaniaNajczęściej zapisywane są problemy pojawiające się po aktualizacjach, błędy uruchamiania, nieoczekiwane zamykanie aplikacji, utrata ustawień, trudności z otwieraniem dokumentów oraz nieprawidłowa współpraca z urządzeniami. W każdym z tych przypadków warto opisać zakres zjawiska. Jeżeli nie można otworzyć jednego pliku, sytuacja różni się od tej, w której nie otwiera się żaden dokument danego typu. Jeżeli błąd występuje na jednym koncie, a na innym nie, może to wskazywać na ustawienia profilu, uprawnienia lub dane zapisane lokalnie. W historii problemów powinno się odnotować również problemy pozornie błahe. Powolne uruchamianie, chwilowe znikanie połączenia, opóźniona reakcja klawiatury albo powracający monit o logowanie mogą z czasem prowadzić do poważniejszych utrudnień. Pojedynczy incydent bywa trudny do oceny, natomiast seria krótkich wpisów może ujawnić wzorzec. Zestawienie częstotliwości, pory występowania i wykonywanych wtedy czynności pozwala ustalić, czy problem jest losowy, czy pojawia się w określonych warunkach. Warto zachować treść komunikatów oraz oznaczenia wersji programu, o ile są dostępne. Pomocne bywają także informacje o tym, czy ponowne uruchomienie rozwiązało sytuację na stałe, czy tylko chwilowo. Jeżeli wykonano przywracanie ustawień, ponowną instalację, naprawę plików albo zmianę konfiguracji, należy opisać kolejność tych działań. Ma to znaczenie, ponieważ kilka czynności wykonanych jednocześnie utrudnia ustalenie, która z nich przyniosła poprawę. Nie powinno się usuwać wcześniejszych wpisów tylko dlatego, że problem został rozwiązany. Lepszym rozwiązaniem jest oznaczenie stanu sprawy i zachowanie opisu zastosowanej metody. Po pewnym czasie może się okazać, że podobny błąd powrócił po innej aktualizacji lub na innym urządzeniu. Wtedy wcześniejsza dokumentacja staje się punktem odniesienia, a nie niepotrzebnym archiwum. Historia problemów i praktyczne wskazówki prowadzenia wpisówNajbardziej użyteczny wpis powstaje bezpośrednio po wystąpieniu usterki, kiedy szczegóły są jeszcze łatwe do odtworzenia. Można zastosować stały schemat: data, element którego dotyczy zdarzenie, objaw, sposób wywołania, ostatnie zmiany, wykonane testy, wynik oraz aktualny status. W przypadku powtarzających się błędów warto zapisywać każdy incydent osobno, nawet gdy rozwiązanie za każdym razem wygląda podobnie. Ułatwia to ocenę częstotliwości i sprawdzenie, czy problem rzeczywiście został usunięty. Opis powinien być rzeczowy i pozbawiony ocen. Sformułowanie „program działa źle” niewiele wyjaśnia, natomiast „po wybraniu funkcji eksportu okno przestaje odpowiadać, a po ponownym uruchomieniu plik nie zostaje utworzony” wskazuje konkretny przebieg. Przydatne jest zaznaczenie, czy można odtworzyć problem oraz czy istnieje bezpieczne obejście. Jeżeli zastosowano rozwiązanie tymczasowe, nie należy oznaczać sprawy jako całkowicie zamkniętej. Nie należy umieszczać w historii problemów haseł, pełnych danych logowania, kluczy dostępu ani innych informacji, które mogłyby narazić użytkownika na utratę kontroli nad kontem. W razie potrzeby można zapisać, że dane uwierzytelniające zostały odświeżone, bez kopiowania ich do dokumentacji. Zrzuty ekranu i pliki dziennika mogą być pomocne, ale powinny być opisane i przechowywane w sposób uporządkowany. W przeciwnym razie załączniki szybko tracą wartość, ponieważ nie wiadomo, którego zdarzenia dotyczą. Po zakończeniu naprawy warto przeprowadzić krótki test kontrolny. Należy sprawdzić działanie funkcji, która wcześniej powodowała błąd, oraz kilka powiązanych czynności. Wpis powinien zawierać informację, czy test zakończył się poprawnie, czy problem zmienił charakter, a także czy potrzebna jest dalsza obserwacja. Taki sposób prowadzenia dokumentacji ogranicza powtarzanie tych samych eksperymentów i ułatwia planowanie kolejnych działań. Historia problemów i moment zgłoszenia do serwisuZgłoszenie warto rozważyć wtedy, gdy usterka powtarza się, narasta, uniemożliwia pracę albo zaczyna dotyczyć kolejnych programów. Szczególnej uwagi wymagają sytuacje, w których występują samoczynne restarty, utrata dostępu do danych, problemy z uruchamianiem systemu, nietypowe dźwięki, przegrzewanie lub nagłe pogorszenie stabilności. Nie zaleca się wielokrotnego wykonywania przypadkowych zmian bez zapisu ich kolejności, ponieważ może to utrudnić późniejsze ustalenie źródła problemu. Przed przekazaniem zgłoszenia dobrze jest przygotować krótką historię problemów: kiedy pojawił się pierwszy objaw, czego dotyczył, czy wcześniej wykonywano aktualizację lub instalację, jakie działania już przeprowadzono i jaki był ich skutek. Jeżeli problem dotyczy konkretnego pliku, można wskazać jego typ oraz sposób powstania, bez przekazywania poufnej zawartości. W przypadku trudności z uruchomieniem przydatny bywa opis ostatniego poprawnego działania i tego, co wydarzyło się później. W sprawach wymagających oględzin sprzętu albo pogłębionej analizy można skorzystać z Warszawskiego Pogotowia Komputerowego 24/7, przekazując przygotowany opis i najważniejsze obserwacje. Taka dokumentacja ułatwia uporządkowanie zgłoszenia, ogranicza liczbę pytań wstępnych i pozwala skupić się na sprawdzeniu najbardziej prawdopodobnych przyczyn. Nie zastępuje ona diagnozy, lecz stanowi wartościowy punkt wyjścia do dalszych czynności. Po zakończeniu sprawy warto uzupełnić wpis o końcowe rozpoznanie, zakres wykonanych działań i zalecenia na przyszłość. Dzięki temu historia problemów pozostaje użyteczna zarówno przy podobnych usterkach, jak i podczas oceny ogólnej stabilności komputera. Regularne porządkowanie takich informacji pomaga odróżnić pojedynczy incydent od powtarzającego się wzorca i wcześniej zauważyć sygnały wymagające reakcji. |