Dzienniki dla pomocy technicznej
Gdy coś się zacina, dzienniki są najszybszą drogą do przyczyny: YouniqMail zapisuje przebieg działań, ostrzeżenia i błędy na bieżąco do plików, które dokładnie odnotowują, co i kiedy poszło nie tak. Zgłoszenie do pomocy technicznej z dziennikami niemal zawsze oszczędza rundę pytań „czy możesz to opisać dokładniej?”.
Otwieranie folderu dzienników
Dział zatytułowany „Otwieranie folderu dzienników”Wygodna droga prowadzi przez aplikację: w Ustawienia → Zaawansowane w sekcji Dziennik zdarzeń przy Lokalizacja plików dziennika: ścieżka jest podana jako link. Kliknięcie go otwiera folder.
Jeśli aplikacja w ogóle się nie uruchamia, dotrzesz do folderu
bezpośrednio w systemie plików. Leży on w katalogu danych, w podfolderze
logs:
~/Library/Application Support/YouniqMail/logs/W Finderze: Idź → Idź do folderu… i wklej ścieżkę.
%APPDATA%\YouniqMail\logs\Wklej ten wiersz w takiej postaci do paska adresu Eksploratora,
%APPDATA% Windows rozwinie sam.
~/.config/YouniqMail/logs/Bieżący plik nazywa się main.log. Gdy osiągnie 5 MB, staje się
plikiem main.old.log i zaczyna się nowy; starsze wersje są przy tym
nadpisywane.
Logowanie debugowania
Dział zatytułowany „Logowanie debugowania”Do uporczywych przypadków służy poziom szczegółowy: przełącznik Włącz logowanie debugowania w Ustawienia → Zaawansowane. Aplikacja zapisuje wtedy znacznie dokładniej, także czas trwania wielu operacji, i działa przy tym nieco wolniej. Sensowna kolejność wygląda tak:
- Włącz logowanie debugowania.
- Wywołaj problem raz, celowo.
- Zbierz dzienniki i wyłącz poziom debugowania z powrotem.
Co jest w dziennikach, a czego w nich nie ma
Dział zatytułowany „Co jest w dziennikach, a czego w nich nie ma”Dzienniki zawierają przebieg techniczny: znaczniki czasu, komunikaty błędów, identyfikatory zainteresowanych kont i nazwy serwerów. Hasła, tokeny dostępu i klucze YouniqMail odfiltrowuje przed zapisem, a nazwy folderów są w wielu miejscach skracane. Treści ani tematów wiadomości w nich nie ma, mogą się jednak pojawić adresy e-mail. Jeśli ci na tym zależy, zajrzyj do plików przed przekazaniem; są to zwykłe pliki tekstowe.
Do pomocy technicznej
Dział zatytułowany „Do pomocy technicznej”Wyślij plik main.log (przy świeżo odtworzonym problemie wystarczy,
w innym razie dołącz też main.old.log) razem z trzema
informacjami:
- Co zrobiłeś? („pobrałem konto X”, „otworzyłem wiadomość z dużym załącznikiem”)
- Co się stało, a czego się spodziewałeś?
- Od kiedy? („po aktualizacji”, „od zmiany dostawcy”)
Pomocny jest poza tym raport diagnostyczny: w Ustawienia → Import / Eksport w sekcji Zgłoś problem przycisk Eksportuj raport diagnostyczny tworzy plik z wersją aplikacji, systemem operacyjnym, statystykami bazy danych (tylko liczby) i zanonimizowaną strukturą twoich reguł. Treści wiadomości, kontakty i hasła nie są w nim zawarte.
Dzięki temu poszukiwanie błędu jest w większości przypadków krótkie.