La creazione di un profilo delle prestazioni può essere utile agli sviluppatori per trovare le cause di un elevato carico della CPU, di lentezza o di un elevato utilizzo della memoria in Thunderbird. Ma prima, verificare se il problema si risolve in Modalità risoluzione problemi. Potrebbe anche essere utile consultare la lista di controllo delle prestazioni (in inglese).

Alcuni tipi di profilazione richiederanno l'utilizzo di una build di sviluppo che è possibile ottenere dalla pagina di download di Thunderbird Daily.

Verrà utilizzato il profiler delle prestazioni di Firefox, pertanto è possibile che vengano visualizzati riferimenti a Firefox nelle finestre di dialogo del profiler. La documentazione del profiler di Firefox (in inglese) è eccellente, ma sarà necessario consultarla solo se si riscontrano problemi o si desidera eseguire operazioni speciali, come la profilazione delle prestazioni di avvio. Nella documentazione, ovunque sia menzionato 'Firefox', si dovrà pensare a 'Thunderbird'.

Passo 1 - Preparazione della registrazione delle prestazioni in Thunderbird

Il registratore delle prestazioni fa parte della Cassetta degli strumenti di sviluppo disponibile in Thunderbird.

Prima di iniziare la registrazione, preparare il più possibile lo scenario da sottoporre al test in Thunderbird.

1. Nella finestra principale di Thunderbird, aprire la Cassetta degli strumenti di sviluppo: premere la combinazione di tasti Ctrl + Maiusc + ICommand + Shift + I, oppure fare clic su ≡ > Strumenti > Strumenti di sviluppo.

   Importante: confermare il messaggio di avviso Connessione in entrata… Consentire la connessione? con OK in modo che la cassetta degli strumenti possa connettersi all'applicazione Thunderbird.
   
   Nota: il messaggio di avviso potrebbe essere nascosto dietro altre finestre di Thunderbird.

2. Verrà visualizzata la finestra Strumenti di sviluppo.
3. Le versioni correnti di Thunderbird visualizzeranno la scheda Prestazioni mostrando il pulsante Avvia registrazione. Se non viene visualizzata quella scheda, premere il tasto F1, oppure fare clic sul pulsante ••• nell'angolo in alto a destra, quindi su Impostazioni. Assicurarsi che la casella [✓] Prestazioni sia contrassegnata. Fare quindi clic sulla scheda Prestazioni visualizzata nella parte superiore della cassetta degli strumenti.
4. Se viene visualizzato il messaggio "Failed to get the active browserId while starting the profiler", è possibile ignorarlo.
5. Configurare le impostazioni del profiler:
   1. Fare clic su Modifica impostazioni... che è l'ultimo elemento nella finestra Strumenti di sviluppo.
   2. Verrà visualizzata la finestra about:profiling.
   3. Selezionare il preset Thunderbird, se non è già selezionato. Dopo questo punto, quando si contrassegna qualsiasi altra impostazione, il preset cambierà in "Personalizzato" ("Custom"), il che è normale. (Se si utilizzano build nightly/trunk, selezionare il preset "Daily").
   4. Se si hanno problemi di privacy o per risparmiare memoria, deselezionare la casella di controllo per Screenshots.
   5. Scorrere verso il basso e contrassegnare anche la casella di controllo per All File IO.
   6. Modificare qualsiasi altra impostazione che potrebbe essere necessaria, ad esempio, Native Allocations (per problemi di memoria elevata. (Native Allocations richiede l'utilizzo delle build daily di Thunderbird.)
   7. Se è necessario più di un minuto per acquisire il problema che si sta profilando, o se sono state aggiunte alcune raccolte dati aggiuntive, potrebbe essere necessario regolare alcune Impostazioni del buffer (Buffer Settings), come aumentare la Dimensione del buffer (Buffer size) da 1 GB a 2 GB e aumentare l' Intervallo di campionamento (Sampling interval) dal valore predefinito di 1 ms.
   8. Chiudere la finestra about:profiling utilizzando i controlli della finestra (non sono presenti i pulsanti OK o Salva).
6. Importante: prima di avviare la registrazione delle prestazioni, tornare alla finestra principale di Thunderbird e completare la preparazione dello scenario da registrare.

Passo 2 - Registrazione di un profilo delle prestazioni

A questo punto si è pronti per registrare e salvare il profilo delle prestazioni del proprio scenario. Salvo diversa indicazione, cercare di mantenere la registrazione nei tempi strettamente necessari registrando solo la serie esatta di azioni che si sospetta causino il problema.

1. Nella scheda Prestazioni della finestra Strumenti di sviluppo, fare clic sul pulsante Avvia registrazione.
2. Senza indugiare, tornare alla finestra principale di Thunderbird ed eseguire la serie di azioni che si desidera registrare.
3. Al termine, selezionare immediatamente Acquisisci registrazione nella finestra Strumenti di sviluppo.

Passo 3 - Salvataggio e condivisione di un profilo delle prestazioni

1. Fare clic su Acquisisci registrazione per terminare il processo di raccolta e si visualizzerà brevemente il messaggio Acquisizione profilo in corso, che si concluderà con una finestra di Firefox Profiler all'indirizzo "https://profiler.firefox.com/from-browser/". Se non è stato visualizzato il pulsante di acquisizione, si sta utilizzando una versione precedente del profiler di Thunderbird. Saltare alla sezione Versioni precedenti di Thunderbird.
2. Fare clic su Carica profilo locale. Per il profilo che ci si prepara a condividere, è presente un elenco di elementi sotto "Includi dati aggiuntivi che potrebbero essere identificabili" ("Include additional data that may be identifiable"): deselezionare le caselle per tutti gli elementi di informazione privata che non si desidera condividere.
3. Scorrere verso il basso fino alle opzioni per il salvataggio dei dati. Utilizzare Scarica per salvare un file json locale che si potrà poi inviare privatamente via email a qualcun altro o allegare a una segnalazione di bug. Utilizzare Carica per inviare il profilo a un repository su https://profiler.firefox.com/. Carica fornirà un link permanente (permalink) nel formato https://share.firefox.dev/ che si potrà copiare e condividere con gli sviluppatori e con chiunque altro possa aiutare a risolvere il problema.
4. Chiudere la finestra Profiler delle prestazioni.
5. Chiudere la finestra Strumenti di sviluppo.

Versioni precedenti di Thunderbird

Le versioni precedenti di Thunderbird richiedono alcuni passaggi manuali per salvare il profilo.

1. Sul lato sinistro, accanto al nuovo elemento Registrazione #1 (Recording #1), fare clic sul link Salva (Save) e salvare il file in una posizione sul computer. L'estensione del file deve essere .json.
2. Collegarsi all'indirizzo https://profiler.firefox.com/.
3. Selezionare Carica profilo da file e selezionare quindi il file .json precedentemente salvato per eseguirne il caricamento.
4. Importante: in alto a destra, selezionare il pulsante verde Pubblica, quindi nel pannello Condividi profilo delle prestazioni (Share Performance Profile), selezionare di nuovo il pulsante (blu) Pubblica.
5. Copiare il link (ad esempio https://share.firefox.dev/1XYZXYz) che compare nell'angolo in alto a destra sotto il nuovo pulsante permalink e incollarlo in un nuovo bug appropriato o in un bug esistente su Bugzilla (BMO).
6. Infine, tornando di nuovo alla scheda Prestazioni degli Strumenti di sviluppo, si può eliminare il profilo delle prestazioni utilizzando l'icona del cestino appena sopra l'elenco dei profili nell'angolo in alto a sinistra (dove si è salvato il profilo), quindi chiudere la finestra Strumenti di sviluppo.

Profilazione dell'avvio e dello spegnimento di Thunderbird

La profilazione dell'avvio o dello spegnimento comporta istruzioni speciali, ma molto semplici (in inglese). Anche in questo caso, nella documentazione, ovunque viene menzionato "Firefox", le occorrenze "Firefox" andranno pensate come se fossero "Thunderbird".