Escribe y visualiza los registros

Esta página describe los registros que están disponibles para las aplicaciones de App Engine y cómo escribir y ver entradas de registro.

App Engine recopila dos tipos de registros:

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

  • Registro de la aplicación: registra las entradas que escribes en un marco o archivo compatible, como se describe en esta página.

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

Cómo escribir registros de aplicaciones

Para escribir entradas de registro, te recomendamos usar el paquete de registro compatible con la biblioteca que proporciona Cloud Logging. Este enfoque habilita todas las funciones de Cloud Logging y requiere solo unas pocas líneas de código específico de Google Cloud.

Para obtener instrucciones y ejemplos de código, consulta Configura Cloud Logging para Go.

Alternativa: escribir 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 visor de registros, la línea de comandos y la API de Cloud Logging, y se asociarán con el servicio de App Engine y la versión que las emitió.

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

Si deseas correlacionar las entradas en el registro de la aplicación con el registro de la solicitud, tus entradas de registro de la aplicación estructurada deben contener el identificador de seguimiento de la solicitud. Puedes extraer el identificador de seguimiento del encabezado de la solicitud X-Cloud-Trace-Context. En tu entrada de registro estructurado, 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 Cómo forzar el seguimiento de una solicitud.

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

Ver registros

Puedes ver tu aplicación y solicitar registros con el Lector de registros:

  1. Ve al visor de registros en Cloud Console:

    Ir al visor 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 GAE como tu tipo de recurso.

  4. Para ver qué entradas del registro de la app se correlacionan con las entradas del registro de solicitudes:

    1. Selecciona el registro httpRequest.requestUrl en el menú de selección.

    2. Expande una entrada de registro de solicitud. Los registros de la aplicación relacionados con esa solicitud aparecen anidados en la entrada del registro de la solicitud.

    Si envías entradas de texto simples a la salida estándar, no puedes usar el visor de registros para filtrar las entradas de la aplicación por gravedad, ni puedes ver qué registros de la aplicación corresponden a solicitudes específicas. Aún puedes usar otros tipos de filtros en el visor de registros, como texto y marca de tiempo.

Puedes filtrar el visor de registros por el servicio de App Engine, la versión y otros criterios. También puedes buscar entradas específicas en los registros. Consulta Ver registros.

Visualiza registros con la línea de comandos

Para 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 gcloud app logs.

Cómo leer registros de manera programática

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

Precios, cuotas y política de retención de registros

Para obtener información sobre los precios que se aplican a los registros de solicitudes y apps, consulta precios para 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 registro

Puedes controlar la cantidad de actividad de registro de los registros de tu app escribiendo más o menos entradas del código de tu app. Los registros de solicitudes se crean automáticamente, por lo que, para administrar la cantidad de entradas de registro de solicitudes asociadas con tu app, usa la función de exclusión de registros de Cloud Logging.