Visualiza registros y métricas

Los registros y las métricas son herramientas importantes para depurar y supervisar el código. App Hosting proporciona acceso rápido para ver registros y métricas de los servicios de Google Cloud 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 registros en la consola

En el menú contextual de la consola Firebase (un menú de 3 puntos en la parte superior derecha) de un lanzamiento, puedes obtener acceso rápido para ver los detalles y errores de la revisión Cloud Run, así como los registros Cloud Build.

Estos registros contienen información útil para depurar tus implementaciones de App Hosting. Por ejemplo, el registro Cloud Run anota cuando no se encuentra package.json.

El registro Cloud Build 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 configuración de App Hosting. También muestra tu configuración básica de runConfig e indica cuándo falta la configuración o cuando apphosting.yaml no existe:

> 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

Escribe registros en Cloud Logging

Si deseas registrar eventos personalizados, puedes escribir en Cloud Logging desde Cloud Run, donde se ejecuta el 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 a partir de código para un controlador de rutas de Next.js, debes hacer 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 pasa a 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 Cloud Build, mientras que la renderización del servidor se envía a los registros Cloud Run.

Cómo ver métricas en la consola

Desde la consola de Firebase, puedes acceder a las métricas de tráfico y uso del servicio Cloud Run que potencia tu app web.

En el menú contextual de la consola de Firebase (un menú de 3 puntos en la esquina superior derecha) para la implementación actual, selecciona Ver métricas de Cloud Run. Podrás supervisar la cantidad de solicitudes que llegan a tu servicio de Cloud Run, incluido el desglose por código de respuesta, para comprender la tasa de errores de la app.

También encontrarás la latencia de las solicitudes y las métricas de uso del contenedor (como el uso de CPU y de memoria) para comprender el rendimiento y la escalabilidad de la app.

Ver errores del servidor

Cloud Error Reporting consolida los errores de tu instancia de Cloud Run App Hosting. De manera opcional, puedes configurar Cloud Error Reporting para que te notifique cuando surgen errores nuevos.