Performance Monitoring collecte des traces pour vous aider à surveiller les performances de votre appli. A une trace est un rapport sur les données de performances capturées entre deux moments au cours votre application.
Vous pouvez créer vos propres traces pour surveiller les données de performances associées aux un code spécifique dans votre application. Une trace de code personnalisée vous permet de mesurer à quel point le temps nécessaire à votre application pour accomplir une tâche spécifique ou un ensemble de tâches, par exemple pour charger un ensemble d'images ou interroger votre base de données.
La métrique par défaut d'une trace de code personnalisée est sa "durée" (temps écoulé entre le point de départ et le point d'arrêt de la trace), mais vous pouvez également ajouter des métriques personnalisées.
Dans votre code, vous définissez le début et la fin d'une trace de code personnalisée à l'aide des API fournies par le SDK de surveillance des performances.
Les traces de code personnalisées peuvent être démarrées à tout moment après leur création et sont thread-safe.
Étant donné que la métrique par défaut collectée pour ces traces est "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 des traces. situé en bas du tableau de bord Performances (en savoir plus sur à l'aide de la console plus loin sur cette page).
Attributs par défaut, attributs personnalisés et métriques personnalisées
Pour les traces de code personnalisées, Performance Monitoring consigne automatiquement attributs par défaut (métadonnées courantes telles que la version de l'application, le pays, l'appareil, etc.) afin de filtrer les données de la trace dans la console Firebase. Vous pouvez également ajouter et surveiller des attributs personnalisés (par exemple, le niveau du jeu ou les propriétés utilisateur).
Vous pouvez également configurer une trace de code personnalisée pour enregistrer des métriques personnalisées pour les événements liés aux performances qui se produisent dans le champ d'application de la trace. Par exemple, vous pouvez créer une métrique personnalisée le nombre de succès de cache et de défauts de cache, ou le nombre de fois où l'UI devient ne répond pas pendant une période notable.
Les attributs et métriques personnalisés s'affichent dans la console Firebase, ainsi que les attributs et la métrique par défaut de la trace.
Ajouter des traces de code personnalisées
Utilisez l'API Performance Monitoring Trace pour ajouter des traces de code personnalisées afin de surveiller un code d'application spécifique.
Veuillez noter les points suivants :
- Une application peut avoir plusieurs traces de code personnalisées.
- Plusieurs traces de code personnalisé peuvent s'exécuter simultanément.
- Les noms des traces de code personnalisés doivent répondre aux exigences suivantes:
pas d'espace blanc de début ou de fin, pas de trait de soulignement au début (
_) ; et la longueur maximale est de 100 caractères. - Les traces de code personnalisées permettent d'ajouter des métriques personnalisées et des attributs personnalisés.
Pour démarrer et arrêter une traçabilité de code personnalisée, encapsulez le code que vous souhaitez tracer avec un code semblable à celui-ci :
Trace customTrace = FirebasePerformance.instance.newTrace('custom-trace');
await customTrace.start();
// Code you want to trace
await customTrace.stop();
Ajouter des métriques personnalisées aux traces de code personnalisées
Utilisez l'API Performance Monitoring Trace pour ajouter des métriques personnalisées aux traces de code personnalisées.
Veuillez noter les points suivants :
- Les noms des métriques personnalisées doivent répondre aux exigences suivantes:
pas d'espace blanc de début ou de fin, pas de trait de soulignement au début (
_) ; et la longueur maximale est de 100 caractères. - Chaque trace de code personnalisée peut enregistrer jusqu'à 32 métriques (y compris la métrique Durée par défaut).
Pour ajouter une métrique personnalisée, insérez à chaque fois une ligne de code semblable à celle-ci : que l'événement se produit. Par exemple, cette métrique personnalisée comptabilise les événements liés aux performances qui se produisent dans votre application, tels que les hits de cache ou les nouvelles tentatives.
Trace customTrace = FirebasePerformance.instance.newTrace("custom-trace");
await customTrace.start();
// Code you want to trace
customTrace.incrementMetric("metric-name", 1);
// More code
await customTrace.stop();
Créer des attributs personnalisés pour les traces de code personnalisées
Pour utiliser des attributs personnalisés, ajoutez à votre application du code qui les définit et et l'associe à une trace de code personnalisé spécifique. Vous pouvez définir l'attribut personnalisé à tout moment entre le début et la fin de la trace.
Veuillez noter les points suivants :
Les noms des attributs personnalisés doivent respecter les conditions suivantes : pas d'espaces au début ni à la fin, pas de trait de soulignement (
_) au début, et longueur maximale de 32 caractères.Chaque trace de code personnalisé peut enregistrer jusqu'à cinq attributs personnalisés.
N'utilisez pas d'attributs personnalisés contenant des informations permettant d'identifier personnellement un individu auprès de Google.
Trace trace = FirebasePerformance.instance.newTrace("test_trace");
// Update scenario.
trace.putAttribute("experiment", "A");
// Reading scenario.
String? experimentValue = trace.getAttribute("experiment");
// Delete scenario.
trace.removeAttribute("experiment");
// Read attributes.
Map<String, String> traceAttributes = trace.getAttributes();
Suivre, afficher et filtrer les données de performances
Suivre des métriques spécifiques dans votre tableau de bord
Pour découvrir les tendances de vos métriques clés, ajoutez-les à votre tableau des métriques à l'adresse en haut du tableau de bord Performances. Vous pouvez identifier rapidement les régressions en observant les variations 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 bord, accédez au tableau de bord "Performances" dans la console Firebase, puis cliquez sur l'onglet Tableau de bord. Cliquez sur une métrique vide puis sélectionnez une métrique existante à ajouter à votre tableau. Cliquez sur les points de suspension verticaux (⋮) sur une fiche de métrique renseignée pour accéder à d'autres options, comme remplacer ou supprimer une métrique.
Le panneau des métriques affiche les données de métriques collectées au fil du temps, 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 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 par pourcentage de variation d'une métrique spécifique.
Si vous cliquez sur un nom de trace dans le tableau des traces, vous pouvez ensuite passer par différents écrans pour explorer la trace et examiner les métriques qui vous intéressent. Sur la plupart des pages, vous pouvez utiliser le bouton Filtrer (en haut à gauche de l'écran) pour filtrer les données par attribut, par exemple:
- Filtrez les données par Version de l'application pour afficher les données d'une version précédente ou de votre dernière version.
- Filtrez par Appareil pour savoir comment les appareils plus anciens gèrent votre application.
- Filtrez les données par Pays pour vous assurer que l'emplacement de votre base de données n'affecte pas un région spécifique
Découvrez comment afficher les données de vos traces.
Étapes suivantes
Découvrez comment utiliser des attributs pour examiner les données sur les performances.
Découvrez comment suivre les problèmes de performances dans la console Firebase.
Configurer des alertes pour les modifications de code qui se dégradent les performances de votre application. Par exemple, vous pouvez configurer une alerte par e-mail pour votre équipe si la durée d'une trace de code personnalisé dépasse une que vous avez défini.