Trazas e intervalos

En este documento se ofrece una introducción a los rastreos y los intervalos. Una traza representa una sola operación de principio a fin. Los rastreos se componen de spans, que son registros de una sola función u operación.

Modelo de datos de traza

Un rastreo tiene las siguientes propiedades:

  • Trace ID: el identificador único de la operación de principio a fin. El ID de la traza debe propagarse como context como parte de la operación integral.

  • Conjunto de intervalos que comparten el mismo valor de ID de la traza.

    Cloud Trace usa el ID de traza para identificar qué intervalos de su repositorio están asociados a la misma traza.

Modelo de datos de intervalo

Un intervalo corresponde a una operación que se ha llevado a cabo durante un periodo de tiempo finito pero distinto de cero. A continuación, se enumeran algunas propiedades esenciales almacenadas por cada intervalo:

  • ID de seguimiento: identificador de la operación integral en la que se ha llevado a cabo esta operación general concreta.
  • ID de intervalo: identificador único del intervalo. Si se invoca la misma operación varias veces en la realización de una sola operación general, un rastreo puede contener varios intervalos con el mismo nombre. Sin embargo, cada intervalo tiene un ID distinto.
  • ID del intervalo principal: identifica la operación que ha invocado este intervalo. El intervalo "root" tiene el ID de intervalo principal definido como null.
  • Nombre: el nombre de la operación que se ha realizado.
  • Hora de inicio: la hora de inicio de la operación.
  • Hora de finalización: la hora de finalización de la operación.

Los intervalos también pueden contener atributos, que almacenan información adicional sobre una operación mediante pares clave-valor. Cloud Trace recomienda usar las convenciones semánticas de OpenTelemetry siempre que sea posible.

Recursos

Recursos de OpenTelemetry:

Siguientes pasos