Interoperabilidad de la API de OpenTelemetry y trazas de Datadog instrumentadas
Instrumentación personalizada con la API de OpenTelemetry
Las bibliotecas de rastreo de Datadog proporcionan una implementación de la API de OpenTelemetry para instrumentar tu código. Esto significa que puedes mantener una instrumentación de proveedor neutral de todos tus servicios, sin dejar de aprovechar la implementación nativa, las características y los productos de Datadog.
Con la instrumentación de tu código con la API de OpenTelemetry:
- Tu código permanece libre de llamadas a la API específicas del proveedor.
- Tu código no depende de las bibliotecas de rastreo de Datadog en el tiempo de compilación (solo en el tiempo de ejecución).
- Tu código no utiliza la API de OpenTracing obsoleta.
Sustituye el SDK de OpenTelemetry por la biblioteca de rastreo de Datadog en la aplicación instrumentada, y las trazas (traces) producidas por tu código en ejecución pueden ser procesadas, analizadas y monitorizadas junto con las trazas de Datadog y en los productos propiedad de Datadog como Continuous Profiler, Data Streams Monitoring, Application Security Management, y Live Processes.
Propagación de contexto de trazas W3C
Para facilitar el manejo fluido de los datos de traza de OpenTelemetry dentro de Datadog y correlacionarlos con los datos de traza generados por la instrumentación de Datadog, las versiones más recientes de las bibliotecas de rastreo de Datadog admiten ambos estilos de propagación, Datadog (datadog
) y W3C (tracecontext
) por defecto. Actualiza tus dependencias de la biblioteca de rastreo de tiempo de ejecución a la versión más reciente.
Este estilo de propagación de contexto permite a los rastreadores de Datadog operar en el mismo entorno de aplicación con los SDKs de OpenTelemetry y otros rastreadores conformes con W3C.
Identificadores de traza de 128 bits
Las trazas W3C contienen implícitamente identificadores de traza de 128 bits, en lugar de los identificadores de traza de 64 bits que las trazas de Datadog han utilizado históricamente. La configuración de las bibliotecas de rastreo de Datadog más reciente por defecto utiliza el ajuste DD_TRACE_128_BIT_TRACEID_GENERATION_ENABLED=True
para que también produzcan datos de traza con IDs de traza de 128 bits.
Siguiendo las recomendaciones de contexto de traza W3C, los IDs de traza de 128 bits de Datadog tienen aleatoriedad en los 64 bits de orden inferior. Esta restricción proporciona compatibilidad con versiones anteriores para los sistemas que entremezclan bibliotecas que generan IDs de traza de 64 bits con otras más recientes que admiten IDs de 128 bits. En tales sistemas, los tramos (spans) con el ID de traza completo de 128 bits y los tramos con el ID de traza truncado de 64 bits de orden inferior pueden llegar al backend y ser tratados como coincidentes y parte de la misma traza.
Referencias adicionales
Additional helpful documentation, links, and articles: