Información general

Este check monitoriza InfiniBand a través del Datadog Agent.

Esta integración monitoriza las transferencias de datos mediante la recopilación de contadores y contadores de hardware RDMA del subsistema InfiniBand. Realiza un seguimiento de las métricas de rendimiento a través de la interfaz de InfiniBand del núcleo Linux, que proporciona contadores de métricas incluso cuando se utilizan transportes alternativos como RDMA sobre Ethernet convergente (RoCE).

Obtén visibilidad de tu infraestructura de red de alto rendimiento para ayudar a identificar cuellos de botella y problemas de rendimiento en cargas de trabajo con gran cantidad de datos. Al monitorizar tanto los contadores estándar de InfiniBand como los contadores de hardware RDMA, obtendrás información completa sobre el rendimiento de la red, los errores y las estadísticas de paquetes en todos tus dispositivos y puertos.

Las métricas clave recopiladas incluyen contadores de puertos como bytes/paquetes transmitidos y recibidos, recuento de errores y métricas específicas del hardware RDMA, lo que proporciona a los operadores los datos necesarios para garantizar un rendimiento óptimo de su infraestructura de red de alta velocidad.

Configuración

Sigue las instrucciones a continuación para instalar y configurar este check para un Agent que se ejecute en un host. El check recopila métricas leyendo y enviando contadores de forma predeterminada desde los directorios /sys/class/infiniband/<device>/ports/*/counters/ y /sys/class/infiniband/<device>/ports/*/hw_counters/. Para asegurarte de que esta integración funciona, debes garantizar que el Agent tiene los permisos adecuados para acceder y leer los contadores de estos directorios.

Instalación

El check de InfiniBand se incluye en el paquete del Datadog Agent. No es necesaria ninguna instalación adicional en tu servidor.

Configuración

1. Para empezar a recopilar tus datos de rendimiento de InfiniBand, crea y edita el archivo infiniband.d/conf.yaml, en la carpeta conf.d/ en la raíz de tu directorio de configuración del Agent. Consulta el infiniband.d/conf.yaml de ejemplo para conocer todas las opciones de configuración disponibles.

2. Este check funciona con una configuración mínima. Configura los parámetros opcionales, que se proporcionan para controlar mejor dónde busca el Agent los datos y qué datos recopilar si no se desean los comportamientos predeterminados. Las opciones incluyen configurar el directorio donde residen los contadores, excluir dispositivos/puertos específicos y omitir o añadir contadores para su recopilación.

init_config:
instances:
  -
    ## @param infiniband_path - string - optional - default: /sys/class/infiniband
    ## The path to the infiniband directory.
    #
    # infiniband_path: /sys/class/infiniband

    ## @param exclude_devices - list of strings - optional
    ## A list of devices to exclude from the check. Devices are located in the infiniband directory. 
    ## The devices are located by default in /sys/class/infiniband.
    #
    # exclude_devices:
    #   - mlx5_0
    #   - efa0
    #   - ib1

    ## @param additional_counters - list of strings - optional
    ## A list of additional counters to collect. The counter names are the files in which the counter 
    ## values are stored. These are located inside /sys/class/infiniband/devices/<device>/ports/<port>/counters.
    #
    # additional_counters:
    #   - additional_counter
    #   - rx_mpwqe_frag

    ## @param additional_hw_counters - list of strings - optional
    ## A list of additional hardware counters to collect. The counter names are the files in which the 
    ## counter values are stored. These are located inside 
    ## /sys/class/infiniband/devices/<device>/ports/<port>/hw_counters.
    #
    # additional_hw_counters:
    #   - additional_hw_counter
    #   - rx_mpwqe_frag

    ## @param exclude_counters - list of strings - optional
    ## A list of counters to exclude from the check.
    #
    # exclude_counters:
    #   - duplicate_request
    #   - lifespan

    ## @param exclude_hw_counters - list of strings - optional
    ## A list of hardware counters to exclude from the check.
    #
    # exclude_hw_counters:
    #   - VL15_dropped
    #   - link_downed

3. Reinicia el Agent.

Validación

Ejecuta el subcomando de estado del Agent y busca infiniband en la sección Checks.

Datos recopilados

Métricas

Eventos

La integración de InfiniBand no incluye ningún evento.

Checks de servicio

La integración de InfiniBand no incluye checks de servicio.

Solucionar problemas

¿Necesitas ayuda? Ponte en contacto con el soporte de Datadog.