Performance Monitoring 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 moments précis dans votre application.
Pour tous les types d'applications, Performance Monitoring collecte automatiquement une trace pour chaque réseau envoyée par votre application, appelée trace de requête réseau HTTP/S. Ces les traces collectent des métriques sur le temps écoulé entre le moment où votre application envoie une requête à le point de terminaison du service et lorsque la réponse de ce point de terminaison est terminée. Pour toute auquel votre application envoie une requête, Performance Monitoring en capture plusieurs métriques:
Temps de réponse : délai entre l'envoi de la requête et Lorsque la réponse a été entièrement reçue
Taille de la charge utile de réponse – Taille en octets de la charge utile réseau téléchargée par l'application
Taille de la charge utile de la requête : taille en octets de la charge utile réseau importé par l'application
Taux de réussite — Pourcentage de réponses réussies (codes de réponse compris entre 100 et plage 399) par rapport au nombre total de réponses
Vous pouvez afficher les données de ces traces dans le sous-onglet Requêtes réseau de table des traces, située en bas du tableau de bord Performances (en savoir plus sur l'utilisation de la console, plus loin sur cette page).
Personnaliser l'agrégation des données de requête réseau
En plus des outils prêts à l'emploi et de l'agrégation de données pour les requêtes réseau, Performance Monitoring est également compatible avec les options suivantes :
- Instrumenter manuellement les traces des requêtes réseau:la surveillance prête à l'emploi. inclut la plupart des requêtes réseau pour votre appli. Cependant, il est possible que certaines requêtes être signalé ou vous pouvez utiliser une bibliothèque différente pour effectuer des requêtes réseau. Dans Dans ce cas, vous pouvez utiliser l'API Performance Monitoring pour instrumenter manuellement traces de requêtes réseau personnalisées.
- Regroupez les données sous des formats d'URL personnalisée:si des URL spécifiques Firebase n'effectue pas de capture avec sa mise en correspondance automatique de format d'URL dérivée. peuvent créer des formats d'URL personnalisés ; pour surveiller un ensemble spécifique d'URL au fil du temps.
- Personnaliser le calcul du taux de réussite:un code d'erreur peut parfois s'afficher. pour certains points de terminaison d'API ou est déjà gérée dans votre application. Dans ces cas, vous pouvez configurer le calcul du taux de réussite et surveiller plus précisément le taux de réussite des appels réseau de votre application.
Agrégation des données sous les formats d'URL
Firebase Performance Monitoring agrège automatiquement les données des requêtes réseau similaires pour vous aider à comprendre les tendances des performances de vos requêtes réseau.
Pour chaque requête, Firebase vérifie si l'URL de la requête réseau correspond à une URL du modèle. Si l'URL de la requête correspond à un format d'URL, Firebase regroupe les données de la requête sous le format d'URL. URL à afficher Firebase et leurs données globales dans l'onglet Réseau de la Tableau de bord Performances de la console Firebase.
Qu'est-ce qu'un format d'URL ?
Un format d'URL contient un domaine et un format qui peut correspondre à un chemin d'URL, par exemple
instance: example.com/*/animals/**.
Les formats d'URL peuvent contenir les segments de chemin suivants:
- texte brut : correspond à une chaîne exacte
*: correspond à n'importe quelle chaîne dans un seul segment de chemin d'accès**: correspond à un suffixe de chemin arbitraire
Les formats d'URL peuvent être:
- Formats dérivés de Firebase (appelés URL automatiques modèles
- Modèles définis par l'utilisateur (appelés formats d'URL personnalisés)
Par exemple, une des requêtes d'URL suivantes peut correspondre au format d'URL.
example.com/*/animals/**
example.com/singapore/animalsexample.com/australia/animals/spidersexample.com/australia/animals/marsupials/koala.png
Le domaine d'un format d'URL peut également contenir le premier segment *,
(par exemple, *.example.com/*/fruits/**).
Firebase ne mappe chaque requête qu'à un seul format d'URL. Si vous avez configuré les formats d'URL personnalisés, Firebase tente de faire correspondre les URL de requête vers ces formats. Si Firebase ne trouve aucune URL personnalisée correspondante , il met en correspondance une URL de requête avec l'URL automatique format d'URL : En savoir plus sur les URL automatiques et personnalisées des modèles dans les sections suivantes.
Formats d'URL automatiques
Sans aucune configuration de votre part, Performance Monitoring tente de refléter le dernier comportement d'utilisation de votre application en faisant correspondre les requêtes de votre application à des formats d'URL automatiques.
Comment fonctionne la mise en correspondance automatique des formats d'URL ?
Firebase fait correspondre chaque requête au format d'URL automatique le plus représentatif qu'il a dérivé des requêtes envoyées par votre application. Notez toutefois que Firebase tente d'abord de faire correspondre les URL de requête à tous les formats d'URL personnalisés configurés.
Voici un exemple de base illustrant la façon dont Firebase tente de mettre en correspondance les requêtes le format d'URL automatique le plus représentatif pour votre application.
Votre application envoie de nombreuses requêtes aux URL, par exemple:
example.com/germany/animals/bearsexample.com/germany/animals/birdsexample.com/germany/cars
Firebase détermine que la requête
example.com/germany/**est courante pour votre application et l'ajoute en tant que format d'URL automatique dans votre projet.Pour toute nouvelle requête correspondant à ce format d'URL, Firebase agrège les données des requêtes sous le format d'URL automatique
example.com/germany/**.Après une semaine, la majorité des demandes concernant votre application concernent
example.com/germany/animals/bearsetexample.com/germany/animals/birdsFirebase exploite format d'URL représentatif deexample.com/germany/animals/**.Pour toute nouvelle requête correspondante vers ce nouveau format d'URL, Firebase regroupe les demandes les données uniquement sous le nouveau format d'URL. Firebase continue d'agréger les données pour les requêtes envoyées à
example.com/germany/carssousexample.com/germany/**.Cependant, au cours des prochaines semaines, les demandes de votre application à
example.com/germany/animals/bearsetexample.com/germany/animals/birdsdiminuent de manière significative. Firebase détermine queexample.com/germany/animals/**n'est pas représentatif de la dernière version de votre appli d'utilisation. Firebase commence donc à faire correspondre ces deux requêtesexample.com/germany/**Firebase ne regroupe pas d'autres données sur les demandes
example.com/germany/animals/**, car ce n'est plus le plus un format d'URL automatique représentatif.
La mise en correspondance automatique des formats d'URL étant dynamique, tenez compte des points suivants:
Les correspondances et les données agrégées des requêtes précédentes ne sont pas affectées par les nouveaux formats d'URL. Firebase ne réagrège pas rétroactivement les données des demandes.
Seules les requêtes futures sont affectées par les nouveaux formats d'URL. Firebase mappe chacune new au format d'URL automatique le plus représentatif. Notez toutefois que Firebase tente d'abord de faire correspondre les URL de requête à tous les modèles d'URL personnalisés configurés.
Afficher les formats d'URL automatiques et leurs données
Firebase affiche tous les formats d'URL et leurs données globales dans Sous-onglet Requêtes réseau du tableau des traces, situé en bas du tableau Tableau de bord Performances de la console Firebase.
Des formats d'URL associés au libellé Sans catégorie peuvent s'afficher. Il s'agit de la requête "large" des formats d'URL automatiques, à partir desquels Firebase peut agréger des données pour les requêtes ne correspondent à aucun format d'URL plus spécifique.
Lorsque la durée de conservation des données pour les données agrégées dans un format d'URL, Firebase supprime ces données du format d'URL. Si toutes les données sont agrégées sous un format d'URL automatique expire, puis Firebase supprime ce format d'URL de la console Firebase.
Formats d'URL personnalisés
Vous pouvez créer des formats d'URL personnalisés pour surveiller des formats d'URL spécifiques que Firebase ne capture pas avec sa mise en correspondance automatique des formats d'URL dérivée. Par exemple, vous pouvez utiliser un format d'URL personnalisé pour résoudre les problèmes liés à une URL spécifique ou pour surveiller un ensemble d'URL spécifiques au fil du temps.
Consultez Créer des formats d'URL personnalisés pour en savoir plus. plus encore.
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 un Version du SDK 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
Suivre des métriques spécifiques 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 Performances. Vous pouvez identifier rapidement les régressions en examinant les données d'une semaine à l'autre ou vérifier que des modifications récentes apportées à votre code améliorent les performances.
"Panneau de contrôle Firebase Performance Monitoring" />
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 renseignée pour afficher d'autres options, par exemple pour remplacer ou supprimer une métrique.
Le panneau des métriques affiche les données de métriques collectées au fil du temps, à la fois sous forme graphique 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 à la Tableau de bord Performances Dans la console Firebase, faites défiler la page jusqu'au tableau des traces, puis cliquez sur le sous-onglet approprié. Le tableau affiche certaines métriques principales pour chaque trace. Vous pouvez même trier la liste en fonction du pourcentage de variation d'une métrique spécifique.
Performance Monitoring fournit une page de dépannage dans la console Firebase qui met en évidence la métrique ce qui vous permet de résoudre rapidement les problèmes de performances et de limiter leur impact les applications et les utilisateurs. Consultez la page de dépannage pour connaître les problèmes des problèmes de performances, par exemple, dans les scénarios suivants:
- Vous sélectionnez des métriques pertinentes dans le tableau de bord et vous remarquez un grand delta.
- Dans le tableau des traces, vous triez de manière à afficher les deltas les plus grands en haut, et vous voyez un changement significatif 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 de différentes manières:
- Dans le tableau de bord des métriques, cliquez sur le bouton Afficher les détails de la métrique.
- Sur une fiche de métriques, sélectionnez
. => Afficher les détails La page de dépannage affiche des informations sur la métrique sélectionné. - Dans le tableau des traces, cliquez sur le nom d'une trace ou sur une valeur de métrique dans la ligne associée à ce nom. traceur.
- Dans une alerte par e-mail, cliquez sur Examiner.
Lorsque vous cliquez sur un nom de trace dans le tableau des traces, vous pouvez ensuite examiner les métriques qui vous intéressent. Cliquez sur l'icône
Bouton
Données Firebase Performance Monitoring filtrées par attribut" />
- Filtrez par Version de l'application pour afficher les données sur une release antérieure ou la dernière version
- Filtrez les données 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 les données de votre les traces.
Étapes suivantes
En savoir plus sur utiliser des attributs pour examiner les données de performances.
Découvrez comment suivre les problèmes de performances Console Firebase.
Configurer des alertes pour les requêtes réseau qui se dégradent les performances de votre application. Par exemple, vous pouvez configurer une alerte par e-mail pour votre équipe si le temps de réponse pour un format d'URL spécifique dépasse que vous avez défini.
- consulter des rapports détaillés sur les sessions utilisateur au cours desquelles vous pouvez voir une trace spécifique dans un contexte chronologique d'autres traces collectées au cours de la même session.