Escribe y visualiza registros

En esta página, se describen los registros disponibles para las apps de App Engine y cómo escribir y ver las entradas de registro.

App Engine recopila dos tipos de registros:

  • Registro de solicitudes: Es un registro de las solicitudes que se envían a tu app. App Engine crea entradas de forma automática en el registro de solicitudes.

  • Registro de apps: Son las entradas de registro que escribes en un framework o archivo compatible, como se describe en esta página.

App Engine envía estos registros de forma automática al agente de Cloud Logging, y puedes verlos en el visor de registros, en la línea de comandos o de manera programática.

Escribe registros de apps

Si deseas escribir entradas de registro, te recomendamos que uses la biblioteca cliente de Cloud Logging para Ruby. Si deseas obtener instrucciones y muestras de código, consulta Configura Cloud Logging para Ruby.

Alternativa: Escribe registros estructurados en stdout y stderr

En lugar del enfoque recomendado, puedes enviar strings de texto simples a stdout y stderr. Las strings aparecerán como mensajes en el Explorador de registros, la línea de comandos y la API de Cloud Logging, y se asociarán con el servicio y la versión de App Engine que las emitió.

Si deseas filtrar estas strings en el Explorador de registros por nivel de gravedad, debes aplicarles el formato de datos estructurados. Para obtener más información, consulta Registro estructurado.

Si deseas correlacionar las entradas del registro de la app con el registro de solicitudes, las entradas estructuradas del registro de la app deben contener el identificador de seguimiento de la solicitud. Puedes extraer el identificador de seguimiento del encabezado X-Cloud-Trace-Context de la solicitud. En la entrada de registro estructurada, escribe el ID en un campo llamado logging.googleapis.com/trace. Para obtener más información sobre el encabezado X-Cloud-Trace-Context, consulta Fuerza el seguimiento de una solicitud.

Consulta un ejemplo de entradas de registro estructuradas de escritura con un ID de seguimiento en la documentación de Cloud Run. Puedes usar la misma técnica en tus apps de App Engine.

Visualiza los registros

Puedes ver tu aplicación y solicitar registros mediante el Explorador de registros:

  1. Ve al Explorador de registros en la consola de Google Cloud:

    Ir al Explorador de registros.

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

  3. En los menús desplegables, selecciona Aplicación en GAE como el tipo de recurso.

  4. Para ver qué entradas de registro de apps se correlacionan con las entradas de registro de solicitudes, haz lo siguiente:

    1. Selecciona el registro httpRequest.requestUrl en los menús de filtro.

    2. Expande una entrada de registro de solicitudes. Los registros de la app relacionados con esa solicitud aparecen anidados en la entrada del registro de solicitudes.

    Si envías entradas de texto simples al resultado estándar, no puedes usar el visor de registros para filtrar las entradas de la app por gravedad, ni puedes ver qué registros de la app corresponden a solicitudes específicas. Sin embargo, puedes usar otros tipos de filtros en el Explorador de registros, como el texto y la marca de tiempo.

Puedes filtrar el Explorador de registros por servicio y versión de App Engine, además de otros criterios. También puedes buscar los registros de las entradas específicas. Consulta Usa el Explorador de registros para obtener más detalles.

Visualiza registros mediante la línea de comandos

Si deseas ver los registros de App Engine desde la línea de comandos, usa el siguiente comando:

gcloud app logs tail

Para obtener más información, consulta el comando gcloud app logs tail.

Lee registros de manera programática

Si deseas leer los registros de manera programática, puedes usar uno de estos métodos:

Política de retención de registros, precios y cuotas

Para obtener información sobre los precios que se aplican a los registros de las solicitudes y de las apps, consulta los precios de Cloud Logging.

Para conocer la política de retención de registros y el tamaño máximo de las entradas de registro, consulta Cuotas y límites. Si quieres almacenar los registros por un período más largo, puedes exportarlos a Cloud Storage. También puedes exportar registros a BigQuery y Pub/Sub para su procesamiento posterior.

Administra el uso de recursos de registros

Puedes controlar la cantidad de actividad de registro de los registros de tu app si escribes una cantidad mayor o menor de entradas desde el código de la app. Los registros de solicitudes se crean de forma automática, por lo que, para administrar la cantidad de entradas del registro de solicitudes asociadas con tu app, usa la función de exclusión de registros de Cloud Logging.

Problemas conocidos

En ocasiones, las entradas de registros de la app no están correlacionadas con el registro de solicitud. Esto sucede la primera vez que la app recibe una solicitud y en cualquier otro momento que App Engine escriba mensajes de estado en el registro de la app. Para obtener más información, consulta https://issuetracker.google.com/issues/138365527.