En savoir plus sur les données de performances de démarrage d'application, d'application au premier plan et d'application en arrière-plan (applications Apple et Android)

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 qui contient des données capturées entre deux points dans le temps dans votre application.

Pour les applications Apple et Android, Performance Monitoring collecte automatiquement plusieurs traces liées au cycle de vie de l'application. Toutes ces traces sont comme des temporisateurs 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 est réactive

  • 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 de l' application en arrière-plan — Une trace qui mesure le temps pendant lequel l'application s'exécute en arrière-plan

Comme ces traces ne collectent que 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 en bas du tableau de bord des performances (en savoir plus sur l'utilisation de la console plus loin sur cette page).

Définitions pour chaque trace

La surveillance 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.

Suivi du 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 est réactive. Dans la console, le nom de la trace est _app_start . La métrique collectée pour cette trace est "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 d'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 "durée".

  • Démarre lorsque l'application reçoit la notification UIApplicationDidBecomeActiveNotification .

  • S'arrête lorsqu'il reçoit la notification UIApplicationWillResignActiveNotification .

Suivi de l'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 "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 personnalisées 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 de surveillance des performances 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 métriques clés, ajoutez-les à votre tableau de métriques en haut du tableau de bord des performances . Vous pouvez rapidement identifier les régressions en voyant les changements d'une semaine sur l'autre ou vérifier que les modifications récentes de votre code améliorent les performances.

une image du tableau des métriques dans le tableau de bord Firebase Performance Monitoring

Pour ajouter une statistique à votre tableau de statistiques, procédez comme suit :

  1. Accédez au tableau de bord des performances dans la console Firebase.
  2. Cliquez sur une carte de métrique vide, puis sélectionnez une métrique existante à ajouter à votre tableau.
  3. Cliquez sur sur une carte 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 pourcentage de variation numérique.

En savoir plus sur l'utilisation du tableau de bord .

Visualiser les traces et leurs données

Pour afficher vos traces, accédez au tableau de bord des 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 métriques pour chaque trace, et vous pouvez même trier la liste en fonction du pourcentage de changement pour une métrique 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 permet de résoudre rapidement et de minimiser 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 grand delta.
  • Dans le tableau des traces, vous triez pour afficher les plus grands deltas 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 :

  • Dans le tableau de bord des métriques, cliquez sur le bouton Afficher les détails des métriques .
  • Sur n'importe quelle carte de métrique, sélectionnez => Afficher les détails . La page de dépannage affiche des informations sur la métrique que vous avez sélectionnée.
  • 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 explorer les métriques qui vous intéressent. Cliquez sur le bouton Filter pour filtrer les données par attribut, par exemple :

une image des données Firebase Performance Monitoring filtrées par attribut
  • Filtrez par version de l'application pour afficher les données d'une version antérieure ou de votre dernière version
  • Filtrez par appareil pour savoir comment les appareils plus anciens 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 pour vos traces .

Prochaines étapes

  • En savoir plus sur l'utilisation des attributs pour examiner les données de performances.

  • En savoir plus sur le suivi des 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 de chronologie des autres traces collectées au cours de la même session.