Självstudie: Skicka e-postmeddelanden om Azure IoT Hub-händelser med Event Grid och Logic Apps

Artikel
05/13/2021
7 minuter för att läsa

Med Azure Event Grid kan du reagera på händelser i IoT Hub genom att utlösa åtgärder i underordnade företagsprogram.

Den här artikeln beskriver en exempel konfiguration som använder IoT Hub och Event Grid. I slutet har du konfigurerat en Azure Logic app som skickar ett e-postmeddelande varje gång en enhet ansluts eller kopplas till din IoT-hubb. Event Grid kan användas för att få aviseringar i tid om att kritiska enheter kopplas från. Mått och diagnostik kan ta flera (t. ex. 20 eller mer – men vi vill inte placera ett tal på det) minuter att visa i loggar/varningar. Detta kan vara oacceptabelt för kritisk infrastruktur.

Om du inte har en Azure-prenumerationkan du skapa ett kostnads fritt konto innan du börjar.

Förutsättningar

Ett e-postkonto från valfri e-postleverantör som stöds av Azure Logic Apps, till exempel Office 365 Outlook eller Outlook.com. Det här e-postkontot används för att skicka händelsemeddelandena.

Använd bash-miljön i Azure Cloud Shell.
Om du vill kan du i stället installera Azure CLI för att köra CLI-referenskommandon.
- Om du använder en lokal installation loggar du in på Azure CLI med hjälp av kommandot az login. Slutför autentiseringsprocessen genom att följa stegen som visas i terminalen. Fler inloggningsalternativ finns i Logga in med Azure CLI.
- När du uppmanas till det installerar du Azure CLI-tillägg vid första användning. Mer information om tillägg finns i Använda tillägg med Azure CLI.
- Kör az version om du vill hitta versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.

Skapa en IoT Hub

Du kan snabbt skapa en ny IoT-hubb med hjälp av Azure Cloud Shell terminalen i portalen.

Logga in på Azure-portalen.
I det övre högra hörnet på sidan väljer du knappen Cloud Shell.

Kör följande kommando för att skapa en ny resursgrupp:

az group create --name {your resource group name} --location westus

Kör följande kommando för att skapa en IoT-hubb:

az iot hub create --name {your iot hub name} --resource-group {your resource group name} --sku S1

Minimera Cloud Shell terminalen. Du kommer tillbaka till gränssnittet senare i självstudien.

Skapa en logikapp

Skapa sedan en Logic app och Lägg till en HTTP Event Grid-utlösare som bearbetar begär Anden från IoT Hub.

Skapa en resurs för en logikapp

I Azure Portalväljer du skapa en resurs och skriver sedan "Logic app" i sökrutan och väljer RETUR. Välj Logic app från resultaten.
På nästa skärm väljer du skapa.
Ge logikappen ett namn som är unikt i din prenumeration och välj sedan samma prenumeration, resursgrupp och plats som din IoT-hubb.
Välj Granska + skapa.
Verifiera inställningarna och välj sedan skapa.
När resursen har skapats väljer du gå till resurs.
I Logic Apps designer går du nedåt för att se mallarna. Välj Tom Logic app så att du kan bygga din Logic app från grunden.

Välj en utlösare

En utlösare är en specifik händelse som startar din logikapp. I den här självstudien tar utlösaren som utlöser arbetsflödet emot en begäran via HTTP.

Skriv HTTP i sökfältet för anslutningsprogram och utlösare.
Bläddra igenom resultaten och välj begäran – när en HTTP-begäran tas emot som utlösare.
Välj Generera schemat genom att använda en exempelnyttolast.

Klistra in den anslutna händelse schema -JSON i text rutan och välj sedan färdig:

  [{  
   "id": "f6bbf8f4-d365-520d-a878-17bf7238abd8",
   "topic": "/SUBSCRIPTIONS/<subscription ID>/RESOURCEGROUPS/<resource group name>/PROVIDERS/MICROSOFT.DEVICES/IOTHUBS/<hub name>",
   "subject": "devices/LogicAppTestDevice",
   "eventType": "Microsoft.Devices.DeviceConnected",
   "eventTime": "2018-06-02T19:17:44.4383997Z",
   "data": {
       "deviceConnectionStateEventInfo": {
         "sequenceNumber":
           "000000000000000001D4132452F67CE200000002000000000000000000000001"
       },
     "hubName": "egtesthub1",
     "deviceId": "LogicAppTestDevice",
     "moduleId" : "DeviceModuleID"
   }, 
   "dataVersion": "1",
   "metadataVersion": "1"
 }]

Den här händelsen publicerar när en enhet är ansluten till en IoT-hubb.

Anteckning

Ett popup-meddelande med texten Remember to include a Content-Type header set to application/json in your request (Glöm inte att ta med ett Content-Type-huvud konfigurerat till application/json i din begäran). Du kan ignorera det här förslaget och gå vidare till nästa avsnitt.

Skapa en åtgärd

Åtgärder är alla steg som utförs när utlösaren har startat logikappens arbetsflöde. I den här självstudiekursen är åtgärden att skicka ett e-postmeddelande från din e-postleverantör.

Välj Nytt steg. Då öppnas ett fönster där du kan välja en åtgärd.
Sök efter Outlook.
Baserat på din e-leverantör söker du och väljer matchande anslutningsapp. I den här självstudien används Outlook.com. Stegen för andra e-postleverantörer liknar dessa.
Välj åtgärden Skicka ett e-postmeddelande (v2) .
Välj Logga in och logga in på ditt e-postkonto. Välj Ja om du vill att appen ska kunna komma åt din information.
Skapa din e-postmall.
- Till: Ange e-postadressen som e-postaviseringarna ska skickas till. I den här självstudien använder du ett e-postkonto som du kan komma åt för testning.
- Ämne: Fyll i ämnestexten. När du klickar på text rutan ämne kan du välja dynamiskt innehåll som ska inkluderas. I den här självstudien används till exempel IoT Hub alert: {eventType} . Om du inte kan se dynamiskt innehåll, väljer du hyperlänken Lägg till dynamiskt innehåll – detta växlar till och från.
- Brödtext: Skriv texten för e-postmeddelandet. Välj JSON-egenskaper från valverktyget för att ta med dynamiskt innehåll baserat på händelsedata. Om du inte kan se det dynamiska innehållet väljer du hyperlänken Lägg till dynamiskt innehåll under text rutan brödtext . Om du inte ser de fält som du vill ha klickar du på mer på skärmen med dynamiskt innehåll för att ta med fälten från föregående åtgärd.
Din e-postmall kanske liknar den i det här exemplet:
Välj Spara i Logikappdesignern.

Kopiera HTTP-URL:en

Innan du lämnar Logic Apps-designern kopierar du URL:en som används av dina logikappar för att lyssna efter en utlösare. Du använder den här URL:en för att konfigurera Event Grid.

Expandera konfigurationsrutan för utlösaren När en HTTP-begäran tas emot genom att klicka på den.
Kopiera värdet för HTTP POST-URL genom att välja kopieringsknappen bredvid det.
Spara den här URL:en så att du kan referera till den i nästa avsnitt.

Konfigurera prenumerationen för IoT Hub-händelser

I det här avsnittet ska du konfigurera din IoT-hubb så att den publicerar händelser när de inträffar.

Gå till din IoT-hubb på Azure Portal. Du kan göra detta genom att välja resurs grupper och sedan välja resurs gruppen för den här själv studie kursen och sedan välja din IoT Hub i listan över resurser.
Välj Händelser.
Välj Händelseprenumeration.
Skapa händelseprenumerationen med följande värden:
1. I avsnittet Information om händelseprenumeration:
  1. Ange ett namn för händelse prenumerationen.
  2. Välj Event Grid schema för händelse schema.
2. I avsnittet Ämnesinformation:
  1. Bekräfta att IoT Hub har angetts som Ämnestyp.
  2. Bekräfta att namnet på IoT-hubben har angetts som värdet för fältet Källresurs.
  3. Ange ett namn på system avsnittet som ska skapas åt dig. Information om system ämnen finns i Översikt över system ämnen.
3. I avsnittet Händelsetyper:
  1. Välj listrutan Filtrera till händelsetyper.
  2. Avmarkera kryss rutorna enhet som skapats och enhet borttagna , så att kryss rutorna enhet ansluten och avkopplad enhet är markerade.
4. I avsnittet Information om slutpunkt:
  1. Välj typ av slut punkt som Web Hook.
  2. Klicka på Välj en slutpunkt, klistra in URL:en som du kopierade från din logikapp och bekräfta valet.
  När du är färdig ska fönstret se ut som i följande exempel:
Välj Skapa.

Simulera en ny enhet som ansluter och skickar telemetri

Testa din Logic app genom att snabbt simulera en enhets anslutning med hjälp av Azure CLI.

Välj knappen Cloud Shell för att öppna din terminal igen.

Kör följande kommando för att skapa en simulerad enhets identitet:

az iot hub device-identity create --device-id simDevice --hub-name {YourIoTHubName}

Kör följande kommando för att simulera anslutning av enheten till IoT Hub och skicka telemetri:
```
az iot device simulate -d simDevice -n {YourIoTHubName}
```
När den simulerade enheten ansluter till IoT Hub får du ett e-postmeddelande som meddelar dig om en "DeviceConnected"-händelse.
När simuleringen är klar får du ett e-postmeddelande som meddelar dig om en "DeviceDisconnected"-händelse.

Rensa resurser

I den här självstudiekursen användes resurser som medför kostnader för din Azure-prenumeration. När du är klar med att testa självstudien och testa dina resultat kan du inaktivera eller ta bort resurser som du inte vill behålla.

Ta bort resurs gruppen om du vill ta bort alla resurser som skapats i den här självstudien.

Välj resurs grupper och välj sedan den resurs grupp som du skapade för den här självstudien.
I fönstret resurs grupp väljer du ta bort resurs grupp. Du uppmanas att ange namnet på resurs gruppen och sedan kan du ta bort det. Alla resurser som ingår däri tas också bort.

Nästa steg

Lär dig mer om hur du kan svara på IoT Hub-händelser med hjälp av Event Grid för att utlösa åtgärder.
Lär dig att ordna enhetsanslutningshändelser och frånkopplingar
Lär dig mer om vad du kan göra med Event Grid.

En fullständig lista över Logic app-kopplingar som stöds finns i

Översikt över anslutningar.