Implementación del módulo univariante de Anomaly Detector en IoT Edge

  • Artículo

Importante

A partir del 20 de septiembre de 2023, no podrá crear nuevos recursos de Anomaly Detector. El servicio Anomaly Detector se retira el 1 de octubre de 2026.

Obtenga información sobre cómo implementar el módulo de servicios Azure AI Anomaly Detector en un dispositivo IoT Edge. Una vez que implementa el módulo en IoT Edge, se ejecuta en IoT Edge junto con otros módulos como instancias de contenedor. Expone exactamente las mismas API que una instancia de contenedor de Anomaly Detector que se ejecute en un entorno estándar de contenedor de Docker.

Requisitos previos

Creación de un recurso de Anomaly Detector

  1. Inicie sesión en Azure Portal.

  2. Haga clic en Creación de un recurso de Anomaly Detector.

  3. Establezca todas las opciones de configuración necesarias:

    Configuración Value
    Nombre Nombre que quiera (2-64 caracteres).
    Subscription Seleccione una suscripción adecuada.
    Location Seleccione cualquier ubicación disponible cercana.
    Nivel de precios F0: 10 llamadas por segundo, 20 000 transacciones al mes.
    O:
    S0: 80 llamadas por segundo.
    Grupo de recursos Seleccione un grupo de recursos disponible.

  4. Seleccione Crear y espere a que el recurso se cree. Una vez creado, vaya a la página de recursos.

  5. Recopile el elemento endpoint configurado y una clave de API:

    Pestaña de claves y punto de conexión en el portal Configuración Value
    Información general Punto de conexión Copie el punto de conexión. Tiene un aspecto similar a https://<your-resource-name>.cognitiveservices.azure.com/.
    Claves Clave de API Copie una de las dos claves. Es una cadena de 32 caracteres alfanuméricos sin espacios ni guiones, xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.

Implementación del módulo Anomaly Detector en el borde

  1. En Azure Portal, escriba Anomaly Detector en IoT Edge en la búsqueda y abra el resultado de Azure Marketplace.

  2. Le llevará a la página Dispositivos de destino para el módulo de IoT Edge de Azure Portal. Proporcione la siguiente información requerida:

    1. Seleccione su suscripción.

    2. Seleccione su instancia de IoT Hub.

    3. Seleccione Buscar dispositivo y busque un dispositivo IoT Edge.

  3. Seleccione el botón Crear.

  4. Seleccione el módulo AnomalyDetectoronIoTEdge.

    Image of IoT Edge Modules user interface with AnomalyDetectoronIoTEdge link highlighted with a red box to indicate that this is the item to select.

  5. Vaya a Variables de entorno e indique la siguiente información.

    1. Mantenga el valor accept para Eula.

    2. Rellene facturación con el punto de conexión de servicios de Azure AI.

    3. Rellene ApiKey con la clave de API de los servicios de Azure AI.

    Environment variables with red boxes around the areas that need values to be filled in for endpoint and API key

  6. Seleccione Update (Actualizar).

  7. Seleccione Siguiente: Rutas para definir la ruta. Especifique que todos los mensajes de todos los módulos vayan a Azure IoT Hub. Para obtener información sobre cómo declarar una ruta, consulte Establecimiento de rutas en IoT Edge.

  8. Seleccione Siguiente: Revisar y crear. Podemos obtener una vista previa del archivo JSON que define todos los módulos que se van a implementar en nuestro dispositivo IoT Edge.

  9. Seleccione Crear para iniciar la implementación de módulos.

  10. Una vez completada la implementación del módulo, volveremos a la página IoT Edge de nuestra instancia de IoT Hub. Seleccione el dispositivo en la lista de dispositivos IoT Edge para ver los detalles correspondientes.

  11. Desplácese hacia abajo y vea los módulos que aparecen. Compruebe que el estado de tiempo de ejecución esté en ejecución para el nuevo módulo.

Para solucionar los problemas de estado de tiempo de ejecución del dispositivo IoT Edge, consulte la guía de solución de problemas.

Prueba de Anomaly Detector en un dispositivo IoT Edge

Realizará una llamada HTTP al dispositivo Azure IoT Edge que tiene el contenedor de servicios Azure AI en ejecución. El contenedor proporciona API de punto de conexión basadas en REST. Use el host, http://<your-edge-device-ipaddress>:5000, para las API del módulo.

Como alternativa, puede crear un cliente de módulo utilizando la biblioteca de clientes de Anomaly Detector en el dispositivo Azure IoT Edge y después llamar al contenedor de servicios Azure AI en ejecución en el Edge. Use el punto de conexión de host http://<your-edge-device-ipaddress>:5000 y deje la clave de host vacía.

Si el dispositivo perimetral no permite ya la comunicación entrante en el puerto 5000, tendrá que crear una nueva regla de puerto de entrada.

En el caso de una VM de Azure, esto puede establecerse en Máquina virtual>Configuración>Redes>Regla de puerto de entrada>Agregar regla de puerto de entrada.

Hay varias maneras de validar que el módulo esté en ejecución. Busque la dirección IP externa y el puerto expuesto del dispositivo perimetral en cuestión y abra el explorador web que prefiera. Use las distintas direcciones URL de solicitud para validar que el contenedor se está ejecutando. Las direcciones URL de solicitud de ejemplo que se enumeran a continuación son http://<your-edge-device-ipaddress:5000, pero el contenedor específico puede variar. Tenga en cuenta que debe usar la dirección IP externa del dispositivo perimetral.

URL de la solicitud Propósito
http://<your-edge-device-ipaddress>:5000/ El contenedor proporciona una página principal.
http://<your-edge-device-ipaddress>:5000/status También se solicita con GET y comprueba si el valor de api-key usado para iniciar el contenedor es válido sin generar una consulta de punto de conexión. Esta solicitud se puede usar con los sondeos de ejecución y preparación de Kubernetes.
http://<your-edge-device-ipaddress>:5000/swagger El contenedor cuenta con un completo conjunto de documentación sobre los puntos de conexión y una característica de prueba. Esta característica le permite especificar la configuración en un formulario HTML basado en web y realizar la consulta sin necesidad de escribir código. Una vez que la consulta devuelve resultados, se proporciona un ejemplo del comando CURL para mostrar los encabezados HTTP y el formato de cuerpo requeridos.

Container's home page

Pasos siguientes