Escribe registros de la aplicación

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.

Un agente de Stackdriver Logging recopila los registros de solicitud y de aplicación para tu aplicación. 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.

Puedes obtener una lista de los registros disponibles en Registros flexibles de App Engine.

Escribe registros de la aplicación

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 usar 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 de registros para limitar su tamaño.

Cómo ver los registros de la aplicación

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.

Filtra 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 por el mismo trace se pueden ver en un formato "principal-secundario".

A continuación, se indica cómo 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 app con un tipo que no sea el mismo que el tipo de registro de request.

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

  3. Configura el identificador trace en el campo trace de LogEntry en las entradas de registro de tu app. El formato esperado es projects/[PROJECT_ID]/traces/[TRACE_ID].

Una vez que hayas correlacionado las entradas de registro, continúa con las siguientes 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 Cómo ver 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.

Lectura de registros a través de la API

No existe una API para leer los registros de App Engine que se crean en el entorno flexible.