Seguimientos e intervalos

En este documento, se proporciona una introducción a los seguimientos y los intervalos. Un trace representa una sola operación de extremo a extremo. Los seguimientos se componen de intervalos, que son registros de una sola operación o función.

Modelo de datos de seguimiento

Un seguimiento tiene las siguientes propiedades:

  • ID de seguimiento: El identificador único de la operación de extremo a extremo. El ID de seguimiento se debe propagar como contexto como parte de la operación de extremo a extremo.

  • Una colección de intervalos que comparten el mismo valor para el ID de seguimiento.

    Cloud Trace usa el ID de seguimiento para identificar qué intervalos de su repositorio están asociados con el mismo seguimiento.

Modelo de datos del intervalo

Un intervalo corresponde a una operación que se llevó a cabo durante un período finito, pero distinto de cero. A continuación, se enumeran algunas propiedades esenciales almacenadas por cada intervalo:

  • ID de seguimiento: Es el identificador de la operación de extremo a extremo en la que se llevó a cabo esta operación general en particular.
  • ID de intervalo: Es el identificador único del intervalo. Si se invoca la misma operación varias veces en la entrega de una sola operación general, es posible que un seguimiento contenga varios intervalos con el mismo nombre. Sin embargo, cada intervalo tiene un ID distinto.
  • ID de intervalo principal: Identifica la operación que invocó este intervalo. El intervalo "raíz" tiene el ID de intervalo superior establecido en null.
  • Nombre: El nombre de la operación que se realizó.
  • Hora de inicio: Es la hora de inicio de la operación.
  • Hora de finalización: Es 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 el uso de pares clave-valor. Cloud Trace recomienda que uses las convenciones semánticas de OpenTelemetry cuando sea posible.

Recursos

Recursos de OpenTelemetry:

¿Qué sigue?