Realiza la integración de Cloud Logging

En este documento, se describe cómo puedes asociar un registro con una entrada de registro de Cloud Logging. Si usas los campos de seguimiento en la estructura LogEntry (spanId, trace y traceSampled), puedes correlacionar los registros y los seguimientos para permitir una mejor solución de problemas distribuidos.

Asocia manualmente una entrada de registro con un seguimiento o un intervalo

Si usas la API de Cloud Logging para escribir datos de registro o si escribes datos de registro estructurados, puedes asociar una entrada de registro con un seguimiento o con un intervalo. La entrada de registro también puede registrar si se realizó el muestreo del seguimiento. Para obtener información sobre cómo El Agente de operaciones convierte los datos de registro estructurados en campos en un LogEntry, consulta Campos especiales en cargas útiles estructuradas.

Configura el campo trace para asociar una entrada de registro con un seguimiento en el objeto LogEntry. El campo trace debe establecerse en una cadena con el siguiente formato:

   projects/PROJECT_ID/traces/TRACE_ID

En el que PROJECT_ID es tu ID del proyecto de Google Cloud y TRACE_ID es el identificador de seguimiento

Para asociar una entrada de registro con un intervalo cuando usas la API de Cloud Logging, Establece el campo spanId en el objeto LogEntry. a la codificación hexadecimal de 16 caracteres del ID del intervalo. Por ejemplo, para asociar una entrada de registro a un intervalo que tiene un ID de 74, establece el ID de intervalo en 000000000000004a.

Indicar que estás utilizando el muestreo de seguimientos y que se muestreó el seguimiento para el almacenamiento cuando se escribió la entrada de registro, configura el campo traceSampled en el objeto LogEntry. Cuando usas el muestreo de seguimientos, es posible que se cree una entrada de registro cuando no se captura el seguimiento.

Asocia automáticamente una entrada de registro con un seguimiento o un intervalo

Cuando usas las bibliotecas cliente de Cloud Logging, en algunos casos, los campos de seguimiento de una entrada de registro se pueden configurar automáticamente. Los valores establecidos de forma manual tienen prioridad sobre los valores establecidos automáticamente.

Por ejemplo, si usas OpenTelemetry y registras desde un intervalo activo de OpenTelemetry, los campos de seguimiento en la entrada de registro se propagan desde el contexto de OpenTelemetry.

En algunos casos, como alternativa, cuando hay una solicitud HTTP los campos de seguimiento se pueden configurar W3C traceparent o la valor X-Cloud-Trace-Context en la solicitud HTTP.

Obtén más información sobre la propagación automática de los campos de seguimiento en el registro consulta la siguiente documentación de la biblioteca cliente específica para el lenguaje:

Visualiza registros

Puedes ver la entrada de registro de un seguimiento junto con el gráfico de cascada o en el Explorador de registros. Cuando usas el Explorador de registros, se restringe automáticamente al rango de marca de tiempo del seguimiento. Si no hay entradas de registro para mostrar, el Explorador de registros muestra el mensaje No entries found matching current filter

En el panel Detalles de seguimiento, para ver la entrada de registro del seguimiento, haz una de las siguientes acciones:

  • Para mostrar las entradas de registros de seguimiento junto con el gráfico de cascada, ve al gráfico de cascada y haz clic en Mostrar registros. Cuando no se muestra Mostrar registros, no hay entradas de registro disponibles.

  • Para ver la entrada de registro en el Explorador de registros, haz clic en Ver junto al etiqueta Log en la sección Detalles. Cuando tengas un seguimiento de Cloud Load Balancing, haz clic en Ver, a la etiqueta VM Log.

Para obtener más información sobre cómo ver las entradas de registros en Cloud Logging, consulta Usa el Explorador de registros.

Permisos de visualización de registros

Para ver las entradas de registros, debes tener el permiso logging.logEntries.list en tu proyecto. Este permiso se obtiene mediante las funciones de la administración de identidades y accesos (IAM) de visor de registros y visualizador del proyecto.

Para ver los registros de instancias de VM, debes tener el permiso compute.instances.get en tu proyecto. Este permiso se obtiene mediante las funciones de IAM de Lector de red de Compute Engine y Lector del proyecto.