Descripción general

Datadog ofrece múltiples opciones de configuración para adaptarse a diversos casos de uso, desde implementaciones completas de OpenTelemetry (OTel) hasta configuraciones híbridas que utilizan tanto componentes de OpenTelemetry como de Datadog. Esta página cubre la compatibilidad entre diferentes configuraciones y los productos y características de Datadog compatibles, ayudándote a elegir la mejor configuración para tus necesidades.

Configuraciones

Datadog admite varias configuraciones para utilizar OpenTelemetry. La principal diferencia entre estas configuraciones es la elección del SDK (OpenTelemetry o Datadog) y el colector utilizado para procesar y enviar datos de telemetría.

Compatibilidad de características

La siguiente tabla muestra la compatibilidad de características entre diferentes configuraciones:

Soporte de API

Los SDKs de Datadog proporcionan soporte para las APIs de OpenTelemetry Traces, Metrics y Logs en varios lenguajes. Encuentra tu lenguaje en la tabla a continuación para guías de configuración y detalles de soporte.

Más detalles

Observabilidad de LLM

Las trazas de OpenTelemetry que tienen atributos de IA generativa se convierten automáticamente en trazas de LLM Observability. Para deshabilitar esta conversión, consulte Deshabilitar la conversión de Observabilidad de LLM.

Métricas de tiempo de ejecución

• Configuraciones del SDK de Datadog: Emita Métricas de Tiempo de Ejecución utilizando DogStatsD (puerto UDP 8125). Asegúrese de que DogStatsD esté habilitado en su Agente de Datadog.
• Configuraciones del SDK de OpenTelemetry: Siga la especificación de Métricas de Tiempo de Ejecución de OpenTelemetry y generalmente se envían utilizando OTLP (puerto 4317/4318).

Monitoreo de Usuarios Reales (RUM)

Para habilitar la funcionalidad completa de RUM, necesita inyectar encabezados soportados para correlacionar RUM y trazas.

Monitoreo de Redes en la Nube (CNM)

El monitoreo a nivel de span o a nivel de endpoint no es compatible.

Para más información, consulte Configuración de Monitoreo de Redes en la Nube.

Integración de Código Fuente

Para lenguajes no soportados en configuraciones de OpenTelemetry, configure el etiquetado de telemetría para vincular datos a un commit específico.

Niveles de soporte

Datadog proporciona diferentes niveles de soporte para componentes y configuraciones de OpenTelemetry:

• Componentes Soportados por Datadog: Componentes de propiedad de Datadog como el Conector de Datadog, Exportador de Datadog y Procesador de Atributos de Infraestructura. Estos componentes son mantenidos por Datadog, reciben actualizaciones regulares y tienen prioridad para correcciones de errores y mejoras de características.

• Componentes Soportados por la Comunidad: Componentes de OpenTelemetry incluidos con el DDOT Collector por defecto. Datadog ayuda a garantizar que estos componentes sean seguros, estables y compatibles.

• Componentes personalizados: Componentes o configuraciones de OpenTelemetry que no están incluidos por defecto, como componentes de Collector personalizados o instrumentación de entornos no soportados. Datadog proporciona orientación y documentación como punto de partida, pero no apoya directamente la funcionalidad de estos componentes. Para problemas con componentes personalizados, interactúe con la comunidad de OpenTelemetry o con los mantenedores de los componentes.

Soporte de plataforma y entorno

Si bien el Collector de OpenTelemetry se puede implementar en muchos entornos, ciertas plataformas tienen limitaciones específicas o requisitos de soporte.

• AWS EKS Fargate: Este entorno no está actualmente soportado y resultará en una facturación incorrecta del servidor de infraestructura cuando se use con el OpenTelemetry Collector. Se planea soporte oficial para una futura versión. Consulte la guía de configuración del Collector para obtener la información más actualizada.

Mejores prácticas

Al usar Datadog y OpenTelemetry juntos, Datadog recomienda las siguientes mejores prácticas para garantizar un rendimiento óptimo y evitar problemas potenciales:

• Evite la instrumentación mixta: En la mayoría de los casos, no debe usar tanto un SDK de Datadog como un SDK de OpenTelemetry en la misma aplicación, ya que esto conduce a un comportamiento indefinido.
  • Excepción: El soporte para algunos lenguajes, como Python, requiere que tanto el SDK de Datadog como el SDK de OpenTelemetry estén instalados.
  • Siempre siga la documentación de instrumentación específica para cada lenguaje para asegurarse de que está utilizando la configuración correcta y soportada.
• Avoid Agent and separate Collector on same host: Evite el Datadog Agent y el OpenTelemetry Collector separado en el mismo servidor: No ejecute el Datadog Agent y un OpenTelemetry Collector separado en el mismo servidor, ya que esto puede causar problemas. Sin embargo, puede ejecutar Datadog Agents y OpenTelemetry Collectors en diferentes servidores dentro de la misma flota.

Lectura adicional

Más enlaces, artículos y documentación útiles:

Solución de problemas de OpenTelemetryDOCUMENTACIÓN