Tutorial: Creación de una regla y configuración de las notificaciones en la aplicación de Azure IoT Central

Puede usar Azure IoT Central para supervisar de forma remota los dispositivos conectados. Las reglas de Azure IoT Central le permiten supervisar los dispositivos casi en tiempo real e invocar acciones automáticamente, como el envío de correo electrónico. En este artículo se explica cómo crear reglas para supervisar los datos de telemetría enviados por el dispositivo.

Los dispositivos usan la telemetría para enviar datos numéricos. Cuando los datos de telemetría seleccionados superan un umbral especificado, se desencadena una regla.

En este tutorial se crea una regla que envía un correo electrónico cuando la temperatura de un dispositivo de sensor simulado supera los 70 °F.

En este tutorial, aprenderá a:

  • Crear una regla
  • Adición de una acción de correo electrónico

Requisitos previos

Para completar los pasos de este tutorial, necesitará lo siguiente:

Incorporación y personalización de una plantilla de dispositivo

Agregue una plantilla de dispositivo desde el catálogo de dispositivos. En este tutorial se usa la plantilla de dispositivo ESP32-Azure IoT Kit:

  1. Para agregar una nueva plantilla de dispositivo, seleccione + New (+ Nuevo) en la página Device templates (Plantillas de dispositivo).

  2. En la página Select type (Seleccionar tipo), desplácese hacia abajo hasta que encuentre el icono de ESP32-Azure IoT Kit en la sección Use a preconfigured device template (Usar una plantilla de dispositivo preconfigurada).

  3. Seleccione el icono ESP32-Azure IoT Kit y Next: Revisión.

  4. En la página Revisar, seleccione Crear.

El nombre de la plantilla que creó es Sensor Controller. El modelo incluye componentes como Sensor Controller, SensorTemp y Device Information interface (Interfaz de información del dispositivo). Los componentes definen las funcionalidades de un dispositivo ESP32, como la telemetría, las propiedades y los comandos.

Agregue dos propiedades de la nube a la plantilla de dispositivo Sensor Controller:

  1. Seleccione Cloud Properties (Propiedades de la nube) y, luego, + Add cloud property (+ Agregar propiedad de la nube). Use la información de la tabla siguiente para agregar dos propiedades de la nube a la plantilla de dispositivo:

    Display Name (Nombre para mostrar) Semantic Type (Tipo semántico) Schema
    Fecha de la última revisión None Date
    Nombre del cliente None String
  2. Haga clic en Guardar para guardar los cambios.

Agregue un nuevo formulario a la plantilla de dispositivo para administrar el dispositivo:

  1. Seleccione el nodo Views (Vistas) y, después, seleccione el icono Editing device and cloud data (Editar datos del dispositivo y de la nube) para agregar una vista.

  2. Cambie el nombre del formulario a Manage device (Administrar dispositivo).

  3. Seleccione las propiedades de la nube Customer Name (Nombre del cliente) y Last Service Date (Fecha de la última revisión), así como la propiedad Target Temperature (Temperatura objetivo). Después, seleccione Add section (Agregar sección).

  4. Seleccione Save (Guardar) para guardar la configuración.

Ahora publique la plantilla de dispositivo.

Crear una regla

Para crear una regla de telemetría, la plantilla de dispositivo debe incluir al menos un valor de telemetría. En este tutorial se usa un dispositivo Sensor Controller simulado que envía datos de telemetría de temperatura y humedad. La regla supervisa la temperatura notificada por el dispositivo y envía un correo electrónico cada vez que sube de 70 grados.

Nota

Hay un límite de 50 reglas por aplicación.

  1. En el panel izquierdo, seleccione Rules (Reglas).

  2. Si aún no ha creado ninguna regla, consulte la siguiente pantalla:

    Screenshot that shows the empty list of rules

  3. Seleccione + Nuevo para agregar una regla nueva.

  4. Escriba el nombre Temperature monitor para identificar la regla y presione Entrar.

  5. Seleccione la plantilla de dispositivo Sensor Controller. De forma predeterminada, la regla se aplica automáticamente a todos los dispositivos asociados con la plantilla de dispositivo. Para filtrar un subconjunto de los dispositivos, seleccione + Filter (+ Filtro) y use las propiedades de dispositivo para identificar los dispositivos. Para deshabilitar la regla, alterne el botón Habilitado/Deshabilitado:

    Screenshot that shows the selection of the device template in the rule definition

Configuración de las condiciones de la regla

Las condiciones definen los criterios que la regla supervisa. En este tutorial, configurará la regla para que se active cuando la temperatura supere los 70 °F.

  1. Seleccione Temperature (Temperatura) en la lista desplegable Telemetry (Telemetría).

  2. A continuación, elija Is greater than (Es mayor que) como Operator (Operador) y escriba 70 en Value (Valor).

    Screenshot that shows the temperature condition for the rule

  3. Opcionalmente, puede establecer un valor de Time aggregation (Agregación de tiempo). Al seleccionar una agregación de tiempo, también debe seleccionar un tipo de agregación, como la media o la suma, en la lista desplegable de agregación.

    • Sin la agregación, la regla se desencadena para cada punto de datos de telemetría que cumple la condición. Por ejemplo, si configura la regla para desencadenarse cuando la temperatura está por encima de 70, la regla se desencadena casi al instante cuando la temperatura del dispositivo supere este valor.
    • Con la agregación, la regla se desencadena si el valor agregado de los puntos de datos de telemetría de la ventana de tiempo cumple la condición. Por ejemplo, si configura la regla para desencadenarse cuando la temperatura sea superior a 70 con una agregación de tiempo media de 10 minutos, la regla se desencadena cuando el dispositivo informa de una temperatura media por encima de 70, calculada a lo largo de un intervalo de 10 minutos.

    Screenshot that shows the aggregate condition filled out

Puede agregar varias condiciones a una regla seleccionando + Condition (+ Condición). Cuando se agregan varias condiciones, puede especificar si se deben cumplir todas las condiciones o solo alguna para que se desencadene la regla. Si usa la agregación de tiempo con varias condiciones, se deben agregar todos los valores de telemetría.

Configuración de acciones

Después de definir la condición, configure las acciones que deben llevarse a cabo cuando se desencadene la regla. Las acciones se invocan cuando todas las condiciones especificadas en la regla se evalúan como verdaderas.

  1. Seleccione + Email (+ Correo electrónico) en la sección Actions (Acciones).

  2. Escriba Advertencia de temperatura como nombre para mostrar de la acción, la dirección de correo electrónico en el campo Para y Debe comprobar el dispositivo como la nota que va a aparecer en el cuerpo del correo electrónico.

    Nota

    Solo se envían mensajes de correo electrónico a los usuarios que se han agregado a la aplicación y han iniciado sesión al menos una vez. Obtenga más información sobre la administración de usuarios en Azure IoT Central.

    Screenshot that shows the email action for the rule

  3. Para guardar la acción, elija Listo. Puede agregar varias acciones a una regla.

  4. Para guardar la regla, elija Guardar. La regla está activa en unos minutos e inicia la supervisión de telemetría que se envía a la aplicación. Cuando se cumple la condición especificada en la regla, la regla desencadena la acción de correo electrónico configurada.

Después de un tiempo, recibirá un mensaje de correo electrónico cuando se desencadene la regla:

Screenshot that shows notification email

Eliminar una regla

Si ya no necesita una regla, elimínela; para ello, abra la regla y seleccione Eliminar.

Habilitación o deshabilitación de una regla

Elija la regla que quiere habilitar o deshabilitar. Alterne el botón Habilitado/Deshabilitado en la regla para habilitar o deshabilitar la regla para todos los dispositivos que tengan el ámbito de esta.

Habilitación o deshabilitación de una regla para dispositivo específicos

Elija la regla que quiere personalizar. Use uno o varios filtros de la sección Dispositivos de destino para restringir el ámbito de la regla a los dispositivos que desea supervisar.

Limpieza de recursos

Si no tiene previsto realizar otro inicios rápidos o tutoriales de IoT Central, puede eliminar la aplicación de IoT Central:

  1. En la aplicación de IoT Central, vaya a Aplicación Administración.
  2. Seleccione Delete (Eliminar) y confirme la acción.

Pasos siguientes

En este tutorial, ha aprendido a:

  • Crear una regla basada en la telemetría
  • Agregar una acción

Ahora que ha definido una regla basada en umbral, el siguiente paso que se recomienda dar es: