Jak rejestrować i udostępniać dzienniki błędów za pomocą Loom
Loom umożliwia zespołom rejestrowanie problemów technicznych, pomagając im łączyć kontekst wizualny z odpowiednimi dziennikami, pulpitami nawigacyjnymi i komunikatami systemowymi. Zamiast polegać wyłącznie na opisach pisemnych, zespoły mogą zobaczyć, jak doszło do błędu, co pojawiło się na ekranie i jakie kroki do niego doprowadziły.
Może to sprawić, że zgłoszenia błędów, eskalacje i przeglądy incydentów będą łatwiejsze do zrozumienia i pozwolą na szybsze podjęcie działań.
Krok 1. Identyfikacja i reprodukcja problemu
Przed nagraniem omówienia potwierdź dokładny problem, który chcesz zarejestrować. Wykonaj te same kroki, które doprowadziły do jego wystąpienia, i odnotuj informacje o środowisku, działaniach użytkownika oraz warunkach, w których doszło do problemu.
Celem jest upewnienie się, że problem można w sposób powtarzalny zreprodukować przed jego nagraniem. Niektóre błędy pojawiają się tylko w określonych warunkach, dlatego istotne mogą być takie szczegóły jak przeglądarka, urządzenie, rola użytkownika, ustawienia konta czy moment wystąpienia problemu.
Krok 2. Przygotowanie odpowiednich dzienników i kontekstu technicznego
Następnie otwórz narzędzia deweloperskie, pulpity monitorujące lub dzienniki systemowe, które pokazują błąd. Poszukaj znacznika czasu, który odpowiada dokładnemu czasowi wystąpienia błędu. Zanotuj wszystkie komunikaty o błędach i kody, które mogą dostarczyć szczegółowych informacji na temat błędu.
Warto też przeanalizować, co dzieje się bezpośrednio przed wystąpieniem błędu i po nim, aby uzyskać więcej kontekstu.
Krok 3. Nagranie omówienie problemu w Loom
Po zreprodukowaniu problemu i otwarciu odpowiednich dzienników skorzystaj z rejestratora ekranu Loom, aby nagrać czytelną prezentację krok po kroku.
Podczas nagrywania opisz oczekiwane zachowanie i jasno wyjaśnij, gdzie występuje problem. Wyraźne wskazanie problemu może pomóc zespołom IT lub inżynieryjnym w jego zreprodukowaniu i zbadaniu przyczyny. Możesz również użyć Loom do nagrania komentarza głosowego po zakończeniu rejestrowania problemu.
Krok 4. Wyróżnienie komunikatów o błędach i odpowiedzi systemu
Podczas nagrywania zwróć uwagę na konkretne komunikaty, alerty, nieudane żądania lub nieoczekiwane zachowanie, które mogą pomóc w wyjaśnieniu problemu. Pomoże to osobom oglądającym nagranie powiązać to, co widzą na ekranie, ze szczegółami technicznymi w dziennikach.
Nie ograniczaj się do informowania, że wystąpił błąd. Wyjaśnij, jak wpływa on na wrażenia użytkowników, jaki przepływ pracy przerywa i dlaczego wymaga uwagi. Dodatkowy kontekst może pomóc zespołom ustalić priorytety zgłoszenia i zdecydować, co należy zbadać w pierwszej kolejności.
Krok 5. Udostępnienie nagrania z Loom interesariuszom
Po zakończeniu nagrywania film zostanie automatycznie przesłany na Twoje konto Loom. Loom utworzy też łącze do udostępniania, które możesz wysłać interesariuszom.
Nagranie z Loom możesz udostępnić interesariuszom za pośrednictwem aplikacji do współpracy, z których już korzystasz, takich jak Jira, Confluence czy Slack. Wyślij nagranie do inżynierów, menedżerów produktu lub zespołów wsparcia. Udostępnianie nagrań z Loom zespołom inżynieryjnym i wsparcia może ułatwić współpracę międzyfunkcyjną.
Skorzystaj z ustawień udostępniania Loom, aby odpowiednie osoby mogły wyświetlać nagranie i dodawać komentarze.
Krok 6. Udokumentowanie wyników i zapisanie nagrania do wykorzystania w przyszłości
Po rozwiązaniu problemu zachowaj nagranie z Loom wraz z resztą dokumentacji incydentu. Dzięki temu powstaje bardziej przejrzysty zapis tego, co się wydarzyło, jak pojawiło się zgłoszenie oraz jakie działania pomogły zespołowi je rozwiązać.
Nagrania mogą również ułatwiać przeglądy po incydentach, wdrażanie nowych osób oraz rozwiązywanie problemów w przyszłości. W bibliotece filmów w Loom zespoły mogą sortować nagrania według projektu, typu incydentu, daty lub systemu, co ułatwia ich późniejsze odnalezienie.