Il logging e le metriche sono strumenti importanti per il debug e il monitoraggio del codice. App Hosting fornisce un accesso rapido per visualizzare i log e le metriche dei servizi Google Cloud alla base della tua app web:Cloud Run, Cloud Build e Cloud CDN.
Utilizzando la sintassi di logging standard, come console.log
di Node.js, puoi scrivere voci di log in Cloud Logging.
Visualizzare l'utilizzo nella console
Ogni backend ha una scheda Panoramica con un riepilogo del traffico (numero di richieste) e del tasso di errore della tua app negli ultimi sette giorni.
Ogni backend ha anche una scheda Utilizzo con diversi grafici sull'utilizzo per l'attività e l'utilizzo della tua app. I dati rappresentati includono richieste e larghezza di banda della CDN, utilizzo della CPU e della memoria di Cloud Run e altro ancora.
Nella console Google Cloud puoi trovare altre metriche sull'utilizzo per Cloud Run (ad esempio l'utilizzo della CPU e della memoria).
Visualizzare i log nella console
Dal menu contestuale della console Firebase (un menu con tre puntini in alto a destra) per un rollout, puoi accedere rapidamente ai dettagli e agli errori della revisione Cloud Run, nonché ai log di compilazione.
Questi log contengono informazioni utili per il debug dei deployment di App Hosting. Ad esempio, il log Cloud Run registra quando package.json
non viene trovato.
Il log di compilazione mostra l'output della compilazione, consentendoti di stabilire se si sono verificati errori nella configurazione del framework o nella configurazione di App Hosting. Vengono visualizzate anche le impostazioni di base di runConfig
e viene indicato quando le impostazioni mancano o quando apphosting.yaml
non esiste:
> next build
▲ Next.js 14.1.4
- Environments: .env
...
Route (app) Size First Load JS
┌ λ / 4.79 kB 214 kB
├ λ /_not-found 882 B 85.3 kB
└ λ /restaurant/[id] 5.28 kB 207 kB
+ First Load JS shared by all 84.4 kB
├ chunks/69-6678c81190a8fe82.js 29 kB
├ chunks/fd9d1056-51920e345d2966e8.js 53.4 kB
└ other shared chunks (total) 1.98 kB
Scrivere log in Cloud Logging
Se vuoi registrare eventi personalizzati, puoi scrivere in Cloud Logging da
Cloud Run, dove viene eseguito il codice visualizzato sul server. Utilizza le chiamate di logging JavaScript standard come console.log
e console.error
. Ad esempio, per scrivere una voce personalizzata dal codice per un handler delle route di Next.js, puoi procedere nel seguente modo:
- I comandi
console.log()
hanno il livello di log INFO. - I comandi
console.info()
hanno il livello di log INFO. - I comandi
console.warn()
hanno il livello di log ERRORE. - I comandi
console.error()
hanno il livello di log ERRORE. - I messaggi di sistema interni hanno il livello di log DEBUG.
Tieni presente che console.log
passa a Cloud Logging nel codice con rendering lato server per la tua app. Gli eventi relativi al rendering statico vengono inviati ai log Cloud Build, mentre quelli con rendering lato server vengono inviati ai log Cloud Run.
Visualizzare gli errori del server
Cloud Error Reporting consolida gli errori dell'istanza App Hosting Cloud Run. Se vuoi, puoi configurare Cloud Error Reporting in modo che ti invii una notifica quando si verificano nuovi errori.