Affichez, recherchez et filtrez les journaux de requêtes Web de votre site avec Cloud Logging

Vous pouvez lier votre projet Firebase à Cloud Logging pour afficher, rechercher et filtrer vos journaux de requêtes Web pour chacun de vos sites d'hébergement. Ces journaux proviennent du CDN qui est automatiquement fourni par Firebase, de sorte que chaque demande adressée à votre site et les données de demande associées sont enregistrées.

Voici certaines choses que vous faites avec les journaux Cloud Logging. Visitez chaque section de cette page pour en savoir plus.

  • Mieux comprendre votre site - En savoir où et quand vous avez visites sur votre site, les statuts de réponse de votre site, le temps d' attente des demandes de l' utilisateur final, et plus encore.

  • Filtrez vos journaux avec des requêtes - Tirer parti des données collectées automatiquement aux données de filtrage et de terrain associés à chaque demande ou sur votre site.

  • Utiliser les mesures fondées sur les journaux - Créer des graphiques cloud surveillance et d' alerte des politiques de paramètres système prédéfinis ou des paramètres définis par l' utilisateur.

  • Exporter les journaux vers d' autres outils Google cloud - Utiliser les données dans d' autres outils (comme BigQuery et Data Studio) pour une analyse plus puissante et la corrélation.

Si vous avez plusieurs sites d'hébergement dans votre projet, vous pouvez sélectionner lequel de vos sites d'hébergement exportera les journaux. Vous pouvez ensuite filtrer et visualiser vos données de logs par site d'hébergement et même par domaine. En sélectionnant des sites d'hébergement spécifiques pour exporter les journaux, vous pouvez également contrôler la quantité de données traitées pour votre projet.

  1. Cliquez sur le lien dans la carte d'intégration Cloud Logging dans la console Firebase.

    Pour lier ou délier Cloud Logging, vous devez disposer des droits regroupés dans l' un des rôles suivants: projet du propriétaire ou de l' éditeur ou Firebase Développer Administrateur .

  2. Suivez les instructions à l'écran pour sélectionner lequel de vos sites d'hébergement doit exporter les journaux vers Cloud Logging.

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

Après la liaison à Cloud Logging, les journaux pour toute nouvelle demande à vos sites d' hébergement montreront habituellement dans les 30 minutes suivant la demande faite.

Vous pouvez également unlink Firebase Hébergement de cloud Logging, qui arrête les exportations de grumes de demande Web à Cloud Logging.

Surveillez votre utilisation des données pour les journaux

Après vous être connecté à Cloud Logging, vous pouvez afficher le niveau d'utilisation des données pour les journaux de vos sites d'hébergement :

Mieux comprendre votre site

L' interface de la visionneuse des journaux dans le Google Cloud Console offre des outils pour visualiser vos journaux spécifiques et des données en utilisant des requêtes et des filtres intégrés et panneaux de données. En savoir plus sur le filtrage de vos journaux avec des requêtes dans la section suivante ci-dessous.

  • D'où provient le trafic de votre site à un niveau granulaire ?
    Vous pouvez afficher des informations sur chaque demande, y compris l'adresse IP source, le référent, la ville et le statut.

  • Quand les utilisateurs visitent-ils votre site ?
    Vous pouvez utiliser le panneau Histogramme pour voir la répartition par plages horaires spécifiques. Cela peut vous donner un aperçu des pics et des creux normaux de l'utilisation de votre application, ainsi que révéler tout pic de trafic inattendu.

  • Quelle est la distribution de l'état des demandes des utilisateurs finaux ?
    Vous pouvez afficher l'état de chaque demande et même diagnostiquer les demandes qui reçoivent des erreurs. Vous pouvez filtrer vos journaux par Critical , Error ou Warning .

  • Combien de temps votre site met-il pour répondre à une requête ?
    Vous pouvez voir la latence de votre site pour chaque demande en utilisant le latency d' latency valeur capturée dans chaque journal.

  • Votre site tire-t-il parti de la mise en cache de contenu ?
    Chaque journal contient un cacheHit champ pour vous dire si a servi de ressource de votre site rapidement à partir du cache CDN d' hébergement, ou si elle devait faire le plein voyage au back - end d' hébergement. Cela peut vous aider à améliorer les performances de votre site Web en tirant le meilleur parti du CDN mondial de Firebase. Par exemple, vous pouvez utiliser les données pour affiner les habitudes de mise en cache de vos actifs statiques et des contenus dynamiques .

  • Quelle est la répartition du trafic vers vos différents domaines ?
    Si vous avez plusieurs domaines ou sites d'hébergement, 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 savoir quel domaine est le plus visité.

Filtrez vos journaux avec des requêtes

Pour en savoir plus sur la façon de filtrer vos journaux avec des requêtes, rendez - vous des exemples de requêtes à l' aide de journaux Viewer et requêtes de journal du bâtiment . Le tableau ci-dessous décrit les champs disponibles pour ces requêtes.

Pour l'hébergement, voici quelques filtres initiaux pour une requête :

  • Ressources ( resource.type ) - firebase_domain (Firebase Hébergement de domaine du site)
  • Nom du journal ( logName ) - webrequests (Firebase Hébergement)

Chaque entrée de journal a une structure prédéfinie et champs interrogeables (voir logentry ). Pour l'hébergement, certains champs sont standard pour une requête HTTP, mais il existe d'autres valeurs de champ qui proviennent du traitement que l'hébergement exécute sur chaque requête.

Domaine La description
Firebase Hébergement stocke les champs suivants dans l' httpRequest objet de l'entrée du journal.
Ces champs sont définis dans la spécification HTTP.
cacheHit Si oui ou non le CDN d'hébergement avait la ressource de la réponse en cache
latency La durée de la demande, en quelques secondes avec s Postfix (par exemple, 1.256s )
protocol Le protocole utilisé pour la demande (par exemple, HTTP/1.1 , HTTP/2 , websocket )
referer L'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 L'adresse IP du client d'origine pour la demande
requestMethod La méthode de requête ( GET , POST , PUT , etc.)
requestSize La taille de la requête en octets
requestUrl L'URL complète de la demande (par exemple,
https://foo.web.app/bar ou https://custom.domain.com?query=param )
responseSize La taille de la réponse HTTP en octets
serverIp pas peuplée
status L'état de la réponse HTTP (par exemple, 200 ou 404 )
userAgent L'en-tête user-Agent de la requête
Firebase magasins d' hébergement des champs supplémentaires dans le jsonPayload objet de l'entrée du journal.
acceptEncoding ( à partir de la requête HTTP) Quels codage de contenu, généralement un algorithme de compression, les supports du client (par exemple, gzip ou compress )
billable Si votre projet a été facturé ou non pour la demande
customDomain Si la demande a été effectuée ou non sur un domaine personnalisé
hostname Le nom d'hôte sur lequel la demande a été effectuée
remoteIpCountry Le pays d'origine de la demande
remoteIpCity La ville d'origine de la demande

Utiliser des métriques basées sur les journaux

Vous pouvez visualiser et construire des mesures basées sur les journaux , utilisez ces paramètres du Cloud pour créer des graphiques de suivi et d' alerte des politiques.

  • L' effet de levier des métriques de système prédéfinies qui sont enregistrés automatiquement, par exemple le nombre d'événements qui se sont produits journalisation dans une période de temps spécifique.

  • Créer des paramètres définis par l' utilisateur pour votre projet. Vous pouvez compter le nombre d'entrées de journal correspondant à une requête donnée ou suivre des valeurs particulières avec les entrées de journal correspondantes. Vous pouvez filtrer à l'aide d'expressions régulières.

  • Utilisez Nuage de surveillance pour enregistrer le nombre d'entrées du journal contenant des messages ou des informations particulières de latence d'extrait rapportées dans les entrées du 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 à l'hébergement suivantes. Ces mesures ne sont pas spécifiques à une entrée de journal mais plutôt au site d'hébergement spécifique dans son ensemble.

  • log_bytes : Nombre total d' octets d'utilisation des données pour chaque site

  • response_count : Nombre total de réponses écrites pour le site

    Cette métrique inclut le champ de statut HTTP, vous pouvez donc tracer les réponses HTTP par statut (à titre d'exemple).

Exporter des journaux vers d'autres outils Google Cloud

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

  • En utilisant Cloud Monitoring , vous pouvez créer des paramètres basée sur le journal que vous pouvez utiliser dans les graphiques et les politiques d' alerte.

  • En utilisant BigQuery , vous pouvez faire un des éléments suivants:

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