Los registros y las métricas son herramientas importantes para depurar y supervisar el código. App Hosting proporciona acceso rápido para ver los registros y las métricas de los Google Cloud servicios que impulsan tu app web: Cloud Run, Cloud Build y Cloud CDN.
Con la sintaxis de registro estándar, como console.log de Node.js, puedes escribir entradas de registro
en Cloud Logging.
Cómo ver el uso en la consola
Cada backend tiene una pestaña Descripción general, con un resumen del tráfico de tu app (recuento de solicitudes) y la tasa de errores en los últimos siete días.
La pestaña Registros de un backend te permite ver y filtrar los "Registros de compilación" (de Cloud Build) y los "Registros de tiempo de ejecución" (de Cloud Run y Cloud CDN).
Cada backend también tiene una pestaña Uso con varios gráficos de uso para la actividad y el uso de tu app. Los datos representados incluyen el ancho de banda y las solicitudes de CDN, el uso de CPU y memoria Cloud Runy mucho más.
Puedes encontrar métricas de uso adicionales para Cloud Run (como el uso de CPU y el uso de memoria) en la consola de Google Cloud.
Cómo ver los registros en la consola
En el menú contextual de la consola Firebase (un menú de 3 puntos en la esquina superior derecha) para un lanzamiento, puedes obtener acceso rápido para ver los detalles y los errores de la revisión Cloud Run así como los registros de compilación.
Estos registros contienen información útil para depurar tus App Hosting
implementaciones. Por ejemplo, el Cloud Run registro indica cuándo package.json
no se encuentra.
El registro de compilación muestra el resultado de la compilación, lo que te permite determinar
si se produjeron errores en la configuración de tu framework o en la
App Hosting configuración. También muestra tu configuración básica de runConfig y muestra cuándo faltan parámetros de configuración o cuándo no existe apphosting.yaml:
> 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
Cómo escribir registros en Cloud Logging
Si deseas registrar eventos personalizados, puedes escribir en Cloud Logging desde
Cloud Run, donde se ejecuta tu código renderizado por el servidor. Usa llamadas de registro estándar de JavaScript, como console.log y console.error. Por ejemplo,
para escribir una entrada personalizada desde el código de un
controlador de ruta de Next.js,
harías algo como lo siguiente:
- Los comandos
console.log()tienen el nivel de registro INFO. - Los comandos
console.info()tienen el nivel de registro INFO. - Los comandos
console.warn()tienen el nivel de registro ERROR. - Los comandos
console.error()tienen el nivel de registro ERROR. - Los mensajes internos del sistema tienen el nivel de registro DEBUG.
Ten en cuenta que console.log se canaliza a través de Cloud Logging en el
código renderizado por el servidor de tu app. Los eventos relacionados con la renderización estática se envían
a los registros de Cloud Build, mientras que la renderización del servidor se envía a los registros de Cloud Run.
Cómo ver los errores del servidor
Cloud Error Reporting consolida los errores de tu instancia de App Hosting Cloud Run. De manera opcional, puedes configurar Cloud Error Reporting para que te notifique cuando surjan errores nuevos.