Dépannage et questions fréquentes concernant Performance Monitoring
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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
Activez la journalisation de débogage comme suit:
Dans Xcode (version 15.2 ou ultérieure), sélectionnez Produit >
Schéma > Modifier le schéma
Sélectionnez Exécuter dans le menu de gauche, puis l'onglet Arguments.
Dans la section Arguments transmis au lancement, ajoutez -FIRDebugEnabled.
Recherchez d'éventuels messages d'erreur dans vos messages de journal.
Performance Monitoring ajoute un tag Firebase/Performance à ses messages de journal pour que vous puissiez
peuvent filtrer vos messages de journal.
Recherchez les types de journaux suivants, qui indiquent que Performance Monitoring est
sur la journalisation des événements liés aux performances:
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
Si vous développez toujours en local, essayez de générer plus d'événements pour la collecte de données :
Continuez à développer votre application à l'aide d'un simulateur ou d'un appareil de test.
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.
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 settings.
Si vous constatez un problème avec le fichier de configuration de votre application, procédez comme suit:
Supprimez le fichier de configuration qui se trouve actuellement dans votre application.
Suivez ces instructions pour télécharger un nouveau fichier de configuration et l'ajouter à votre application Apple.
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
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
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:
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.
Vérifiez vos messages de journal pour vous assurer que
Performance Monitoring consigne les traces de code personnalisées attendues.
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:
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
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.
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.
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
settingsProjet
.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/09/12 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2024/09/12 (UTC)."],[],[]]