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 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.