Información general

Azure IoT Edge es un servicio totalmente gestionado para desplegar cargas de trabajo en la nube que se ejecuten en dispositivos Edge de Internet de las Cosas (IoT) utilizando contenedores estándar.

Utiliza la integración de Datadog y Azure IoT Edge para recopilar métricas y el estado de los dispositivos IoT Edge.

Nota: Este integración requiere un tiempo de ejecución de IoT Edge versión 1.0.10 o superior.

Configuración

Sigue las instrucciones siguientes para instalar y configurar este check para un dispositivo IoT Edge que se ejecuta en un host de dispositivo.

Instalación

El check de Azure IoT Edge se incluye en el paquete del Datadog Agent.

No es necesaria ninguna instalación adicional en tu dispositivo.

Configuración

Configura el dispositivo Edge de IoT para que el Agent se ejecute como un módulo personalizado. Sigue la documentación de Microsoft sobre implementación de módulos de Azure IoT Edge para obtener información sobre cómo instalar y trabajar con módulos personalizados para Azure IoT Edge.

Sigue los pasos que se indican a continuación para configurar el dispositivo de IoT Edge, los módulos del tiempo de ejecución y el Datadog Agent para empezar a recopilar métricas de IoT Edge.

1. Configura el módulo del tiempo de ejecución de Edge Agent de la siguiente manera:

   • La versión de la imagen debe ser 1.0.10 o superior.

   • En “Create Options” (Crear opciones), añade las siguientes Labels. Edita la etiqueta com.datadoghq.ad.instances según proceda. Consulta el azure_iot_edge.d/conf.yaml de ejemplo para conocer todas las opciones de configuración disponibles. Consulta la documentación sobre Autodiscovery de integraciones de Docker para obtener más información sobre la configuración de la integración basada en etiquetas.

     "Labels": {
         "com.datadoghq.ad.check_names": "[\"azure_iot_edge\"]",
         "com.datadoghq.ad.init_configs": "[{}]",
         "com.datadoghq.ad.instances": "[{\"edge_hub_prometheus_url\": \"http://edgeHub:9600/metrics\", \"edge_agent_prometheus_url\": \"http://edgeAgent:9600/metrics\"}]"
     }
     

2. Configura el módulo del tiempo de ejecución de Edge Hub de la siguiente manera:

   • La versión de la imagen debe ser 1.0.10 o superior.

3. Instala y configura el Datadog Agent como módulo personalizado:

   • Configura el nombre del módulo. Por ejemplo: datadog-agent.

   • Configura la URL de la imagen del Agent. Por ejemplo: datadog/agent:7.

   • En “Variables de entorno”, configura tu DD_API_KEY. También puedes establecer aquí una configuración adicional del Agent (consulta Variables de entorno del Agent).

   • En “Opciones para crear el contenedor”, introduce la siguiente configuración en función del sistema operativo de tu dispositivo. Nota: NetworkId debe corresponder al nombre de la red configurado en el archivo config.yaml del dispositivo.

     • Linux:

       {
           "HostConfig": {
               "NetworkMode": "default",
               "Env": ["NetworkId=azure-iot-edge"],
               "Binds": ["/var/run/docker.sock:/var/run/docker.sock"]
           }
       }
       

     • Windows:

       {
           "HostConfig": {
               "NetworkMode": "default",
               "Env": ["NetworkId=nat"],
               "Binds": ["//./pipe/iotedge_moby_engine:/./pipe/docker_engine"]
           }
       }
       

   • Guarda el módulo personalizado del Datadog Agent.

4. Guarda e implementa los cambios en la configuración de tu dispositivo.

Recopilación de logs

1. La recopilación de logs está desactivada de forma predeterminada en el Datadog Agent, actívala configurando tu módulo personalizado del Datadog Agent:

   • En “Variables de entorno”, configura la variable de entorno DD_LOGS_ENABLED:

     DD_LOGS_ENABLED: true
     

2. Configura los módulos de Edge Agent y Edge Hub: en “Crear opciones”, añade la siguiente etiqueta:

   "Labels": {
       "com.datadoghq.ad.logs": "[{\"source\": \"azure.iot_edge\", \"service\": \"<SERVICE>\"}]",
       "...": "..."
   }
   

   Cambia el service en función de tu entorno.

   Repite esta operación para cualquier módulo personalizado para el que desees recopilar logs.

3. Guarda e implementa los cambios en la configuración de tu dispositivo.

Validación

Una vez que el Agent se haya desplegado en el dispositivo, ejecuta el subcomando de estado del Agent y busca azure_iot_edge en la sección Checks.

Datos recopilados

Métricas

Eventos

Azure IoT Edge no incluye ningún evento.

Checks de servicio

azure.iot_edge.edge_agent.prometheus.health

Devuelve CRITICAL si el Agent no puede llegar al endpoint de Prometheus de métricas de Edge Agent. En caso contrario, devuelve OK.

Estados: ok, critical

azure.iot_edge.edge_hub.prometheus.health

Devuelve CRITICAL si el Agent no puede llegar al endpoint de Prometheus de métricas de Edge Hub. En caso contrario, devuelve OK.

Estados: ok, critical

Solucionar problemas

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

Referencias adicionales

• Monitoriza Azure IoT Edge con Datadog