Dépannage et questions fréquentes concernant Performance Monitoring

iOS ou version ultérieure Android Web

Cette page fournit des conseils de dépannage pour commencer à utiliser Performance Monitoring ou à l'aide des fonctionnalités et 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. Rechercher les événements liés aux performances dans les messages de journal

Vérifiez vos messages de journal pour vous assurer que le SDK Performance Monitoring capture les événements de performances.

Afficher les messages de journal des événements liés aux performances

1. Activez la journalisation de débogage comme suit:

   1. Dans Xcode (version 15.2 ou ultérieure), sélectionnez Produit > Schéma > Modifier le schéma
   2. Sélectionnez Exécuter dans le menu de gauche, puis l'onglet Arguments.
   3. Dans la section Arguments transmis au lancement, ajoutez -FIRDebugEnabled.

2. Recherchez d'éventuels messages d'erreur dans vos messages de journal.

3. Performance Monitoring ajoute un tag Firebase/Performance à ses messages de journal pour que vous puissiez peuvent filtrer vos messages de journal.

4. Recherchez les types de journaux suivants, qui indiquent que Performance Monitoring est sur la journalisation des événements liés aux performances:

   • Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URL
   • Logging network request trace: URL

5. Cliquez sur l'URL pour afficher vos données dans la console Firebase. Cela peut prendre quelques des moments pour que les données soient mises à jour dans le tableau de bord.

Si votre application n'enregistre pas les événements liés aux performances, consultez le guide de dépannage conseils.

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

Consultez le Tableau de bord d'état Firebase au cas où il y a une indisponibilité connue pour Firebase ou Performance Monitoring.

Premiers pas avec Performance Monitoring

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

Le SDK a été ajouté à l'application, mais la console indique toujours d'ajouter le SDK

Firebase peut détecter si vous avez bien ajouté le SDK Performance Monitoring à votre application lorsqu'il reçoit des informations d'événement (telles que des interactions avec l'application) de votre application. En général, dans les 10 minutes qui suivent le démarrage de votre application, la section Performances tableau de bord de la console Firebase affiche le message "SDK détecté" . Puis, dans les 30 minutes, le tableau de bord affiche les données traitées initiales.

Si vous avez ajouté la dernière version du SDK depuis plus de 10 minutes application et que vous ne constatez toujours aucun changement, consultez votre journal messages pour vous assurer que Performance Monitoring enregistre bien événements. Suivez les étapes de dépannage ci-dessous pour essayer de résoudre le problème. résoudre les problèmes liés à un message de détection retardée d'un SDK.

L'application consigne les événements: dépannage pas

Remarque :Le SDK Performance Monitoring regroupe les événements localement, puis les envoie à Firebase périodiquement ou lorsque l'application revient au premier plan. Il existe donc un délai entre une interaction dans l'application et le moment où Firebase reçoit les informations sur l'événement de 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. Continuez à développer votre application à l'aide d'un simulateur ou d'un appareil de test.

   2. Générez des événements en basculant votre application entre l'arrière-plan et l'avant-plan plusieurs fois, en interagissant avec votre application en parcourant les écrans et/ou en déclenchant des requêtes réseau.

2. Assurez-vous que votre configuration Firebase fichier (Google-Service-Info.plist) est correctement ajouté à votre application et que vous n'avez pas modifié le fichier. Vérifiez plus particulièrement les points suivants:

   • Le nom du fichier de configuration n'est pas suivi de caractères supplémentaires, comme (2).

   • Le fichier de configuration se trouve à la racine de votre projet XCode et a été ajouté au les cibles correctes.

   • L'ID de l'application Firebase Apple (GOOGLE_APP_ID) indiqué dans le fichier de configuration est pour votre application. Vous trouverez votre ID d'application Firebase dans la fiche Vos applications de votre projet .

   Si vous constatez un problème avec le fichier de configuration de votre application, procédez comme suit:

   1. Supprimez le fichier de configuration qui se trouve actuellement dans votre application.

   2. Suivez ces instructions pour télécharger un nouveau fichier de configuration et l'ajouter à votre application Apple.

3. Si le SDK enregistre les événements et que tout semble être correctement configuré, mais 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 ne consigne pas les événements: procédure de dépannage

1. Assurez-vous que le SDK Performance Monitoring n'est pas désactivé via l'un des indicateurs suivants dans votre fichier Info.plist:

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

2. Assurez-vous que Performance Monitoring n'est pas désactivé au moment de l'exécution. (Swift) | Obj-C).

3. Si vous ne trouvez aucun élément désactivé dans votre application, contactez l'assistance Firebase.

indique que le SDK est détecté, mais aucune donnée ne s'affiche

Performance Monitoring traite les données d'événement de performances avant de les afficher dans le Tableau de bord Performances :

Si plus de 24 heures se sont écoulées depuis la détection du SDK, s'affiche, et que vous ne voyez toujours pas de données, vérifiez le Tableau de bord d'état Firebase, le cas échéant d'une panne connue. En l'absence d'indisponibilité, contactez l'assistance Firebase.

Dépannage d'ordre général

Si vous avez réussi à ajouter le SDK et à utiliser Performance Monitoring dans votre application, la Les conseils de dépannage suivants peuvent vous aider à résoudre les problèmes d'ordre général impliquant Fonctionnalités et outils Performance Monitoring.

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

Si vous ne voyez pas les messages de journal relatifs aux performances , suivez les étapes de dépannage ci-dessous:

1. Assurez-vous que le SDK Performance Monitoring n'est pas désactivé via l'un des indicateurs suivants dans votre fichier Info.plist:

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

2. Assurez-vous que Performance Monitoring n'est pas désactivé au moment de l'exécution. (Swift) | Obj-C).

3. Si vous ne trouvez aucun élément désactivé dans votre application, contactez l'assistance Firebase.

Données de trace d'écran manquantes dans le tableau de bord des performances

S'il vous manque des données pour les traces de rendu d'écran, essayez ce qui suit étapes de dépannage:

Le tableau de bord des performances données de trace personnalisées manquantes

Les données de performances s'affichent-elles pour les traces collectées automatiquement, mais pas pour des traces de code personnalisées. Suivez les étapes de dépannage ci-dessous:

1. Vérifiez la configuration des traces de code personnalisées instrumentées via la API Trace, notamment les suivants:

   • Les noms des traces de code personnalisées et des métriques 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 32 caractères.
   • Toutes les traces doivent être démarrées et arrêtées. Toute trace qui n'est pas démarrée, arrêtées ou arrêtées avant son démarrage ne sont pas consignées.

2. Vérifiez vos messages de journal pour vous assurer que Performance Monitoring consigne les traces de code personnalisées attendues.

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

Tableau de bord des performances il manque des données de requête réseau

S'il manque des données de requête réseau, essayez de suivre les étapes de dépannage ci-dessous:

1. Recherchez une incompatibilité avec la bibliothèque réseau. Performance Monitoring automatiquement collecte des métriques pour les requêtes réseau qui utilisent les bibliothèques réseau suivantes:

   • Pour Swift : URLSession et URLConnection
   • Pour Objective-C: NSURLSession et NSURLConnection

   Notez que vous pouvez ajouter une surveillance personnalisée requêtes.

2. Important :

   • En fonction du comportement de votre code et des bibliothèques réseau utilisées par votre code, il est possible que Performance Monitoring ne génère des rapports que sur les requêtes réseau terminé. Cela signifie que les connexions HTTP/S laissées ouvertes peuvent ne pas être signalé.

   • Performance Monitoring ne fournit pas de rapports sur les requêtes réseau contenant des Content-Type. En revanche, les requêtes réseau sans Content-Type en-têtes seront toujours acceptés.

Les données des demandes réseau ne sont pas agrégées comme prévu

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

Vous pouvez également essayer les URL personnalisées des modèles.

Questions fréquentes

iOS ou version ultérieure Android Web

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

Nous avons remplacé la section Principaux problèmes par Alertes récentes à la suite de notre les alertes récemment lancées, 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ées par les alertes.

Le sélecteur d'applications, en haut de la fiche "Performances", permet de filtrer l'alerte. sous Alertes récentes. Seules les trois alertes les plus récentes pour le application(s) sélectionnée(s) 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 accepte les alertes pour les métriques qui dépassent des 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 arrivé aux informations sur les détails et les métriques dans la console Firebase ?

Nous avons remplacé les pages "Détails" et "Métriques" par une nouvelle interface centralisée pour améliorer la résolution des problèmes. Cette nouvelle interface de dépannage offre les mêmes fonctionnalités de base que les options "Détails" et "Métriques". Pour en savoir plus sur le dépannage, consultez Affichez plus de données pour une trace spécifique.

Pourquoi le nombre d'échantillons ne correspond-il pas à mes attentes ?

Performance Monitoring collecte des données de performances sur les appareils des utilisateurs de votre application. Si votre que l'application compte de nombreux utilisateurs ou qu'elle génère de nombreuses performances d'activité, Performance Monitoring peut limiter la collecte des données à un sous-ensemble d'appareils à 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 de l'utilisateur dans l'application.

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

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

• Échantillonnage dynamique : Performance Monitoring collecte une limite d'environ 100 millions d'événements pour les traces de code et 100 millions pour les 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 Firebase Remote Config) pour déterminer si un appareil aléatoire doit de capturer et d'envoyer des traces. Un appareil non sélectionné pour l'échantillonnage n'importe quel é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 inférieur à la limite.

  Les sessions utilisateur envoient des données supplémentaires détaillées depuis l'appareil d'un utilisateur, ce qui nécessite plus de ressources pour capturer et envoyer les données. Afin de minimiser l'impact de l'utilisateur sessions, 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 le délai d'échantillonnage limite, Performance Monitoring peut utiliser l'échantillonnage côté serveur pour supprimer certains événements provenant des appareils. Bien que ce type de limitation ne change pas de nos métriques, cela peut entraîner de légers changements dans les tendances, par exemple suivantes:

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

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

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

Nous avons remplacé l'onglet "Problèmes" par "Alertes", qui vous avertit automatiquement lorsque les seuils que vous définissez sont dépassés. Non vous n'avez plus besoin de vérifier manuellement la console Firebase pour déterminer l'état 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 puis-je consulter les traces qui se trouvaient sur ces pages ?

Nous avons repensé la section Performance Monitoring de la console Firebase pour que le L'onglet Tableau de bord affiche vos métriques clés et toutes vos traces dans un seul et même espace. En tant que 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 présente exactement les mêmes informations affichées dans les onglets Sur l'appareil et Réseau, mais avec quelques nouvelles fonctionnalités, comme la possibilité de trier vos traces en fonction du pourcentage pour une métrique spécifique. Pour afficher toutes les métriques et données d'un trace, cliquez sur son nom dans le tableau des traces.

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

• Traces de requête réseau (prêts à l'emploi et personnalisés) – sous-onglet Demandes réseau
• Traces de code personnalisés : sous-onglet Traces personnalisées
• Démarrage de l'application, traces de l'application au premier plan et en arrière-plan – sous-onglet Traces personnalisées
• Traces de rendu d'écran : sous-onglet Rendu de l'é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 le page de présentation de la console (iOS+ | Android | Web).

Pourquoi le nombre d'images lentes et figées n'est-il pas conforme à mes attentes ?

Les images de rendu lent et les images figées sont calculées en supposant une fréquence d'actualisation de l'appareil de 60 Hz. Si la fréquence d'actualisation d'un appareil est inférieure à 60 Hz, chaque image aura un temps d'affichage plus lent, car moins d'images sont affichées par seconde. Des cadres lents ou figés peuvent être signalés si l'affichage est plus lent. car un plus grand nombre d'images s'afficheront plus lentement ou se figeront. Toutefois, si un appareil est supérieure à 60 Hz, le rendu est plus court pour chaque image. Cela peut réduire le nombre de cadres lents ou figés à signaler. Il s'agit d'un dans le SDK Performance Monitoring.

L'exportation de mes données Performance Monitoring vers BigQuery prend plus de temps que prévu. Ce n'est pas en temps réel ?

Si vous avez activé l'intégration BigQuery pour Firebase Performance Monitoring, vos données sont exportées vers BigQuery 12 à 24 heures après la fin de la journée l'heure).

Par exemple, les données du 19 avril seront disponibles dans BigQuery le 20 avril entre 12h00 et minuit (toutes les dates et heures sont exprimées en heure du Pacifique).

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

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

Firebase Performance Monitoring traite les données sur les performances au fur et à mesure qu'elles arrivent, ce qui permet l'affichage des données en temps quasi réel dans la console Firebase. Traité les données s'affichent dans la console quelques minutes après leur collecte. "quasi en temps réel".

Pour profiter du traitement des données en temps quasi réel, assurez-vous que votre application utilise un SDK compatible en temps réel version.

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

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

Voici les versions compatibles en temps réel des SDK:

• iOS : v7.3.0 ou version ultérieure
• tvOS : version 8.9.0 ou ultérieure
• Android : v19.0.10 ou version ultérieure (ou Firebase Android BoM v26.1.0 ou version ultérieure)
• Web : version 7.14.0 ou ultérieure

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

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

Voici les versions de 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 : v19.0.10 ou version ultérieure (ou Firebase Android BoM v26.1.0 ou version 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 n'importe quelle version listée ci-dessus permet à 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 qu'elle utilise une version compatible du SDK en temps réel ?

Si votre application n'utilise pas de version de SDK compatible avec le temps réel, vous verrez toujours toutes les données de performances de votre application dans la console Firebase. Toutefois, l'écran des données sur les performances est retardé d'environ 36 heures collection.

J'ai effectué la mise à jour vers une version du SDK compatible en temps réel, mais certains de mes utilisateurs toujours sur d'anciennes versions de mon application. Est-ce que je continue de voir leurs 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 sur les 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 d'utilisateurs d'instances de l'application à l'aide d'un rapport en temps réel vers une version compatible du SDK. En revanche, 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, toujours inclure l'ID de votre application Firebase. Recherchez votre ID d'application Firebase dans le Fiche Vos applications de votre Projet .