Créer des modèles d'URL personnalisés

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.

Pour chaque demande, vérifie si Firebase l'URL de la demande de 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ée pour surveiller les modèles d'URL spécifiques Firebase ne capture pas avec son dérivé correspondant de modèle d'URL automatique . 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.

Affiche Firebase tous les modèles d'URL (y compris les modèles d'URL personnalisées) et leurs données agrégées dans les demandes du réseau sous - onglet de la table des traces, qui se trouve au bas du tableau de bord de performance de la console Firebase.

Comment fonctionne la correspondance de modèle 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 requête correspondant à un modèle d'URL personnalisé, Firebase agrège les données des requêtes sous le modèle d'URL personnalisé.

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

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

Cependant, le modèle example.com/books/* est le plus modèle d'URL correspondant spécifique parce que les segments les plus à gauche des books dans example.com/books/* a priorité sur le segment de gauche * en example.com/*/dog .

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

  • Matches 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ée. Firebase ne regroupe 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ée. 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é de la demande du réseau sous - onglet dans le tableau des traces, qui se trouve au bas du tableau de bord de performance de la console Firebase.

Un membre du projet doit être un propriétaire ou de l' é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.

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 pouvant correspondre aux URL.

  • texte brut — correspond à une chaîne exacte
  • * - correspond au premier segment de sous - domaine, ou une chaîne dans un seul segment de chemin
  • ** - correspond à un suffixe de chemin arbitraire

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

Correspondre... Créez un modèle d'URL personnalisé comme... L'exemple correspond à ce modèle d'URL
Une URL exacte example.com/foo/baz example.com/foo/baz
Tout seul segment de chemin ( * ) 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

Note: 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

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

Affiche Firebase tous les modèles d'URL (y compris les modèles d'URL personnalisées) et leurs données agrégées dans les demandes du réseau sous - onglet de la table des traces, qui se trouve au bas du tableau de bord de performance de la console Firebase.

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

Lorsque la période de conservation des données extrémités pour les données agrégées sous un format d'URL, Firebase supprime ces données du modèle d'URL. Si toutes les données regroupées sous un modèle URL personnalisée expire, alors Firebase ne supprime pas le modèle d'URL personnalisé à partir de la console Firebase. Au lieu de cela, Firebase continue à la liste des modèles d'URL personnalisée « vide » dans la liste des modèles personnalisés des demandes réseau sous - onglet de la table 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. Depuis le tableau de bord de performance , faites défiler vers le bas à la table des traces, puis sélectionnez le sous - onglet Réseau demande.

  2. Sélectionnez les modèles personnalisés dans le menu déroulant dans les demandes du réseau sous - onglet.

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

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

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

  • Toute demande de futures sont mis en correspondance avec le prochain modèle d'URL la plus personnalisée correspondant spécifique. Si Firebase trouve pas de modèles d'URL personnalisés correspondant, il revient à l' appariement automatique de modèle d'URL .

  • Matches 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ée supprimé et ses données agrégées dans les demandes réseau sous - onglet (avec toutes les demandes de réseau sélectionnées) jusqu'à la fin de la période de conservation des données. 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 réseau demande sous - onglet (avec des motifs personnalisés sélectionnés) ne répertorie pas les modèles d'URL supprimés personnalisée.