La compatibilidad con vínculos de tramos está en fase beta.

Información general

Los vínculos de tramos son un concepto de OpenTelemetry y una parte de la API de rastreo OpenTelemetry. Datadog admite vínculos de tramos para:

  • Aplicaciones instrumentadas con SDK de OpenTelemetry.
  • Aplicaciones instrumentadas con bibliotecas cliente de Datadog utilizando la API OpenTelemetry. Nota: Esta versión beta sólo es compatible con la biblioteca cliente PHP.

Los vínculos de tramos correlacionan uno o más tramos que estén causalmente relacionados pero no tengan una relación típica elemento principal-secundario. Estos vínculos pueden correlacionar tramos dentro de una misma traza o entre diferentes trazas.

Los vínculos de tramos ayudan a rastrear operaciones en sistemas distribuidos, donde los flujos de trabajo a menudo se desvían de los patrones de ejecución lineales. Son útiles para rastrear el flujo de operaciones en sistemas que ejecutan solicitudes por lotes o eventos de procesos de forma asíncrona.

Casos de uso común

Los vínculos de tramos son más aplicables en escenarios fan-in, en los que múltiples operaciones convergen en un único tramo. El único tramo vincula con múltiples operaciones convergentes.

Por ejemplo:

  • Scatter-Gather y Map-Reduce: Aquí, el vínculo de tramos rastrea y correlaciona múltiples procesos paralelos que convergen en un único proceso combinado. Conectan los resultados de estos procesos paralelos con su resultado colectivo.

  • Agregación de mensajes: En sistemas como Kafka Streams, los vínculos de tramos conectan cada mensaje de un grupo de mensajes con su resultado agregado, mostrando cómo los mensajes individuales contribuyen al resultado final.

  • Mensajería transaccional: En situaciones en las que varios mensajes forman parte de una única transacción, como en las colas de mensajes, los vínculos de tramos rastrean la relación entre cada mensaje y el proceso transacción global.

  • Suministro de eventos: Los vínculos de tramos del suministro de eventos rastrean cómo múltiples mensajes de cambio contribuyen al estado actual de una entidad.

Creación de vínculos de tramos

Si tu aplicación está instrumentada con:

Compatibilidad mínima

Nota*: Esta sección documenta la compatibilidad mínima necesaria para generar vínculos de tramos con bibliotecas cliente APM de Datadog (con la API de OpenTelemetry). Los vínculos de tramos generados por el SDK de OpenTelemetry se envían a Datadog a través del consumo de OTLP.

Agent v7.52.0 o posterior para generar vínculos de tramos) utilizando bibliotecas de rastreo de Datadog. La compatibilidad con los vínculos de tramos se introdujo en las siguientes versiones:

LenguajeVersión mínima de biblioteca de rastreo
C++/proxyAún no es compatible
Go1.61.0
Java1.26.0
.NET2.53.0
Node5.3.0
PHP0.97.0
Python2.5.0
Ruby2.0.0

Visualizar vínculos de tramos

Puedes consultar los vínculos de tramos desde el Explorador de trazas en Datadog.

Leer más