Correlaciona las entradas de registro

En este documento, se describe cómo agrupar y ver las entradas de registro en un formato de “principal-secundario” mediante 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 las entradas de registro con el campo trace en el objeto LogEntry.

Cuando correlacionas las 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 puedes instrumentar tu aplicación para que envíe seguimientos a Cloud Trace mediante las bibliotecas cliente de Google. Con la siguiente configuración, se capturan automáticamente los datos de registro:

  • Entorno estándar de App Engine

  • Cloud Functions y Cloud Run

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

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

  • El campo trace en el objeto LogEntry se establece en una string 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 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 el panel de navegación de la consola de Google Cloud, elige Logging y, luego, Explorador de registros:

    Ir al Explorador de registros

  2. En el menú desplegable Recurso, selecciona Aplicación 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 Expandir.

    Las entradas de registro de la aplicación que se correlacionan con la entrada de registro de la solicitud están anidadas en la entrada de registro de la solicitud:

    Las entradas de registro de la aplicación 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.

Busca entradas de registro correlacionadas

La búsqueda correlacionada te permite buscar entradas de registro principales 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 principales o secundarias. Por ejemplo, para buscar la string “mensaje de registro de la app” en las entradas de registro secundarias y principales, haz lo siguiente:

  1. En el panel de navegación de la consola de Google Cloud, elige Logging y, luego, Explorador de registros:

    Ir al Explorador de registros

  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 la 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 string "app log message" o que tienen un elemento secundario que contiene la string.

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

    Las entradas de registro de la aplicación 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 que contienen la string “mensaje de registro de la app”. 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 habrá entradas superiores y secundarias correlacionadas que coincidan con tu consulta.

¿Qué sigue?