Zelfstudie: Een regel maken en meldingen instellen in uw Azure IoT Central-toepassing
U kunt Azure IoT Central gebruiken om uw verbonden apparaten op afstand te bewaken. Met Azure IoT Central-regels kunt u uw apparaten bijna in realtime bewaken en automatisch acties aanroepen, zoals het verzenden van een e-mailbericht. In dit artikel wordt uitgelegd hoe u regels kunt maken voor het bewaken van de telemetrie die uw apparaten verzenden.
Apparaten gebruiken telemetrie om numerieke gegevens van het apparaat te verzenden. Een regel wordt geactiveerd wanneer de geselecteerde telemetrie een opgegeven drempel overschrijdt.
In deze zelfstudie maakt u een regel voor het verzenden van een e-mailbericht wanneer de temperatuur in een gesimuleerd sensorapparaat hoger is dan 70 °C.
In deze zelfstudie leert u het volgende:
- Een regel maken
- Een e-mailactie maken
Vereisten
Voor het voltooien van de stappen in deze zelfstudie hebt u het volgende nodig:
Een actief Azure-abonnement. Als u nog geen abonnement op Azure hebt, maak dan een gratis account aan voordat u begint.
Een V3-IoT Central gemaakt op basis van de sjabloon Aangepaste toepassing. Zie Create an IoT Central application (Een toepassing IoT Central maken) en About your application (Over uw toepassing) voor meer informatie.
Een apparaatsjabloon toevoegen en aanpassen
Voeg een apparaatsjabloon toe uit de apparaatcatalogus. In deze zelfstudie wordt gebruikgemaakt van de apparaatsjabloon ESP32-Azure IoT Kit:
Selecteer + Nieuw op de pagina Apparaatsjablonen om een nieuwe apparaatsjabloon toe te voegen.
Schuif op de pagina Type selecteren omlaag totdat u de tegel ESP32-Azure IoT Kit vindt in de sectie Een vooraf geconfigureerde apparaatsjabloon gebruiken.
Selecteer de tegel ESP32-Azure IoT Kit en selecteer vervolgens Volgende: Review.
Selecteer op de pagina Beoordelen de optie Maken.
De naam van de sjabloon die u hebt gemaakt, is Sensorcontroller. Het model bevat onderdelen als Sensorcontroller, SensorTemp en Apparaatgegevens-interface. Onderdelen definiëren de mogelijkheden van een ESP32-apparaat. Mogelijkheden zijn bijvoorbeeld de telemetrie, eigenschappen en opdrachten.
Voeg twee cloudeigenschappen toe aan de apparaatsjabloon Sensorcontroller:
Selecteer Cloudeigenschappen en klik vervolgens op + Cloudeigenschap toevoegen. Gebruik de informatie in de volgende tabel om twee cloudeigenschappen toe te voegen aan uw apparaatsjabloon:
Weergavenaam Semantisch type Schema Laatste servicedatum Geen Date Naam van klant Geen Tekenreeks Selecteer Opslaan om uw wijzigingen op te slaan.
Voeg een nieuw formulier toe aan de apparaatsjabloon om het apparaat te beheren:
Selecteer het knooppunt Weergaven en vervolgens de tegel Apparaat- en cloudgegevens bewerken om een nieuwe weergave toe te voegen.
Wijzig de naam van het formulier in Apparaat beheren.
Selecteer de cloudeigenschappen Klantnaam en Laatste servicedatum en de eigenschap Doeltemperatuur. Selecteer vervolgens Sectie toevoegen.
Selecteer Opslaan om uw nieuwe formulier op te slaan.
Publiceer nu de apparaatsjabloon.
Een regel maken
Voor het maken van een telemetrieregel moet de apparaatsjabloon ten minste één telemetriewaarde bevatten. Deze zelfstudie maakt gebruik van een gesimuleerd Sensor Controller-apparaat dat de telemetrie van de temperatuur en de vochtigheid verzendt. De regel controleert de door het apparaat gemelde temperatuur en verzendt een e-mailbericht wanneer deze hoger wordt dan 70 graden.
Notitie
Er geldt een limiet van 50 regels per toepassing.
Selecteer in het linkerdeelvenster de optie Regels.
Als u nog geen regels hebt gemaakt, ziet u het volgende scherm:
Selecteer + Nieuw om een nieuwe regel toe te voegen.
Voer Temperatuurmonitor in als naam voor de regel en druk op Enter.
Selecteer het apparaatsjabloon Sensor Controller. De regel wordt standaard automatisch toegepast op alle apparaten die aan de apparaatsjabloon zijn gekoppeld. Als u wilt filteren op een subset van apparaten, selecteert u + Filter en gebruikt u apparaateigenschappen om de apparaten te identificeren. U kunt de regel uitschakelen met de knop In-/uitschakelen:
De regelvoorwaarden configureren
Voorwaarden vormen de criteria die met de regel worden gecontroleerd. In deze zelfstudie configureert u de regel die moet worden geactiveerd wanneer de temperatuur hoger is dan 70 °C.
Selecteer Temperatuur in de vervolgkeuzelijst Telemetrie.
Kies vervolgens Is groter dan als operator en voer 70 in als waarde.
U kunt desgewenst een tijdaggregatie instellen. Wanneer u een tijdaggregatie selecteert, moet u ook een aggregatietype, zoals gemiddelde of som, selecteren in de vervolgkeuzelijst Aggregatie.
- Zonder aggregatie wordt de regel geactiveerd voor elk telemetriegegevenspunt dat voldoet aan de voorwaarde. Als u bijvoorbeeld de regel zodanig configureert dat deze wordt geactiveerd wanneer de temperatuur hoger is dan 70 graden, wordt de regel bijna onmiddellijk geactiveerd wanneer de temperatuur van het apparaat deze waarde overschrijdt.
- Met aggregatie wordt de regel geactiveerd als de aggregatiewaarde van de telemetriegegevenspunten in het tijdvenster voldoet aan de voorwaarde. Als u bijvoorbeeld de regel zodanig configureert dat deze wordt geactiveerd wanneer de temperatuur hoger is dan 70 graden met een gemiddelde tijdaggregatie van 10 minuten, wordt de regel geactiveerd wanneer het apparaat een gemiddelde temperatuur van meer dan 70 graden rapporteert, berekend over een interval van 10 minuten.
U kunt meerdere voorwaarden aan een regel toevoegen door + Voorwaarde te selecteren. Wanneer er meerdere voorwaarden worden toegevoegd, kunt u opgeven of aan alle voorwaarden moet worden voldaan of dat aan een van de voorwaarden moet worden voldaan om de regel te activeren. Als u tijdaggregatie met meerdere voorwaarden gebruikt, moeten alle telemetriewaarden worden geaggregeerd.
Acties configureren
Nadat u de voorwaarde hebt gedefinieerd, stelt u de acties in die moeten worden uitgevoerd wanneer de regel wordt geactiveerd. Acties worden aangeroepen wanneer de voorwaarden die in de regel zijn opgegeven, worden geëvalueerd als waar.
Selecteer + E-mail in de sectie Acties.
Voer Temperatuurwaarschuwing in als weergavenaam voor de actie, uw e-mailadres in het veld Naar en Controleer het apparaat! als opmerking die moet worden weergegeven in de hoofdtekst van het e-mailbericht.
Notitie
E-mailberichten worden alleen verzonden naar gebruikers die zijn toegevoegd aan de toepassing en zich ten minste één keer hebben aangemeld. Meer informatie over gebruikersbeheer in Azure IoT Central.
Als u de actie wilt opslaan, kiest u Gereed. U kunt meerdere acties toevoegen aan een regel.
Als u de regel wilt opslaan, kiest u Opslaan. De regel wordt binnen enkele minuten van kracht en begint met de bewaking van de telemetrische gegevens die naar uw toepassing worden verzonden. Wanneer aan de voorwaarde die in de regel is opgegeven, wordt voldaan, wordt de geconfigureerde e-mailactie door de regel geactiveerd.
Enige tijd nadat de regel is geactiveerd, ontvangt u een e-mailbericht:
Een regel verwijderen
Als u een regel niet meer nodig hebt, kunt u deze verwijderen door de regel te openen en Verwijderen te kiezen.
Een regel in- of uitschakelen
Kies de regel die u wilt in- of uitschakelen. Gebruik de knop In- of uitschakelen om de regel in of uit te schakelen voor alle apparaten waarop de regel van toepassing is.
Een regel voor specifieke apparaten in- of uitschakelen
Kies de regel die u wilt aanpassen. Gebruik een of meer filters in de sectie Doelapparaten om het bereik van de regel te beperken tot de apparaten die u wilt bewaken.
Resources opschonen
Als u geen verdere IoT Central Snelstartgids of zelf studies wilt volt ooien, kunt u uw IoT Central toepassing verwijderen:
- Ga in uw IoT Central-toepassing naar beheer > uw toepassing.
- Selecteer verwijderen en bevestig vervolgens uw actie.
Volgende stappen
In deze zelfstudie heeft u het volgende geleerd:
- Een regel op basis van telemetrie maken
- Een actie toevoegen
Nu u een regel op basis van drempelwaarden hebt gedefinieerd, is dit de voorgestelde volgende stap: