Performance Monitoring collecte des traces pour vous aider à surveiller les performances de votre application. Une trace est un rapport sur les données de performances capturées entre deux points dans le temps dans votre application.
Vous pouvez créer vos propres traces pour surveiller les données de performances associées à un code spécifique dans votre application. Avec une trace de code personnalisée, vous pouvez mesurer le temps nécessaire à votre application pour effectuer une tâche spécifique ou un ensemble de tâches, par exemple charger un ensemble d'images ou interroger votre base de données.
La métrique par défaut d'une trace de code personnalisé est sa "durée" (délai entre les points de départ et d'arrêt de la trace), mais vous pouvez ajouter ainsi que des métriques personnalisées.
Dans votre code, vous définissez le début et la fin d'une trace de code personnalisé à l'aide de
les API fournies par le SDK Performance Monitoring.
Pour les applications Android, vous pouvez également surveiller des méthodes spécifiques à l'aide de l'annotation @AddTrace
.
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 les attributs par défaut (métadonnées courantes telles que la version de l'application, le pays, l'appareil, etc.) afin que vous puissiez filtrer les données de la trace dans la console Firebase. Toi Vous pouvez également ajouter et surveiller des attributs personnalisés. (niveau de jeu ou propriétés utilisateur, par exemple).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 les métriques personnalisés s'affichent dans la console Firebase, ainsi que les attributs et la métrique par défaut de la trace.
Un attribut est une valeur de chaîne qui vous aide à filtrer et à segmenter les données dans la console. Une métrique est une valeur numérique qui peut être représentée et mesurée au fil du temps.Ajouter des traces de code personnalisées
Utiliser le Performance Monitoring API 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ées peuvent s'exécuter en même temps.
- Les noms des traces de code personnalisées doivent respecter les conditions suivantes : pas d'espace blanc au début ni à la fin, pas de caractère de soulignement (
_
) au début, et longueur maximale 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 trace de code personnalisée, encapsulez le code que vous souhaitez tracer avec des lignes de code semblables à celles-ci (cet exemple utilise un nom de trace personnalisé de test_trace
) :
Kotlin+KTX
// Import these Performance Monitoring classes at the top of your `.kt` file import com.google.firebase.perf.FirebasePerformance; import com.google.firebase.perf.metrics.Trace; val myTrace = Firebase.performance.newTrace("test_trace") myTrace.start() // code that you want to trace myTrace.stop()
Java
// Import these Performance Monitoring classes at the top of your `.java` file import com.google.firebase.perf.FirebasePerformance; import com.google.firebase.perf.metrics.Trace; Trace myTrace = FirebasePerformance.getInstance().newTrace("test_trace"); myTrace.start(); // code that you want to trace myTrace.stop();
(Facultatif) Surveiller des méthodes spécifiques à l'aide de @AddTrace
Les applications Android sont également compatibles avec l'annotation @AddTrace
pour instrumenter les traces de code personnalisées. Avec cette fonctionnalité, la trace commence au
début de la méthode spécifiée et s'arrête une fois la méthode terminée, y compris
tout élément appelé par la méthode.
Par exemple, vous pouvez créer une trace de code personnalisée appelée onCreateTrace
qui s'exécute lorsque la méthode onCreate()
est appelée.
Kotlin+KTX
// Import these Performance Monitoring classes at the top of your `.kt` file import com.google.firebase.perf.FirebasePerformance; import com.google.firebase.perf.metrics.AddTrace; // Add the `@AddTrace` annotation above the method you want to trace // the `enabled` argument is optional and defaults to true @AddTrace(name = "onCreateTrace", enabled = true) override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) }
Java
// Import these Performance Monitoring classes at the top of your `.java` file import com.google.firebase.perf.FirebasePerformance; import com.google.firebase.perf.metrics.AddTrace; // Add the `@AddTrace` annotation above the method you want to trace @Override @AddTrace(name = "onCreateTrace", enabled = true /* optional */) protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); }
Ajouter des métriques personnalisées aux traces de code personnalisées
Utilisez l'Performance MonitoringAPI 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, ajoutez une ligne de code semblable à celle-ci chaque fois 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 échecs et les réussites de la mise en cache (à l'aide des noms d'événements item_cache_hit
et item_cache_miss
et d'un incrément de 1
).
Kotlin+KTX
val myTrace = Firebase.performance.newTrace("test_trace") myTrace.start() // code that you want to trace (and log custom metrics) val item = cache.fetch("item") if (item != null) { myTrace.incrementMetric("item_cache_hit", 1) } else { myTrace.incrementMetric("item_cache_miss", 1) } myTrace.stop()
Java
Trace myTrace = FirebasePerformance.getInstance().newTrace("test_trace"); myTrace.start(); // code that you want to trace (and log custom metrics) Item item = cache.fetch("item"); if (item != null) { myTrace.incrementMetric("item_cache_hit", 1); } else { myTrace.incrementMetric("item_cache_miss", 1); } myTrace.stop();
Créer des attributs personnalisés pour les traces de code personnalisées
Utiliser le Performance Monitoring API Trace pour ajouter des attributs personnalisés aux traces de code personnalisées.Pour utiliser des attributs personnalisés, ajoutez du code à votre application qui définit l'attribut et l'associe à une trace de code personnalisée spécifique. Vous pouvez définir l'attribut à tout moment entre le début de la trace et son arrêt.
Veuillez noter les points suivants :
Les noms des attributs personnalisés doivent répondre aux exigences suivantes :
- Aucun espace de début ou de fin, aucun caractère de soulignement (
_
) de début - Pas d'espaces
- La longueur maximale est de 32 caractères
- Les caractères autorisés pour le nom sont
A-Z
,a-z
et_
.
- Aucun espace de début ou de fin, aucun caractère de soulignement (
Chaque trace de code personnalisé peut enregistrer jusqu'à cinq attributs personnalisés.
Veuillez vous assurer que les attributs personnalisés ne contiennent aucune information permettant d'identifier personnellement une personne auprès de Google.
En savoir plus sur cette consigne
Kotlin+KTX
Firebase.performance.newTrace("test_trace").trace { // Update scenario. putAttribute("experiment", "A") // Reading scenario. val experimentValue = getAttribute("experiment") // Delete scenario. removeAttribute("experiment") // Read attributes. val traceAttributes = this.attributes }
Java
Trace trace = FirebasePerformance.getInstance().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 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.
Tableau de bord 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 tableau de données métriques affiche les données métriques collectées au fil du temps, à la fois sous forme graphique et sous forme de pourcentage numérique.
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. 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 les métriques pertinentes dans le tableau de bord et vous remarquez un écart important.
- Dans le tableau des traces, vous triez les données pour afficher les deltas les plus importants en haut. Vous constatez alors une variation importante 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
La page de dépannage affiche des informations sur la métrique que vous avez sélectionnée. . => Afficher les détails - 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 le nom d'une trace dans le tableau des traces, vous pouvez afficher le détail des métriques de
d’intérêt. Cliquez sur le bouton
- Filtrez par Version de l'application pour afficher les données sur une release antérieure ou la 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 pays spécifique. région
Découvrez comment afficher les données de vos 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 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 la durée d'une trace de code personnalisé spécifique dépasse un seuil que vous définissez.
- 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.