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 servicios de Google Cloud que potencian 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 la configuración básica de runConfig y, además, indica cuándo falta la configuración o cuando 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
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 de JavaScript estándar, 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 error de tu 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.
Cómo ver los 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.