Visualizzazione dei log e delle metriche

I log 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 Google Cloud servizi 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 (numero di richieste) e della percentuale di errori dell'app negli ultimi sette giorni.

La scheda Log di un backend consente di visualizzare e filtrare i "Log di build" (da Cloud Build) e i "Log di runtime" (da Cloud Run e Cloud CDN).

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

Puoi trovare altre metriche di utilizzo per Cloud Run (ad esempio 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 ai dettagli e agli errori della revisione Cloud Run nonché ai log di build.

Questi log contengono informazioni utili per il debug dei tuoi App Hosting deployment. Ad esempio, il Cloud Run log indica 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 App Hosting configurazione. Mostra anche le impostazioni di base di runConfig e indica quando mancano le 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

Scrivere log in Cloud Logging

Se vuoi registrare eventi personalizzati, puoi scrivere in 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, 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 viene inviato a Cloud Logging nel codice sottoposto a rendering lato server per la tua app. Gli eventi relativi al rendering statico vengono inviati a Cloud Build log, mentre il rendering lato server viene inviato a Cloud Run log.

Visualizzare gli errori del server

Cloud Error Reporting consolida gli errori dell'istanza App Hosting Cloud Run. Facoltativamente, puoi configurare Cloud Error Reporting in modo che ti invii una notifica quando si verificano nuovi errori.