Integración en Cloud Logging

En este documento, se describe cómo asociar un seguimiento a un LogEntry de Cloud Logging.

Cómo asociar un seguimiento a una entrada de registro

Cuando usas las bibliotecas cliente de Trace o la biblioteca de OpenCensus para Python o Java, asocias un seguimiento a una entrada de registro mediante la configuración del campo trace en el objeto LogEntry.

El campo trace debe establecerse en una string 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

Puedes asociar un intervalo con una entrada de registro configurando el campo spanId en el objeto LogEntry. En este caso, configura el campo spanId con la codificación hexadecimal de 16 caracteres del ID del intervalo. Por ejemplo, un intervalo con un ID de 74 se representa como 000000000000004a. Cuando uses el muestreo de seguimientos, configura el campo traceSampled del objeto LogEntry para indicar que se muestreó el seguimiento para su almacenamiento cuando se escribió la entrada de registro. Es posible que se cree una entrada de registro cuando no se captura el seguimiento.

Visualiza los registros

Puedes ver la entrada de registro de un seguimiento junto con el gráfico de cascada o 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, realiza 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. Ten en cuenta que, cuando tengas un seguimiento 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 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 Visualizador de red de Compute Engine y Visualizador del proyecto.