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

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

Toutefois, il est parfois nécessaire de personnaliser la façon dont Firebase regroupe des les données de requête réseau pour mieux répondre aux cas d'utilisation de votre application. Nous proposons deux méthodes personnaliser l'agrégation des données pour les requêtes réseau: agrégez les données sous formats d'URL personnalisés personnaliser le mode de calcul du taux de réussite.

Agréger des données sous des formats d'URL personnalisés

Pour chaque requête, Firebase vérifie si l'URL de la requête réseau correspond à Format d'URL : Si l'URL de la requête correspond à un format d'URL, Firebase agrège automatiquement les données de la requête sous le format d'URL.

Vous pouvez créer des formats d'URL personnalisés pour surveiller les formats d'URL spécifiques Firebase n'effectue pas de capture avec son format d'URL automatique dérivé correspondantes. Par exemple, vous pouvez utiliser un format d'URL personnalisé pour résoudre les problèmes liés à une URL spécifique ou pour surveiller un ensemble spécifique d'URL au fil du temps.

Firebase affiche tous les formats d'URL (y compris les formats d'URL personnalisés) et leurs les données globales dans le sous-onglet Demandes réseau du tableau des traces, soit au bas de la section Tableau de bord Performances de la console Firebase.

Comment fonctionne la mise en correspondance de formats d'URL personnalisés ?

Firebase tente de faire correspondre les URL de demande aux formats d'URL personnalisés configurés. avant de revenir à la mise en correspondance automatique des formats d'URL. Pour toute demande avec mise en correspondance à un format d'URL personnalisé, Firebase regroupe les requêtes sous le nom Format d'URL.

Si l'URL d'une requête correspond à plusieurs formats d'URL personnalisés, Firebase mappe vers le format d'URL personnalisée le plus spécifique uniquement, conformément au ordre de spécificité suivant: texte brut > * > ** de gauche à sur la voie du succès. Par exemple, une requête envoyée à example.com/books/dog correspond aux correspondances deux formats d'URL personnalisées:

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

Cependant, le modèle example.com/books/* est le format d'URL de correspondance le plus spécifique, car le le segment le plus à gauche books dans example.com/books/* est prioritaire sur le segment segment le plus à gauche * de la zone example.com/*/dog.

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

• Les correspondances et les données globales des requêtes précédentes ne sont pas affectées par en créant un format d'URL personnalisé. Firebase n'applique pas les règles pour réagréger les données de requête.

• Seuls les requêtes futures sont concernées par la création d'un format d'URL personnalisé. Vous devrez peut-être patienter jusqu'à 12 heures, le temps que Performance Monitoring collecte et agréger des données sous un nouveau format d'URL personnalisé.

Créer un format d'URL personnalisé

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

Un membre du projet doit être propriétaire ou éditeur pour créer un format d'URL personnalisé ; Toutefois, tous les membres du projet peuvent voir les formats d'URL et leurs données globales.

Vous pouvez créer jusqu'à 400 formats d'URL personnalisée au total par application et jusqu'à 100 formats d'URL personnalisée par pour cette application.

Pour créer un format d'URL personnalisé, commencez par un nom d'hôte, suivi d'un chemin d'accès. segments. 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 à des URL.

• texte brut : correspond à une chaîne exacte
• * : correspond au premier segment de sous-domaine ou à n'importe quelle chaîne d'un segment de chemin unique
• ** : correspond à un suffixe de chemin arbitraire

Le tableau suivant décrit quelques exemples de correspondances de formats d'URL personnalisés.

Pour faire correspondre…	Créez un format d'URL personnalisé tel que...	L'exemple correspond à ce format d'URL
Une URL exacte	example.com/foo/baz	example.com/foo/baz
N'importe quel segment de chemin d'accès 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 correspond 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

Remarque : Pour les modèles d'URL personnalisés, Firebase n'est pas compatible avec la syntaxe de *.file-extension, comme *.png ou *.css.

Afficher les formats d'URL personnalisées et leurs données

Firebase affiche tous les formats d'URL (y compris les formats d'URL personnalisés) et leurs les données globales dans le sous-onglet Demandes réseau du tableau des traces, soit au bas de la section Tableau de bord Performances de la console Firebase.

Pour afficher uniquement les formats d'URL personnalisées, sélectionnez Formats personnalisés dans le menu déroulant du sous-onglet Requêtes réseau du tableau des traces. Notez que si une URL personnalisée Le format d'URL ne contient pas de données globales : il n'apparaît que dans cette liste.

Lorsque la durée de conservation des données pour les données agrégées dans un format d'URL, Firebase supprime ces données du format d'URL. Si toutes les données sont regroupées sous un format d'URL personnalisé expire, cela signifie que Firebase ne supprime pas le format d'URL personnalisé Console Firebase. Au lieu de cela, Firebase continue d'afficher "vide" URL personnalisée formats dans la liste Formats personnalisés du sous-onglet Requêtes réseau de la table des traces.

Supprimer un format d'URL personnalisé

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

1. Dans l'onglet Performances tableau de bord, Faites défiler la page jusqu'au tableau des traces, puis sélectionnez le sous-onglet Requêtes réseau.

2. Sélectionnez Formats personnalisés dans le menu déroulant de la section Requêtes réseau. sous-onglet.

3. Pointez sur la ligne du format d'URL personnalisée que vous souhaitez supprimer.

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

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

• Les requêtes futures sont mappées sur la prochaine requête la plus spécifique. le format d'URL personnalisé. Si Firebase ne trouve aucun format d'URL personnalisé correspondant, il revient à la mise en correspondance automatique des formats d'URL.

• Les correspondances et les données globales des requêtes précédentes ne sont pas affectées. en supprimant un format d'URL personnalisé.

  Vous pouvez toujours accéder à un format d'URL personnalisée supprimé et à ses données agrégées Données du sous-onglet Demandes réseau (avec l'option Toutes les requêtes réseau sélectionnée) jusqu'à la fin de la période de conservation des données applicable. Lorsque toutes les les données globales du format d'URL personnalisée supprimé expirent, Firebase supprime le format d'URL personnalisé.

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

Étapes suivantes

• Configurer des alertes pour les requêtes réseau qui se 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 format d'URL spécifique dépasse que vous avez défini.

Personnaliser le mode de calcul du taux de réussite

L'une des métriques surveillées par Firebase pour chaque requête réseau est la le taux de réussite de la requête. Le taux de réussite correspond au pourcentage de réponses positives par rapport au nombre total de réponses. Cette métrique vous aide à évaluer les performances d'échecs.

Plus précisément, Firebase comptabilise automatiquement les requêtes réseau avec une réponse compris entre 100 et 399 comme réponses positives.

Vous pouvez personnaliser le calcul du taux de réussite en comptant certains codes d'erreur comme des "réponses positives" en plus des codes de réponse que Firebase est automatiquement considérée comme réussie.

Par exemple, si votre application dispose d'une API Search Endpoint, vous pouvez compter les réponses 404. comme "réussie" car des réponses 404 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 200 réponses et 40 d'entre elles sont des réponses 404. Avant de configurer le taux de réussite, il est de 60 %. Après avoir configuré l'authentification du calcul du taux de réussite pour comptabiliser les réponses 404 comme réussies, le taux de réussite sera 100%.

Remarque :Les nouvelles configurations du taux de réussite ne s'appliquent qu'aux données collectées après le configuration est créée.

Configurer le calcul du taux de réussite

Pour configurer le calcul du taux de réussite pour un format d'URL réseau, vous devez : disposer de l'autorisation firebaseperformance.config.update. Les rôles suivants incluent cette autorisation requise par défaut : Administrateur des performances Firebase, Administrateur de qualité Firebase, Administrateur Firebase et Propriétaire ou éditeur du projet.

1. Accédez au tableau de bord Performance Monitoring. Tabulation 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 la page jusqu'au tableau des traces en bas de l'écran, puis sélectionnez l'icône Onglet Requêtes réseau.
3. Recherchez le format d'URL pour lequel vous souhaitez configurer le taux de réussite. calcul.
4. À droite de la ligne, ouvrez le menu à développer (), puis sélectionnez Configuration réussie. débit.
5. Suivez les instructions à l'écran pour sélectionner les codes de réponse que vous souhaitez sont comptés comme des codes de réponse réussies.

Remarque : Vous pouvez configurer le taux de réussite pour les formats d'URL automatiques et personnalisés. Nous vous recommandons de ne configurer le taux de réussite que pour les formats d'URL personnalisées car les formats d'URL automatiques peuvent évoluer au fil du temps, en fonction de l'évolution de vos données.