Información general

Azure IoT Edge es un servicio totalmente gestionado servicio que permite implementar cargas de trabajo en la nube para 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 IoT Edge de modo 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 “Crear opciones”, añade las siguientes Labels. Edita la etiqueta com.datadoghq.ad.instances según proceda. Consulta el ejemplo de azure_iot_edge.d/conf.yaml para ver todas las opciones disponibles de configuración. Consulta la documentación sobre Autodiscovery de integraciones de Docker para obtener más información sobre la configuración de 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 configurar 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 Agent se haya implementado 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
Returns CRITICAL if the Agent is unable to reach the Edge Agent metrics Prometheus endpoint. Returns OK otherwise.
Statuses: ok, critical

azure.iot_edge.edge_hub.prometheus.health
Returns CRITICAL if the Agent is unable to reach the Edge Hub metrics Prometheus endpoint. Returns OK otherwise.
Statuses: ok, critical

Solucionar problemas

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

Referencias adicionales

• Monitoriza Azure IoT Edge con Datadog