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

Surveiller les requêtes réseau HTTP / S

Une trace de demande réseau HTTP / S est un rapport qui capture le temps entre le moment où votre application émet une demande à un point de terminaison de service et le moment où la réponse de ce point de terminaison est terminée. Pour tout point de terminaison auquel votre application fait une demande, Performance Monitoring capture plusieurs métriques:

  • Temps de réponse - Temps entre le moment où la demande est faite et le moment où la réponse est entièrement reçue

  • Taille de la charge utile - Taille en octets de la charge utile du réseau téléchargée et téléchargée par l'application

  • Taux de réussite - Pourcentage de réponses réussies par rapport au nombre total de réponses (pour mesurer les pannes de réseau ou de serveur)

Agrégation de données sous des modèles d'URL

Firebase Performance Monitoring agrège automatiquement les données pour des demandes réseau similaires pour vous aider à comprendre les tendances des performances de vos demandes réseau.

Pour chaque requête, Firebase vérifie si l'URL de la requête réseau correspond à un modèle d'URL. Si l'URL de la demande correspond à un modèle d'URL, Firebase agrège automatiquement les données de la demande sous le modèle d'URL. Firebase affiche les modèles d'URL et leurs données agrégées dans l'onglet Réseau de la section Performances de la console Firebase.

Qu'est-ce qu'un modèle d'URL?

Un modèle d'URL contient un domaine plus un modèle qui peut correspondre à un chemin d'URL, par exemple: example.com/*/animals/** .

  • Les modèles d'URL peuvent contenir les segments de chemin suivants:

    • texte brut - correspond à une chaîne exacte
    • * - correspond à n'importe quelle chaîne dans un seul segment de chemin
    • ** - correspond à un suffixe de chemin arbitraire
  • Les modèles d'URL peuvent être:

Par exemple: l'une des demandes d'URL suivantes peut correspondre au modèle d'URL example.com/*/animals/** .

  • example.com/singapore/animals
  • example.com/australia/animals/spiders
  • example.com/australia/animals/marsupials/koala.png

Firebase mappe chaque requête sur un seul modèle d'URL . Si vous avez configuré des modèles d'URL personnalisés , Firebase tente d'abord de faire correspondre les URL de demande à ces modèles. Si Firebase ne trouve aucun modèle d'URL personnalisé correspondant, il met en correspondance une URL de demande avec le modèle d'URL automatique le plus représentatif. En savoir plus sur les modèles d'URL automatiques et personnalisés dans les sections suivantes.

Modèles d'URL automatiques

Sans aucune configuration de votre part, la surveillance des performances tente de refléter le dernier comportement d'utilisation de votre application en faisant correspondre les demandes de votre application aux modèles d'URL automatiques .

Comment fonctionne la correspondance automatique des modèles d'URL?

Firebase fait correspondre chaque demande au modèle d'URL automatique le plus représentatif qu'il a dérivé des demandes envoyées par votre application. Notez, cependant, que Firebase essaie d'abord de faire correspondre les URL de demande à tous les modèles d'URL personnalisés configurés.

Voici un exemple de base de la manière dont Firebase tente de faire correspondre les demandes avec le modèle d'URL automatique le plus représentatif de votre application.

  1. Votre application envoie de nombreuses requêtes à des URL telles que:

    • example.com/germany/animals/bears
    • example.com/germany/animals/birds
    • example.com/germany/cars

    Firebase détermine que example.com/germany/** est un modèle de requête courant pour votre application et l'ajoute en tant que modèle d'URL automatique dans votre projet.

    Pour toute nouvelle requête correspondant à ce modèle d'URL, Firebase regroupe les données des requêtes sous le modèle d'URL automatique example.com/germany/** .

  2. Après une semaine, la majorité des demandes de votre application sont example.com/germany/animals/bears à example.com/germany/animals/bears et example.com/germany/animals/birds . Ainsi, Firebase dérive un modèle d'URL plus représentatif de example.com/germany/animals/** .

    Pour toute nouvelle requête correspondant à ce nouveau modèle d'URL, Firebase regroupe les données des requêtes uniquement sous le nouveau modèle d'URL. Firebase continue d'agréger les données pour les demandes example.com/germany/cars à example.com/germany/cars sous example.com/germany/** .

  3. Cependant, au cours des prochaines semaines, les demandes de votre application à example.com/germany/animals/bears et example.com/germany/animals/birds diminuent considérablement. Firebase détermine que example.com/germany/animals/** n'est pas représentatif du dernier comportement d'utilisation de votre application, donc Firebase commence à faire correspondre ces deux demandes à example.com/germany/** .

    Firebase ne regroupe aucune autre donnée de demande sous example.com/germany/animals/** car ce n'est plus le modèle d'URL automatique le plus représentatif.

La correspondance automatique des modèles d'URL étant dynamique, tenez compte des points suivants:

  • Les correspondances et les données agrégées des demandes précédentes ne sont pas affectées par les nouveaux modèles d'URL. Firebase ne ré-agrège pas rétroactivement les données de demande.

  • Seules les demandes futures sont affectées par les nouveaux modèles d'URL. Firebase mappe chaque nouvelle requête au modèle d'URL automatique le plus représentatif. Notez, cependant, que Firebase essaie d'abord de faire correspondre les URL de demande à tous les modèles d'URL personnalisés configurés.

Afficher les modèles d'URL automatiques et leurs données

La section Performances de la console répertorie les modèles d'URL automatiques dans l'onglet Réseau > Tous . Vous pouvez voir des modèles d'URL avec une étiquette Sans catégorie . Il s'agit de modèles d'URL automatiques "larges" dans lesquels Firebase peut regrouper des données pour les demandes qui ne correspondent à aucun modèle d'URL plus spécifique.

Lorsque la période de conservation des données se termine pour les données agrégées sous un modèle d'URL, Firebase supprime ces données du modèle d'URL. Si toutes les données agrégées sous un modèle d'URL automatique expirent, Firebase supprime ce modèle d'URL de la console Firebase.

Modèles d'URL personnalisés

Vous pouvez créer des modèles d'URL personnalisés pour surveiller des modèles d'URL spécifiques que Firebase ne capture pas avec sa correspondance de modèle d'URL automatique dérivée. Par exemple, vous pouvez utiliser un modèle d'URL personnalisé pour dépanner une URL spécifique ou pour surveiller un ensemble spécifique d'URL au fil du temps.

Comment fonctionne la correspondance de modèle d'URL personnalisée?

Firebase tente de faire correspondre les URL de demande à tout modèle d'URL personnalisé configuré avant de revenir à la correspondance de modèle d'URL automatique. Pour toutes les demandes correspondantes à un modèle d'URL personnalisé, Firebase regroupe les données des demandes sous le modèle d'URL personnalisé.

Si l'URL d'une requête correspond à plusieurs modèles d'URL personnalisés, Firebase mappe la requête uniquement sur le modèle d'URL personnalisé le plus spécifique , selon l'ordre de spécificité suivant: texte brut> * > ** de gauche à droite dans le chemin . Par exemple, une demande à example.com/books/dog correspond à deux modèles d'URL personnalisés:

  • example.com/books/*
  • example.com/*/dog

Cependant, le modèle example.com/books/* est le modèle d'URL correspondant le plus spécifique , car le segment le plus à gauche des books dans example.com/books/* est prioritaire sur le segment le plus à gauche * dans example.com/*/dog .

Lorsque vous créez un nouveau modèle d'URL personnalisé, tenez compte des éléments suivants:

  • Les correspondances et les données agrégées des demandes précédentes ne sont pas affectées par la création d'un nouveau modèle d'URL personnalisé. Firebase ne ré-agrège pas rétroactivement les données de demande.

  • Seules les demandes futures sont affectées par la création d'un nouveau modèle d'URL personnalisé. Vous devrez peut-être attendre jusqu'à 12 heures pour que la surveillance des performances collecte et agrège les données sous un nouveau modèle d'URL personnalisé.

Créer un modèle d'URL personnalisé

Créez un modèle d'URL personnalisé à partir de la section Performances de la console dans l'onglet Réseau . Un membre du projet doit être propriétaire ou éditeur pour créer un nouveau modèle d'URL personnalisé; cependant, tous les membres du projet peuvent afficher des modèles d'URL personnalisés et leurs données agrégées.

Pour créer un modèle d'URL personnalisé, commencez par un domaine, puis utilisez la syntaxe de segment de chemin suivante pour créer un modèle qui peut correspondre aux chemins d'URL.

  • texte brut - correspond à une chaîne exacte
  • * - correspond à n'importe quelle chaîne dans un seul segment de chemin
  • ** - correspond à un suffixe de chemin arbitraire

Le tableau suivant décrit certaines correspondances de modèles d'URL personnalisées potentielles.

Correspondre... Créez un modèle d'URL personnalisé comme ... Exemple de correspondance avec ce modèle d'URL
Une URL exacte example.com/foo/baz example.com/foo/baz
Tout segment de chemin unique ( * ) example.com/*/baz example.com/foo/baz
example.com/bar/baz
example.com/*/*/baz example.com/foo/bar/baz
example.com/bah/qux/baz
example.com/foo/* example.com/foo/baz
example.com/foo/bar

Remarque: ce modèle ne correspondra pas à example.com/foo .

Un suffixe de chemin arbitraire ( ** ) example.com/foo/** example.com/foo
example.com/foo/baz
example.com/foo/baz/more/segments
subdomain.example.com/foo.bar/** subdomain.example.com/foo.bar
subdomain.example.com/foo.bar/baz
subdomain.example.com/foo.bar/baz/more/segments

Afficher les modèles d'URL personnalisés et leurs données

La section Performances de la console répertorie les modèles d'URL personnalisés qui ont des données agrégées à la fois dans l'onglet Réseau > Tous et dans l'onglet Réseau > Personnalisé . Si un modèle d'URL personnalisé ne contient aucune donnée agrégée, il n'apparaît que dans l'onglet Réseau > Personnalisé .

Lorsque la période de conservation des données se termine pour les données agrégées sous un modèle d'URL, Firebase supprime ces données du modèle d'URL. Si toutes les données agrégées sous un modèle d'URL personnalisé expirent, Firebase ne supprime pas le modèle d'URL personnalisé de la console Firebase. Au lieu de cela, Firebase continue de répertorier les modèles d'URL personnalisés «vides» dans l'onglet Réseau > Personnalisé .

Supprimer un modèle d'URL personnalisé

Contrairement à un modèle d'URL automatique, vous pouvez supprimer des modèles d'URL personnalisés de votre projet.

  1. Dans la section Performances de la console, accédez à l'onglet Réseau > Personnalisé .

  2. Passez la souris sur la ligne du modèle d'URL personnalisé que vous souhaitez supprimer.

  3. Cliquez sur à l'extrême droite de la ligne, puis confirmez la suppression dans la boîte de dialogue.

Lorsque vous supprimez un modèle d'URL personnalisé, tenez compte des éléments suivants:

  • Toutes les demandes futures sont mappées au prochain modèle d'URL personnalisé correspondant le plus spécifique . Si Firebase ne trouve aucun modèle d'URL personnalisé correspondant, il revient à la correspondance de modèle d'URL automatique .

  • Les correspondances et les données agrégées des demandes précédentes ne sont pas affectées par la suppression d'un modèle d'URL personnalisé.

    Vous pouvez toujours accéder à un modèle d'URL personnalisé supprimé et à ses données agrégées dans l'onglet Réseau > Tous jusqu'à la fin de la période de conservation des données applicable. Lorsque toutes les données agrégées sous le modèle d'URL personnalisé supprimé expirent, Firebase supprime le modèle d'URL personnalisé.

  • L'onglet Réseau > Personnalisé ne répertorie pas les modèles d'URL personnalisés supprimés.

Surveiller les traces de demande réseau dans la console

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

  2. Cliquez sur l'onglet Réseau , puis vous pouvez:

    • Consultez un rapport rapide des données collectées pour toutes vos demandes réseau.

    • Cliquez sur un point de terminaison spécifique pour examiner les données du point de terminaison 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 un point de terminaison spécifique, la console affiche une vue d'ensemble des données collectées sur les cartes métriques.

    • Utilisez les options en haut à droite du tableau de bord pour:

      • Affichez les différentes données sous forme agrégée , au fil du temps ou pour chaque version de votre application.
      • Affichez le taux de réussite d'un point de terminaison 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.

Prochaines étapes