Asignación de las convenciones semánticas de OpenTelemetry a información de host de la lista de infraestructura

Esta función está en fase beta. Si tienes algún comentario, ponte en contacto con el servicio de soporte de Datadog.

Información general

El exportador de Datadog admite el envío de información del sistema sobre tus hosts a Datadog, que puedes ver en la lista de infraestructura. Puedes enviar esta información en OTLP a través del campo ‘Resource’ como parte de cualquiera de las señales existentes. Esto es compatible con cualquier patrón de despliegue incluidos despliegues de gateway.

Datadog utiliza convenciones semánticas de OpenTelemetry para reconocer la información del sistema sobre tus hosts. Sigue las instrucciones de configuración para métricas de host para enviar los atributos necesarios de métricas y recursos a Datadog. También puedes enviar manualmente esta información de la forma que mejor se adapte a tu infraestructura.

Elección de la función

Para elegir la función beta pública, establece el atributo de recurso datadog.host.use_as_metadata en true en todas las cargas útiles OTLP que contengan información sobre hosts.

Los recursos rellenan la información de la lista de infraestructura si tienen un atributo que identifica hosts y el atributo datadog.host.use_as_metadata establecido en true.

Para declarar explícitamente qué recursos utilizar para los metadatos, añade el atributo de recurso booleano datadog.host.use_as_metadata a todos los recursos que tengan información relevante de host.

Por ejemplo, para establecer esto para todos los recursos en métricas, trazas (traces) y logs, utiliza el procesador de transformación con la siguiente configuración:

processors:
  transform:
    metric_statements:
      - context: resource
        statements:
          - set(attributes["datadog.host.use_as_metadata"], true)
    trace_statements:
      - context: resource
        statements:
          - set(attributes["datadog.host.use_as_metadata"], true)
    log_statements:
      - context: resource
        statements:
          - set(attributes["datadog.host.use_as_metadata"], true)

Añade este procesador a la lista processors de todos tus pipelines.

Debes etiquetar explícitamente todos tus recursos con un atributo que identifica hosts. Esto lo hace por defecto la configuración recomendada para métricas de host.

Convenciones admitidas

El exportador de Datadog admite tanto convenciones semánticas de recurso a nivel de atributo como convenciones semánticas de sistema a nivel de métricas. Las convenciones semánticas de atributos de recursos compatibles se encuentran principalmente en el espacio de nombres host. y el espacio de nombres os.. Todas las convenciones semánticas de sistema a nivel de métricas compatibles están en el espacio de nombres system..

Convenciones generales del sistema

Convención semánticaTipoCampo en la aplicación
Varios atributos que identifican hostsAtributo de recursoNombre de host
os.descriptionAtributo de recursoSistema operativo

Convenciones de la CPU

Convención semánticaTipoCampo en la aplicación
host.cpu.vendor.idAtributo de recursoID de proveedor
host.cpu.model.nameAtributo de recursoNombre del modelo
host.cpu.cache.l2.sizeAtributo de recursoTamaño de la caché
host.cpu.familyAtributo de recursoFamilia
host.cpu.model.idAtributo de recursoModelo
host.cpu.steppingAtributo de recursoPasos
system.cpu.logical.countMétrica del sistemaProcesadores lógicos
system.cpu.physical.countMétrica del sistemaNúcleos
system.cpu.frequencyMétrica del sistemaMHz

Convenciones de red

Convención semánticaTipoCampo en la aplicación
host.ipAtributo de recursoDirección IP y dirección IPv6
host.macAtributo de recursoDirección Mac

Recopilación de estas convenciones con el OpenTelemetry Collector

Para recopilar estas convenciones con el OpenTelemetry Collector, usa la configuración recomendada para métricas de host. El receptor de métricas de host recopila todas las métricas, mientras que el procesador de detección de recursos recopila todos los atributos relevantes de los recursos.

Nota: Es necesario añadir estos procesadores y receptores en el Collector que se ejecuta en el host que deseas monitorizar. Un host de gateway no recopila esta información de hosts remotos.

Referencias adicionales

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