Megosztás a következőn keresztül:


Oktatóanyag: Az Azure Stream Analytics üzembe helyezése IoT Edge-modulként

A következőkre vonatkozik:IoT Edge 1.5 ellenőrző jel IoT Edge 1.5

Fontos

Az IoT Edge 1.5 LTS a támogatott kiadás. Az IoT Edge 1.4 LTS 2024. november 12-én megszűnik. Ha egy korábbi kiadáson dolgozik, olvassa el az IoT Edge frissítése című témakört.

Ebben az oktatóanyagban létrehoz egy Azure Stream Analytics-feladatot az Azure Portalon, és üzembe helyezi azt IoT Edge-modulként további kód nélkül.

Ebben az oktatóanyagban a következőket sajátíthatja el:

  • Azure Stream Analytics-feladat létrehozása az adatok a peremeszközökön való feldolgozásához.
  • Az új Azure Stream Analytics-feladat csatlakoztatása más IoT Edge-modulokhoz.
  • Az Azure Stream Analytics üzembe helyezése egy IoT Edge-eszközön az Azure Portalról.

A streamarchitektúrát bemutató ábra, beleértve az Azure Stream Analytics-feladatok előkészítését és üzembe helyezését.

Ebben az oktatóanyagban a Stream Analytics modul az átlaghőmérsékletet számítja egy gördülő 30 másodperces ablakon belül. Amikor az átlag eléri a 70-et, a modul riasztást küld az eszköznek a művelet végrehajtásához. Ebben az esetben a művelet a szimulált hőmérséklet-érzékelő alaphelyzetbe állítása. Éles környezetben ezzel a funkcióval kikapcsolhat egy gépet, vagy megelőző intézkedéseket tehet, amikor a hőmérséklet eléri a veszélyes szinteket.

Miért érdemes az Azure Stream Analyticst használni az IoT Edge-ben?

Számos IoT-megoldás használ elemzési szolgáltatásokat az adatok elemzéséhez, amikor az IoT-eszközökről érkezik a felhőbe. Az Azure IoT Edge használatával az Azure Stream Analytics-logikát maga az eszközre helyezheti át. A peremhálózati telemetriai adatfolyamok feldolgozása csökkenti a feltöltött adatok mennyiségét és a végrehajtható megállapításokra való reagáláshoz szükséges időt. Az Azure IoT Edge és az Azure Stream Analytics integrálása leegyszerűsíti a számítási feladatok fejlesztését.

Az Azure Stream Analytics strukturált lekérdezési szintaxist használ az adatelemzéshez a felhőben és az IoT Edge-eszközökön. További információkért tekintse meg az Azure Stream Analytics dokumentációját.

Előfeltételek

Ha még nem rendelkezik Azure-fiókkal, első lépésként hozzon létre egy ingyenes fiókot.

  • Azure IoT Edge-eszköz.

    Azure-beli virtuális gép használata IoT Edge-eszközként a Linux vagy Windows rendszerű eszközök rövid útmutatójának lépéseit követve.

  • Egy ingyenes vagy standard szintű IoT Hub az Azure-ban.

Azure Stream Analytics-feladat létrehozása

Ebben a szakaszban egy Azure Stream Analytics-feladatot hoz létre, amely:

  • Adatokat fogad az IoT Edge-eszközről.
  • Lekérdezi a megadott tartományon kívüli értékek telemetriai adatait.
  • A lekérdezési eredmények alapján műveletet hajt végre az IoT Edge-eszközön.

Tárfiók létrehozása

Amikor létrehoz egy Azure Stream Analytics-feladatot egy IoT Edge-eszközön való futtatáshoz, azt tárolnia kell, hogy az eszköz hozzáférhessen. Használhat meglévő Azure Storage-fiókot, vagy létrehozhat egy újat.

  1. Az Azure Portalon nyissa meg az >létrehozása lehetőséget.

  2. Adja meg a következő értékeket a tárfiók létrehozásához:

    Mező Érték
    Előfizetés Válassza ugyanazt az előfizetést, mint az IoT Hub esetében.
    Erőforráscsoport Az IoT Edge gyorsútmutatóihoz és oktatóanyagaihoz használja ugyanazt az erőforráscsoportot az összes teszterőforráshoz. Például: IoTEdgeResources.
    Név Adja meg a tárfiók egyedi nevét.
    Hely Válasszon egy Önhöz közeli helyet.
  3. Tartsa meg a többi mező alapértelmezett értékeit, és válassza a Véleményezés + Létrehozás lehetőséget.

  4. Tekintse át a beállításokat, majd válassza a Létrehozás lehetőséget.

Új feladat létrehozása

  1. Az Azure Portalon válassza a következőt:

    1. Erőforrás létrehozása
    2. A dolgok internete a bal oldali menüből
    3. Írja be a Stream Analytics kifejezést a keresősávba, hogy megtalálja az Azure Marketplace-en
    4. Válassza a Létrehozás, majd a Stream Analytics-feladat lehetőséget a legördülő menüből
  2. Adja meg a következő értékeket az új Stream Analytics-feladat létrehozásához:

    Mező Érték
    Név Adja meg a feladat nevét. Például: IoTEdgeJob
    Előfizetés Válassza ugyanazt az előfizetést, mint az IoT Hub esetében.
    Erőforráscsoport Használja ugyanazt az erőforráscsoportot az IoT Edge gyorsútmutatói és oktatóanyagai során létrehozott összes teszterőforráshoz. Például egy IoTEdgeResources nevű erőforrás.
    Régió Válassza ki az Önhöz legközelebb eső helyet.
    Üzemeltetési környezet Válassza az Edge lehetőséget. Ez a beállítás lehetővé teszi, hogy a felhő helyett egy IoT Edge-eszközön telepítsen.
  3. Válassza az Áttekintés + létrehozás lehetőséget.

  4. Erősítse meg a beállításokat, majd válassza a Létrehozás lehetőséget.

A feladat konfigurálása

Miután létrehozta a Stream Analytics-feladatot az Azure Portalon, konfigurálja egy bemenettel, egy kimenettel és egy lekérdezéssel az áthaladó adatok futtatásához.

Ez a szakasz bemutatja, hogyan hozhat létre olyan feladatot, amely hőmérsékletadatokat fogad egy IoT Edge-eszközről. Egy 30 másodperces gördülő ablakban elemzi az adatokat. Ha az ablak átlaghőmérséklete meghaladja a 70 fokot, a feladat riasztást küld az IoT Edge-eszköznek.

Feljegyzés

A feladat üzembe helyezésekor adja meg, hogy honnan származnak az adatok, és hová kerülnek a következő szakaszban: Az IoT Edge beállításainak konfigurálása.

A bemenet és a kimenet beállítása

  1. Keresse meg a Stream Analytics-feladatot az Azure Portalon.

  2. A Feladattopológia területen válassza a Bemenetek, majd a Bemenet hozzáadása lehetőséget.

  3. Válassza az Edge Hubot a legördülő listából.

    Ha nem látja az Edge Hub lehetőséget a listában, előfordulhat, hogy a Stream Analytics-feladatot felhőalapú feladatként hozta létre. Próbáljon meg létrehozni egy új feladatot, és győződjön meg arról, hogy az Edge-t választja üzemeltetési környezetként.

  4. Az Új beviteli panelen adja meg a hőmérsékletet bemeneti aliasként.

  5. Hagyja változatlanul a többi mező értékét, és válassza a Mentés lehetőséget.

  6. A Feladattopológia területen válassza a Kimenetek, majd a Hozzáadás lehetőséget.

  7. Válassza az Edge Hub elemet a legördülő listából.

  8. Az Új kimenet panelen adja meg az alert (riasztás) nevet a kimenet aliasaként.

  9. Hagyja változatlanul a többi mező értékét, és válassza a Mentés lehetőséget.

Lekérdezés létrehozása

  1. A Feladattopológia területen válassza a Lekérdezés lehetőséget.

  2. Cserélje le az alapértelmezett szöveget a következő lekérdezésre:

    SELECT  
        'reset' AS command
    INTO
       alert
    FROM
       temperature TIMESTAMP BY timeCreated
    GROUP BY TumblingWindow(second,30)
    HAVING Avg(machine.temperature) > 70
    

    Ebben a lekérdezésben az SQL-kód egy alaphelyzetbe állítási parancsot küld a riasztás kimenetének, ha a gép átlagos hőmérséklete egy 30 másodperces ablakban eléri a 70 fokot. Az alaphelyzetbe állítási parancs előre be van programozva az érzékelőbe műveletként.

  3. Válassza a Lekérdezés mentése lehetőséget.

Az IoT Edge-beállítások konfigurálása

A Stream Analytics-feladat IoT Edge-eszközön való üzembe helyezéséhez társítsa az Azure Stream Analytics-feladatot egy tárfiókkal. Amikor üzembe helyezi a feladatot, a feladatdefiníció konténerként exportálódik a tárfiókra.

  1. A Stream Analytics szolgáltatás Beállítások menüjében válassza a Tárfiók beállításai lehetőséget.

  2. Válassza ki a Blob Storage/ADLS Gen 2 lehetőséget az előfizetések közül.

  3. Az Azure Storage-fiók automatikusan megjelenik a lapon. Ha nem lát egyet, hozzon létre egy tárolót. Ha a Tárfiók mezőben felsorolt tárterülettől eltérő tárterületet kell választania, válassza ki a legördülő menüből.

  4. Ha módosításokat végzett, válassza a Mentés lehetőséget.

A feladat üzembe helyezése

Most már készen áll az Azure Stream Analytics-feladat üzembe helyezésére az IoT Edge-eszközön.

Ebben a szakaszban az Azure Portal Modulok beállítása varázslójával hozhat létre üzembehelyezési jegyzéket. Az üzembehelyezési jegyzék egy JSON-fájl, amely az eszközön üzembe helyezett összes modult ismerteti. A jegyzék tartalmazza a modulrendszerképeket tárolóregisztrációs adatbázisokat, a modulok kezelésének módját és azt, hogy a modulok hogyan kommunikálhatnak egymással. Az IoT Edge-eszköz lekéri az üzembehelyezési jegyzéket az IoT Hubról, majd az abban lévő információkkal üzembe helyezi és konfigurálja az összes hozzárendelt modult.

Ebben az oktatóanyagban két modult helyezhet üzembe. Az első a SimulatedTemperatureSensor, amely egy hőmérséklet- és páratartalom-érzékelőt szimuláló modul. A második a Stream Analytics-feladat. Az érzékelőmodul biztosítja a feladat-lekérdezés által elemezett adatstreamet.

  1. Az Azure Portalon keresse meg az IoT-központot.

  2. Válassza az Eszközök lehetőséget az Eszközfelügyelet menüben, majd az IoT Edge-eszköz megnyitásához.

  3. Válassza a Set modules (Modulok beállítása) lehetőséget.

  4. Ha korábban telepítette a SimulatedTemperatureSensor modult ezen az eszközön, az automatikusan feltöltődhet. Ha nem, adja hozzá a modult a következő lépésekkel:

    1. Válassza a + Hozzáadás lehetőséget, és válassza az IoT Edge-modult.
    2. A névhez írja be a SimulatedTemperatureSensor nevet.
    3. A kép URI-jának megadásához írja be a mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:1.5.
    4. Hagyja meg a többi alapértelmezett beállítást, majd válassza a Hozzáadás lehetőséget.
  5. Adja hozzá az Azure Stream Analytics Edge-feladatot a következő lépésekkel:

    1. Válassza a + Hozzáadás lehetőséget, és válassza az Azure Stream Analytics-modult.
    2. Válassza ki az előfizetést, és a létrehozott Azure Stream Analytics Edge-feladatot.
    3. Válassza a Mentés lehetőséget.

    A módosítások mentése után a Stream Analytics-feladat részletei közzé lesznek téve a létrehozott tárolóban.

  6. Miután a Stream Analytics-bővítmény üzembe helyezése befejeződött, ellenőrizze, hogy két új modul jelenik-e meg a Modulok beállítása lapon.

    Képernyőkép arról, hogy két új modul található az eszközön. A képernyőkép azt is megjeleníti, hogy hol található a Véleményezés + létrehozás gomb.

  7. Válassza az Áttekintés + létrehozás lehetőséget. Megjelenik az üzembehelyezési jegyzék.

  8. Válassza a Létrehozás lehetőséget.

  9. Az eszköz Modulok beállítása lapján néhány perc múlva látnia kell a felsorolt és futó modulokat. Ha nem látja a modulokat, frissítse a lapot, vagy várjon még néhány percet, majd frissítse újra.

A két új modul ismertetése

  1. Az eszköz Modulok beállítása lapján válassza ki a Stream Analytics-modul nevét az IoT Edge-modul frissítése lapra való ugráshoz. Itt frissítheti a beállításokat.

    A Beállítások lapon található a rendszerkép URI-ja , amely egy szabványos Azure Stream Analytics-rendszerképre mutat. Ez az egyetlen rendszerkép minden Olyan Stream Analytics-modulhoz használható, amely egy IoT Edge-eszközön lesz üzembe helyezve.

    A Modul ikerbeállításai lapon látható az Azure Stream Analytics (ASA) ASAJobInfo nevű tulajdonságát meghatározó JSON. A tulajdonság értéke a feladat tárolóban lévő definíciójára mutat. Ez a tulajdonság a Stream Analytics-rendszerkép konfigurálása az Ön konkrét feladatadataival.

    A Stream Analytics-modul alapértelmezés szerint ugyanazt a nevet veszi fel, mint a rajta alapuló feladat. Ha szeretné, módosíthatja a modul nevét ezen a lapon, de nem szükséges.

  2. Ha módosításokat végzett, válassza az Alkalmaz elemet, vagy ha nem végzett módosításokat, a Mégse elemet.

Útvonalak hozzárendelése a modulokhoz

  1. Az eszköz:<az eszköz neve> lapon válassza a Tovább: Útvonalak lehetőséget.

  2. Az Útvonalak lapon megadhatja, hogyan továbbítják az üzeneteket a modulok és az IoT Hub között. Az üzenetek név- és értékpárok használatával jönnek létre.

    Adja hozzá az útvonalneveket és az értékeket a következő táblázatban látható párokkal. Cserélje le a {moduleName} példányokat az Azure Stream Analytics-modul nevére. Ennek a modulnak meg kell egyeznie az eszköz modullistájában a Modulok beállítása lapon látható névvel, ahogyan az az Azure Portalon is látható.

    Képernyőkép a Stream Analytics-modulok nevéről az IoT Edge-eszközén az Azure Portalon.

    Név Érték
    telemetriaFelhőbe FROM /messages/modules/SimulatedTemperatureSensor/* INTO $upstream
    Figyelmeztetések a felhőbe FROM /messages/modules/{moduleName}/* INTO $upstream
    riasztásokVisszaállítása FROM /messages/modules/{moduleName}/* INTO BrokeredEndpoint("/modules/SimulatedTemperatureSensor/inputs/control")
    telemetryToAsa FROM /messages/modules/SimulatedTemperatureSensor/* INTO BrokeredEndpoint("/modules/{moduleName}/inputs/temperature")

    Az itt deklarált útvonalak határozzák meg az IoT Edge-eszközön keresztüli adatáramlást. A SimulatedTemperatureSensor telemetriai adatait a rendszer elküldi az IoT Hubnak és a Stream Analytics-feladatban konfigurált hőmérséklet-bemenetnek . A rendszer elküldi a riasztás kimeneti üzeneteit az IoT Hubnak és a SimulatedTemperatureSensor modulnak az alaphelyzetbe állítási parancs aktiválásához.

  3. Válassza a Tovább: Felülvizsgálat + létrehozás lehetőséget.

  4. A Véleményezés + Létrehozás lapon láthatja, hogy a varázslóban megadott információk hogyan lesznek JSON-alapú üzembehelyezési jegyzékké alakítva.

  5. Ha végzett a jegyzék áttekintésével, válassza a Létrehozás lehetőséget a modul beállításának befejezéséhez.

Adatok megtekintése

Lépjen az IoT Edge-eszközére az Azure Stream Analytics modul és a SimulatedTemperatureSensor modul közötti interakció megtekintéséhez.

Feljegyzés

Ha egy eszközhöz virtuális gépet használ, az Azure Cloud Shell használatával közvetlenül hozzáférhet az összes Azure-beli hitelesített szolgáltatáshoz.

  1. Ellenőrizze, hogy fut-e mindegyik modul a Dockerben:

    iotedge list  
    
  2. Tekintse át az összes rendszernaplót és metrikaadatot. Cserélje le a(z) {moduleName} elemet az Azure Stream Analytics-modul nevére:

    iotedge logs -f {moduleName}  
    
  3. Az érzékelőnaplók megtekintésével megtudhatja, hogyan befolyásolja az alaphelyzetbe állítási parancs a SimulatedTemperatureSensort:

    iotedge logs SimulatedTemperatureSensor
    

    Megfigyelheti, hogy a gép hőmérséklete fokozatosan emelkedik, amíg 30 másodpercig el nem éri a 70 fokot. A Stream Analytics-modul ekkor kiváltja a rendszer alaphelyzetbe állítását, és a géphőmérséklet visszaáll 21 fokra.

    Képernyőkép a modulnaplók kimenetében található alaphelyzetbe állítási parancsról.

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

Ha folytatni szeretné a következő ajánlott cikket, tartsa meg a létrehozott erőforrásokat és konfigurációkat, és használja újra őket. Azt is megteheti, hogy ugyanezt az IoT Edge-eszközt használja teszteszközként.

Ellenkező esetben törölje a cikkben használt helyi konfigurációkat és Azure-erőforrásokat a díjak elkerülése érdekében.

Azure-erőforrások törlése

Az Azure-erőforrások és -erőforráscsoportok törlése visszafordíthatatlan. Figyeljen, nehogy véletlenül rossz erőforráscsoportot vagy erőforrásokat töröljön. Ha az IoT Hubot egy meglévő erőforráscsoporton belül hozta létre, amelyben meg szeretné tartani az erőforrásokat, csak magát az IoT Hub-erőforrást törölje, nem pedig az erőforráscsoportot.

Az erőforrások törlése:

  1. Jelentkezzen be az Azure Portalra, és válassza az Erőforráscsoportok elemet.
  2. Válassza ki az IoT Edge teszterőforrásokat tartalmazó erőforráscsoport nevét.
  3. Tekintse át az erőforráscsoport által tartalmazott erőforrások listáját. Ha mindet törölni szeretné, válassza az Erőforráscsoport törlése lehetőséget. Ha csak néhányat szeretne törölni, az egyes erőforrásokat egyenként is törölheti.

Következő lépések

Ebben az oktatóanyagban beállít egy Azure Stream Analytics-feladatot az IoT Edge-eszköz adatainak elemzéséhez. Betöltötte az Azure Stream Analytics modult az IoT Edge-eszközére, hogy helyileg feldolgozhassa és reagáljon a hőmérséklet-növekedésre, és elküldte az összesített adatfolyamot a felhőbe. Ha szeretné megtudni, hogyan segíthet az Azure IoT Edge további megoldások létrehozásában, próbálkozzon a következő oktatóanyagban.