Oktatóanyag: Eszközadatok küldése az Azure Storage-ba az IoT Hub üzenet-útválasztásával

Az Azure IoT Hub üzenet-útválasztásával telemetriai adatokat küldhet az IoT-eszközökről olyan Azure-szolgáltatásokba, mint a blobtároló, a Service Bus-üzenetsorok, a Service Bus-témakörök és az Event Hubs. Minden IoT Hub rendelkezik egy alapértelmezett beépített végponttal, amely kompatibilis az Event Hubs szolgáltatással. Az útválasztási lekérdezések definiálásával egyéni végpontokat is létrehozhat, és üzeneteket irányíthat más Azure-szolgáltatásokba. Az IoT Hubra érkező összes üzenet az összes végpontra lesz irányítva, amelynek útválasztási lekérdezései megegyeznek. Ha egy üzenet nem egyezik a megadott útválasztási lekérdezésekkel, a rendszer az alapértelmezett végpontra irányítja.

Az oktatóanyagban az alábbi feladatokat fogja végrehajtani:

• Hozzon létre egy IoT Hubot, és küldjön neki eszközüzeneteket.
• Hozzon létre egy tárfiókot.
• Hozzon létre egy egyéni végpontot a tárfiókhoz, és irányozza az üzeneteket az IoT Hubról.
• Eszközüzenetek megtekintése a tárfiók blobjában.

Előfeltételek

• Azure-előfizetés. Ha még nincs Azure-előfizetése, kezdés előtt hozzon létre egy ingyenes fiókot.

• IoT Hub az Azure-előfizetésben. Ha még nem rendelkezik központokkal, kövesse az IoT Hub létrehozása című témakörben leírt lépéseket.

• Ez az oktatóanyag a C#-hoz készült Azure IoT SDK-ból származó mintakódot használja.

  • Töltse le vagy klónozza az SDK-adattárat a fejlesztőgépre.
  • .NET Core 3.0.0-s vagy újabb verzióval rendelkezik a fejlesztői gépen. Ellenőrizze a verziót a futtatással dotnet --version , és szükség esetén töltse le a .NET-et .

• Győződjön meg arról, hogy a 8883-as port nyitva van a tűzfalon. Az oktatóanyagban szereplő minta MQTT protokollt használ, amely a 8883-es porton keresztül kommunikál. Ez a port néhány vállalati és oktatási hálózati környezetben blokkolható. További információkért és a probléma megoldásának módjaiért tekintse meg az IoT Hubra (MQTT) való Csatlakozás.

• Igény szerint telepítse az Azure IoT Explorert. Ez az eszköz segít megfigyelni az üzeneteket, amint megérkeznek az IoT Hubra. Ez a cikk az Azure IoT Explorert használja.

Azure Portal

Az Azure Portalnak nincsenek egyéb előfeltételei.

Azure CLI

• Használja a Bash-környezetet az Azure Cloud Shellben. További információ: A Bash rövid útmutatója az Azure Cloud Shellben.

  

• Ha inkább helyi cli-referenciaparancsokat szeretne futtatni, telepítse az Azure CLI-t. Ha Windows vagy macOS rendszert használ, fontolja meg az Azure CLI Docker-tárolóban való futtatását. További információ: Az Azure CLI futtatása Docker-tárolóban.

  • Ha helyi telepítést használ, jelentkezzen be az Azure CLI-be az az login parancs futtatásával. A hitelesítési folyamat befejezéséhez kövesse a terminálon megjelenő lépéseket. További bejelentkezési lehetőségekért lásd : Bejelentkezés az Azure CLI-vel.

  • Amikor a rendszer kéri, először telepítse az Azure CLI-bővítményt. További információ a bővítményekről: Bővítmények használata az Azure CLI-vel.

  • Futtassa az az version parancsot a telepített verzió és a függő kódtárak megkereséséhez. A legújabb verzióra az az upgrade paranccsal frissíthet.

Eszköz regisztrálása és üzenetek küldése az IoT Hubra

Regisztráljon egy új eszközt az IoT Hubon.

Azure Portal

1. Jelentkezzen be az Azure Portalra , és lépjen az IoT Hubra.

2. Válassza az Eszközök lehetőséget a menü Eszközfelügyelet szakaszában.

3. Válassza az Eszköz hozzáadása lehetőséget.

   

4. Adjon meg egy eszközazonosítót, és válassza a Mentés lehetőséget.

5. Az új eszköznek szerepelnie kell az eszközök listájában. Ha nem, frissítse a lapot. Az eszközadatok lap megnyitásához válassza ki az eszközazonosítót.

6. Másolja ki az egyik eszközkulcsot, és mentse. Ezzel az értékkel konfigurálhatja a szimulált eszköz telemetriai üzeneteket létrehozó mintakódot.

   

Azure CLI

Tipp.

Az oktatóanyag során használt parancssori felületi parancsok közül sok ugyanazokat a paramétereket használja. Az Ön kényelme érdekében meghatározzuk a helyi változókat, amelyek igény szerint hívhatók meg. Mindenképpen futtassa az összes parancsot ugyanabban a munkamenetben, különben újra kell definiálnia a változókat.

1. Definiáljon változókat az IoT Hubhoz és az eszközhöz.

   IOTHUB_NAME: Cserélje le ezt a helyőrzőt az IoT Hub nevére.

   DEVICE_NAME: Cserélje le ezt a helyőrzőt az oktatóanyagban az eszközhöz használni kívánt névre.

   hubName=IOTHUB_NAME
   deviceName=DEVICE_NAME
   

2. Futtassa az az iot hub device-identity create parancsot a CLI-rendszerhéjban. Ez a parancs létrehozza az eszközidentitást.

   az iot hub device-identity create --device-id $deviceName --hub-name $hubName
   

3. Az eszköz-identitás kimenetéből másolja ki a primaryKey értéket a környező idézőjelek nélkül, és mentse. Ezzel az értékkel konfigurálhatja a szimulált eszköz telemetriai üzeneteket létrehozó mintakódot.

Most, hogy rendelkezik egy eszközazonosítóval és -kulccsal, a mintakód használatával megkezdheti az eszköz telemetriai üzeneteinek küldését az IoT Hubra.

Tipp.

Ha az oktatóanyaghoz tartozó Azure CLI-lépéseket követi, futtassa a mintakódot egy külön munkamenetben. Így engedélyezheti a mintakód futtatását a parancssori felület többi lépésének végrehajtása közben.

1. Ha nem tette meg az előfeltételek részét, töltse le vagy klónozza az Azure IoT SDK for C#-adattárat a GitHubról.

2. Az SDK letöltését vagy klónozását tartalmazó mappából lépjen a azure-iot-sdk-csharp\iothub\device\samples\how to guides\HubRoutingSample mappába.

3. Telepítse az Azure IoT C# SDK-t és a szükséges függőségeket a HubRoutingSample.csproj fájlban megadott módon:

   dotnet restore
   

4. Nyissa meg a Parameters.cs fájlt egy tetszőleges szerkesztőben. Ez a fájl a minta által támogatott paramétereket jeleníti meg. A minta futtatásakor csak a PrimaryConnectionString paraméter lesz használva ebben a cikkben. Tekintse át a fájlban található kódot. Nincs szükség módosításokra.

5. Hozza létre és futtassa a mintakódot a következő paranccsal:

   Cserélje le <myDevicePrimaryConnectionString> az IoT Hubon lévő eszköz elsődleges kapcsolati sztring.

   dotnet run --PrimaryConnectionString <myDevicePrimaryConnectionString>
   

6. Az IoT Hubra küldött üzeneteket a kimenetre nyomtatva kell látnia. Hagyja futni a programot az oktatóanyag során.

Az IoT Explorer konfigurálása üzenetek megtekintéséhez

Konfigurálja az IoT Explorert úgy, hogy csatlakozzon az IoT Hubhoz, és olvasson üzeneteket a beépített végpontra érkezve.

Először kérje le az IoT Hub kapcsolati sztring.

Azure Portal

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

2. Válassza a megosztott hozzáférési szabályzatokat a menü Biztonsági beállítások szakaszában.

3. Válassza ki az iothubowner szabályzatot.

   

4. Másolja ki az elsődleges kapcsolati sztring.

   

Azure CLI

1. Futtassa az az iot hub connection-string show parancsot:

   az iot hub connection-string show --hub-name $hubName
   

2. Másolja a kapcsolati sztring a környező idézőjelek nélkül.

Ezzel a kapcsolati sztring konfigurálhatja az IoT Explorert az IoT Hubhoz.

1. Nyissa meg az IoT Explorert a fejlesztői gépen.

2. Válassza a Kapcsolat hozzáadása lehetőséget.

   

3. Illessze be a központ kapcsolati sztring a szövegmezőbe.

4. Válassza a Mentés lehetőséget.

5. Miután csatlakozott az IoT Hubhoz, látnia kell az eszközök listáját. Válassza ki az oktatóanyaghoz létrehozott eszközazonosítót.

6. Válassza a Telemetria lehetőséget.

7. Ha az eszköz továbbra is fut, válassza a Start lehetőséget. Ha az eszköz nem fut, nem jelenik meg a telemetria.

   

8. Látnia kell az eszközről érkező üzeneteket, felül pedig a legújabb üzenet jelenik meg.

   

   Néhány pillanatig figyelje meg a bejövő üzeneteket, és ellenőrizze, hogy három különböző típusú üzenet jelenik-e meg: normál, tárolási és kritikus. Ezt követően leállíthatja az eszközt.

Ezek az üzenetek mind az IoT Hub alapértelmezett beépített végpontjához érkeznek. A következő szakaszokban létrehozunk egy egyéni végpontot, és az üzenet tulajdonságai alapján átirányítjuk az üzenetek egy részét a tárolóba. Ezek az üzenetek nem jelennek meg az IoT Explorerben, mert az üzenetek csak akkor kerülnek a beépített végpontra, ha nem felelnek meg az IoT Hub más útvonalainak.

Üzenetek útválasztásának beállítása

A szimulált eszköz által az üzenethez csatolt tulajdonságok alapján különböző erőforrásokba fogja irányítani az üzeneteket. Az egyénileg nem irányított üzeneteket a rendszer az alapértelmezett végpontra (üzenetek/események) küldi el.

Az oktatóanyag mintaalkalmazása hozzárendel egy szinttulajdonságot az IoT Hubnak küldött minden egyes üzenethez. A rendszer véletlenszerűen hozzárendeli az egyes üzeneteket a normál, a tárolási vagy a kritikus szinthez.

Az első lépés annak a végpontnak a beállítása, amelyhez az adatok irányítva lesznek. A második lépés az adott végpontot használó üzenetútvonal beállítása. Az útválasztás beállítása után megtekintheti a végpontokat és az üzenetútvonalakat a portálon.

Tárfiók létrehozása

Hozzon létre egy Azure Storage-fiókot és egy tárolót azon a fiókon belül, amely a hozzá irányított eszközüzeneteket fogja tárolni.

Azure Portal

1. Az Azure Portalon keressen tárfiókokat.

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

3. Adja meg a következő értékeket a tárfiókhoz:

   Paraméter	Érték
   Előfizetés	Válassza ki ugyanazt az előfizetést, amely az IoT Hubot tartalmazza.
   Erőforráscsoport	Válassza ki ugyanazt az erőforráscsoportot, amely az IoT Hubot tartalmazza.
   Tárfiók neve	Adjon meg egy globálisan egyedi nevet a tárfióknak.
   Teljesítmény	Fogadja el az alapértelmezett Standard értéket.

   

4. Az összes többi alapértelmezett értéket a Véleményezés + létrehozás gombra kattintva fogadhatja el.

5. Az ellenőrzés befejezése után válassza a Létrehozás lehetőséget.

6. Ha az üzembe helyezés befejeződött, válassza az Erőforráshoz megnyitása lehetőséget.

7. A Tárfiók menüben válassza a Tárolók lehetőséget az Adattárolás szakaszban.

8. Új tároló létrehozásához válassza a + Tároló lehetőséget.

   

9. Adjon nevet a tárolónak, és válassza a Létrehozás lehetőséget.

Azure CLI

1. Adja meg a tárfiók és a tároló változóit.

   GROUP_NAME: Cserélje le ezt a helyőrzőt az IoT Hubot tartalmazó erőforráscsoport nevére.

   STORAGE_NAME: Cserélje le ezt a helyőrzőt a tárfiók nevére. A tárfiókok nevének kisbetűsnek és globálisan egyedinek kell lennie.

   CONTAINER_NAME: Cserélje le ezt a helyőrzőt a tároló nevére.

   resourceGroup=GROUP_NAME
   storageName=STORAGE_NAME
   containerName=CONTAINER_NAME
   

2. Az az storage account create paranccsal hozzon létre egy szabványos általános célú v2-tárfiókot.

   az storage account create --name $storageName --resource-group $resourceGroup
   

3. Az az storage container create használatával adjon hozzá egy tárolót a tárfiókhoz.

   az storage container create --auth-mode login --account-name $storageName --name $containerName
   

Átirányítás tárfiókhoz

Most beállíthatja az útválasztást a tárfiókhoz. Ebben a szakaszban egy új végpontot határoz meg, amely a létrehozott tárfiókra mutat. Ezután hozzon létre egy útvonalat, amely szűri azokat az üzeneteket, amelyekben a szinttulajdonság tárolóra van állítva, és azokat a tárolási végpontra irányítja.

Feljegyzés

Az adatok Apache Avro formátumban vagy JSON formátumban írhatók blobtárolóba.

A kódolási formátum csak a Blob Storage-végpont konfigurálásakor állítható be. A formátum nem módosítható olyan végpont esetében, amely már be van állítva. JSON-kódolás használatakor a contentType értékét JSON-ra, a contentEncoding értékét pedig UTF-8 értékre kell állítania az üzenetrendszer tulajdonságai között.

A Blob Storage-végpontok használatával kapcsolatos további információkért tekintse meg a tárterületre való útválasztással kapcsolatos útmutatást.

Azure Portal

1. Az Azure Portalon nyissa meg az IoT Hubot.

2. Az Erőforrás menü Központi beállítások területén válassza az Üzenet útválasztása, majd a Hozzáadás lehetőséget.

   

3. A Végpont lapon hozzon létre egy Storage-végpontot a következő információk megadásával:

   Paraméter	Érték
   Végpont típusa	Válassza a Storage lehetőséget.
   Végpont neve	Adjon meg egy egyedi nevet ennek a végpontnak.
   Azure Storage-tároló	Válassza a Tároló kiválasztása lehetőséget. Az utasításokat követve válassza ki az előző szakaszban létrehozott tárfiókot és tárolót.
   Kódolás	Válassza a JSON lehetőséget. Ha ez a mező szürkítve jelenik meg, akkor a tárfiók régiója nem támogatja a JSON-t. Ebben az esetben folytassa az alapértelmezett AVRO-val.

   

4. Fogadja el a többi paraméter alapértelmezett értékeit, és válassza a Létrehozás + tovább lehetőséget.

5. Az Útvonal lapon adja meg a következő információkat egy olyan útvonal létrehozásához, amely a létrehozott Storage-végpontra mutat:

   Paraméter	Érték
   Név	Hozzon létre egy nevet az útvonalnak.
   Adatforrás	Ellenőrizze, hogy az eszköz telemetriai üzenetei ki van-e választva a legördülő listából.
   Útvonal engedélyezése	Ellenőrizze, hogy ez a mező be van-e jelölve.
   Útválasztási lekérdezés	Adja meg level="storage" a lekérdezési sztringet.

   

6. Válassza a Létrehozás + kihagyás elemet.

Azure CLI

1. Konfigurálja a végpont- és útvonalparancsokhoz szükséges változókat.

   ENDPOINT_NAME: Adja meg a tárolót jelképező végpont nevét.

   ROUTE_NAME: Adja meg annak az útvonalnak a nevét, amely szűri a tárolási végpont üzenetét

   endpointName=ENDPOINT_NAME
   routeName=ROUTE_NAME
   

2. Az az iot hub routing-endpoint create parancsával hozzon létre egy egyéni végpontot, amely az előző szakaszban létrehozott tárolóra mutat.

   az iot hub routing-endpoint create \
     --connection-string $(az storage account show-connection-string --name $storageName --query connectionString -o tsv) \
     --endpoint-name $endpointName \
     --endpoint-resource-group $resourceGroup \
     --endpoint-subscription-id $(az account show --query id -o tsv) \
     --endpoint-type azurestoragecontainer
     --hub-name $hubName \
     --container $containerName \
     --resource-group $resourceGroup \
     --encoding json
   

3. Az az iot hub route create parancsával hozzon létre egy útvonalat, amely minden üzenetet level=storage továbbít a tárolóvégpontnak.

   az iot hub route create \
     --name $routeName \
     --hub-name $hubName \
     --resource-group $resourceGroup \
     --source devicemessages \
     --endpoint-name $endpointName \
     --enabled true \
     --condition 'level="storage"'
   

Irányított üzenetek megtekintése

Miután az útvonal létrejött az IoT Hubon, és engedélyezve van, azonnal elindítja a lekérdezési feltételnek megfelelő útválasztási üzeneteket a tárvégpontra.

A beépített végpont figyelése az IoT Explorerrel

Térjen vissza az IoT Explorer-munkamenethez a fejlesztői gépen. Ne feledje, hogy az IoT Explorer monitorozza az IoT Hub beépített végpontját. Ez azt jelenti, hogy most csak azokat az üzeneteket kell látnia, amelyeket nem a létrehozott egyéni útvonal irányít.

Indítsa újra a mintát a kód futtatásával. Figyelje meg a bejövő üzeneteket néhány pillanatig, és csak azokat az üzeneteket kell látnia, ahol level be van állítva normal vagy critical.

Üzenetek megtekintése a tárolóban

Ellenőrizze, hogy az üzenetek a tárolóba érkeznek-e.

1. Az Azure Portalon lépjen a tárfiókra.

2. A menü Adattároló szakaszában válassza a Tárolóklehetőséget.

3. Válassza ki az oktatóanyaghoz létrehozott tárolót.

4. Az IoT Hub nevével kell rendelkeznie egy mappának. Fúrjon végig a fájlszerkezeten, amíg el nem jut egy .json fájlhoz.

   

5. Válassza ki a JSON-fájlt, majd a Letöltés gombra kattintva töltse le a JSON-fájlt. Győződjön meg arról, hogy a fájl olyan üzeneteket tartalmaz az eszközről, amelyeknek a level tulajdonsága be van állítva storage.

6. Állítsa le a minta futtatását.

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

Ha el szeretné távolítani az oktatóanyaghoz használt összes Azure-erőforrást, törölje az erőforráscsoportot. Ez a művelet törli a csoportban lévő összes erőforrást. Ha nem szeretné törölni a teljes erőforráscsoportot, az Azure Portalon keresse meg és törölje az egyes erőforrásokat.

Ha folytatni szeretné a következő oktatóanyagot, tartsa meg az itt létrehozott erőforrásokat.

Azure Portal

1. Az Azure Portalon keresse meg azt az erőforráscsoportot, amely az oktatóanyaghoz tartozó IoT Hub- és tárfiókot tartalmazza.
2. Tekintse át az erőforráscsoportban található összes erőforrást, és állapítsa meg, hogy mely erőforrásokat szeretné törölni.
   • Ha az összes erőforrást törölni szeretné, válassza az Erőforráscsoport törlése lehetőséget.
   • Ha csak bizonyos erőforrásokat szeretne törölni, az egyes erőforrásnevek melletti jelölőnégyzetekkel jelölje ki a törölni kívánt erőforrásokat. Ezután válassza a Törlés elemet.

Azure CLI

1. Az az resource list paranccsal megtekintheti az erőforráscsoport összes erőforrását.

   az resource list --resource-group $resourceGroup --output table
   

2. Tekintse át az erőforráscsoportban található összes erőforrást, és állapítsa meg, hogy mely erőforrásokat szeretné törölni.

   • Ha az összes erőforrást törölni szeretné, használja az az group delete parancsot.

     az group delete --name $resourceGroup
     

   • Ha csak bizonyos erőforrásokat szeretne törölni, használja az az resource delete parancsot. Példa:

     az resource delete --resource-group $resourceGroup --name $storageName
     

Következő lépések

Ebben az oktatóanyagban megtanulta, hogyan hozhat létre egyéni végpontot egy Azure-erőforráshoz, majd hogyan hozhat létre egy útvonalat, amellyel eszközüzeneteket küldhet az adott végpontnak. Folytassa a következő oktatóanyaggal, amelyből megtudhatja, hogyan bővítheti az üzeneteket az alsóbb rétegbeli feldolgozás egyszerűsítése érdekében használható további adatokkal

Az Azure IoT Hub üzenet-bővítésének használata