La journalisation et les métriques sont des outils importants pour déboguer et surveiller le code. App Hosting permet d'accéder rapidement aux journaux et aux métriques des services Google Cloud qui alimentent votre application Web : Cloud Run, Cloud Build et Cloud CDN.
En utilisant la syntaxe de journalisation standard, comme console.log de Node.js, vous pouvez écrire des entrées de journal dans Cloud Logging.
Afficher l'utilisation dans la console
Chaque backend comporte un onglet Présentation, qui récapitule le trafic (nombre de requêtes) et le taux d'erreur de votre application au cours des sept derniers jours.
Chaque backend dispose également d'un onglet Utilisation avec plusieurs graphiques d'utilisation pour l'activité et l'utilisation de votre application. Les données représentées incluent la bande passante et les requêtes du CDN, l'utilisation du processeur et de la mémoire Cloud Run, et plus encore.
Vous trouverez d'autres métriques d'utilisation pour Cloud Run (comme l'utilisation du processeur et de la mémoire) dans la console Google Cloud.
Afficher les journaux dans la console
Dans le menu contextuel de la console Firebase (menu à trois points en haut à droite) d'un déploiement, vous pouvez accéder rapidement aux détails et aux erreurs de la révision Cloud Run, ainsi qu'aux journaux de compilation.
Ces journaux contiennent des informations utiles pour déboguer vos déploiements App Hosting. Par exemple, le journal Cloud Run indique quand package.json est introuvable.
Le journal de compilation affiche le résultat de votre compilation, ce qui vous permet de déterminer si des erreurs se sont produites dans la configuration de votre framework ou dans la configuration App Hosting. Il affiche également vos paramètres runConfig de base et indique quand des paramètres sont manquants ou quand apphosting.yaml n'existe pas :
> 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
Écrire des journaux dans Cloud Logging
Si vous souhaitez enregistrer des événements personnalisés, vous pouvez écrire dans Cloud Logging à partir de Cloud Run, où s'exécute votre code rendu côté serveur. Utilisez des appels de journalisation JavaScript standards tels que console.log et console.error. Par exemple, pour écrire une entrée personnalisée à partir du code d'un gestionnaire de route Next.js, vous devez procéder comme suit :
- Les commandes
console.log()ont le niveau de journalisation INFO. - Les commandes
console.info()ont le niveau de journalisation INFO. - Les commandes
console.warn()ont le niveau de journalisation ERROR. - Les commandes
console.error()ont le niveau de journalisation ERROR. - Les messages système internes ont le niveau de journalisation DEBUG.
Notez que console.log est transmis à Cloud Logging dans le code rendu côté serveur de votre application. Les événements liés au rendu statique sont envoyés aux journaux Cloud Build, tandis que ceux liés au rendu côté serveur sont envoyés aux journaux Cloud Run.
Afficher les erreurs de serveur
Cloud Error Reporting consolide les erreurs de votre instance App Hosting Cloud Run. Vous pouvez éventuellement configurer Cloud Error Reporting pour recevoir des notifications lorsque de nouvelles erreurs se produisent.