Dépannage et questions fréquentes concernant Performance Monitoring

iOS+ Android Web

Cette page fournit des conseils de dépannage pour vous aider à vous lancer avec Performance Monitoring ou à utiliser les fonctionnalités et les outils Performance Monitoring.

Premières vérifications pour résoudre les problèmes

Les deux vérifications suivantes sont des bonnes pratiques générales recommandées pour tous les utilisateurs avant de poursuivre le dépannage.

1. Consultez les messages du journal pour les événements de performance

Consultez vos messages de journaux pour vous assurer que le SDK Performance Monitoring capture les événements de performances.

Afficher les messages de journal pour les événements de performances

1. Ouvrez les outils pour les développeurs de votre navigateur (par exemple, l'onglet "Réseau" des outils pour les développeurs Chrome ou le Moniteur réseau de Firefox).

2. Actualisez votre application Web dans le navigateur.

3. Recherchez les éventuels messages d'erreur dans vos messages de journaux.

4. Au bout de quelques secondes, recherchez un appel réseau vers firebaselogging.googleapis.com dans les outils de développement de votre navigateur. La présence de cet appel réseau indique que le navigateur envoie des données de performances à Firebase.

Si votre application n'enregistre pas les événements de performances, consultez les conseils de dépannage.

2. Consulter le tableau de bord d'état Firebase

Consultez le tableau de bord d'état Firebase pour savoir si Firebase ou Performance Monitoring sont concernés par une panne connue.

Premiers pas avec Performance Monitoring

Si vous débutez avec Performance Monitoring (iOS+ | Android | Web), les conseils de dépannage suivants peuvent vous aider à résoudre les problèmes liés à la détection du SDK par Firebase ou à l'affichage de vos premières données sur les performances dans la console Firebase.

J'ai ajouté le SDK à l'application, mais la console indique toujours de l'ajouter

Firebase peut détecter si vous avez bien ajouté le SDK Performance Monitoring à votre application lorsqu'il reçoit des informations sur les événements (comme les interactions avec l'application) de votre application. En général, dans les 10 minutes suivant le démarrage de votre application, le message "SDK détecté" s'affiche dans le tableau de bord "Performances" de la console Firebase. Ensuite, dans les 30 minutes, le tableau de bord affiche les premières données traitées.

Si vous avez ajouté la dernière version du SDK à votre application il y a plus de 10 minutes et que vous ne constatez toujours aucun changement, vérifiez vos messages de journal pour vous assurer que Performance Monitoring enregistre les événements. Suivez les étapes de dépannage appropriées décrites ci-dessous pour résoudre le problème lié à un message de détection différée du SDK.

L'application enregistre des événements : étapes de dépannage

Remarque : Le SDK Performance Monitoring regroupe les événements localement, puis les envoie à Firebase périodiquement. Cela signifie qu'il existe un délai entre une interaction avec l'application et le moment où Firebase reçoit les informations sur l'événement depuis votre application.

1. Si vous développez toujours en local, essayez de générer plus d'événements pour la collecte de données :

   1. Diffuser et afficher votre application Web dans un environnement local

   2. Générez des événements en chargeant des sous-pages de votre site, en interagissant avec votre application et/ou en déclenchant des requêtes réseau. Veillez à laisser l'onglet du navigateur ouvert pendant au moins 10 secondes après le chargement de la page.

2. Assurez-vous que votre objet de configuration Firebase est correctement ajouté à votre application et que vous ne l'avez pas modifié. Vérifiez en particulier les points suivants :

   • L'ID d'application Web Firebase (appId) dans l'objet de configuration est correct pour votre application. Trouvez votre ID d'application Firebase dans la fiche Vos applications de vos Paramètres du projet.

   Si vous pensez que l'objet de configuration de votre application présente un problème, essayez les solutions suivantes :

   1. Supprimez l'objet de configuration actuellement présent dans votre application.

   2. Suivez ces instructions pour obtenir un nouvel objet de configuration et l'ajouter à votre application Web.

3. Si le SDK enregistre des événements et que tout semble correctement configuré, mais que vous ne voyez toujours pas le message de détection du SDK ni les données traitées (après deux heures), contactez l'assistance Firebase.

L'application n'enregistre pas d'événements : étapes de dépannage

1. Assurez-vous que le SDK Performance Monitoring est correctement initialisé dans votre application.

2. Assurez-vous que le SDK Performance Monitoring n'est pas désactivé à l'aide de l'indicateur suivant :

   • performance.instrumentationEnabled

3. Assurez-vous que la mise en cache de votre navigateur est désactivée. Sinon, le navigateur risque de ne pas prendre en compte les nouveaux paramètres d'instrumentation.

4. Fermez l'onglet de la page Web, puis rouvrez-le. Vérifiez à nouveau si la journalisation fonctionne.

   Si vous venez d'ajouter le SDK Performance Monitoring à votre application, vous devrez peut-être la redémarrer complètement pour que le SDK commence à fonctionner.

5. Si vous ne trouvez rien de désactivé dans votre application, contactez l'assistance Firebase.

La console indique que le SDK est détecté, mais aucune donnée n'est affichée

Performance Monitoring traite les données d'événements de performances avant de les afficher dans le tableau de bord "Performances".

Si plus de 24 heures se sont écoulées depuis l'affichage du message "SDK détecté" et que vous ne voyez toujours aucune donnée, consultez le tableau de bord de l'état de Firebase pour vérifier si une panne connue est en cours. S'il n'y a pas de panne, contactez l'assistance Firebase.

Dépannage d'ordre général

Si vous avez ajouté le SDK et que vous utilisez Performance Monitoring dans votre application, les conseils de dépannage suivants peuvent vous aider à résoudre les problèmes généraux liés aux fonctionnalités et aux outils Performance Monitoring.

L'application n'enregistre pas les événements de performances

Si vous ne voyez pas les messages de journal pour les événements de performances, essayez les étapes de dépannage suivantes :

1. Assurez-vous que le SDK Performance Monitoring est correctement initialisé dans votre application.

2. Assurez-vous que lePerformance Monitoring Le SDK estpas désactivé par l'intermédiaire du drapeau suivant :

   • performance.instrumentationEnabled

3. Assurez-vous que la mise en cache de votre navigateur est désactivée. Sinon, le navigateur risque de ne pas prendre en compte les nouveaux paramètres d'instrumentation.

4. Fermez l'onglet de la page Web, puis rouvrez-le. Vérifiez à nouveau si la journalisation fonctionne.

   Si vous venez d'ajouter le SDK Performance Monitoring à votre application, vous devrez peut-être la redémarrer complètement pour que le SDK commence à fonctionner.

5. Si vous ne trouvez rien de désactivé dans votre application, contactez l'assistance Firebase.

Les données sur le délai de la première entrée sont manquantes dans le tableau de bord des performances

Si vous ne voyez pas de données pour la métrique Délai avant la première entrée, essayez les étapes de dépannage suivantes :

1. Notez que Performance Monitoring n'enregistre la métrique Délai avant la première interaction que lorsqu'un utilisateur clique sur la page Web dans les cinq premières secondes après le chargement de la page.

2. Assurez-vous d'avoir configuré votre application pour mesurer cette mesure. La métrique premier délai d'entrée nécessite une configuration manuelle. Plus précisément, vous devez ajouter la bibliothèque polyfill pour cette métrique. Pour obtenir des instructions d'installation, consultez la documentation de la bibliothèque.

   Notez que l'ajout de cette bibliothèque polyfill n'est pas nécessaire pour que Performance Monitoring signale d'autres métriques d'application Web.

Il manque des données de trace personnalisées dans le tableau de bord des performances

Affichez-vous des données de performances pour les traces collectées automatiquement, mais pas pour les traces de code personnalisé ? Suivez les étapes de dépannage ci-dessous :

1. Vérifiez la configuration des traces de code personnalisé instrumentées via l'API Trace, en particulier les éléments suivants :

   • Les noms des traces de code personnalisé et des métriques personnalisées doivent respecter les exigences suivantes : pas d'espace blanc au début ni à la fin, pas de caractère de soulignement (_) au début et une longueur maximale de 32 caractères.
   • Toutes les traces doivent être démarrées et arrêtées. Toute trace qui n'a pas été démarrée, qui n'a pas été arrêtée ou qui a été arrêtée avant d'avoir été démarrée ne sera pas enregistrée.

   Notez que si vous utilisez la méthode record(), vous n'avez pas besoin de démarrer ni d'arrêter explicitement votre trace.

2. Assurez-vous que la collecte de données Performance Monitoring n'est pas désactivée à l'aide de l'indicateur suivant :

   • performance.dataCollectionEnabled

     Cette option ne contrôle que la collecte de données pour les traces de code personnalisé (et non pour toutes les données).

3. Vérifiez vos messages de journal pour vous assurer que Performance Monitoring enregistre les traces de code personnalisé attendues.

4. Si Performance Monitoring enregistre des événements, mais qu'aucune donnée ne s'affiche au bout de 24 heures, contactez l'assistance Firebase.

Le tableau de bord des performances ne contient pas de données sur les requêtes réseau.

Si des données de requête réseau vous manquent, tenez compte des points suivants :

• Performance Monitoring collecte automatiquement les métriques pour les requêtes réseau signalées par l'API du navigateur. Ces rapports n'incluent pas les demandes réseau ayant échoué.

• En fonction du comportement de votre code et des bibliothèques réseau utilisées par votre code, Performance Monitoring pourrait ne signaler que les requêtes réseau qui sont terminées. Cela signifie que les connexions HTTP/S laissées ouvertes peuvent ne pas être signalées.

Les données des requêtes réseau ne s'agrègent pas comme prévu

Découvrez comment Performance Monitoring agrège les données des requêtes réseau sous les formats d'URL.

Vous pouvez également essayer les formats d'URL personnalisés.

Questions fréquentes

iOS+ Android Web

Qu'est-il arrivé à "Problèmes principaux" dans la fiche "Performances" de la page d'accueil du projet ?

Nous avons remplacé Problèmes principaux par Alertes récentes suite à l'introduction récente des alertes, qui vous avertissent automatiquement lorsque les seuils que vous avez définis sont dépassés. Les problèmes sont désormais obsolètes et remplacés par des alertes.

Le sélecteur d'applications en haut de la fiche "Performances" filtre les entrées d'alertes sous Alertes récentes. Seules les trois alertes les plus récentes pour les applications sélectionnées sont affichées.

Pour en savoir plus sur les alertes, consultez Configurer des alertes pour les problèmes de performances.

Qu'est-il arrivé à la possibilité de définir des seuils pour les problèmes dans la console ?

Performance Monitoring est compatible avec les alertes pour les métriques qui dépassent les seuils définis. Pour éviter toute confusion avec ces seuils configurables pour les métriques de performances, nous avons supprimé la possibilité de configurer des seuils pour les problèmes.

Qu'est-il advenu des informations "Détails" et "Métriques" dans la console Firebase ?

Nous avons remplacé les pages "Détails" et "Métriques" par une interface utilisateur (UI) centralisée et repensée pour vous aider à résoudre les problèmes plus facilement. Cette nouvelle interface utilisateur de dépannage offre les mêmes fonctionnalités de base que les sections "Détails" et "Métriques". Pour en savoir plus sur le dépannage, consultez Afficher plus de données pour une trace spécifique.

Pourquoi le nombre d'échantillons ne correspond-il pas à ce que j'attendais ?

Performance Monitoring collecte des données de performances à partir des appareils des utilisateurs de votre application. Si votre application compte de nombreux utilisateurs ou génère une grande quantité d'activités liées aux performances, Performance Monitoring peut limiter la collecte de données à un sous-ensemble d'appareils afin de réduire le nombre d'événements traités. Ces limites sont suffisamment élevées pour que, même avec moins d'événements, les valeurs des métriques restent représentatives de l'expérience utilisateur dans votre application.

Pour gérer le volume de données que nous collectons, Performance Monitoring utilise les options d'échantillonnage suivantes :

• Limitation du débit sur l'appareil : pour empêcher un appareil d'envoyer des rafales soudaines de traces, nous limitons le nombre de traces de code et de requêtes réseau envoyées par un appareil à 300 événements toutes les 10 minutes. Cette approche protège l'appareil contre les instrumentations en boucle qui peuvent envoyer de grandes quantités de données de performances, et empêche un seul appareil de fausser les mesures de performances.

• Échantillonnage dynamique : Performance Monitoring collecte un nombre limité de traces de code et de traces de requêtes réseau par application et par jour pour tous les utilisateurs de l'application. Un taux d'échantillonnage dynamique est récupéré sur les appareils (à l'aide de Firebase Remote Config) pour déterminer si un appareil aléatoire doit capturer et envoyer des traces. Un appareil qui n'est pas sélectionné pour l'échantillonnage n'envoie aucun événement. Le taux d'échantillonnage dynamique est spécifique à l'application et s'ajuste pour s'assurer que le volume global de données collectées reste en dessous de la limite.

  Les sessions utilisateur envoient des données supplémentaires et détaillées depuis l'appareil d'un utilisateur, ce qui nécessite plus de ressources pour capturer et envoyer les données. Pour minimiser l'impact des sessions utilisateur, Performance Monitoring peut également limiter le nombre de sessions.

• Limitation du débit côté serveur : pour s'assurer que les applications ne dépassent pas la limite d'échantillonnage, Performance Monitoring peut utiliser l'échantillonnage côté serveur pour supprimer certains événements reçus des appareils. Bien que ce type de limitation ne modifie pas l'efficacité de nos métriques, il peut entraîner de légères modifications des tendances, y compris les suivantes :

  • Le nombre de traces peut être différent du nombre de fois qu'un extrait de code a été exécuté.
  • Les traces étroitement couplées dans le code peuvent avoir un nombre d'échantillons différent.

Remarque : Les limites d'échantillonnage spécifiques et leur application peuvent changer à mesure que Performance Monitoring évolue.

Qu'est-il arrivé à l'onglet Problèmes de la console ?

Nous avons remplacé l'onglet "Problèmes" par les alertes, qui vous avertissent automatiquement lorsque les seuils que vous avez définis sont dépassés. Vous n'avez plus besoin de vérifier manuellement la console Firebase pour déterminer l'état d'un seuil. Pour en savoir plus sur les alertes, consultez Configurer des alertes pour les problèmes de performances.

Qu'est-il arrivé aux onglets Sur l'appareil et Réseau de la console ? Comment afficher les traces qui se trouvaient sur ces pages ?

Nous avons repensé la section Performance Monitoring de la console Firebase afin que l'onglet Tableau de bord affiche vos métriques clés et toutes vos traces dans un seul et même espace. Dans le cadre de cette refonte, nous avons supprimé les pages Sur l'appareil et Réseau.

Le tableau des traces en bas de l'onglet Tableau de bord contient les mêmes informations que celles affichées dans les onglets Sur l'appareil et Réseau, mais avec quelques fonctionnalités supplémentaires, y compris la possibilité de trier vos traces par variation en pourcentage pour une métrique spécifique. Pour afficher toutes les métriques et données d'une trace spécifique, cliquez sur son nom dans le tableau des traces.

Affichez vos traces dans les sous-onglets suivants du tableau des traces :

• Traces de requêtes réseau (prêtes à l'emploi et personnalisées) : sous-onglet Requêtes réseau
• Traces de code personnalisé : sous-onglet Traces personnalisées
• Traces de démarrage de l'application, d'application au premier plan et d'application en arrière-plan : sous-onglet Traces personnalisées
• Traces de rendu d'écran : sous-onglet Rendu d'écran
• Traces de chargement de page : sous-onglet Chargement de page

Pour en savoir plus sur le tableau des traces et sur l'affichage des métriques et des données, consultez la page de présentation de la console (iOS+ | Android | Web).

Pourquoi le nombre d'images lentes et figées n'est-il pas celui auquel je m'attendais ?

Les images à rendu lent et les images figées sont calculées avec une fréquence d'actualisation de l'appareil supposée de 60 Hz. Si la fréquence d'actualisation d'un appareil est inférieure à 60 Hz, le temps de rendu de chaque frame sera plus lent, car moins de frames sont rendues par seconde. Des temps de rendu plus lents peuvent entraîner le signalement d'un plus grand nombre de frames lents ou figés, car davantage de frames seront rendus plus lentement ou se figeront. Toutefois, si la fréquence d'actualisation d'un appareil est supérieure à 60 Hz, le temps de rendu de chaque frame sera plus rapide. Cela peut entraîner la signalisation d'un nombre moins important d'images lentes ou figées. Il s'agit d'une limitation actuelle du SDK Performance Monitoring.

Comment puis-je ajouter le SDK JS Performance Monitoring plus petit et avec espace de noms (le SDK « autonome ») à mon application Web ?

Si Performance Monitoring est le seul produit Firebase de votre application, vous pouvez utiliser le SDK Performance Monitoring autonome (et le script d'en-tête recommandé ci-dessous) si vous souhaitez :

• Utiliser une bibliothèque avec un espace de noms
• réduire la taille de votre package SDK
• Retarder l'initialisation du SDK jusqu'à ce que votre page soit chargée.

Important : Pour la plupart des applications Web Firebase, nous vous recommandons vivement d'utiliser le SDK Firebase JS modulaire via npm.
De plus, en utilisant npm avec un bundler de module, vous pouvez obtenir une taille de package SDK encore plus petite qu'en utilisant le SDK Performance Monitoring autonome.

Pour inclure le SDK Performance Monitoring autonome dans votre application et retarder son initialisation jusqu'après le chargement de votre page :

1. Ajoutez le script suivant à l'en-tête de votre fichier d'index.
2. Veillez à ajouter l'objet de configuration du projet Firebase de votre application.

(function(sa,fbc){function load(f,c){var a=document.createElement('script');
a.async=1;a.src=f;var s=document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(a,s);}load(sa);
window.addEventListener('load',function(){firebase.initializeApp(fbc).performance()});
})(performance_standalone, firebaseConfig);

où :

• performance_standalone est 'https://www.gstatic.com/firebasejs/12.6.0/firebase-performance.js'
• firebaseConfig est l'objet de configuration Firebase de votre application.

Le script ci-dessus charge le SDK autonome de manière asynchrone, puis initialise Firebase après le déclenchement de l'événement onload de la fenêtre. Cette tactique réduit l'impact que le SDK pourrait avoir sur les métriques de chargement de page, car le navigateur a déjà signalé ses métriques de chargement lorsque vous avez initialisé le SDK.

Remarque : Lorsque vous utilisez le SDK Performance Monitoring autonome, vous n'incluez pas explicitement le SDK Firebase principal, car le SDK autonome inclut déjà son propre SDK Firebase principal plus léger.

En savoir plus sur le SDK Performance Monitoring autonome et le script d'en-tête

Ce SDK autonome est optimisé pour la taille. Compressé, il pèse environ 10 Ko. Il dispose de toutes les fonctionnalités de Firebase Performance Monitoring, ainsi que d'un ensemble minimal de fonctionnalités du SDK Firebase Core.

Firebase Performance Monitoring utilise les API fetch et Promise, qui ne sont pas disponibles sur les anciens navigateurs. Les polyfills pour ces API sont inclus dans le SDK JS Firebase Performance Monitoring standard, mais ils sont omis du SDK autonome pour réduire la taille.

Le SDK Performance Monitoring s'appuie en partie sur l'API Resource Timing pour obtenir les métriques de chargement de page à partir du navigateur.

L'extrait suivant décompose le script d'en-tête qui inclut, puis retarde l'initialisation du SDK :

(function(sdkSource, firebaseConfigObject) {
   function load(f, c) {
       // Creates a script tag to load the standalone SDK
       var sdkScript = document.createElement('script');

       // Sets it to an async script so that it doesn't interfere with page load
       sdkScript.async = 1;

       // Sets the source of the script
       sdkScript.src = f;

       // Inserts the script into the head of the page
       var s = document.getElementsByTagName('script')[0];
       s.parentNode.insertBefore(sdkScript, s);
   }

   // Calls the load method
   load(sdkSource);

   // Initializes the SDK only when the onload method is called
   window.addEventListener('load', function() {
       firebase.initializeApp(firebaseConfigObject).performance();
   });
})(performance_standalone, firebaseConfig);

où :

• performance_standalone est 'https://www.gstatic.com/firebasejs/12.6.0/firebase-performance-standalone.js'
• firebaseConfig est l'objet de configuration Firebase de votre application.

Traitement et affichage des données en temps quasi réel

Que signifient les données sur les performances "en temps quasi réel" ?

Firebase Performance Monitoring traite les données de performances collectées à mesure qu'elles arrivent, ce qui permet d'afficher les données en temps quasi réel dans la console Firebase. Les données traitées s'affichent sur la console quelques minutes après leur collecte, d'où le terme « quasi temps réel ».

Pour bénéficier d'un traitement des données quasi en temps réel, assurez-vous que votre application utilise une version SDK compatible temps réel.

Comment obtenir des données sur les performances de mon application en quasi-temps réel ?

Pour profiter du traitement des données en quasi-temps réel, il vous suffit de vous assurer que votre application utilise une version Performance Monitoring du SDK compatible avec le traitement des données en temps réel.

Voici les versions du SDK compatibles avec la surveillance en temps réel :

• iOS : version 7.3.0 ou ultérieure
• tvOS : version 8.9.0 ou ultérieure
• Android : version 19.0.10 ou ultérieure (ou Firebase Android BoM version 26.1.0 ou ultérieure)
• Web : version 7.14.0 ou ultérieure

Notez que nous vous recommandons toujours d'utiliser la dernière version du SDK, mais que toute version listée ci-dessus permettra à Performance Monitoring de traiter vos données en quasi-temps réel.

Quelles versions du SDK Performance Monitoring sont considérées comme compatibles avec la surveillance en temps réel ?

Voici les versions du SDK compatibles avec le traitement des données en temps réel :

• iOS : version 7.3.0 ou ultérieure
• tvOS : version 8.9.0 ou ultérieure
• Android : version 19.0.10 ou ultérieure (ou Firebase Android BoM version 26.1.0 ou ultérieure)
• Web : version 7.14.0 ou ultérieure

Notez que nous vous recommandons toujours d'utiliser la dernière version du SDK, mais que toute version listée ci-dessus permettra à Performance Monitoring de traiter vos données en quasi-temps réel.

Que se passe-t-il si je ne mets pas à jour mon application pour utiliser une version du SDK compatible avec le temps réel ?

Si votre application n'utilise pas de version du SDK compatible avec le temps réel, vous verrez quand même toutes les données de performances de votre application dans la console Firebase. Toutefois, l'affichage des données de performance sera retardé d'environ 36 heures par rapport à l'heure de leur collecte.

Je suis passé à une version du SDK compatible avec la surveillance en temps réel, mais certains de mes utilisateurs utilisent encore d'anciennes versions de mon application. Vais-je continuer à voir leurs données de performances dans la console Firebase ?

Oui. Quelle que soit la version du SDK utilisée par une instance d'application, vous verrez les données de performances de tous vos utilisateurs.

Toutefois, si vous consultez des données récentes (datant de moins de 36 heures environ), les données affichées proviennent des utilisateurs d'instances d'application utilisant une version du SDK compatible avec le temps réel. Toutefois, les données non récentes incluent les données sur les performances de toutes les versions de votre application.

Contacter l'assistance Firebase

Si vous contactez l'assistance Firebase, veillez à toujours inclure l'ID de votre application Firebase. Vous trouverez l'ID de votre application Firebase dans la fiche Vos applications de vos Paramètres du projet.