Gyakorlat – IoT-telemetria feldolgozásának implementálása

  • 10 perc

Ez a gyakorlat áttekintést nyújt az Azure IoT Central-alkalmazások szabályok konfigurálásához és az IoT-telemetriai adatok exportálásához való használatáról. For more information, see:

Ebben a gyakorlatban a következőket fogja végrehajtani:

  • Hozzon létre egy Azure-függvényt, amely egy HTTP-kérés hasznos adatait naplózza.
  • Egy Azure IoT Central-alkalmazás IoT-telemetriai szabályainak konfigurálása és ellenőrzése.
  • Hozzon létre egy Azure Storage-fiókot, amely IoT-telemetriát fog tárolni.
  • Azure IoT Central-alkalmazások adatexportálásának konfigurálása és ellenőrzése.

Előfeltételek

  • Azure-előfizetés
  • Egy Microsoft-fiók vagy Egy Microsoft Entra-fiók, amely globális Rendszergazda istrator szerepkörrel rendelkezik az Azure-előfizetéshez társított Microsoft Entra-bérlőben, valamint az Azure-előfizetés tulajdonosi vagy közreműködői szerepkörével
  • A gyakorlategység befejezése Az Azure IoT Central beállítása

HTTP-kérés hasznos adatait naplózó Azure-függvény létrehozása

Az Azure IoT Central alkalmazásszabályok konfigurálása előtt létre fog hozni egy Azure-függvényalkalmazást, amely segít ellenőrizni a szabályfeldolgozást. A natív felhőalkalmazás megvalósításakor egyszerűen lecserélheti az Azure-függvényalkalmazást a HTTP-webhook funkciót támogató bármely más összetevőre.

  1. Egy webböngészőben lépjen az Azure Portalra , és jelentkezzen be a modulban használni kívánt Azure-előfizetés eléréséhez.

  2. Az Azure Portal oldalának elején található Erőforrások, szolgáltatások és dokumentumok keresése mezővel keressen rá, és válassza a Függvényalkalmazás lehetőséget.

  3. A Függvényalkalmazás panelen válassza az + Új vagy a + Létrehozás lehetőséget.

  4. A Függvényalkalmazás létrehozása panel Alapismeretek lapján konfigurálja a következő beállításokat, majd válassza a Véleményezés + létrehozás lehetőséget:

    Setting Konfiguráció
    Előfizetés Válassza ki a modulban használni kívánt Azure-előfizetés nevét.
    Erőforráscsoport Hozzon létre egy iot-central-apps-RG nevű új erőforráscsoportot.
    Függvényalkalmazás neve Adjon meg egy egyedi nevet, amely kisbetűkből, számjegyekből vagy kötőjelekből áll, és betűvel kezdődik.
    Közzététel Válassza a Kód lehetőséget.
    Futtatókörnyezet verme Válassza a .NET lehetőséget.
    Verzió Válassza a 3.1 lehetőséget.
    Region Válassza ki a laborkörnyezet helyéhez legközelebb eső Azure-régiót, lehetőleg az Azure IoT Central üzembe helyezésének helyével egyezően.
    Operating System Ablakok
    Konstrukció típusa Felhasználás (kiszolgáló nélküli)

    Screenshot of the Azure portal Create Function App blade Basics tab.

  5. Válassza a Létrehozás parancsot.

    Megjegyzés:

    Várja meg, amíg befejeződik az Azure-függvényalkalmazás kiépítése. Ez akár két percet is igénybe vehet.

  6. Az Azure-portált az Azure-függvényalkalmazás kiépítési állapotpaneljével megjelenítő böngészőablakban válassza az Ugrás az erőforráshoz lehetőséget.

  7. Az Azure-függvényalkalmazás panelen válassza a Functions, majd a + Létrehozás lehetőséget.

  8. A Függvény létrehozása panelen válassza ki a HTTP-eseményindító sablonbejegyzését, majd válassza a Létrehozás lehetőséget. Ha a rendszer kéri, fogadja el a HTTP-eseményindító sablon alapértelmezett értékét.

    Screenshot of the Azure portal Azure Function app Add function blade.

  9. A HttpTrigger1 panel függőleges menüsávján válassza a Kód + Teszt lehetőséget.

  10. A HttpTrigger1 | Kód + Teszt panel, cserélje le a meglévő kódot a következő tartalomra, majd kattintson a Mentés gombra a módosítások mentéséhez:

    #r "Newtonsoft.Json"

using System.Net;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Primitives;
using Newtonsoft.Json;

public static async Task<IActionResult> Run(HttpRequest req, ILogger log)
{
    log.LogInformation("C# HTTP trigger function processed a request.");

    string requestBody = await new StreamReader(req.Body).ReadToEndAsync();
    dynamic data = JsonConvert.DeserializeObject(requestBody);

    string responseMessage = $"Payload: {data}. \nThis HTTP triggered function executed successfully."; 
    log.LogInformation(responseMessage);

    return new OkObjectResult(responseMessage);
}

    Megjegyzés:

    A függvény naplózza a HTTP-kérés hasznos adatait, amelyek a modul előző gyakorlatában létrehozott Azure IoT Central-alkalmazás által a függvényalkalmazás végpontjára továbbított telemetriai adatokat jelölik.

  11. A HttpTrigger1 | Code + Test panel, válassza a Függvény URL-címének lekérése lehetőséget, majd jegyezze fel az Azure-függvény URL-címét.

  12. Az újonnan létrehozott függvény teszteléséhez a HttpTrigger1 | Code + Test panel, válassza a Tesztelés/Futtatás lehetőséget. Válassza a Bemenet lapot, majd a Futtatás lehetőséget.

    Screenshot of the Code + Test blade of the HttpTrigger1 blade with the Input tab selected.

  13. Az eredmények ellenőrzéséhez a HttpTrigger1 | Code + Test panel, tekintse át a naplópanelt, és ellenőrizze, hogy a hasznos adatok megegyeznek-e a Kimenet lapon látható adatokkal.

    Screenshot of the Code + Test blade of the HttpTrigger1 blade with the Output tab selected.

    Megjegyzés:

    Előfordulhat, hogy a futtatás második alkalommal lehetőséget választva hozza létre az eredményeket a naplópanelen.

Egy Azure IoT Central-alkalmazás IoT-telemetriai szabályainak konfigurálása és ellenőrzése

  1. Nyisson meg egy másik webböngészőablakot, és lépjen az IoT Central alkalmazásaim lapjára.

  2. Ha a rendszer kéri, jelentkezzen be az Azure IoT Central beállítása gyakorlategységben használt Azure-előfizetés eléréséhez.

  3. A Saját alkalmazások lapon válassza az adatum-iot-custom-application bejegyzést.

  4. A függőleges menü Kiterjesztése területén válassza a Szabályok lehetőséget.

  5. A Szabályok lapon válassza a Szabály létrehozása lehetőséget, és konfigurálja a következő beállításokat:

    Setting Konfiguráció
    Szabály neve Adja meg az Adatum IoT egyéni alkalmazástesztelési szabályát.
    Eszközsablon Válassza a Raspberry Pi lehetőséget.
    Idő összesítése Kapcsolja be úgy, hogy az időintervallum értéke 5 perc.
    Telemetria Válassza ki a páratartalmat.
    Operator Válassza a nagyobb, mint lehetőséget.
    Összesítés Válassza az Átlag lehetőséget.
    Adjon meg egy értéket Adja meg a 30-at.
    Action Válassza a + Webhook lehetőséget.
    Megjelenítendő név Adja meg az Azure-függvény webhookját.
    Visszahívási URL-cím Illessze be a gyakorlat előző feladatában rögzített Azure-függvény URL-címét.

    Megjegyzés:

    A páratartalom-telemetria értéke szándékosan alacsony mesterségesen, a webhook funkció meghívásához és a függvény aktiválásához. Valós helyzetekben a riasztást vagy a szervizelési műveletet indokoló feltételnek megfelelően kell módosítania.

  6. A Szabályok lapon válassza a Kész, majd a Mentés lehetőséget.

  7. Váltson arra a böngészőablakra, amely a modul előző gyakorlatában használt Raspberry Pi Azure IoT Online Szimulátor oldalt jeleníti meg. Ezen a lapon ellenőrizze, hogy a szimulált eszköz üzeneteket küld-e az Azure IoT Central-alkalmazásnak. Ha a szimulátor leállt, válassza a Futtatás lehetőséget közvetlenül a kódpanel után.

  8. Váltson vissza a HttpTrigger1 | böngészőablakra Kód + Teszt panel az Azure Portalon. A függőleges menüben válassza a Monitor bejegyzést, majd a HttpTrigger1 | A Code + Test panelen válassza a Naplók lapot.

  9. Ellenőrizze, hogy a naplók panel megjeleníti-e a feladat korábbi részében konfigurált Azure IoT Central-alkalmazás webhookából származó HTTP-eseményindítóra válaszul létrehozott üzeneteket.

IoT-telemetriát tároló Azure Storage-fiók létrehozása

  1. Váltson az Azure Portalt megjelenítő böngészőablakra.

  2. Az Azure Portalon az Erőforrások, szolgáltatások és dokumentumok keresése szövegmezővel kereshet, és kiválaszthatja a Storage-fiókokat.

  3. A Tárfiókok panelen válassza az + Új vagy a + Létrehozás lehetőséget.

  4. A Tárfiók létrehozása panel Alapszintű beállítások lapján konfigurálja a következő beállításokat (hagyja meg a többit az alapértelmezett értékekkel):

    Setting Konfiguráció
    Előfizetés Válassza ki a modulban használni kívánt Azure-előfizetés nevét.
    Erőforráscsoport Válassza az iot-central-apps-RG lehetőséget.
    Storage account name Adjon meg egy egyedi nevet, amely 3 és 24 közötti kisbetűket és számjegyeket tartalmaz, és egy betűvel kezdődik.
    Teljesítmény Válassza a Standard lehetőséget.
    Redundancia Helyileg redundáns tárolás (LRS) kiválasztása

    Screenshot of the Azure portal, Create storage account blade, Basics tab.

  5. A Tárfiók létrehozása panel Alapszintű beállítások lapján válassza a Véleményezés + létrehozás lehetőséget, majd a Létrehozás lehetőséget.

    Megjegyzés:

    Várja meg, amíg az Azure Storage-fiók kiépítése befejeződik. Ez körülbelül két percet vehet igénybe.

  6. A kiépítés befejezése után válassza az Ugrás az erőforrásra lehetőséget.

  7. Az Azure Storage-fiók panel függőleges menüjében válassza a Tárolók, majd a + Tároló lehetőséget.

  8. Az Új tároló panel Név szövegmezőjében írja be az iotcontainer kifejezést, hagyja meg a nyilvános hozzáférési szintet Privát (névtelen hozzáférés nélkül) értékre, majd válassza a Létrehozás lehetőséget.

    Screenshot of the Azure portal, New container blade.

  9. Az Azure Storage-fiók panel függőleges menüjében, a Biztonság és hálózatkezelés szakaszban válassza az Access-kulcsokat. Válassza a Kulcsok megjelenítése lehetőséget, majd rögzítse az 1. kulcsnak megfelelő kapcsolati sztring értékét.

    Screenshot of the Azure portal, Access keys blade.

Azure IoT Central-alkalmazás adatexportálásának konfigurálása és ellenőrzése

  1. Váltson arra a böngészőablakra, amely az adatum-iot-custom-application oldalt jeleníti meg az IoT Central Application Portalon.

  2. Az IoT Central Application Portal adatum-iot-custom-application oldalának függőleges menüjében, a Kiterjesztő szakaszban válassza az Adatexportálás lehetőséget, majd válassza az Exportálás hozzáadása lehetőséget.

    Screenshot of the Azure IoT Central portal, Data export page.

  3. Az Új exportálás létrehozása lapon konfigurálja a következő beállításokat:

    Setting Konfiguráció
    Név exportálása Adja meg az Egyéni Adatum IoT-alkalmazás exportálását.
    Exportálandó adatok típusa Válassza a Telemetria lehetőséget.
    Célok Válassza az új létrehozása lehetőséget.
    Új célnév Adja meg az Adatum Blob Storage-t.
    Céltípus Válassza az Azure Blob Storage lehetőséget.
    Kapcsolati sztring Illessze be a gyakorlat előző feladatában másolt kapcsolati sztring értékét.
    Tároló Írja be az iotcontainert.

    Screenshot of the Azure IoT Central application export new destination settings.

  4. Válassza a Létrehozás, majd a Mentés lehetőséget az Új exportálás létrehozása lapon.

  5. Váltson a gyakorlat korábbi részében használt Raspberry Pi Azure IoT Online szimulátoroldalt megjelenítő böngészőablakra. Ezen a lapon, közvetlenül a kódpanel után válassza a Futtatás lehetőséget, és ellenőrizze, hogy a szimulált eszköz üzeneteket küld-e az Azure IoT Central-alkalmazásnak.

  6. Váltson arra a böngészőablakra, amely megjeleníti az Azure Storage-fiók paneljét az Azure Portalon.

  7. Az Azure Storage-fiók panel függőleges menüjében válassza a Tárolók lehetőséget.

  8. A tárolók listájában válassza ki az iotcontainer bejegyzést.

  9. Az iotcontainer panelen ellenőrizze, hogy van-e új mappa GUID-alapú névvel.

    Megjegyzés:

    Ha a mappa nem található, várjon körülbelül egy percet, és válassza a Frissítés lehetőséget.

  10. Az iotcontainer panelen válassza ki az újonnan létrehozott mappát, és navigáljon az almappái között, amíg el nem éri a blobot bármelyik almappájában.

  11. Az iotcontainer panelen válassza ki az előző lépésben azonosított blobot. A blob panelen válassza a Szerkesztés lapot a tartalom megjelenítéséhez.

    Screenshot of the content of a blob representing telemetry exported from the Azure IoT Central application.

  12. Váltson a Raspberry Pi Azure IoT Online Szimulátor oldalt megjelenítő böngészőablakra. Ezen a lapon, közvetlenül a kódpanel után válassza a Leállítás lehetőséget, és ellenőrizze, hogy a szimulált eszköz már nem küld-e üzeneteket az Azure IoT Central-alkalmazásnak.

EREDMÉNY

Gratulálunk! Elvégezte a modul második gyakorlatát. Ebben a gyakorlatban a következőt kell elvégeznie:

  • Létrehozott egy Azure-függvényt, amely egy HTTP-kérés hasznos adatait naplózza.
  • Egy Azure IoT Central-alkalmazás konfigurált és ellenőrzött IoT-telemetriai szabályai.
  • Létrehozott egy Azure Storage-fiókot, amely IoT-telemetriát fog tárolni.
  • Egy Azure IoT Central-alkalmazás konfigurált és ellenőrzött adatexportálása.

Az erőforrások eltávolítása

Az Azure-erőforrások használatából származó szükségtelen díjak elkerülése érdekében törölnie kell a gyakorlat elején létrehozott iot-central-apps-RG erőforráscsoportot. Ehhez az Azure Portalon lépjen az iot-central-apps-RG panelre, és válassza az eszköztár Erőforráscsoport törlése elemét. Az ERŐFORRÁSCSOPORT NEVE szövegmezőbe írja be az iot-central-apps-RG kifejezést, majd válassza a Törlés lehetőséget.