Escribe registros de aplicaciones

Cuando se envía una solicitud a tu aplicación que se ejecuta en App Engine, los detalles de la solicitud y la respuesta se registran automáticamente y se pueden ver en el Visor de registros de Stackdriver de Google Cloud Platform Console.

Consulta la Política de cuotas para conocer la política de retención de registros y el tamaño máximo de las entradas de registro. Si quieres almacenarlos por un período más largo, puedes exportar tus registros a Cloud Storage. También puedes exportar tus registros a BigQuery y Pub/Sub para su procesamiento posterior.

Para obtener una lista de los registros disponibles que puedes usar, consulta los registros del entorno estándar de App Engine.

Cómo escribir registros de aplicaciones

Cuando tu aplicación maneja una solicitud, también puede escribir sus propios mensajes de registro en stdout y stderr. Escribe los registros de tu aplicación mediante el uso de stdout para salida y stderr para errores. Estos archivos se recopilan automáticamente y se pueden ver en el Visor de registros. Ten en cuenta que esto no proporciona niveles de registro que puedas utilizar para filtrar en el visor de registros. Sin embargo, este proporciona otras opciones de filtro, como texto, marca de tiempo, etc. En el visor de registros, solo se conservan las entradas más recientes para limitar su tamaño.

Para emitir un elemento de registro de la app de Node.js, puedes utilizar las funciones console.log() o console.error(), las cuales tienen los siguientes niveles de registro:

  • Los elementos emitidos con console.log() tienen el nivel de registro INFO.
  • Los elementos emitidos con console.error() tienen el nivel de registro ERROR.
  • Los mensajes internos del sistema tienen el nivel de registro DEBUG.

En el caso de las apps de Node.js, puedes utilizar los complementos de Bunyan o Winston, además de la biblioteca cliente en la nube de Stackdriver Logging para Node.js directamente. Si deseas más información, consulta Configura Stackdriver Logging para Node.js.

Ve registros de aplicaciones

Puedes ver los registros de tu aplicación con el Visor de registros:

  1. Ve a la página Stackdriver > Logging en GCP Console.

    Ir a la página del Visor de registros

  2. Selecciona un proyecto de GCP existente en la parte superior de la página.

  3. En los menús desplegables, selecciona Aplicación GAE como tu tipo de recurso para ver tus registros de App Engine.

Puedes usar los menús desplegables y otros componentes del Visor de registros para filtrar o buscar entradas relevantes en los registros. Consulta Interfaces de filtro del Visor de registros para obtener más detalles.

Cómo filtrar los registros de la aplicación

Para filtrar las entradas de registro por etiqueta o búsqueda de texto en el Visor de registros, consulta Filtros de registros básicos.

Para escribir filtros de registros avanzados a fin de especificar un conjunto de entradas de registro, consulta Filtros de registros avanzados.

Para ver los registros de instancias, versiones o servicios específicos, filtra por el ID del recurso en el Visor de registros. Para encontrar los ID de servicio y versión, consulta el panel de App Engine.

En el visor de registros, las entradas de registro que se correlacionan con el mismo trace se pueden ver en un formato que refleja la jerarquía entre elementos superiores y secundarios.

Consulta la documentación de GitHub para obtener instrucciones para correlacionar las entradas de registro.

Una vez que correlaciones las entradas de registro, sigue estas instrucciones para ver las entradas de registro correlacionadas:

  1. Abre tus registros de App Engine en el Visor de registros. Para obtener más información, consulta Visualiza los registros de la aplicación.

  2. Para expandir un registro de request, haz clic en el pequeño triángulo negro a la izquierda de la entrada de registro. Se mostrarán los registros de request y de aplicación en un formato anidado.

Además:

  • El grado de severity más alto de las entradas de registro secundarias no se aplica automáticamente a la entrada principal. Para cambiar esa configuración, establece manualmente el grado de severity más alto en la entrada principal.
  • Establece el campo httpRequest.requestUrl para el registro principal.
¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Documentación del entorno estándar de App Engine para Node.js