Tutoriel : Créer une règle et configurer des notifications dans votre application Azure IoT Central
Dans ce tutoriel, vous allez apprendre à utiliser Azure IoT Central pour surveiller à distance vos appareils connectés. Les règles Azure IoT Central vous permettent de superviser vos appareils quasiment en temps réel et d’appeler automatiquement des actions, comme l’envoi d’un e-mail. Cet article explique comment créer des règles pour superviser la télémétrie envoyée par vos appareils.
Les appareils utilisent la télémétrie pour envoyer des données numériques. Une règle se déclenche quand la télémétrie sélectionnée dépasse un seuil spécifique.
Dans ce tutoriel, vous allez apprendre à :
- Créez une règle qui se déclenche lorsque la température de l’appareil atteint 70° F.
- Ajoutez une action par e-mail pour vous avertir lorsque la règle se déclenche.
Prérequis
Pour suivre les étapes de ce tutoriel, vous devez disposer des éléments suivants :
Un abonnement Azure actif. Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.
Application IoT Central créée à partir du modèle Application personnalisée. Pour plus d’informations, consultez Créer une application IoT Central et À propos de votre application.
Ajouter et personnaliser un modèle d’appareil
Ajoutez un modèle d’appareil à partir du catalogue d’appareils. Ce tutoriel utilise le modèle d’appareil Onset Hobo MX-100 Temp Sensor :
Pour ajouter un nouveau modèle d’appareil, sélectionnez + Nouveau dans la page Modèles d’appareil.
Dans la page Sélectionner le type, faites défiler vers le bas de l’écran jusqu’à ce que vous trouviez la mosaïque Onset Hobo MX-100 Temp Sensor dans la section Modèles d’appareil proposés.
Sélectionnez la mosaïque Onset Hobo MX-100 Temp Sensor, puis Suivant : vérifier.
Dans la page Vérifier, sélectionnez Créer.
Le nom du modèle créé est Hobo MX-100. Le modèle comprend des composants tels que Hobo MX-100 et IotDevice. Les composants définissent les fonctionnalités d’un appareil ESP32, Ces capacités peuvent comprendre la télémétrie, les propriétés et les commandes.
Utiliser un appareil simulé
Pour tester la règle que vous créez dans la section suivante, ajoutez un appareil simulé à votre application :
Sélectionnez Appareils dans le panneau de navigation de gauche. Sélectionnez ensuite Hobo MX-100.
Sélectionnez +Nouveau. Dans le panneau Créer un appareil, conservez les valeurs par défaut pour le nom de l’appareil et l’ID d’appareil. Configurez Voulez-vous simuler cet appareil ? sur Oui.
Sélectionnez Créer.
Créer une règle
Pour créer une règle de télémétrie, le modèle d’appareil doit contenir au moins une valeur de télémétrie. Ce tutoriel utilise un appareil Hobo MX-100 simulé qui envoie la télémétrie relative à la température. La règle surveille la température signalée par l’appareil et envoie un e-mail quand elle dépasse 70 degrés.
Notes
Il existe une limite de 50 règles par application.
Dans le volet gauche, sélectionnez Règles.
Sélectionnez + Nouveau pour ajouter une nouvelle règle.
Entrez le nom Supervision de la température pour identifier la règle, puis appuyez sur Entrée.
Sélectionnez le modèle d’appareil Hobo MX-100. Par défaut, la règle est automatiquement appliquée à tous les appareils affectés au modèle d’appareil :
Pour filtrer une partie des appareils, sélectionnez + Filtre, puis utilisez les propriétés nécessaires pour identifier les appareils. Pour désactiver la règle, servez-vous du bouton Activé/Désactivé.
Configurer les conditions de la règle
Les conditions définissent les critères de supervision de la règle. Dans ce tutoriel, vous configurez la règle pour qu’elle se déclenche quand la température dépasse 70° F (environ 21° C).
Sélectionnez Température dans le menu déroulant Télémétrie.
Choisissez ensuite Est supérieur à pour Opérateur, puis entrez 70 comme Valeur :
Vous pouvez éventuellement définir une Agrégation de temps. Quand vous sélectionnez une agrégation de temps, vous devez également sélectionner un type d’agrégation, par exemple une moyenne ou une somme, dans la liste déroulante d’agrégation.
- Sans agrégation, la règle se déclenche pour chaque point de données de télémétrie qui répond à la condition. Par exemple, si vous configurez la règle pour se déclencher quand la température dépasse 70, elle se déclenche presque instantanément quand la température de l’appareil dépasse cette valeur.
- Avec l’agrégation, la règle se déclenche si la valeur agrégée des points de données de télémétrie de la fenêtre de temps répond à la condition. Par exemple, si vous configurez la règle pour se déclencher quand la température dépasse 70 et avec une agrégation de temps moyenne de 10 minutes, la règle se déclenche quand l’appareil signale une température moyenne supérieure à 70 calculée sur un intervalle de 10 minutes.
Vous pouvez ajouter plusieurs conditions à une règle en sélectionnant + Condition. Lorsque plusieurs conditions sont ajoutées, vous pouvez spécifier si toutes les conditions doivent être remplies ou si l’une des conditions doit être remplie pour que la règle soit déclenchée. Si vous utilisez une agrégation de temps avec plusieurs conditions, toutes les valeurs de télémétrie doivent être agrégées.
Configurer les actions
Une fois que vous avez défini la condition, vous configurez les actions à entreprendre quand la règle se déclenche. Les actions sont appelées quand toutes les conditions spécifiées dans la règle ont la valeur true.
Sélectionnez + E-mail dans la section Actions.
Entrez Avertissement de température pour le nom d’affichage de l’action, votre adresse e-mail dans le champ À, puis Vous devez vérifier l’appareil ! comme note à afficher dans le corps de votre e-mail.
Notes
Les e-mails sont envoyés seulement aux utilisateurs qui ont été ajoutés à l’application et qui se sont connectés au moins une fois. Découvrez plus en détail la gestion des utilisateurs dans Azure IoT Central.
Pour enregistrer l'action, choisissez Terminé. Vous pouvez ajouter plusieurs actions à une règle.
Pour enregistrer la règle, choisissez Enregistrer. La règle est active au bout de quelques minutes et commence à surveiller la télémétrie envoyée à votre application. Quand la condition spécifiée dans la règle est remplie, cette dernière déclenche l’action d’envoi d’e-mail configurée.
Après un certain temps, vous recevez un e-mail quand la règle se déclenche :
Supprimer une règle
Si vous n’avez plus besoin d’une règle, supprimez-la en ouvrant la règle et en choisissant Supprimer.
Activer ou désactiver une règle
Choisissez la règle que vous voulez activer ou désactiver. Activez ou désactivez le bouton Activé/désactivé de la règle afin de l’activer ou de la désactiver pour tous les appareils délimités dans la règle.
Activer ou désactiver une règle pour des appareils spécifiques
Choisissez la règle à personnaliser. Utilisez un ou plusieurs filtres dans la section Appareils cibles pour limiter l’étendue de la règle aux appareils à superviser.
Nettoyer les ressources
Si vous ne prévoyez pas de suivre d’autres guides de démarrage rapide ou tutoriels IoT Central, vous pouvez supprimer votre application IoT Central :
- Dans votre application IoT Central, accédez à Application > Gestion.
- Sélectionnez Supprimer, puis confirmez l’opération.
Étape suivante
Une fois que vous avez défini une règle basée sur un seuil, l’étape suivante suggérée consiste à apprendre à :