Información general

A partir de OpenTelemetry Collector Contrib módulos v0.129.0 y posteriores, la extensión de Datadog se incluye en distribuciones de contribución del recopilador de OpenTelemetry. También está disponible para compilaciones personalizadas del recopilador de OpenTelemetry.

La extensión de Datadog te permite visualizar la configuración del recopilador de OpenTelemetry y la información de compilación directamente en Datadog en la Lista de infraestructuras y Resource Catalog. Cuando se utiliza con Datadog Exporter, esta extensión te ofrece visibilidad de tu flota de recopiladores sin salir de la interfaz de usuario de Datadog.

Características principales

• Visibilidad de la configuración del recopilador: Visualiza la configuración completa de cualquier recopilador de tu infraestructura.
• Información de compilación: Consulta la versión del recopilador, los detalles de la compilación y la información de los componentes.
• Gestión de flotas: Monitoriza y gestiona tu flota de recopiladores de OpenTelemetry desde la interfaz de usuario de Datadog.
• Endpoint de inspección local: Utiliza un endpoint de HTTP para la depuración local y la verificación de la configuración.

Instalación

1. Añade la extensión de Datadog a la configuración del recopilador.

Configura la extensión de Datadog en tu archivo de configuración del recopilador de OpenTelemetry:

extensions:
  datadog:
    api:
      key: ${env:DD_API_KEY}
      site: 
    # hostname: "my-collector-host"  # Optional: must match Datadog Exporter hostname if set

service:
  extensions: [datadog]

2. Configura el exportador de Datadog

Esta función requiere que el exportador de Datadog esté configurado y activado en un pipeline activo (traces o metrics). La extensión utiliza la telemetría del exportador para asociar la configuración del recopilador con un host específico en Datadog.

exporters:
  datadog/exporter:
    api:
      key: ${env:DD_API_KEY}
      site: 
    # hostname: "my-collector-host"  # Optional: must match Datadog Extension hostname if set

3. Activa la extensión en la configuración de tu servicio

Añade la extensión de Datadog a tus extensiones de servicio:

service:
  extensions: [datadog]
  pipelines:
    traces:
      receivers: [otlp]
      processors: [batch]
      exporters: [datadog/exporter]
    metrics:
      receivers: [otlp]
      processors: [batch]
      exporters: [datadog/exporter]

Opciones de configuración

Ejemplo de configuración completa

extensions:
  datadog:
    api:
      key: ${env:DD_API_KEY}
      site: 
    hostname: "my-collector-host"
    http:
      endpoint: "localhost:9875"
      path: "/metadata"
    proxy_url: "http://proxy.example.com:8080"
    timeout: 30s
    tls:
      insecure_skip_verify: false

exporters:
  datadog/exporter:
    api:
      key: ${env:DD_API_KEY}
      site: 
    hostname: "my-collector-host"

service:
  extensions: [datadog]
  pipelines:
    traces:
      receivers: [otlp]
      processors: [batch]
      exporters: [datadog/exporter]
    metrics:
      receivers: [otlp]
      processors: [batch]
      exporters: [datadog/exporter]

Visualización de la configuración del recopilador

Una vez configurado, puedes visualizar la configuración del recopilador de OpenTelemetry y la información de compilación en dos ubicaciones:

Lista de infraestructuras (Lista de hosts)

1. Ve a Infraestructure > Hosts (Infraestructura > Hosts) en tu cuenta de Datadog.
2. Haz clic en cualquier host que ejecute el recopilador de OpenTelemetry (Nota: filtra por field:apps:OpenTelemetry para mostrar solo las instancias del recopilador).
3. En el panel de detalles del host, selecciona la pestaña OTel Collector (Recopilador de OpenTelemetry) para consultar la información de compilación y la configuración completa del recopilador.

Catálogo de recursos

1. Ve a Infrastructure > Resource Catalog (Infraestructura > Resource Catalog) en tu cuenta de Datadog
2. Filtra por hosts o busca tus instancias del recopilador.
3. Haz clic en cualquier host que ejecute el recopilador de OpenTelemetry.
4. Desplázate a Collector (Recopilador) para consultar la información de compilación y la configuración completa del recopilador.

Servidor HTTP local

La extensión de Datadog incluye un servidor HTTP local para depuración e inspección:

# Access collector metadata locally
curl http://localhost:9875/metadata

Este endpoint proporciona:

• Configuración del recopilador (sin información confidencial)
• Información sobre la compilación y detalles de la versión
• Lista de componentes activos
• Estado de la extensión

Solucionar problemas

La configuración no aparece en Datadog

1. Check la coincidencia de nombres de host: Asegúrate de que los nombres de host coincidan entre la extensión de Datadog y el exportador de Datadog.
2. Verificar la clave de API: Confirma que la clave de API sea válida y que tenga los permisos adecuados.
3. Check los logs del recopilador: Busca los logs de inicialización de la extensión y de envío de datos.
4. Confirmar que la extensión esté activada: Verifica que la extensión aparezca en la configuración del servicio.

Problemas con el servidor HTTP

1. Conflictos de puertos: Asegúrate de que el puerto 9875 esté disponible o configura un puerto diferente.
2. Acceso a la red: Verifica que el servidor HTTP esté accesible desde tu ubicación de depuración.
3. Check los logs: Revisa los logs de la extensión en busca de problemas de inicio del servidor HTTP.

Referencias adicionales

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

Configuración de OpenTelemetry CollectorDOCUMENTACIÓN Lista de infraestructurasDOCUMENTACIÓN Resource CatalogDOCUMENTACIÓN