Afficher, rechercher et filtrer les journaux de requêtes Web de votre site avec Cloud Logging

Vous pouvez associer votre projet Firebase à Cloud Logging pour afficher, rechercher et filtrer les journaux des requêtes Web pour chacun de vos sites Hosting. Ces journaux proviennent du CDN fourni automatiquement par Firebase. Chaque requête envoyée à votre site et les données de requête associées sont donc consignées.

Voici quelques exemples de ce que vous pouvez faire avec les journaux Cloud Logging. Consultez chaque section de cette page pour en savoir plus.

Si votre projet comporte plusieurs sites Hosting, vous pouvez sélectionner ceux pour lesquels vous souhaitez exporter les journaux.Hosting Vous pouvez ensuite filtrer et afficher les données de vos journaux par site Hosting, voire par domaine. En sélectionnant des sites Hosting spécifiques pour exporter les journaux, vous pouvez également contrôler la quantité de données traitées pour votre projet.

  1. Cliquez sur Associer dans la fiche d'intégration Cloud Logging de la console Firebase.

    Pour associer ou dissocier Cloud Logging, vous devez disposer des autorisations incluses dans l'un des rôles suivants : Propriétaire ou Éditeur du projet ou Administrateur Firebase Develop.

  2. Suivez les instructions à l'écran pour sélectionner les sites Hosting dont les journaux doivent être exportés vers Cloud Logging.

    Si vous avez déjà un ou plusieurs sites Hosting actifs, le workflow d'association affiche une estimation du niveau d'utilisation des données pour les journaux de chacun de vos sites Hosting. Cette valeur est estimée à partir des 30 derniers jours.

Une fois que vous avez associé Cloud Logging, les journaux de toutes les nouvelles demandes adressées à vos sites Hosting s'affichent généralement dans les 30 minutes suivant l'envoi de la demande.

Vous pouvez également dissocier Firebase Hosting de Cloud Logging, ce qui arrête l'exportation des journaux des requêtes Web vers Cloud Logging.

Surveiller votre consommation de données pour les journaux

Une fois que vous avez associé Cloud Logging, vous pouvez afficher le niveau d'utilisation des données pour les journaux de vos sites Hosting :

Mieux comprendre votre site

L'interface Logs Viewer de la console Google Cloud propose des outils permettant d'afficher vos journaux et données spécifiques à l'aide de requêtes, de filtres intégrés et de panneaux de données. Pour en savoir plus sur le filtrage de vos journaux avec des requêtes, consultez la section suivante.

  • D'où provient le trafic de votre site de manière précise ?
    Vous pouvez afficher des informations sur chaque demande, y compris l'adresse IP source, le referrer, la ville et l'état.

  • À quel moment les utilisateurs visitent-ils votre site ?
    Vous pouvez utiliser le panneau d'histogramme pour afficher la répartition par plages horaires spécifiques. Cela peut vous donner un aperçu des pics et des baisses habituels de l'utilisation de votre application, ainsi que révéler toute augmentation inattendue du trafic.

  • Quelle est la répartition des états pour les demandes des utilisateurs finaux ?
    Vous pouvez consulter l'état de chaque demande et même diagnostiquer celles qui génèrent des erreurs. Vous pouvez filtrer vos journaux par Critical, Error ou Warning.

  • Combien de temps faut-il à votre site pour répondre à une requête ?
    Vous pouvez consulter la latence de votre site pour chaque requête à l'aide de la valeur latency enregistrée dans chaque journal.

  • Votre site utilise-t-il la mise en cache de contenu ?
    Chaque journal contient un champ cacheHit qui indique si la ressource de votre site a été diffusée rapidement à partir du cache CDN de Hosting ou si elle a dû effectuer le trajet complet jusqu'au backend Hosting. Cela peut vous aider à améliorer les performances de votre site Web en exploitant au maximum le CDN mondial de Firebase. Par exemple, vous pouvez utiliser les données pour affiner les habitudes de mise en cache de vos assets statiques et de votre contenu dynamique.

  • Comment le trafic est-il réparti entre vos différents domaines ?
    Si vous avez plusieurs domaines ou sites Hosting, vous pouvez filtrer vos journaux par domaine ou par site. Cela vous permet de voir comment votre trafic est distribué. Lorsque vous filtrez par domaine, vous pouvez suivre le domaine le plus souvent visité.

Filtrer vos journaux avec des requêtes

Pour savoir comment filtrer vos journaux à l'aide de requêtes, consultez Exemples de requêtes avec la visionneuse de journaux et Créer des requêtes de journal. Le tableau ci-dessous décrit les champs disponibles pour ces requêtes.

Pour Hosting, voici quelques filtres initiaux pour une requête :

  • Ressource (resource.type) : firebase_domain (Firebase Hosting domaine du site)
  • Nom du journal (logName) : webrequests (Firebase Hosting)

Chaque entrée de journal possède une structure prédéfinie et des champs interrogeables (voir LogEntry). Pour Hosting, certains champs sont standards pour une requête HTTP, mais d'autres valeurs de champ proviennent du traitement que Hosting exécute sur chaque requête.

Champ Description
Firebase Hosting stocke les champs suivants dans l'objet httpRequest de l'entrée de journal.
Ces champs sont définis dans la spécification HTTP.
cacheHit Indique si le CDN Hosting disposait ou non de la ressource de la réponse dans le cache.
latency Durée de la requête, en secondes, avec le suffixe s (par exemple, 1.256s)
protocol Protocole utilisé pour la requête (par exemple, HTTP/1.1, HTTP/2, websocket)
referer Adresse de la page Web précédente à partir de laquelle un lien vers la page actuellement demandée a été suivi (le cas échéant)
remoteIp Adresse IP du client d'origine de la requête
requestMethod Méthode de requête (GET, POST, PUT, etc.)
requestSize Taille de la requête en octets
requestUrl URL complète de la requête (par exemple,
https://foo.web.app/bar ou https://custom.domain.com?query=param)
responseSize Taille de la réponse HTTP en octets
serverIp non renseigné
status État de la réponse HTTP (par exemple, 200 ou 404)
userAgent En-tête User-Agent de la requête
Firebase Hosting stocke des champs supplémentaires dans l'objet jsonPayload de l'entrée de journal.
acceptEncoding (à partir de la requête HTTP) Encodage du contenu, généralement un algorithme de compression, que le client accepte (par exemple, gzip ou compress)
billable Si votre projet a été facturé pour la demande
customDomain Indique si la requête a été envoyée à un domaine personnalisé.
hostname Nom d'hôte sur lequel la requête a été effectuée
remoteIpCountry Pays d'origine de la demande
remoteIpCity Ville d'origine de la demande

Utiliser des métriques basées sur les journaux

Vous pouvez afficher et créer des métriques basées sur les journaux, puis les utiliser dans Cloud Monitoring pour créer des graphiques et des règles d'alerte.

  • Exploitez les métriques système prédéfinies qui sont enregistrées automatiquement, comme le nombre d'événements de journalisation survenus au cours d'une période donnée.

  • Créez des métriques définies par l'utilisateur pour votre projet. Vous pouvez compter le nombre d'entrées de journal correspondant à une requête donnée ou effectuer le suivi de valeurs particulières dans les entrées de journal correspondantes. Vous pouvez filtrer les données à l'aide d'expressions régulières.

  • Utilisez Cloud Monitoring pour enregistrer le nombre d'entrées de journal contenant des messages particuliers ou extraire les informations de latence signalées dans les entrées de journal. Vous pouvez ensuite utiliser ces métriques dans des graphiques et des règles d'alerte.

Firebase Hosting génère également les métriques de journalisation spécifiques à Hosting suivantes. Ces métriques ne sont pas spécifiques à une entrée de journal, mais plutôt au site Hosting dans son ensemble.

  • log_bytes : nombre total d'octets de données utilisés pour chaque site

  • response_count : nombre total de réponses rédigées pour le site

    Cette métrique inclut le champ de l'état HTTP. Vous pouvez donc, par exemple, représenter graphiquement les réponses HTTP par état.

Exporter des journaux vers d'autres outils Google Cloud

Vous pouvez également exporter les journaux de votre site vers d'autres outils Google Cloud, comme Cloud Monitoring ou BigQuery, par exemple :

  • À l'aide de Cloud Monitoring, vous pouvez créer des métriques basées sur les journaux que vous pouvez utiliser dans des graphiques et des règles d'alerte.

  • Avec BigQuery, vous pouvez effectuer les opérations suivantes :

    • Utilisez Data Studio pour générer des tableaux de bord de vos données Hosting.
    • Exécutez des requêtes pour obtenir plus d'informations sur vos demandes (taille moyenne des réponses, hits et misses du cache, etc.).
    • Découvrez les URL que vos utilisateurs demandent réellement.
    • Combinez vos données Hosting avec d'autres données Firebase que vous avez exportées vers BigQuery, et interrogez-les de nouvelles façons.