Correlaciona las entradas de registro

En este documento, se describe cómo agrupar y ver entradas de registro en un formato “superior-secundario” con el Explorador de registros. Por lo general, cuando escribes entradas de registro en Cloud Logging, cada una de entrada de registro aparece por separado y no está correlacionada. Sin embargo, puedes agrupar o correlacionar tus entradas de registro mediante el campo trace en el objeto LogEntry.

Cuando correlacionas entradas de registro, puedes ver una entrada de registro superior con varias entradas de registro secundarias en el Explorador de registros.

Configura entradas de registro correlacionadas

Para configurar entradas de registro correlacionadas, puedes propagar de forma manual el campo trace o instrumentar tu aplicación para enviar seguimientos a Cloud Trace mediante las bibliotecas cliente de Google. Los siguientes parámetros de configuración capturan automáticamente tus datos de seguimiento:

• Entorno estándar de App Engine

• Cloud Functions y Cloud Run

Si quieres obtener información sobre la instrumentación de tu aplicación para recopilar datos de seguimiento, consulta la Descripción general de la instrumentación para Cloud Trace.

Para que el Explorador de registros correlacione una colección de entradas de registro, las entradas de registro deben cumplir los siguientes requisitos:

• El campo trace del objeto LogEntry se establece en una cadena con el siguiente formato:

     projects/PROJECT_ID/traces/TRACE_ID
  

  En el ejemplo anterior, PROJECT_ID es el ID del proyecto de Google Cloud y TRACE_ID es el identificador de seguimiento.

• Los campos trace en las entradas de registro son los mismos.

• Cada entrada de registro pertenece a un registro único. Es decir, el valor de los campos logName debe ser diferente.

Visualiza las entradas de registro correlacionadas en el Explorador de registros

Para ver las entradas de registro secundarias correlacionadas con una entrada de registro superior que estás viendo en el Explorador de registros, expande la entrada de registro.

Por ejemplo, para mostrar tu entrada de registro de solicitud de App Engine y las entradas de registro de la aplicación, haz lo siguiente:

1. En la consola de Google Cloud, ve a la página Explorador de registros:

   Ir al Explorador de registros

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

2. En el menú desplegable Recurso, selecciona Aplicación en GAE.

3. En el menú desplegable Nombre del registro, selecciona request_log.

4. En el panel Resultados de la consulta, para expandir una entrada de registro, haz clic en chevron_right Expandir.

   Las entradas del registro de la aplicación correlacionadas con la entrada de registro de la solicitud están anidadas en la entrada de registro de la solicitud:

   

   En la captura de pantalla anterior, la entrada de registro superior tiene 10 entradas de registro secundarias. Puedes expandir estas entradas de registro secundarias para ver sus detalles.

Buscar entradas de registro correlacionadas

La búsqueda correlacionada te permite buscar entradas de registro superiores y secundarias con una consulta. El resultado de la búsqueda es una lista de entradas de registro superiores que coinciden con la consulta en las entradas de registro superiores o secundarias. Por ejemplo, para buscar la string “mensaje de registro de la app” en las entradas de registro secundarias y superiores, haz lo siguiente:

1. En la consola de Google Cloud, ve a la página Explorador de registros:

   Ir al Explorador de registros

   Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

2. Ingresa "app log message" en el campo de búsqueda y haz clic en Ejecutar consulta. Las entradas de registro secundarias que contienen “mensaje de registro de app” se enumeran en el panel Resultados de la consulta.

3. En el panel Resultados de la consulta, haz clic en Correlar por y selecciona un registro superior. Para ver los registros de solicitud de App Engine, selecciona request_log y haz clic en Aplicar.

4. En el panel Resultados de la consulta, se enumeran todas las entradas de registro superiores que contienen la cadena "app log message" o que tienen un elemento secundario que contiene la cadena.

   Para ver las entradas de registro secundarias anidadas, presiona la entrada de registro superior y haz clic en chevron_right Expandir.

   

   En la captura de pantalla anterior, la entrada de registro superior tiene 10 entradas de registro secundarias que contienen la string “app log message”. Puedes expandir estas entradas de registro secundarias para ver sus detalles.

   Si seleccionaste un registro superior y no ves entradas de registro en el panel Resultados de la consulta, no hay entradas correlacionadas superiores y secundarias que coincidan con tu consulta.

¿Qué sigue?

• Si quieres obtener información sobre cómo instrumentar tu aplicación para Cloud Trace, consulta Descripción general de la instrumentación para Cloud Trace.

• Para obtener información sobre los registros de solicitud y los registros de aplicación de App Engine, consulta Lee y escribe registros de aplicación.