Przejdź do głównej zawartości

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?”.

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:

System operacyjny:
~/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.

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:

  1. Włącz logowanie debugowania.
  2. Wywołaj problem raz, celowo.
  3. Zbierz dzienniki i wyłącz poziom debugowania z powrotem.

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.

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.