Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Personnaliser l'agrégation des données des requêtes réseau

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Firebase Performance Monitoring regroupe automatiquement les données de requêtes réseau similaires pour vous aider à comprendre les tendances des performances de vos requêtes réseau.

Parfois, cependant, vous devez personnaliser la façon dont Firebase agrège des données de demande réseau spécifiques pour mieux prendre en charge les cas d'utilisation de votre application. Nous proposons deux manières de personnaliser l'agrégation des données pour les requêtes réseau : agréger les données sous des modèles d'URL personnalisés et personnaliser le mode de calcul du taux de réussite .

Agréger les données sous des modèles d'URL personnalisés

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.

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.

Firebase affiche tous les modèles d'URL (y compris les modèles d'URL personnalisés) et leurs données agrégées dans le sous-onglet Requêtes réseau du tableau des traces, qui se trouve en bas du tableau de bord des performances de la console Firebase.

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

Firebase tente de faire correspondre les URL de demande à tous les modèles d'URL personnalisés configurés avant de revenir à la correspondance automatique des modèles d'URL. Pour toute demande correspondant à un modèle d'URL personnalisé, Firebase agrège les données des demandes sous le modèle d'URL personnalisé.

Si l'URL d'une demande correspond à plusieurs modèles d'URL personnalisés, Firebase mappe la demande au modèle d'URL personnalisé le plus spécifique uniquement, selon l'ordre de spécificité suivant : texte brut > * > ** de gauche à droite dans le chemin . Par exemple, une requête adressée à example.com/books/dog correspond à deux formats 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 books le plus à gauche dans example.com/books/* a priorité sur le segment le plus à gauche * dans example.com/*/dog .

Lorsque vous créez un modèle d'URL personnalisé, 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 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 regroupe les données sous un nouveau modèle d'URL personnalisé.

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

Vous pouvez créer un modèle d'URL personnalisé à partir du sous-onglet Requêtes réseau dans le tableau des traces, qui se trouve en bas du tableau de bord Performances de la console Firebase.

Un membre du projet doit être un propriétaire ou un éditeur pour créer un nouveau modèle d'URL personnalisé ; cependant, tous les membres du projet peuvent afficher les modèles d'URL personnalisés et leurs données agrégées.

Vous pouvez créer jusqu'à 400 modèles d'URL personnalisés au total par application et jusqu'à 100 modèles d'URL personnalisés par domaine pour cette application.

Pour créer un modèle d'URL personnalisé, commencez par un nom d'hôte, suivi de segments de chemin. Le nom d'hôte doit inclure un domaine valide et peut éventuellement inclure le sous-domaine. Utilisez la syntaxe de segment de chemin suivante pour créer un modèle qui peut correspondre aux URL.

  • texte brut — correspond à une chaîne exacte
  • * — correspond au premier segment de sous-domaine ou à 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... Exemples de correspondances 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
Le premier segment de sous-domaine ( * ) *.example.com/foo bar.example.com/foo
baz.example.com/foo

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

Firebase affiche tous les modèles d'URL (y compris les modèles d'URL personnalisés) et leurs données agrégées dans le sous-onglet Requêtes réseau du tableau des traces, qui se trouve en bas du tableau de bord des performances de la console Firebase.

Pour afficher uniquement les modèles d'URL personnalisés, sélectionnez Modèles personnalisés dans le menu déroulant du sous-onglet Requêtes réseau du tableau des traces. Notez que si un modèle d'URL personnalisé n'a pas de données agrégées, il n'apparaît que dans cette liste.

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 la liste Modèles personnalisés du sous-onglet Requêtes réseau du tableau des traces.

Supprimer un modèle d'URL personnalisé

Vous pouvez supprimer des modèles d'URL personnalisés de votre projet. Notez que vous ne pouvez pas supprimer un modèle d'URL automatique.

  1. Dans le tableau de bord des performances , faites défiler jusqu'au tableau des traces, puis sélectionnez le sous-onglet Requêtes réseau.

  2. Sélectionnez Modèles personnalisés dans le menu déroulant du sous-onglet Requêtes réseau.

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

  4. Cliquez sur à l'extrême droite de la ligne, sélectionnez Supprimer le motif personnalisé , puis confirmez la suppression dans la boîte de dialogue.

Lorsque vous supprimez un format d'URL personnalisé, tenez compte des points suivants :

  • Toutes les requêtes futures sont mappées au modèle d'URL personnalisé correspondant le plus spécifique suivant . Si Firebase ne trouve aucun modèle d'URL personnalisé correspondant, il revient à la mise en correspondance automatique des modèles d'URL .

  • 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 le sous-onglet Requêtes réseau (avec Toutes les requêtes réseau sélectionnées) 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é.

  • Le sous-onglet Requêtes réseau (avec les modèles personnalisés sélectionnés) ne répertorie aucun modèle d'URL personnalisé supprimé.

Prochaines étapes

  • Configurez des alertes pour les demandes réseau qui dégradent les performances de votre application. Par exemple, vous pouvez configurer une alerte par e-mail pour votre équipe si le temps de réponse pour un modèle d'URL spécifique dépasse un seuil que vous avez défini.

Personnalisez le mode de calcul du taux de réussite

L'une des mesures que Firebase surveille pour chaque demande réseau est le taux de réussite de la demande. Le taux de réussite est le pourcentage de réponses réussies par rapport au nombre total de réponses. Cette métrique vous aide à mesurer les pannes de réseau et de serveur.

Plus précisément, Firebase compte automatiquement les requêtes réseau avec un code de réponse compris entre 100 et 399 comme des réponses réussies.

Vous pouvez personnaliser le calcul du taux de réussite en comptant certains codes d'erreur comme "réponses réussies" en plus des codes de réponse que Firebase compte automatiquement comme réussis.

Par exemple, si votre application dispose d'une API de point de terminaison de recherche, vous pouvez compter 404 réponses comme "réussies", car 404 réponses sont attendues pour un point de terminaison de recherche. Supposons qu'il y ait 100 échantillons pour ce point de terminaison de recherche toutes les heures, et que 60 d'entre eux soient des réponses à 200 et 40 des réponses à 404. Avant de configurer le taux de réussite, le taux de réussite sera de 60 %. Après avoir configuré le calcul du taux de réussite pour compter 404 réponses comme réussies, le taux de réussite sera de 100 %.

Configurer le calcul du taux de réussite

Pour configurer le calcul du taux de réussite pour un modèle d'URL réseau, vous devez disposer de l'autorisation firebaseperformance.config.update . Les rôles suivants incluent cette autorisation requise par défaut : Firebase Performance Admin , Firebase Quality Admin , Firebase Admin et Project Owner ou Editor .

  1. Accédez à l' onglet Tableau de bord de surveillance des performances dans la console Firebase, puis sélectionnez l'application pour laquelle vous souhaitez configurer un calcul du taux de réussite.
  2. Faites défiler jusqu'au tableau des traces en bas de l'écran et sélectionnez l'onglet Requêtes réseau .
  3. Recherchez le modèle d'URL pour lequel vous souhaitez configurer le calcul du taux de réussite.
  4. À l'extrême droite de la ligne, ouvrez le menu de dépassement ( ) et sélectionnez Configure success rate .
  5. Suivez les instructions à l'écran pour sélectionner les codes de réponse que vous souhaitez compter comme des codes de réponse réussie.