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.
À l'aide d'une syntaxe de journalisation standard, comme console.log de Node.js, vous pouvez écrire des entrées de journal dans Cloud Logging.
Afficher les journaux dans la console
Dans le menu contextuel de la console Firebase (un menu à trois points en haut à droite) pour un déploiement, vous pouvez accéder rapidement aux détails et aux erreurs de la révision Cloud Run, ainsi qu'aux journaux Cloud Build.
Ces journaux contiennent des informations utiles pour déboguer vos déploiements App Hosting. Par exemple, les notes de journal Cloud Run lorsque package.json est introuvable.
Le journal Cloud Build affiche le résultat de la compilation, ce qui vous permet de déterminer si des erreurs se sont produites dans la configuration de votre framework ou de 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 consigner des événements personnalisés, vous pouvez écrire dans Cloud Logging à partir de Cloud Run, où votre code rendu par le serveur s'exécute. 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, procédez 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 (ERREUR). - 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 par le serveur de votre application. Les événements liés au rendu statique sont envoyés aux journaux Cloud Build, tandis que le rendu par le serveur est envoyé aux journaux Cloud Run.
Afficher les métriques dans la console
À partir de la console Firebase, vous pouvez accéder aux métriques de trafic et d'utilisation du service Cloud Run qui alimente votre application Web.
Dans le menu contextuel de la console Firebase (menu à trois points en haut à droite) pour le déploiement en cours, sélectionnez Afficher les métriques Cloud Run. Vous pourrez surveiller le nombre de requêtes qui atteignent votre service Cloud Run, y compris la répartition par code de réponse pour comprendre le taux d'erreur de votre application.
Vous trouverez également des métriques sur la latence des requêtes et l'utilisation des conteneurs (telles que l'utilisation du processeur et de la mémoire) pour comprendre les performances et l'évolutivité de votre application.
Afficher les erreurs de serveur
Cloud Error Reporting consolide les erreurs de votre instance Cloud Run App Hosting. Vous pouvez éventuellement configurer Cloud Error Reporting pour vous avertir de l'apparition de nouvelles erreurs.