Visualizzazione dei log e delle metriche

Il logging e le metriche sono strumenti importanti per il debug e il monitoraggio del codice. App Hosting fornisce un accesso rapido per visualizzare log e metriche per i servizi Google Cloud che alimentano la 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 della tua app (conteggio delle richieste) e del tasso di errore negli ultimi sette giorni.

Ogni backend ha anche una scheda Utilizzo con diversi grafici di utilizzo per l'attività e l'utilizzo della tua app. I dati rappresentati includono la larghezza di banda e le richieste della CDN, l'utilizzo di CPU e memoria di Cloud Run e altro ancora.

Puoi trovare altre metriche sull'utilizzo per Cloud Run (come l'utilizzo della CPU e della memoria) nella console Google Cloud.

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 per visualizzare i dettagli e gli errori della revisione Cloud Run, nonché i log di build.

Questi log contengono informazioni utili per il debug dei deployment di App Hosting. Ad esempio, il log Cloud Run annota quando package.json non viene trovato.

Il log di build mostra l'output della build, consentendoti di stabilire se si sono verificati errori nella configurazione del framework o nella configurazione di App Hosting. Mostra anche le impostazioni di base di runConfig e indica quando mancano impostazioni 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

Scrivi log in Cloud Logging

Se vuoi registrare eventi personalizzati, puoi scrivere a Cloud Logging da Cloud Run, dove viene eseguito il codice sottoposto a rendering lato server. Utilizza chiamate di logging JavaScript standard come console.log e console.error. Ad esempio, per scrivere una voce personalizzata dal codice per un gestore di route Next.js, fai qualcosa di simile:

  • 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 viene trasferito a Cloud Logging nel codice renderizzato lato server per la tua app. Gli eventi correlati al rendering statico vengono inviati ai log Cloud Build, mentre quelli relativi al 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.