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 meg a megadott útválasztási lekérdezésekkel, az az alapértelmezett végpontra lesz irányítva.

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, majd ezt követően irányítsa az üzeneteket az IoT Hub-ról.
• A tárhelyfiók blobjában lévő eszközüzenetek megtekintése.

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 nincs IoT Hubja, kövesse az IoT Hub létrehozása című témakörben leírt lépéseket.

• Ez az oktatóanyag a Microsoft Azure IoT SDK for .NET mintakódját használja.

  • Töltse le vagy klónozza az SDK-adattárat a fejlesztőgépre.
  • Legyen telepítve a fejlesztői gépén a .NET Core 3.0.0-s vagy újabb verziója. 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 blokkolva lehet. További információkért és a probléma megoldásának módjaiért lásd: Csatlakozás az IoT Hubhoz.

• Igény szerint telepítse az Azure IoT Explorert (előzetes verzió). 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ó: Az Azure Cloud Shell használatának első lépései.

  

• 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: Hitelesítés az Azure-ba az Azure CLI használatával.

  • 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 és kezelése 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.

Fontos

Ez a cikk az eszközök közös hozzáférésű jogosultságkóddal, más néven szimmetrikus kulcshitelesítéssel való csatlakoztatásának lépéseit tartalmazza. Ez a hitelesítési módszer alkalmas tesztelésre és kiértékeléshez, de az eszköz hitelesítése X.509-tanúsítványokkal biztonságosabb módszer. További információkért tekintse meg az IoT-megoldások biztonsági javaslatait és a kapcsolatbiztonságot>.

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-parancssorban. 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 a Microsoft Azure IoT SDK for .NET-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 a .NET-hez készült Microsoft Azure IoT 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étert használja a cikk. 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 eszköze elsődleges kapcsolati sztringjére az IoT Hubban.

   dotnet run --PrimaryConnectionString <myDevicePrimaryConnectionString>
   

6. El kellene kezdenie látni az IoT Hubra küldött üzeneteket, ahogy azok megjelennek a kimeneten. 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 Ön IoT Hub-jából a kapcsolati karakterláncot.

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 karakterláncot.

   

Azure CLI

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

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

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

Ezzel a kapcsolati karakterlánccal konfigurálja az IoT Explorert az IoT Hubhoz.

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

2. Ha megjelenik, válassza a Csatlakozás IoT Hub kapcsolati sztringen keresztül lehetőséget.

   

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

   

4. Illessze be a saját központ kapcsolati karakterláncát a szövegmezőbe.

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

6. 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.

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

8. Ha az eszköz továbbra is fut, válassza a Start lehetőséget. Ha az eszköz nem fut, nem látja a telemetriát.

   

9. 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. Miután mindhárom üzenettípust látta, 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 tárolja.

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árolófió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 Ugrás az erőforráshoz 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 storage account create paranccsal hozzon létre egy általános célú v2 szabványtárfiókot.

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

3. A storage container create használatával adjon hozzá egy tárolót az adattároló fiókjához.

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

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

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

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ó egy korábban konfigurált végpont esetében. 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 részletesebb információkért tekintse meg az Azure Storage-t útválasztási végpontként.

Fontos

Ez a cikk a szolgáltatáshoz való csatlakozás lépéseit tartalmazza közös hozzáférésű jogosultságkód használatával. Ez a hitelesítési módszer a teszteléshez és a kiértékeléshez kényelmes, de biztonságosabb módszer a Microsoft Entra-azonosítóval vagy felügyelt identitásokkal történő hitelesítés egy szolgáltatáshoz. További információkért tekintse meg a felhőalapú biztonság > IoT-megoldások biztonsági legjobb gyakorlatait.

Azure Portal

1. Az Azure Portalon nyissa meg az IoT Hubot.

2. A(z) Központi beállítások alatt az Erőforrás menüben válassza a Üzenet útválasztása lehetőséget, majd válassza 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álasszon Tárolót. 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 + bővítmények kihagyása lehetőséget.

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 iot hub message-endpoint create parancsával hozzon létre egy egyéni végpontot, amely az előző szakaszban létrehozott tárolókonténerre mutat.

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

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

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

Irányított üzenetek megtekintése

Miután az útvonal létrejött az IoT Hubban, és engedélyezve van, azonnal elindítja azokat az útválasztási üzeneteket, amelyek megfelelnek a lekérdezési feltételnek a tárolási vé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 tisztí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. Használja az resource list parancsot az erőforráscsoportja összes erőforrásának megtekintéséhez.

   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 törölni szeretné az összes erőforrást, használja a 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

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