L'esecuzione di una diagnostica delle prestazioni può aiutare gli sviluppatori a identificare le cause di un elevato utilizzo della CPU, di rallentamenti o di un consumo eccessivo di memoria in Thunderbird. Prima di iniziare, verificare se il problema scompare quando Thunderbird viene avviato in Modalità risoluzione problemi. Potrebbe anche essere utile consultare l'elenco per il controllo delle prestazioni (documentazione in inglese).

Alcuni tipi di diagnostica richiedono l'utilizzo di una versione di sviluppo di Thunderbird, disponibile dalla pagina di download di Thunderbird.

La diagnostica delle prestazioni utilizza uno strumento chiamato "performance profiler" (profiler delle prestazioni). Thunderbird utilizza il profiler di Firefox, quindi alcune finestre di dialogo potrebbero fare riferimento a Firefox. La documentazione del profiler di Firefox (in inglese) è eccellente, ma di solito non è necessaria a meno che non si incontrino difficoltà o si debbano eseguire attività speciali come la profilazione dell'avvio. Nella documentazione, ogni istanza della parola "Firefox" deve essere intesa come "Thunderbird".

Preparazione del Performance Profiler

Il profiler delle prestazioni fa parte della Cassetta degli strumenti di sviluppo.

Apertura della Cassetta degli strumenti di sviluppo

Nella finestra principale di Thunderbird, aprire la cassetta degli strumenti di sviluppo:

1. Utilizzare la scorciatoia da tastiera Ctrl + Maiusc + Icommand + option + I, oppure fare clic sul pulsante del menu di Thunderbird e scegliere Strumenti.
2. Dal menu, selezionare Strumenti di sviluppo. Apparirà una richiesta di connessione in entrata.
   
   

   Importante: per consentire alla cassetta degli strumenti di sviluppo di connettersi a Thunderbird, è necessario approvare la connessione nella richiesta. La finestra di richiesta potrebbe essere nascosta dietro altre finestre di Thunderbird.

3. Fare clic su OK. Si aprirà la finestra Strumenti di sviluppo. Nelle versioni attuali di Thunderbird, la scheda Prestazioni è visibile e facendovi clic viene mostrato il pulsante Avvia registrazione.
   Se la scheda non è visibile:

   • Premere F1 o fare clic sul pulsante nell'angolo in alto a destra della finestra e scegliere Impostazioni. Si aprirà la finestra delle impostazioni degli strumenti di sviluppo.
   • Assicurarsi che nella sezione Strumenti di sviluppo predefiniti l'opzione [✓] Prestazioni sia attivata. Se non è attivata:

   • attivarla, quindi fare clic sulla scheda Prestazioni che appare nella parte superiore della finestra degli strumenti di sviluppo.

Configurazione delle impostazioni del profiler

Per configurare le impostazioni del profiler:

1. In fondo alla scheda Prestazioni, fare clic su Modifica impostazioni…. Si aprirà una finestra di Thunderbird con la scheda delle impostazioni del profiler attiva.
2. Nella sezione Impostazioni del profiler, attivare il pulsante di opzione Thunderbird (nelle versioni nightly/trunk, il pulsante Daily). Dopo aver modificato altre opzioni, questo pulsante si disattiverà automaticamente e si attiverà il pulsante Custom (Personalizzato).
3. Nella sezione Funzionalità, attivare la casella di controllo All File IO.
4. Per proteggere la privacy o ridurre l'utilizzo della memoria, scorrere verso il basso e disattivare la casella di controllo Screenshots.
5. Se necessario, regolare altre impostazioni. Ad esempio:
   • Modificare l'opzione Native Allocations disponibile in Thunderbird Daily se si sta diagnosticando un utilizzo elevato della memoria.
   • Aumentare la dimensione del buffer da 1 GB a 2 GB ed estendere l'intervallo di campionamento oltre il valore predefinito di 1 ms se la riproduzione del problema richiede più di un minuto di registrazione o se sono attivate raccolte di dati aggiuntive.
6. Chiudere la finestra delle impostazioni del profiler utilizzando i controlli della finestra: non sono presenti i pulsanti OK o Salva.

Registrazione di una diagnostica delle prestazioni

Quando il profiler e lo scenario di test sono pronti, è possibile iniziare a registrare e salvare la diagnostica delle prestazioni.

1. Nella scheda Prestazioni della finestra degli strumenti di sviluppo, fare clic sul pulsante Avvia registrazione.

   Nota: potrebbe apparire un'icona di avviso sulla barra degli strumenti. Facendovi clic si apre una console nella parte inferiore della finestra con il messaggio "Failed to get the active browserId while starting the profiler", che può essere ignorato.

2. Dopo l'avvio della registrazione, tornare rapidamente alla finestra principale di Thunderbird ed eseguire le azioni dello scenario di test.
3. Al termine, tornare immediatamente alla finestra degli strumenti di sviluppo e fare clic su Acquisizione registrazione per interrompere la raccolta dei dati. Apparirà per un breve istante il messaggio Acquisizione profilo in corso, seguito dalla finestra del profiler di Firefox che visualizza i dati registrati.

Salvataggio e condivisione dei risultati della diagnostica delle prestazioni

Per salvare e condividere i risultati della diagnostica delle prestazioni:

1. Fare clic sul pulsante Carica profilo locale nell'angolo in alto a destra della finestra del profiler.

   

2. Nel pannello "Condividi profilo delle prestazioni", selezionare le caselle di controllo per le informazioni private che si desidera includere. Per impostazione predefinita, nessuna informazione privata è inclusa nel profilo delle prestazioni.

   

3. Fare clic sul pulsante per salvare un file JSON in locale. È quindi possibile inviarlo via email o allegarlo a una segnalazione di bug.
4. Fare clic sul pulsante per caricare il profilo nel repository del profiler di Firefox e generare un link diretto (permalink). Il link diventa disponibile dopo aver fatto clic sul pulsante Permalink nella finestra del profiler. È possibile copiarlo e condividerlo con gli sviluppatori o con altri che possono aiutare a diagnosticare il problema, oppure allegarlo a una nuova o esistente segnalazione di bug su Bugzilla (BMO).

   

5. Chiudere la finestra del profiler delle prestazioni.
6. Chiudere la finestra degli strumenti di sviluppo.

Diagnostica dell'avvio e dell'arresto di Thunderbird

La diagnostica dell'avvio o dell'arresto richiede di seguire istruzioni speciali ma molto semplici (in inglese). Come in precedenza, ogni istanza della parola "Firefox" deve essere intesa come "Thunderbird".