L’exécution d’un diagnostic de performances peut aider développeurs et développeuses à identifier les causes d’une utilisation élevée du processeur, de ralentissements ou d’une consommation excessive de mémoire dans Thunderbird.

Avant de commencer, vérifiez si le problème disparaît lorsque Thunderbird est démarré en mode de dépannage. Il peut également être utile de consulter la liste de contrôle des performances sur le wiki.

Certains types de diagnostics nécessitent l’utilisation d’une version de développement de Thunderbird, disponible sur la page de téléchargement de Thunderbird.

Les diagnostics de performances utilisent un outil appelé le profileur de performances. Thunderbird utilise le profileur de Firefox, en conséquence certaines boîtes de dialogue peuvent faire référence à Firefox. La documentation en anglais du profileur de Firefox est excellente, mais n’est généralement pas nécessaire, sauf si vous rencontrez des difficultés ou devez effectuer des tâches spéciales telles que le profilage du démarrage. Dans la documentation, chaque occurrence du mot « Firefox » doit être comprise comme « Thunderbird ».

Préparation du profileur de performances

Le profileur de performances fait partie des Outils de développement.

Ouvrir les outils de développement

Dans la fenêtre principale de Thunderbird, ouvrez les outils de développement :

1. Utilisez le raccourci clavier Ctrl + Maj + ICommande + Option + I, ou cliquez sur le bouton de menu de Thunderbird et choisissez Outils
2. Dans le menu, sélectionnez Outils de développement. Une invite de connexion entrante apparaît.

   Important ! Pour permettre aux outils de développement de se connecter à Thunderbird, vous devez approuver la connexion dans l’invite. La fenêtre d’invite peut être masquée derrière d’autres fenêtres de Thunderbird.

3. Cliquez sur OK. La fenêtre Outils de développement s’ouvre. Dans les versions actuelles de Thunderbird, l’onglet Performances est visible et un clic dessus affiche le bouton Commencer l'enregistrement.
   Si l’onglet n’est pas visible :

   • Appuyez sur F1 ou cliquez sur le bouton dans le coin supérieur droit de la fenêtre et choisissez Paramètres. La fenêtre des paramètres des outils de développement s’ouvre.
   • Assurez-vous que, dans la section Outils de développement par défaut, l’option [✓] Performances est activée. Si ce n’est pas le cas :

   • activez-la, puis cliquez sur l’onglet Performances qui apparaît en haut de la fenêtre des outils de développement.

Configurer les paramètres du profileur

Pour configurer les paramètres du profileur :

1. Au bas de l’onglet Performances, cliquez sur Modifier les paramètres…. Une fenêtre de Thunderbird s’ouvre avec l’onglet des paramètres du profileur actif.
2. Dans la section Paramètres du profileur, activez le bouton radio Thunderbird (dans les versions Nightly/trunk, le bouton Daily). Après avoir modifié d’autres options, ce bouton se désactivera automatiquement et le bouton Custom deviendra actif.
3. Dans la section Fonctionnalités, cochez la case All File IO.
4. Pour protéger votre vie privée ou réduire l’utilisation de la mémoire, faites défiler vers le bas et décochez la case Screenshots.
5. Ajustez les autres paramètres si nécessaire. Par exemple :
   • Modifiez l’option Native Allocations disponible dans Thunderbird Daily si vous diagnostiquez une utilisation élevée de la mémoire.
   • Augmentez la taille du tampon de 1 Go à 2 Go et prolongez l’intervalle d’échantillonnage au-delà de la valeur par défaut de 1 ms si la reproduction du problème nécessite plus d’une minute d’enregistrement ou si des collectes de données supplémentaires sont activées.
6. Fermez la fenêtre des paramètres du profileur à l’aide des contrôles de la fenêtre – il n’y a pas de bouton OK ou Enregistrer

Enregistrer un diagnostic de performances

Lorsque le profileur et le scénario de test sont prêts, vous pouvez commencer à enregistrer et à sauvegarder le diagnostic de performances.

1. Dans l’onglet Performances de la fenêtre des outils de développement, cliquez sur le bouton Commencer l’enregistrement.

   Note : une icône d’avertissement peut apparaître dans la barre d’outils. Un clic dessus ouvre une console en bas de la fenêtre avec le message « Failed to get the active browserId while starting the profiler » – vous pouvez l’ignorer.

2. Une fois l’enregistrement commencé, retournez rapidement à la fenêtre principale de Thunderbird et effectuez les actions de votre scénario de test.
3. Une fois terminé, retournez immédiatement à la fenêtre des outils de développement et cliquez sur Capturer l’enregistrement pour arrêter la collecte de données. Un bref message Capture du profil apparaît, suivi de la fenêtre du profileur de Firefox affichant les données enregistrées.

Sauvegarder et partager les résultats du diagnostic de performances

Pour sauvegarder et partager les résultats du diagnostic de performances :

1. Cliquez sur le bouton Envoyer le profil local dans le coin supérieur droit de la fenêtre du profileur.

   

2. Dans le panneau « Partager le profil de performances », cochez les cases correspondant aux informations privées que vous souhaitez inclure. Par défaut, aucune information privée n’est incluse dans le profil de performances.

   

3. Cliquez sur le bouton pour enregistrer un fichier JSON localement. Vous pouvez ensuite l’envoyer par e-mail ou le joindre à un rapport de bogue.
4. Cliquez sur le bouton pour envoyer le profil vers le dépôt du le profileur de Firefox et générer un lien direct (permalien). Le lien devient disponible après avoir cliqué sur le bouton Permalien dans la fenêtre du profileur. Vous pouvez le copier et le partager avec des développeurs, développeuses ou d’autres personnes qui peuvent aider à diagnostiquer le problème, ou le joindre à un nouveau rapport de bogue ou à un rapport existant dans Bugzilla (BMO).

   

5. Fermez la fenêtre du profileur de performances.
6. Fermez la fenêtre des outils de développement.

Diagnostiquer le démarrage et l’arrêt de Thunderbird

Le diagnostic du démarrage ou de l’arrêt nécessite de suivre des instructions spéciales en anglais, mais très simples. Comme précédemment, chaque occurrence du mot « Firefox » doit être comprise comme « Thunderbird ».