Los enlaces de tramos (spans) son un concepto de OpenTelemetry y son parte de la API de rastreo OpenTelemetry. Datadog admite enlaces de tramos para:
Los enlaces de tramos correlacionan uno o más tramos que están causalmente relacionados pero no tienen una relación típica elemento principal-secundario. Estos enlaces pueden correlacionar tramos dentro de una misma traza (trace) o entre diferentes trazas.
Los enlaces 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 (flow) de operaciones en sistemas que ejecutan solicitudes por lotes o eventos de procesos de forma asíncrona.
Datadog admite enlaces de tramos prospectivos y retrospectivos, lo que permite a los usuarios visualizar y recorrer las relaciones de tramos entre trazas en ambas direcciones.
- Enlaces prospectivos: Un tramo puede vincularse con otro que se produce más tarde en el tiempo, tanto si pertenece a la misma traza o a uno diferente. Esto te permite navegar desde operaciones anteriores a otras posteriores entre trazas.
- Enlaces retrospectivos: Del mismo modo, un tramo puede vincularse con otro que haya ocurrido antes en el tiempo, tanto dentro de la misma traza como entre diferentes trazas. Esto te permite rastrear desde operaciones recientes a otras anteriores.
Casos de uso común
Los enlaces 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í, los enlaces de tramos rastrean y correlacionan varios 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 enlaces 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 enlaces de tramos rastrean la relación entre cada mensaje y el proceso transacción global.
Suministro de eventos: Los enlaces de tramos del suministro de eventos rastrean cómo múltiples mensajes de cambio contribuyen al estado actual de una entidad.
Creación de enlaces de tramos
Si tu aplicación está instrumentada con:
Compatibilidad mínima
Nota*: Esta sección documenta la compatibilidad mínima necesaria para generar enlaces de tramos con bibliotecas cliente APM de Datadog (con la API de OpenTelemetry). Los enlaces 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 enlaces de tramos) utilizando bibliotecas de rastreo de Datadog. La compatibilidad con los enlaces de tramos se introdujo en las siguientes versiones:
| Lenguaje | Versión mínima de biblioteca de rastreo |
|---|
| C++/proxy | Aún no es compatible |
| Go | 1.61.0 |
| Java | 1.26.0 |
| .NET | 2.53.0 |
| Node | 5.3.0 |
| PHP | 0.97.0 |
| Python | 2.5.0 |
| Ruby | 2.0.0 |
Visualizar enlaces de tramos
Puedes consultar los enlaces de tramos desde el Explorador de trazas en Datadog.
Referencias adicionales
Más enlaces, artículos y documentación útiles:
