Przeprowadzenie diagnostyki wydajności może być przydatne dla programistów, aby znaleźć w Thunderbirdzie przyczyny wysokiego obciążenia procesora, spowolnień lub dużego użycia pamięci. Przed rozpoczęciem diagnostyki, należy sprawdzić, czy problem ustępuje po uruchomieniu Thunderbirda w trybie rozwiązywania problemów. Pomocne może być także zapoznanie się z listą kontrolną wydajności.

Niektóre typy diagnostyki wymagają użycia wersji rozwojowej Thunderbirda, dostępnej na stronie pobierania Thunderbirda.

Do diagnostyki wykorzystywane jest narzędzie zwane profilerem wydajności. W Thunderbirdzie jest wykorzystywany profiler Firefoksa dlatego w oknach dialogowych mogą pojawiać się odwołania do Firefoksa. Dokumentacja profilera Firefoksa jest bardzo dobra, jednak zwykle nie jest potrzebna, chyba że występują trudności lub wymagane jest wykonanie czynności specjalnych, takich jak profilowanie uruchamiania. W dokumentacji każde wystąpienie słowa „Firefox” należy rozumieć jako „Thunderbird”.

Przygotowanie profilera wydajności

Profiler wydajności jest częścią Narzędzi dla programistów.

Otwieranie narzędzi dla programistów

W głównym oknie Thunderbirda otwórz narzędzia dla programistów:

1. Użyj skrótu klawiaturowego Ctrl + Shift + Icommand + option + I lub w oknie Thunderbirda kliknij przycisk menu i wybierz Narzędzia.
2. Z wyświetlonego menu wybierz Narzędzia dla programistów. Zostanie wyświetlony monit połączenia przychodzącego.
   
   

   Ważne! Aby umożliwić połączenie narzędzi dla programistów z Thunderbirdem, należy w wyświetlonym monicie zezwolić na połączenie.
   Okno monitu może być ukryte za innymi oknami Thunderbirda.

3. Kliknij przycisk OK. Zostanie wyświetlone okno Narzędzia dla programistów. W aktualnych wersjach Thunderbirda widoczna jest karta Wydajność po kliknięciu, której widoczny jest przycisk Rozpocznij nagrywanie.
   Jeśli karta nie jest widoczna:

   • Naciśnij klawisz F1 lub kliknij znajdujący się w prawym górnym rogu okna przycisk i z wyświetlonego menu wybierz Ustawienia. Zostanie wyświetlone okno ustawień narzędzi dla programistów.
   • Upewnij się, że w sekcji Domyślne narzędzia dla programistów jest zaznaczony element [✓] Wydajność. Jeśli nie jest zaznaczony:

   • zaznacz go, a następnie kliknij kartę Wydajność, która pojawi się na górze okna narzędzi dla programistów.

Konfiguracja ustawień profilera

Aby skonfigurować ustawienia profilera:

1. Na dole karty Wydajność kliknij Zmień ustawienia…. Zostanie wyświetlone okno Thunderbirda z aktywną kartą ustawień profilera.
2. W sekcji Ustawienia profilera aktywuj, jeśli nie jest już aktywny, przycisk typu „radio” Thunderbird (w wersjach nightly/trunk przycisk Daily). Po dokonaniu zmian innych opcji aktywny przycisk zostanie automatycznie dezaktywowany, a zostanie aktywowany przycisk Inne.
3. W sekcji Funkcje zaznacz pole wyboru All File IO.
4. W celu ochrony prywatności lub zmniejszenia użycia pamięci, przewiń w dół i odznacz pole wyboru Screenshots.
5. W razie potrzeby zmień inne ustawienia. Na przykład:
   • zmień opcję Native Allocations dostępną w wersji Thunderbird Daily w przypadku problemów z dużym użyciem pamięci,
   • zwiększ rozmiar bufora z 1 GB do 2 GB oraz wydłuż przedział próbkowania z domyślnej wartości 1 ms, jeśli do odtworzenia problemu potrzebna jest dłuższa niż jedno minutowa rejestracja lub dodano dodatkowe kolekcje danych.
6. Zamknij okno ustawień profilera za pomocą elementów sterujących okna – nie ma przycisku OK lub Zapisz.

Nagrywanie diagnostyki wydajności

Gdy profiler i scenariusz są gotowe, można przystąpić do nagrywania i zapisywania diagnostyki wydajności.

1. Na karcie Wydajność w oknie narzędzi dla programistów kliknij przycisk Rozpocznij nagrywanie.

   Informacja. Na pasku narzędzi może pojawić się ikona ostrzeżenia po kliknięciu, której na dole okna wyświetli się konsola zawierająca komunikat: „Failed to get the active browserId while starting the profiler” – można go zignorować.

2. Po uruchomieniu nagrywania szybko wróć do głównego okna Thunderbirda i wykonaj zestaw czynności wg przygotowanego scenariusza.
3. Po zakończeniu niezwłocznie wróć do okna narzędzi dla programistów i kliknij przycisk Przechwyć nagranie, aby zakończyć zbieranie danych. Przez chwilę będzie widoczny komunikat Przechwytywanie profilu, po czym zostanie wyświetlone okno profilera Firefoksa z zawartością nagrania.

Zapisywanie i udostępnianie wyników diagnostyki wydajności

Aby zapisać i udostępnić wyniki diagnostyki wydajności:

1. Kliknij przycisk Upload Local Profile znajdujący się w prawym górnym rogu okna profilera.

   

2. W wyświetlonym panelu „Share Performance Profile” zaznacz pola wyboru odpowiadające informacjom prywatnym, które mają być zawarte w profilu. Domyślnie w profilu wydajności nie są zawarte informacje prywatne.

   

3. Kliknij przycisk , aby zapisać lokalnie plik w formacie JSON, który będzie można wysłać pocztą elektroniczną lub dołączyć do zgłoszenia błędu.
4. Kliknij przycisk , aby wysłać profil do repozytorium na stronie profilera Firefoksa i wygenerować odnośnik bezpośredni (permalink). Odnośnik jest dostępny do skopiowania po kliknięciu przycisku Permalink znajdującym się w oknie profilera. Odnośnik można skopiować i udostępnić programistom lub innym osobom, które mogą pomóc w rozwiązaniu problemu lub załączyć do nowego, lub istniejącego zgłoszenia błędu w Bugzilli (BMO).

   

5. Zamknij okno profilera wydajności.
6. Zamknij okno narzędzi dla programistów.

Diagnostyka uruchamiania i zamykania Thunderbirda

Diagnostyka uruchamiania lub zamykania wymaga zastosowania specjalnych, ale bardzo prostych instrukcji. Podobnie jak wcześniej, każde wystąpienie słowa „Firefox” należy rozumieć jako „Thunderbird”.