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: Es un registro de las solicitudes que se envían a tu app. App Engine crea entradas automáticamente en el registro de solicitudes.

  • Registro de aplicaciones: entradas de registro que escribes en un framework 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.

Escribe registros de la app

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

Si deseas correlacionar 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 tu 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 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 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 del 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 a la salida 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 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 y otros criterios. También puedes buscar los registros de las entradas específicas. Consulta los detalles de Visualización de registros.

Visualiza registros mediante la línea de comandos

Si deseas visualizar 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 cola de registros de aplicaciones de gcloud.

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 solicitudes y de las apps, consulta los 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 tus 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 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 del registro de solicitudes asociadas con tu aplicación, usa la función exclusión de registros de Cloud Logging.

Problemas comunes

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