Escribe registros de aplicaciones

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

Un agente de registro de Stackdriver recopila los registros de aplicación y solicitud de la aplicación. Consulta Política de cuotas para ver la política de retención de registros y el tamaño máximo de las entradas de registro. Si quieres almacenarlos por más tiempo, puedes exportar tus registros a Cloud Storage. También puedes exportar tus registros a BigQuery y Pub/Sub para su procesamiento posterior.

Para acceder a una lista de registros disponibles que puedes usar, consulta registros de App Engine Flexible.

Escribe 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 con 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 como filtros en el Visor de registros. Sin embargo, el Visor de registros proporciona otras opciones de filtro, como texto, marca de hora, etc. Solo se conservan las entradas más recientes en el Visor para limitar su tamaño.

Ve los registros de aplicaciones

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

  1. Ve a la página de 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 el menú desplegable, selecciona Aplicación en 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 las interfaces de filtro del Visor de registros para obtener más detalles.

Filtra registros de aplicaciones

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, servicios o versiones específicas, filtra por el ID de ese recurso en el Visor de registros. Si buscas los ID del servicio y de la versión, consulta el panel de App Engine.

En el Visor de registros, las entradas de registro que se correlacionan por igual trace se pueden ver en un formato “superior-secundario”.

Las siguientes son instrucciones para correlacionar las entradas de registro:

  1. Decide qué registros de la aplicación quieres correlacionar con tus registros de request. Ten en cuenta que, para que esta correlación funcione, debes elegir los registros de la aplicación con un tipo de que no sea el mismo del tipo de registro de request.

  2. En el código de tu aplicación, busca el encabezado HTTP de X-Cloud-Trace-Context de las solicitudes entrantes. Extrae el identificador de seguimiento del encabezado. Para obtener más detalles, consulta Asistencia de Stackdriver Trace.

  3. Configura el identificador de trace en el campo trace de LogEntry de tus entradas de registro de la aplicación. El formato esperado es projects/[PROJECT_ID]/traces/[TRACE_ID].

Una vez que correlaciones las entradas de registro, sigue estos pasos para ver las entradas de registro correlacionadas:

  1. Abre tus registros de App Engine en el Visor de registros. Para obtener más detalles, consulta Ver 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 del registro. Verás tus registros de request y de la aplicación en un formato anidado.

Además:

  • La severity más alta de las entradas de registro secundarias no se aplica automáticamente a la entrada principal. Si se desea ese comportamiento, configura manualmente la severity más alta en la entrada principal.
  • Configura el campo httpRequest.requestUrl para el registro de nivel superior.

Lee registros a través de la API

No existe una API que lea los registros de App Engine creados en el entorno flexible.

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Documentación del entorno de App Engine Flexible para Python