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 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, 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 indica quando le impostazioni non sono presenti 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 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 rimanda a Cloud Logging nel codice sottoposto a rendering dal server per la tua app. Gli eventi relativi al rendering statico vengono inviati a Cloud Build log, mentre il rendering del server viene inviato a Cloud Run log.

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 la latenza delle richieste e le metriche di utilizzo dei container (come utilizzo della CPU e utilizzo della memoria), per comprendere le prestazioni e la scalabilità della tua app.

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.