La surveillance des performances utilise des traces pour collecter des données sur les processus surveillés dans votre application. Une trace est un rapport contenant des données capturées entre deux moments dans votre application.
Pour les applications Apple et Android, Performance Monitoring collecte automatiquement plusieurs traces liées au cycle de vie des applications. Toutes ces traces sont comme des minuteurs car elles mesurent le temps nécessaire à l'exécution du processus (la « durée »).
Trace de démarrage de l'application : une trace qui mesure le temps entre le moment où l'utilisateur ouvre l'application et le moment où l'application répond.
Trace de l'application au premier plan : une trace qui mesure le temps pendant lequel l'application s'exécute au premier plan et est disponible pour l'utilisateur.
Trace d'application en arrière-plan : une trace qui mesure le temps pendant lequel l'application s'exécute en arrière-plan
Étant donné que ces traces collectent uniquement la métrique « durée », elles sont parfois appelées « traces de durée ».
Vous pouvez afficher les données de ces traces dans le sous-onglet Traces personnalisées du tableau des traces, qui se trouve au bas du tableau de bord Performances (en savoir plus sur l'utilisation de la console plus loin sur cette page).
Définitions pour chaque trace
L'analyse des performances utilise des appels de méthode et des notifications dans votre application pour déterminer quand chaque type de trace démarre et s'arrête. Toutes ces traces sont comme des minuteries car elles mesurent le temps nécessaire à l’exécution du processus.
Trace de démarrage de l'application
Cette trace mesure le temps entre le moment où l'utilisateur ouvre l'application et le moment où l'application répond. Dans la console, le nom de la trace est _app_start
. La métrique collectée pour cette trace est la « durée ».
Démarre lorsque l'application charge le premier
Object
en mémoire.S'arrête après la première boucle d'exécution réussie qui se produit après que l'application a reçu la notification
UIApplicationDidBecomeActiveNotification
.
Trace de l'application au premier plan
Cette trace mesure le temps pendant lequel l'application s'exécute au premier plan et est disponible pour l'utilisateur. Dans la console, le nom de la trace est _app_in_foreground
. La métrique collectée pour cette trace est la « durée ».
Démarre lorsque l’application reçoit la notification
UIApplicationDidBecomeActiveNotification
.S'arrête lorsqu'il reçoit la notification
UIApplicationWillResignActiveNotification
.
Trace d'application en arrière-plan
Cette trace mesure le temps pendant lequel l'application s'exécute en arrière-plan. Dans la console, le nom de la trace est _app_in_background
. La métrique signalée pour cette trace est la « durée ».
Démarre lorsque l'application reçoit la notification
UIApplicationWillResignActiveNotification
.S'arrête lorsqu'il reçoit la notification
UIApplicationDidBecomeActiveNotification
.
Métriques collectées par ces traces
Ces traces sont des traces prêtes à l'emploi, vous ne pouvez donc pas leur ajouter de métriques ou d'attributs personnalisés.
Toutes ces traces sont comme des minuteries car elles mesurent le temps nécessaire à l'exécution du processus surveillé. Le nom de cette métrique collectée est appelé « durée ».
Suivre, afficher et filtrer les données de performances
Pour afficher les données de performances en temps réel, assurez-vous que votre application utilise une version du SDK Performance Monitoring compatible avec le traitement des données en temps réel. En savoir plus sur les données de performances en temps réel .
Suivez les indicateurs clés dans votre tableau de bord
Pour connaître l'évolution de vos indicateurs clés, ajoutez-les à votre tableau de indicateurs en haut du tableau de bord Performance . Vous pouvez identifier rapidement les régressions en observant les changements d'une semaine à l'autre ou vérifier que les modifications récentes apportées à votre code améliorent les performances.
Pour ajouter une métrique à votre tableau de métriques, procédez comme suit :
- Accédez au tableau de bord Performances dans la console Firebase.
- Cliquez sur une fiche de métrique vide, puis sélectionnez une métrique existante à ajouter à votre tableau.
- Cliquez sur sur une fiche de métrique remplie pour plus d'options, par exemple pour remplacer ou supprimer une métrique.
Le tableau des métriques affiche les données métriques collectées au fil du temps, à la fois sous forme graphique et sous forme de variation numérique en pourcentage.
En savoir plus sur l'utilisation du tableau de bord .
Afficher les traces et leurs données
Pour afficher vos traces, accédez au tableau de bord Performances dans la console Firebase, faites défiler jusqu'au tableau des traces, puis cliquez sur le sous-onglet approprié. Le tableau affiche certaines des principales mesures pour chaque trace, et vous pouvez même trier la liste en fonction du pourcentage de variation pour une mesure spécifique.
La surveillance des performances fournit une page de dépannage dans la console Firebase qui met en évidence les changements de métriques, ce qui facilite la résolution rapide et la minimisation de l'impact des problèmes de performances sur vos applications et vos utilisateurs. Vous pouvez utiliser la page de dépannage lorsque vous découvrez des problèmes de performances potentiels, par exemple dans les scénarios suivants :
- Vous sélectionnez des métriques pertinentes sur le tableau de bord et vous remarquez un gros delta.
- Dans le tableau des traces, vous effectuez un tri pour afficher les deltas les plus importants en haut et vous constatez une variation significative en pourcentage.
- Vous recevez une alerte par e-mail vous informant d'un problème de performances.
Vous pouvez accéder à la page de dépannage des manières suivantes :
- Sur le tableau de bord des métriques, cliquez sur le bouton Afficher les détails de la métrique .
- Sur n'importe quelle carte métrique, sélectionnez
- Dans le tableau des traces, cliquez sur un nom de trace ou sur n'importe quelle valeur de mesure dans la ligne associée à cette trace.
- Dans une alerte par e-mail, cliquez sur Enquêter maintenant .
Lorsque vous cliquez sur un nom de trace dans le tableau des traces, vous pouvez ensuite accéder aux métriques qui vous intéressent. Clique le
- Filtrer par version de l'application pour afficher les données sur une version précédente ou votre dernière version
- Filtrer par appareil pour savoir comment les anciens appareils gèrent votre application
- Filtrez par pays pour vous assurer que l'emplacement de votre base de données n'affecte pas une région spécifique
En savoir plus sur l'affichage des données de vos traces .
Prochaines étapes
Apprenez-en davantage sur l’utilisation des attributs pour examiner les données de performances.
Découvrez comment suivre les problèmes de performances dans la console Firebase.
Configurez des alertes pour les modifications de code qui dégradent les performances de votre application. Par exemple, vous pouvez configurer une alerte par e-mail pour votre équipe si l'heure de démarrage de votre application dépasse un seuil que vous avez défini.
- Affichez des rapports détaillés des sessions utilisateur dans lesquels vous pouvez voir une trace spécifique dans un contexte chronologique d'autres traces collectées au cours de la même session.