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 Google Cloud services qui alimentent votre application Web : Cloud Run, Cloud Build et Cloud CDN.
En utilisant une 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 Overview (Présentation) qui affiche un résumé du trafic de votre application (nombre de requêtes) et du taux d'erreur au cours des sept derniers jours.
L'onglet Logs (Journaux) d'un backend vous permet d'afficher et de filtrer les "journaux de compilation" (de Cloud Build) et les "journaux d'exécution" (de Cloud Run et Cloud CDN).
Chaque backend comporte également un onglet Usage (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 CDN, l'utilisation du processeur et de la mémoire Cloud Run, et plus encore.
Vous trouverez des métriques d'utilisation supplémentaires pour Cloud Run (telles que 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) pour un déploiement progressif, 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 App Hosting
déploiements. Par exemple, le Cloud Run journal indique lorsque 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
App Hosting configuration. 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 routes Next.js,
vous pouvez 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 le rendu côté serveur est envoyé aux journaux Cloud Run.
Afficher les erreurs du serveur
Cloud Error Reporting consolide les erreurs de votre instance App Hosting Cloud Run. Vous pouvez également configurer Cloud Error Reporting pour vous avertir lorsque de nouvelles erreurs surviennent.