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.
Visualizza 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 Cloud Build.
Questi log contengono informazioni utili per il debug dei deployment di App Hosting. Ad esempio, il log Cloud Run registra una nota quando package.json
non viene trovato.
Il log Cloud Build mostra l'output della build, in modo da valutare se gli errori si sono verificati nella configurazione nel 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 chiamate di logging JavaScript standard come console.log e console.error. Ad esempio, per scrivere una voce personalizzata dal codice per un handler di route 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 ERROR. - I comandi
console.error()hanno il livello di log ERROR. - 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 le metriche nella console
Dalla console Firebase, puoi accedere alle metriche sul traffico e sull'utilizzo per il servizio Cloud Run alla base della tua app web.
Nel menu contestuale della console Firebase (un menu con tre puntini in alto a destra) per l'implementazione in corso, seleziona Visualizza metriche Cloud Run. Potrai monitorare il numero di richieste che raggiungono il tuo servizio Cloud Run, compresa la suddivisione per codice di risposta per comprendere la percentuale di errori dell'app.
Troverai anche le metriche sulla latenza delle richieste e sull'utilizzo dei container (ad esempio l'utilizzo della CPU e della memoria) per comprendere le prestazioni e la scalabilità della tua app.
Visualizza errori del server
Cloud Error Reporting consolida gli errori dall'istanza App Hosting Cloud Run. Facoltativamente, puoi configurare Cloud Error Reporting per ricevere una notifica quando si verificano nuovi errori.