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 des données de requête 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 forme de formats d'URL personnalisés et personnaliser le 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 à un modèle 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 des formats d'URL dérivée. 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 d'URL spécifiques 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 le 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 de formats d'URL personnalisés ?
Firebase tente de faire correspondre les URL de requête à 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 ne la met en correspondance qu'avec 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 envoyé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 format d'URL correspondant le plus spécifique, car le segment le plus à gauche (books) dans example.com/books/* prévaut sur le 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 globales des requêtes précédentes. Firebase ne ré-agrège pas rétroactivement 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 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 dans le tableau des traces, 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 au total 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. 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 à des URL.
- texte brut : correspond à une chaîne exacte
*: correspond au premier segment de sous-domaine ou à n'importe quelle chaîne d'un seul segment de chemin d'accès**: correspond à un suffixe de chemin d'accès 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é 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 modèle ne correspond pas à |
|
Un suffixe de chemin 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
|
|
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 le 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 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 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 se termine pour les données agrégées sous un format d'URL, Firebase les supprime 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 console Firebase. À la place, Firebase continue de lister des formats 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 format d'URL personnalisé
Vous pouvez supprimer des formats d'URL personnalisés de votre projet. Notez que vous ne pouvez pas supprimer un modèle 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 Modèles 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 tout à 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:
Toutes les requêtes futures sont mappées sur le modèle d'URL personnalisé le plus spécifique correspondant. Si Firebase ne trouve aucun format d'URL personnalisé correspondant, 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 globales des requêtes précédentes.
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é) 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 le supprime.
Le sous-onglet Requêtes réseau (avec Modèles 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 définissez.
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 réussies 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 compte automatiquement les requêtes réseau dont le code de réponse est compris entre 100 et 399 comme des réponses réussies.
Vous pouvez personnaliser le calcul du taux de réussite en comptabilisant certains codes d'erreur comme "réponses réussies" 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 considérer les réponses 404 comme "réussies", 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 correspondent à des réponses 200 et 40 à des réponses 404. Avant de configurer le taux de réussite, il est de 60%. Une fois que vous avez 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 des performances Firebase, Administrateur de qualité Firebase, Administrateur Firebase et Propriétaire ou éditeur du projet.
- Accédez à l'onglet Performance Monitoring Dashboard (Tableau de bord) de la console Firebase, puis sélectionnez l'application pour laquelle vous souhaitez configurer un calcul du taux de réussite.
- Faites défiler l'écran 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 codes de réponse réussis.