Visualizza, cerca e filtra i log delle richieste web del tuo sito con Cloud Logging

Puoi collegare il tuo progetto Firebase a Cloud Logging per visualizzare, cercare e filtrare i log delle richieste web per ciascuno dei tuoi siti Cloud Logging. Questi log dalla rete CDN fornita automaticamente da Firebase, in modo che ogni richiesta vengono registrati i dati del sito e i dati della richiesta associati.

Ecco alcune cose che puoi fare con i log di Cloud Logging. Visita ogni sezione di questa pagina per scoprire i dettagli.

Se nel progetto sono presenti più siti Hosting, puoi selezionare quale di i tuoi siti Hosting esporteranno i log. Puoi quindi filtrare e visualizzare i log i dati per sito Hosting e persino per dominio. Se selezioni siti Hosting specifici per esportare i log, puoi anche controllare la quantità di dati elaborati per il tuo progetto.

  1. Fai clic su Collega nella Cloud Logging. scheda di integrazione nella console Firebase.

    Per collegare o scollegare Cloud Logging, devi disporre delle autorizzazioni raggruppate in uno dei seguenti ruoli: Proprietario o Editor del progetto o Amministratore di Firebase Develop.

  2. Segui le istruzioni sullo schermo per selezionare i siti di Hosting deve esportare i log in Cloud Logging.

    Se hai già uno o più siti Hosting attivi, il collegamento visualizza un livello di utilizzo dei dati stimato per i log di ciascuno Hosting siti. Questo valore è una stima degli ultimi 30 giorni.

Dopo il collegamento a Cloud Logging, registra eventuali nuove richieste al tuo In genere Hosting siti vengono visualizzati entro 30 minuti dall'invio della richiesta in cui viene eseguito il deployment.

Puoi anche scollega Firebase Hosting da Cloud Logging, che interrompe le esportazioni dei log delle richieste web in Cloud Logging.

Monitora l'utilizzo dei dati per i log

Dopo aver eseguito il collegamento a Cloud Logging, puoi visualizzare il livello di utilizzo dei dati per i log dai tuoi siti Hosting:

Comprendi meglio il tuo sito

La Interfaccia di Logs Viewer nella console Google Cloud offre strumenti per visualizzare log e dati specifici utilizzando query, filtri integrati e riquadri di dati. Scopri di più sui filtri i log con le query nella sezione successiva di seguito.

  • Da dove proviene il traffico del tuo sito a un livello dettagliato?
    Puoi visualizzare le informazioni su ogni richiesta, tra cui IP di origine, referrer città e stato.

  • Quando gli utenti visitano il tuo sito?
    Puoi utilizzare lo Riquadro dell'istogramma per vedere la distribuzione in base a intervalli di tempo specifici. Questo può fornirti informazioni ai normali picchi e cali di utilizzo dell'app, oltre a rivelare eventuali di picchi imprevisti di traffico.

  • Qual è la distribuzione dello stato per le richieste degli utenti finali?
    Puoi visualizzare lo stato di ogni richiesta e persino diagnosticare le richieste che ricevere errori. Puoi filtrare i log per Critical, Error o Warning.

  • Quanto tempo impiega il tuo sito per rispondere a una richiesta?
    Puoi visualizzare la latenza del tuo sito per ogni richiesta utilizzando lo latency acquisito in ogni log.

  • Il tuo sito sta sfruttando la memorizzazione nella cache dei contenuti?
    Ogni log contiene un campo cacheHit per indicare se la risorsa del sito è rapidamente dalla cache CDN di Hosting o se ha dovuto al backend Hosting. Questo può aiutarti a migliorare il rendimento del tuo sito web, sfruttando al massimo la rete CDN globale di Firebase. Ad esempio, puoi utilizzare i dati per perfezionare le abitudini di memorizzazione nella cache asset statici e contenuti dinamici.

  • Qual è la distribuzione del traffico verso i tuoi vari domini?
    Se hai più domini o Hosting siti, puoi filtrare i log per dominio o per sito. In questo modo puoi vedere com'è il tuo traffico, distribuiti in tempo reale. Quando filtri per dominio, puoi monitorare a quale dominio visitati più spesso.

Filtra i log con le query

Per scoprire come filtrare i log con le query, visita Esempi di query con il visualizzatore log e Creazione di query sui log. La tabella seguente descrive i campi disponibili per queste query.

Per Hosting, ecco alcuni filtri iniziali per una query:

  • Risorsa (resource.type) - firebase_domain (Dominio del sito Firebase Hosting)
  • Nome log (logName) - webrequests (Firebase Hosting)

Ogni voce di log ha una struttura predefinita e campi interrogabili (vedi LogEntry). Per Hosting, alcuni campi sono standard di una richiesta HTTP, ma altri valori di campo derivanti dall'elaborazione che Hosting esegue richiesta.

Campo Descrizione
Firebase Hosting archivia i seguenti campi nella Oggetto httpRequest del log .
Questi campi sono definiti nella specifica HTTP.
cacheHit Se la CDN Hosting aveva o meno la risorsa della risposta memorizzata nella cache
latency La durata della richiesta, in secondi con un postfisso s (per esempio, 1.256s)
protocol Il protocollo utilizzato per la richiesta (ad esempio, HTTP/1.1, HTTP/2, websocket)
referer L'indirizzo della pagina web precedente da cui è presente un link alla è stata seguita la pagina attualmente richiesta (se presente)
remoteIp L'indirizzo IP del client di origine per la richiesta
requestMethod Il metodo di richiesta (GET, POST, PUT e così via)
requestSize Le dimensioni della richiesta in byte
requestUrl L'URL completo della richiesta (ad esempio,
https://foo.web.app/bar o https://custom.domain.com?query=param)
responseSize Le dimensioni della risposta HTTP in byte
serverIp non compilato
status Lo stato della risposta HTTP (ad esempio, 200 o 404)
userAgent L'intestazione dello user agent della richiesta
Firebase Hosting archivia altri campi nella jsonPayload dell'oggetto voce di log.
acceptEncoding (dalla richiesta HTTP) La codifica dei contenuti, di solito una di compressione, il client supporta (ad esempio, gzip o compress)
billable Se la richiesta è stata fatturata o meno al progetto
customDomain Indica se la richiesta è stata effettuata o meno in base a un dominio personalizzato
hostname Il nome host per il quale è stata effettuata la richiesta
remoteIpCountry Il paese di origine della richiesta
remoteIpCity La città di origine della richiesta

Utilizzo delle metriche basate su log

Puoi visualizzare e creare metriche basate su log, poi utilizzarle in Cloud Monitoring per creare grafici e criteri di avviso.

  • Leva metriche di sistema predefinite che vengono registrati automaticamente, ad esempio il numero di eventi di logging che che si sono verificate in un determinato periodo di tempo.

  • Crea metriche definite dall'utente per il tuo progetto. Puoi contare il numero di voci di log corrispondenti o tenere traccia di determinati valori con le voci di log corrispondenti. Tu possono filtrare utilizzando le espressioni regolari.

  • Utilizza Cloud Monitoring per registrare il numero di voci di log contenenti messaggi specifici o estrarre le informazioni sulla latenza riportate nelle voci di log. Puoi quindi utilizzare queste metriche grafici e criteri di avviso.

Firebase Hosting genera anche le seguenti metriche di logging specifiche per Hosting. Queste metriche non sono specifiche per una voce di log, ma per il sito Hosting specifico nel suo complesso.

  • log_bytes: byte totali di utilizzo dei dati per ogni sito

  • response_count: numero totale di risposte scritte per il sito

    Questa metrica include il campo dello stato HTTP, quindi puoi tracciare le risposte HTTP in base allo stato (ad esempio).

Esportare i log in altri strumenti Google Cloud

Puoi anche esportare i log del tuo sito in altri strumenti Google Cloud, come Cloud Monitoring o BigQuery, ad esempio:

  • Con Cloud Monitoring, puoi creare metriche basate su log da usare in grafici e avvisi criteri.

  • Con BigQuery puoi eseguire una delle seguenti operazioni:

    • Utilizza Data Studio per generare dashboard dei tuoi dati Hosting.
    • Esegui query per ottenere ulteriori informazioni sulle tue richieste (dimensioni medie della risposta, colpi in cache e mancate corrispondenze e così via).
    • Scopri quali URL vengono effettivamente richiesti dagli utenti.
    • Combina i tuoi dati di Hosting con altri dati Firebase in cui hai esportato BigQuery per eseguire query in nuovi modi.