En este documento se describe cómo vincular una entrada de registro con un rastreo. Para crear la vinculación, debes definir un campo en la entrada de registro.
Si usas los campos de seguimiento de la estructura LogEntry (spanId, trace y traceSampled), puedes correlacionar registros y seguimientos para mejorar la solución de problemas distribuidos.
Asociar manualmente una entrada de registro a una traza o un intervalo
Si usas la API Cloud Logging para escribir datos de registro o si escribes datos de registro estructurados, puedes asociar una entrada de registro con un rastreo o con un intervalo. La entrada de registro también puede registrar si se ha muestreado la traza. 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 a una traza, define el campo trace en el objeto LogEntry.
El campo trace debe tener una cadena con el siguiente formato:
projects/PROJECT_ID/traces/TRACE_ID
donde PROJECT_ID es el ID de tu proyecto Google Cloud y TRACE_ID es el identificador de la traza.
Para asociar una entrada de registro con un intervalo al usar la API de Cloud Logging, define el campo spanId en el objeto LogEntry como la codificación hexadecimal de 16 caracteres del ID del intervalo.
Por ejemplo, para asociar una entrada de registro con un intervalo que tenga el ID 74,
asigna el ID de intervalo 000000000000004a.
Para indicar que estás usando el muestreo de trazas y que la traza se ha muestreado para almacenarla cuando se ha escrito la entrada de registro, define el campo traceSampled en el objeto LogEntry. Cuando usas el muestreo de trazas, es posible que se cree una entrada de registro cuando no se capture la traza.
Asociar automáticamente una entrada de registro a una traza o un intervalo
Cuando se usan las bibliotecas de cliente de Cloud Logging, en algunos casos, los campos de seguimiento de una entrada de registro se pueden definir automáticamente. Los valores definidos manualmente tienen prioridad sobre los valores definidos automáticamente.
Por ejemplo, si usas OpenTelemetry y registras datos de un intervalo de OpenTelemetry activo, los campos de traza de la entrada de registro se rellenan a partir del contexto de OpenTelemetry.
En algunos casos, cuando hay una solicitud HTTP, los campos de la traza se pueden definir a partir del campo traceparent de W3C o del valor X-Cloud-Trace-Context de la solicitud HTTP.
Para obtener más información sobre la población automática de campos de seguimiento en entradas de registro, consulta la siguiente documentación de la biblioteca de cliente específica de cada lenguaje:
Ver registros
Puedes ver la entrada de registro de un rastreo junto con el gráfico de cascada o en el Explorador de registros. Cuando usas el explorador de registros, se restringe automáticamente al intervalo de marca de tiempo del rastreo. Si no hay entradas de registro que mostrar, Explorador de registros muestra el mensaje No entries found matching current filter.
En el panel Detalles del seguimiento, para ver la entrada de registro del seguimiento, haz una de las siguientes acciones:
Para mostrar las entradas del registro de seguimiento junto al gráfico de cascada, ve al gráfico de cascada y haz clic en Mostrar registros. Si no se muestra Mostrar registros, significa que 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 de la sección Detalles. Ten en cuenta que, cuando tengas un rastreo 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 entradas de registro en Cloud Logging, consulta el artículo Usar el Explorador de registros.
Permisos de visualización de registros
Para ver las entradas de registro, debes tener el permiso logging.logEntries.list en tu proyecto. Este permiso se proporciona mediante los roles de gestión de identidades y accesos Lector de registros y Lector de proyectos.
Para ver los registros de instancias de VM, debes tener el permiso compute.instances.get en tu proyecto. Este permiso se proporciona mediante los roles de gestión de identidades y accesos Lector de redes de Compute Engine y Lector de proyectos.