Créer un profil de performances peut être utile aux développeurs et développeuses pour trouver les causes d’une charge processeur élevée, de lenteurs ou d’une utilisation mémoire importante dans Thunderbird. Mais d’abord, vérifiez si le problème disparaît en mode de dépannage. Il peut aussi être utile de consulter la liste de contrôle des performances (en anglais).

Certains types de profilage nécessitent l’utilisation d’une version de développement que vous pouvez obtenir sur la page de téléchargement de Thunderbird Daily.

Nous allons utiliser le profileur de performances de Firefox, vous pourriez donc voir des références à Firefox dans les boîtes de dialogue du profileur. La documentation en anglais du profileur de Firefox est excellente, mais vous n’aurez besoin de la consulter que si vous rencontrez des difficultés ou si vous voulez faire quelque chose de spécial, comme profiler les performances au démarrage. Dans la documentation, partout où « Firefox » est mentionné, pensez « Thunderbird ».

1ʳᵉ étape – Préparer l’enregistrement des performances dans Thunderbird

L’enregistreur des performances fait partie de la boîte à outils de développement de Thunderbird.

Avant de commencer votre enregistrement, préparez autant que possible le scénario à tester dans Thunderbird.

1. Dans la fenêtre principale de Thunderbird, ouvrez la boîte à outils de développement : appuyez sur Ctrl + Shift + ICommand + Shift + I, ou cliquez sur ≡ > Outils > Outils de développement > Boîte à outils de développement.

   Important : confirmez l’avertissement Connexion entrante ... Autoriser la connexion ? avec OK pour que la boîte à outils puisse se connecter à votre application Thunderbird.
   
   Note : l’invite peut être cachée derrière d’autres fenêtres de Thunderbird.

2. La fenêtre Boîte à outils de navigateur multiprocessus s’ouvre.
3. Les versions actuelles de Thunderbird affichent l’onglet Performances avec le bouton Commencer l’enregistrement
   Si vous ne voyez pas cet onglet, appuyez sur F1. Vous pouvez également cliquer sur le bouton ••• dans le coin supérieur droit, puis sur Paramètres. Assurez-vous que la case Performances est cochée [✓]
   Cliquez ensuite sur l’onglet Performances qui est apparu en haut de la boîte à outils.
4. Si vous voyez le message « Échec de l'obtention de l'identifiant du navigateur actif lors du démarrage du profileur », vous pouvez l’ignorer.
5. Configurer les paramètres du profileur :
   1. Cliquez sur Modifier les paramètres... qui est le dernier élément de la fenêtre des outils de développement.
   2. La fenêtre about:profiling s’affiche.
   3. Sélectionnez le préréglage Thunderbird, s’il ne l’est pas déjà. Après cela, lorsque vous cochez d’autres paramètres, le préréglage passera à « Personnaliser », ce qui est normal. (Si vous utilisez des versions Nightly/trunk, sélectionnez le préréglage « Daily ».)
   4. Faites défiler vers le bas et cochez également la case All File IO.
   5. Si vous avez des préoccupations concernant la vie privée ou pour économiser de la mémoire, décochez la case Screenshots.
   6. Modifiez tout autre paramètre qui pourrait être nécessaire, par exemple, Native Allocations (pour les problèmes de mémoire élevée). (Native Allocations nécessite l’utilisation des versions quotidiennes de Thunderbird.)
   7. Si vous avez besoin de plus d’une minute pour capturer le problème que vous profilez, ou si vous avez ajouté certaines collectes de données supplémentaires, vous devrez peut-être ajuster certains paramètres du tampon (Buffer Settings), comme augmenter la taille du tampon (Buffer size) de 1 Go à 2 Go, et augmenter l’intervalle d’échantillonnage (Sampling interval) par rapport à la valeur par défaut de 1 ms.
   8. Fermez la fenêtre about:profiling à l’aide des contrôles de la fenêtre (il n’y a pas de bouton OK ou Save).

2ᵉ étape – Enregistrer un profil de performances

Vous êtes maintenant prêt à enregistrer et à sauvegarder le profil des performances de votre scénario. Sauf indication contraire, essayez de réduire au plus court la durée de votre enregistrement en ne retenant que la série exacte d’actions soupçonnée être à l’origine du problème.

1. Dans l’onglet Performance de la fenêtre Outils de développement, cliquez sur le bouton Commencer l'enregistrement.
2. Sans attendre, retournez dans la fenêtre principale de Thunderbird et effectuez la série d’actions que vous souhaitez enregistrer.
3. Une fois terminé, sélectionnez immédiatement Capturer l'enregistrement dans la fenêtre Outils de développement.

3ᵉ étape – Sauvegarder et partager un profil de performances

1. Cliquez sur Capturer l'enregistrement pour terminer le processus de collecte et vous verrez brièvement Capture du profil, se terminant par une fenêtre du profileur de Firefox « https://profiler.firefox.com/from-browser/ ». Si vous n’avez pas vu le bouton de capture, c’est que vous utilisez une ancienne version du profileur de Thunderbird. Passez à la section sur les Anciennes versions de Thunderbird.
2. Cliquez sur Envoyer le profil local. Pour le profil que vous vous apprêtez à partager, il y a une liste d’éléments sous « Inclure des données supplémentaires qui peuvent être identifiables » – décochez les cases de tous les éléments d’information privée que vous ne souhaitez pas partager.
3. Faites défiler jusqu’aux choix pour enregistrer les données. Utilisez Télécharger pour enregistrer un fichier JSON local que vous pourrez ensuite envoyer par e-mail privé à quelqu’un ou joindre à un rapport de bogue. Utilisez Envoyer pour envoyer le profil à un dépôt sur https://profiler.firefox.com/.L'onglet Lien permanent fournira un lien sous la forme https://share.firefox.dev/ que vous pourrez copier et partager avec les développeurs, développeuses et autres personnes susceptibles de vous aider à résoudre votre problème.
4. Fermez la fenêtre des performances du profileur.
5. Fermez la fenêtre Outils de développement.

Anciennes versions de Thunderbird

Les versions plus anciennes de Thunderbird nécessitent quelques étapes manuelles pour sauvegarder le profil.

1. Sur le côté gauche, juste à côté du nouvel élément « Enregistrement #1 », cliquez sur le lien Enregistrer et sauvegardez le fichier quelque part sur votre ordinateur. L’extension du fichier doit être .json
2. Rendez-vous à l’adresse https://profiler.firefox.com (oui, sur firefox.com).
3. Sélectionnez Charger un profil à partir d’un fichier et sélectionnez le fichier .json que vous venez d’enregistrer localement.
4. Important ! En haut à droite, cliquez sur le bouton vert Publier, puis dans le panneau Partager le profil de performances, cliquez à nouveau sur le bouton bleu Publier
5. Copiez le lien (par exemple https://share.firefox.dev/1XYZXYz) qui apparaît dans le coin supérieur droit sous le nouveau bouton Lien permanent et collez-le dans un nouveau bogue pertinent ou dans un bogue existant sur Bugzilla (BMO).
6. Enfin, de retour dans l’onglet Performances de la boîte à outils de développement, vous pouvez supprimer le profil de performances à l’aide de l’icône de poubelle située juste au-dessus de la liste des profils dans le coin supérieur gauche (là où vous avez enregistré le profil), puis fermer la fenêtre Outils de développement.

Profilage du démarrage et de l’arrêt de Thunderbird

Le profilage du démarrage ou de l’arrêt implique des instructions spéciales en anglais, mais très simples. Là encore, quand est mentionné « Firefox », lire « Thunderbird ».