Escribe y visualiza los 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: 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 aplicaciones: entradas de registro 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

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

Alternativa: escribe registros estructurados en stdout y stderr

En lugar de seguir el 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, debe aplicarles el formato de datos estructurados. Para obtener más información, consulta Registro estructurado.

Si deseas correlacionar las entradas en el registro de aplicaciones con las del registro de solicitudes, las entradas estructuradas del registro de aplicaciones 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 aplicaciones de App Engine.

Ver registros

Puedes ver tu aplicación y solicitar registros mediante el Visor 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 el tipo de recurso.

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

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

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

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

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

Visualiza registros con la línea de comandos

Para ver tus 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 cola de registros de aplicaciones de gcloud.

Cómo leer 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 solicitudes y aplicaciones, consulta 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.

Cómo administrar el uso de recursos del registro

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 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 aplicación, usa la función exclusión de registros de Cloud Logging.