Google is committed to advancing racial equity for Black communities. See how.
Cette page a été traduite par l'API Cloud Translation.
Switch to English

Ajouter une surveillance personnalisée pour un code d'application spécifique

Vous pouvez créer des traces personnalisées pour surveiller les données de performances associées à un code spécifique dans votre application. Avec une trace personnalisée, vous pouvez mesurer le temps qu'il faut à votre application pour terminer une tâche ou un ensemble de tâches spécifique, par exemple le chargement d'un ensemble d'images ou l'interrogation de votre base de données. La métrique par défaut pour une trace personnalisée est sa durée , 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 personnalisée à l'aide des API fournies par le SDK Performance Monitoring.

Les traces peuvent également être démarrées après leur création, et elles sont thread-safe.

Notez ce qui suit:

  • Une application peut avoir plusieurs traces personnalisées.
  • Plusieurs traces personnalisées peuvent s'exécuter en même temps.
  • Les noms des traces personnalisées et des mesures personnalisées doivent répondre aux exigences suivantes: aucun espace blanc de début ou de fin, aucun caractère de soulignement ( _ ) de début et la longueur maximale est de 100 caractères.

Attributs par défaut, attributs personnalisés et métriques personnalisées

Pour les traces personnalisées, Performance Monitoring enregistre automatiquement les attributs par défaut qui sont collectés pour toute trace (métadonnées applicables telles que la version de l'application, le pays, l'appareil, le navigateur, etc.) afin que vous puissiez filtrer les données dans la console Firebase. Pour les traces personnalisées, vous pouvez également ajouter et surveiller des attributs personnalisés (tels que le niveau du jeu ou les propriétés de l'utilisateur).

Vous pouvez en outre configurer une trace personnalisée pour enregistrer des métriques personnalisées pour les événements liés aux performances qui se produisent dans la portée de la trace. Par exemple, vous pouvez créer une métrique personnalisée pour le nombre d'occurrences et d'échecs de cache ou le nombre de fois où l'interface utilisateur cesse de répondre pendant une période de temps notable. Les données de ces métriques personnalisées s'affichent dans la console Firebase avec les métriques par défaut de la trace. Chaque trace personnalisée peut enregistrer jusqu'à 32 métriques, y compris la métrique de durée par défaut et toute métrique personnalisée supplémentaire.

Ajouter des traces personnalisées et des métriques personnalisées

Utilisez l'API Trace ( Swift | Obj-C ) pour ajouter des traces personnalisées et des métriques personnalisées pour surveiller le code d'application spécifique.

  1. Ajoutez le module de surveillance des performances à votre en-tête:

    Rapide

    import FirebasePerformance
    

    Objectif c

    @import FirebasePerformance;
    
  2. Pour démarrer et arrêter une trace personnalisée, enveloppez le code que vous souhaitez suivre avec des lignes de code similaires à ce qui suit:

    Rapide

    let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")
    
    // code that you want to trace
    
    trace.stop()
    

    En savoir plus sur l' API pour les traces personnalisées .

    Objectif c

    FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];
    
    // code that you want to trace
    
    [trace stop];
    

    En savoir plus sur l' API pour les traces personnalisées .

  3. Pour ajouter une métrique personnalisée, ajoutez une ligne de code similaire à la suivante à chaque fois que l'événement se produit. Par exemple, cette métrique personnalisée compte les événements liés aux performances qui se produisent dans votre application, tels que les appels de cache ou les nouvelles tentatives.

    Rapide

    let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")
    
    trace.incrementMetric(named:"EVENT_NAME", by: 1)
    // code that you want to trace (and log custom metrics)
    
    trace.stop()
    

    Objectif c

    FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];
    
    [trace incrementMetric:@"EVENT_NAME" by:1];
    // code that you want to trace (and log custom metrics)
    
    [trace stop];
    

Surveillez les traces et les métriques personnalisées dans la console

  1. Dans la console Firebase, accédez au tableau de bord Performance .

  2. Cliquez sur l'onglet Sur l'appareil , puis vous pouvez:

    • Consultez un rapport rapide des données collectées pour toutes vos traces.

    • Cliquez sur une trace spécifique pour examiner les données de la trace plus en détail.

    • Utilisez le bouton filtre en haut à gauche du tableau de bord pour effectuer un filtrage de base des données par attribut.

  3. Si vous cliquez sur une trace spécifique, la console affiche une vue d'ensemble des données collectées sur les cartes métriques, y compris la métrique Durée par défaut et toutes les autres métriques personnalisées que vous avez configurées pour la trace personnalisée.

    • Utilisez les options en haut à droite du tableau de bord pour afficher les données de durée sous forme agrégée , au fil du temps ou pour chaque version de votre application.

    • Utilisez le bouton filtre en haut à gauche du tableau de bord pour effectuer un filtrage de base des données par attribut.

  4. Pour toute métrique, cliquez sur Afficher plus pour consulter des informations plus détaillées sur les données collectées et utiliser des fonctionnalités d'analyse plus riches. Par exemple, vous pouvez filtrer et segmenter les données par attribut et afficher les données dans le contexte d'une session d'utilisation d'application.

    La section suivante décrit les fonctionnalités disponibles du rapport de suivi détaillé.

Afficher plus de détails sur les échantillons de trace

Vous pouvez plonger en profondeur dans des segments de traces spécifiques ou de requêtes réseau dans la console Firebase . Un échantillonnage aléatoire des sessions enregistrées montre les informations suivantes:

une image de la page des sessions Firebase Performance Monitoring

  • CPU: temps utilisateur et temps système consommés par votre application.

  • Mémoire: la quantité de mémoire utilisée par votre application. La mémoire de tas est la mémoire utilisée pour les allocations dynamiques, y compris les objets créés, les objets désalloués et les objets que l'application utilise activement.

  • Informations individuelles: informations détaillées sur une seule instance d'une trace ou d'une requête réseau, y compris l'heure de début, l'heure de fin, la durée, la taille de la requête et la taille de la réponse.

  • Instances simultanées: informations sur les traces ou les requêtes réseau qui se sont produites en même temps.

  • Attributs de l'appareil: informations sur l'appareil, y compris la version de l'application, le modèle, la version du système d'exploitation, la radio et les attributs personnalisés.

Pour voir ces exemples détaillés dans la console Firebase, vous pouvez:

  • Ouvrez l'une des traces ou requêtes réseau de votre application, puis cliquez sur Afficher les sessions .

  • Cliquez sur le lien des sessions d'un attribut à partir de l'attribut spécifique.

une image de la trace Firebase Performance Monitoring avec un lien vers les sessions

Filtrer les sessions par centile

Les sessions collectées par Performance Monitoring sont réparties en centiles pour chaque métrique. Les sessions dans des plages de centiles inférieurs ont une valeur inférieure pour la métrique que les sessions dans des plages de percentiles supérieurs.

Pour filtrer les sessions disponibles par centile, utilisez la liste déroulante des centiles au-dessus des détails des sessions.

une image de la page des sessions Firebase Performance Monitoring

Prochaines étapes