Registros y tramos

En Cloud Trace, los seguimientos y los intervalos forman el modelo de datos que se usa para hacer un seguimiento de la ruta de acceso y la latencia de las solicitudes a través de tus aplicaciones distribuidas. Un seguimiento captura cómo se ejecuta una solicitud de extremo a extremo en tus servicios. Un seguimiento se compone de intervalos, que registran las operaciones individuales las llamadas a funciones y las RPC que ocurren durante esa solicitud.

Modelo de datos de seguimiento

Un seguimiento consta de lo siguiente:

  • ID de seguimiento: Es el identificador único de la operación de extremo a extremo. El ID de seguimiento se propaga en el contexto de la solicitud a través de los límites del servicio.

  • Colección de intervalos: Es un conjunto de intervalos que comparten el mismo ID de seguimiento. Estos intervalos forman un árbol o un grafo acíclico dirigido que representa la jerarquía de llamadas de una solicitud.

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

Modelo de datos de intervalo

Un intervalo representa una sola operación que ocurrió dentro de un período específico. Cada intervalo contiene campos que proporcionan información sobre el intervalo y el estado de la operación:

  • Los identificadores incluyen los siguientes campos:

    • ID de seguimiento: Es el identificador único de la solicitud o el seguimiento general al que pertenece el intervalo.
    • ID de intervalo: Es el identificador único del intervalo. Si se invoca una operación varias veces dentro de un solo seguimiento, cada invocación genera un intervalo independiente con el mismo nombre, pero con un ID de intervalo único.
    • ID de intervalo superior: Identifica la operación superior que invocó este intervalo. El intervalo "raíz" tiene el ID de intervalo superior establecido en null.
    • Nombre: Es el nombre de la operación que se realizó.
    • Tipo: El tipo de intervalo proporciona información a las herramientas de seguimiento, como el Explorador de Trace, sobre cómo se relacionan los intervalos entre sí. Para obtener más información, consulta OpenTelemetry SpanKind.

  • La información de ejecución se proporciona en los siguientes campos:

    • Estado: Registra el estado de finalización de la operación. El valor de este campo es Unset (predeterminado), Error o Ok. El valor predeterminado no indica un error.
    • 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 pueden contener otros campos, como eventos, atributos y vínculos:

  • Los eventos registran mensajes estructurados con marcas de tiempo dentro de un intervalo.
  • Los atributos almacenan información adicional sobre una operación mediante pares clave-valor. Cuando escribas atributos, te recomendamos que sigas las convenciones semánticas de OpenTelemetry siempre que sea posible.
  • Los vínculos te permiten relacionar un intervalo con otro.

Para obtener más información, consulta OpenTelemetry: Spans.

Recursos

Recursos de OpenTelemetry:

¿Qué sigue?