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, vous devez parfois personnaliser la façon dont Firebase agrège les données de requêtes réseau spécifiques pour mieux prendre en charge les cas d'utilisation de votre application. Nous vous proposons deux façons de personnaliser l'agrégation des données pour les requêtes réseau : agréger les données sous des formats d'URL personnalisés et personnaliser le calcul du taux de réussite.
Agréger les 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 à un 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 des formats d'URL spécifiques que Firebase ne capture pas avec sa mise en correspondance automatique dérivée des formats d'URL . Par exemple, vous pouvez utiliser un format d'URL personnalisé pour résoudre un problème lié à 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 données agrégées dans la sous-onglet Requêtes réseau du tableau des traces, qui se trouve en bas du tableau de bord Performances de la console Firebase.
Comment fonctionne la mise en correspondance des formats d'URL personnalisés ?
Firebase tente de faire correspondre les URL des requêtes à tous les formats d'URL personnalisés configurés avant de revenir à la mise en correspondance automatique des formats d'URL. Pour toutes les requêtes correspondant à un format d'URL personnalisé, Firebase agrège les données des requêtes sous le format d'URL personnalisé.
Si l'URL d'une requête correspond à plusieurs formats d'URL personnalisés, Firebase mappe la
requête uniquement sur le format d'URL personnalisé le plus spécifique, selon l'
ordre de spécificité suivant : texte brut > * > ** de gauche à
droite dans le chemin d'accès. Par exemple, une requête adressée à example.com/books/dog correspond à deux formats d'URL personnalisés :
example.com/books/*example.com/*/dog
Toutefois, le format
example.com/books/* est le plus spécifique format d'URL correspondant, car le
segment le plus à gauche books dans example.com/books/* est prioritaire par rapport au
segment le plus à gauche * dans example.com/*/dog.
Lorsque vous créez un format d'URL personnalisé, tenez compte des points suivants :
La création d'un format d'URL personnalisé n'a aucune incidence sur les correspondances et les données agrégées des requêtes précédentes. Firebase n'agrège pas les données des requêtes de manière rétroactive.
Seules les requêtes futures sont concernées par la création d'un format d'URL personnalisé. Vous devrez peut-être attendre jusqu'à 12 heures pour que Performance Monitoring collecte et agrège les 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é à partir du sous-onglet Requêtes réseau du tableau 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 afficher les formats d'URL personnalisés et leurs données agrégées.
Vous pouvez créer jusqu'à 400 formats d'URL personnalisés par application et jusqu'à 100 formats d'URL personnalisés par domaine pour cette application.
Pour créer un format d'URL personnalisé, commencez par un nom d'hôte, suivi de segments de chemin d'accès. Le nom d'hôte doit inclure un domaine valide et peut éventuellement inclure le sous-domaine. Utilisez la syntaxe de segment de chemin d'accès suivante pour créer un format pouvant correspondre aux URL.
- texte brut : correspond à une chaîne exacte
*: correspond au premier segment du sous-domaine ou à n'importe quelle chaîne dans un seul segment de chemin d'accès**: correspond à un suffixe de chemin d'accès arbitraire
Le tableau suivant décrit quelques mises en correspondance potentielles de formats d'URL personnalisés.
| Pour faire correspondre... | Créez un format d'URL personnalisé comme... | Exemples de correspondances avec ce format d'URL |
|---|---|---|
| Une URL exacte | example.com/foo/baz |
example.com/foo/baz
|
Un segment de chemin unique (*) |
example.com/*/baz |
example.com/foo/bazexample.com/bar/baz
|
example.com/*/*/baz |
example.com/foo/bar/bazexample.com/bah/qux/baz
|
|
example.com/foo/* |
example.com/foo/bazexample.com/foo/bar
Remarque : Ce format ne correspond pas à
|
|
Un suffixe de chemin d'accès arbitraire (**) |
example.com/foo/** |
example.com/fooexample.com/foo/bazexample.com/foo/baz/more/segments
|
subdomain.example.com/foo.bar/** |
subdomain.example.com/foo.barsubdomain.example.com/foo.bar/bazsubdomain.example.com/foo.bar/baz/more/segments
|
|
Le premier segment du sous-domaine (*) |
*.example.com/foo |
bar.example.com/foobaz.example.com/foo |
Afficher les formats d'URL personnalisés et leurs données
Firebase affiche tous les formats d'URL (y compris les formats d'URL personnalisés) et leurs données agrégées dans la sous-onglet Requêtes réseau du tableau des traces, qui se trouve en bas du tableau de bord Performances de la console Firebase.
Pour afficher uniquement les formats d'URL personnalisés, sélectionnez Formats personnalisés dans le menu déroulant du sous-onglet Requêtes réseau du tableau des traces. Notez que si un format d'URL personnalisé ne comporte aucune donnée agrégée, il n'apparaît que dans cette liste.
Lorsque la période de conservation des données agrégées sous un format d'URL arrive à expiration, Firebase supprime ces données du format d'URL. Si toutes les données agrégées sous un format d'URL personnalisé expirent, Firebase ne supprime pas le format d'URL personnalisé de la Firebase console. Au lieu de cela, Firebase continue de lister les formats d'URL personnalisés "vides" dans la liste Formats personnalisés du sous-onglet Requêtes réseau du tableau des traces.
Supprimer un format d'URL personnalisé
Vous pouvez supprimer des formats d'URL personnalisés de votre projet. Notez que vous ne pouvez pas supprimer un format d'URL automatique.
Dans le tableau de bord Performances , faites défiler la page jusqu'au tableau des traces, puis sélectionnez le sous-onglet Requêtes réseau.
Sélectionnez Formats personnalisés dans le menu déroulant du sous-onglet Requêtes réseau.
Pointez sur la ligne du format d'URL personnalisé que vous souhaitez supprimer.
Cliquez sur à l'extrême droite de la ligne, sélectionnez Supprimer le format 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 sur le format d'URL personnalisé correspondant le plus spécifique. Si Firebase ne trouve aucun format d'URL personnalisé correspondant, alors il revient à la mise en correspondance automatique des formats d'URL.
La suppression d'un format d'URL personnalisé n'a aucune incidence sur les correspondances et les données agrégées des requêtes précédentes.
Vous pouvez toujours accéder à un format 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é) jusqu'à la fin de la période de conservation des données applicable. Lorsque toutes les données agrégées sous le format d'URL personnalisé supprimé expirent, Firebase supprime le format d'URL personnalisé.
Le sous-onglet Requêtes réseau (avec Formats personnalisés sélectionné) ne liste aucun format d'URL personnalisé supprimé.
Étapes suivantes
- Configurez des alertes pour les requêtes 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 d'un format d'URL spécifique dépasse un seuil que vous avez défini.
Personnaliser le calcul du taux de réussite
L'une des métriques que Firebase surveille pour chaque requête réseau est 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 à mesurer les défaillances du réseau et du serveur.
Plus précisément, Firebase comptabilise automatiquement les requêtes réseau avec un code de réponse compris entre 100 et 399 comme des réponses positives.
Vous pouvez personnaliser le calcul du taux de réussite en comptabilisant certains codes d'erreur comme des "réponses positives" en plus des codes de réponse que Firebase comptabilise automatiquement comme des réussites.
Par exemple, si votre application dispose d'une API de point de terminaison de recherche, vous pouvez comptabiliser les réponses 404 comme des "réussites", car elles sont attendues pour un point de terminaison de recherche. Supposons qu'il y ait 100 échantillons pour ce point de terminaison de recherche chaque heure, dont 60 sont des réponses 200 et 40 des réponses 404. Avant de configurer le taux de réussite, il sera de 60%. Une fois que vous aurez configuré le calcul du taux de réussite pour comptabiliser les réponses 404 comme des réussites, 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 d'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 Firebase Performance,
administrateur Firebase Quality,
administrateur Firebase,
et propriétaire ou éditeur du projet.
- Accédez à l'onglet Performance Monitoring Tableau de bord dans la console Firebase, puis sélectionnez l'application pour laquelle vous souhaitez configurer un calcul du taux de réussite.
- Faites défiler la page jusqu'au tableau des traces en bas de l'écran, puis sélectionnez l'onglet Requêtes réseau.
- Recherchez le format d'URL pour lequel vous souhaitez configurer le calcul du taux de réussite.
- À l'extrême droite de la ligne, ouvrez le menu à développer () et sélectionnez Configurer le taux de réussite.
- Suivez les instructions à l'écran pour sélectionner les codes de réponse que vous souhaitez comptabiliser comme des codes de réponse positifs.