La correlación de las entradas de registro de Cloud Logging con los seguimientos y los intervalos de Cloud Trace te permite ver los registros junto con los gráficos de cascada de seguimiento o en el Explorador de registros cuando solucionas problemas de solicitudes distribuidas. Para vincular registros con seguimientos, puedes configurar los campos trace, spanId y traceSampled en un objeto LogEntry de forma manual o usar las bibliotecas cliente de Logging para propagar estos campos automáticamente desde el contexto de OpenTelemetry o los encabezados de solicitudes HTTP.
Cómo asociar manualmente una entrada de registro con un seguimiento o 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 muestreó el registro. Para obtener información sobre cómo el agente de operaciones convierte los datos de registro estructurados en campos de un LogEntry, consulta Campos especiales en cargas útiles estructuradas.
Para asociar una entrada de registro con un registro de seguimiento, configura el campo trace en el objeto LogEntry:
- Formato preferido:
TRACE_ID - Formato heredado:
projects/PROJECT_ID/traces/TRACE_ID
En las expresiones anteriores, PROJECT_ID es el ID de tu proyecto de Google Cloud y TRACE_ID es el identificador de seguimiento.
Para asociar una entrada de registro con un intervalo cuando se usa la API de Logging, establece el campo spanId en el objeto LogEntry en la codificación hexadecimal de 16 caracteres del ID del intervalo.
Por ejemplo, para asociar una entrada de registro con un intervalo que tiene un ID de 74, establece el ID del intervalo en 000000000000004a.
Para indicar que usas el muestreo de registros y que se muestreó el registro para su almacenamiento cuando se escribió la entrada de registro, establece el campo traceSampled en el objeto LogEntry. Cuando usas el muestreo de registros, es posible que se cree una entrada de registro cuando no se capture el registro en sí.
Asocia automáticamente una entrada de registro con un seguimiento o un intervalo
En algunos casos, las bibliotecas cliente de registro pueden establecer automáticamente los campos de seguimiento. Los valores establecidos manualmente tienen prioridad sobre los valores establecidos automáticamente.
Por ejemplo, si usas OpenTelemetry y registras datos desde un intervalo activo de OpenTelemetry, los campos de seguimiento en la entrada de registro se propagan desde el contexto de OpenTelemetry.
Como alternativa, en algunos casos, cuando hay una solicitud HTTP, los campos de seguimiento se pueden establecer desde el campo traceparent de W3C o el valor X-Cloud-Trace-Context en la solicitud HTTP.
Para obtener más información sobre la propagación automática de campos de seguimiento en las entradas de registro, consulta la siguiente documentación de la biblioteca cliente específica para cada lenguaje:
Ver 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, el período se restringe automáticamente al período de la marca de tiempo del registro. Si no hay entradas de registro para mostrar, el Explorador de registros mostrará el mensaje No entries found matching current filter.
Para ver la entrada de registro del seguimiento en el panel Detalles 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 a la etiqueta Registro en la sección Detalles. Cuando tengas un registro de Cloud Load Balancing, haz clic en Ver junto a la etiqueta Registro de VM.
Para obtener más información sobre cómo ver las entradas de registro en 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 proporciona a través de los roles de IAM de Visualizador de redes de Compute Engine y Visualizador de proyectos.