Rövid útmutató: Telemetriai adatok küldése egy eszközről egy IoT Hubra, és annak monitorozása az Azure CLI-vel

Cikk
06/01/2023

Az IoT Hub olyan Azure-szolgáltatás, amely lehetővé teszi nagy mennyiségű telemetria betöltését egy IoT-eszközről a felhőbe tárolás vagy feldolgozás céljából. Ebben a kód nélküli rövid útmutatóban az Azure CLI használatával hoz létre egy IoT Hubot és egy szimulált eszközt. Eszköz telemetriát fog küldeni a központnak, és üzeneteket, hívási módszereket és tulajdonságokat fog küldeni az eszközön. Az eszközmetrikák megjelenítéséhez a Azure Portal is használni fogja. Ez a cikk egy alapszintű munkafolyamatot mutat be azoknak a fejlesztőknek, akik a parancssori felületet használják egy IoT Hub alkalmazás használatához.

Előfeltételek

Ha nem rendelkezik Azure-előfizetéssel, a kezdés előtt hozzon létre egyet ingyen .
Azure CLI. Ebben a rövid útmutatóban az összes parancsot futtathatja az Azure Cloud Shell használatával, amely egy interaktív CLI-felület, amely a böngészőben vagy egy olyan alkalmazásban fut, mint a Windows terminál. Ha a Cloud Shell használja, nem kell semmit telepítenie. Ha inkább helyileg szeretné használni a cli-t, ehhez a rövid útmutatóhoz az Azure CLI 2.36-os vagy újabb verziójára van szükség. A verzió azonosításához futtassa a következőt: az --version. Telepítéshez vagy frissítéshez: Az Azure CLI telepítése.

Jelentkezzen be az Azure Portalra.

Függetlenül attól, hogy a parancssori felületet helyileg vagy a Cloud Shell futtatja, a portált nyitva kell tartania a böngészőben. Ezt a rövid útmutató későbbi részében fogja használni.

Indítsa el a Cloud Shell

Ebben a szakaszban elindítja az Azure Cloud Shell egy példányát. Ha helyileg használja a parancssori felületet, ugorjon a Két CLI-munkamenet előkészítése című szakaszra.

A Cloud Shell indítása:

Válassza a Cloud Shell gombot a Azure Portal jobb felső menüsorán.

Megjegyzés

Ha először használja a Cloud Shell, a rendszer kéri, hogy hozzon létre tárterületet, amely a Cloud Shell használatához szükséges. Válasszon ki egy előfizetést a tárfiók és a Microsoft Azure-fájlmegosztás létrehozásához.
Válassza ki az előnyben részesített CLI-környezetet a Környezet kiválasztása legördülő menüben. Ez a rövid útmutató a Bash-környezetet használja. A PowerShell-környezetet is használhatja.

Megjegyzés

Egyes parancsok eltérő szintaxist vagy formázást igényelnek a Bash - és PowerShell-környezetekben . További információ: Tippek az Azure CLI sikeres használatához.

Két CLI-munkamenet előkészítése

Ezután két Azure CLI-munkamenetet fog előkészíteni. Ha a Cloud Shell használja, ezeket a munkameneteket külön Cloud Shell lapon fogja futtatni. Ha helyi CLI-ügyfelet használ, külön CLI-példányokat fog futtatni. A következő feladatokhoz használja a külön CLI-munkameneteket:

Az első munkamenet egy IoT-eszközt szimulál, amely kommunikál az IoT Hubbal.
A második munkamenet vagy az első munkamenetben figyeli az eszközt, vagy üzeneteket, parancsokat és tulajdonságfrissítéseket küld.

Parancs futtatásához válassza a Másolás lehetőséget egy kódblokk másolásához ebben a rövid útmutatóban, illessze be a rendszerhéj-munkamenetbe, és futtassa.

Az Azure CLI használatához be kell jelentkeznie az Azure-fiókjába. Az Azure CLI-rendszerhéj munkamenete és az IoT Hub közötti összes kommunikáció hitelesítve és titkosítva van. Ennek eredményeképpen ez a rövid útmutató nem igényel olyan extra hitelesítést, amelyet valódi eszközzel, például egy kapcsolati sztring használ.

Az első CLI-munkamenetben futtassa az az extension add parancsot. A parancs hozzáadja az Azure CLI-hez készült Microsoft Azure IoT-bővítményt a CLI-felülethez. Az IOT-bővítmény IoT Hub, IoT Edge és IoT Device Provisioning Service (DPS) specifikus parancsokat ad hozzá az Azure CLI-hez.
```
az extension add --name azure-iot
```
Az Azure IOT-bővítmény telepítése után nem kell újra telepítenie egy Cloud Shell munkamenetben sem.

Megjegyzés

Ez a cikk az Azure IoT-bővítmény legújabb, nevű azure-iotverzióját használja. Az örökölt verzió neve azure-cli-iot-ext. Egyszerre csak egy verziót kell telepítenie. Az paranccsal az extension list ellenőrizheti a jelenleg telepített bővítményeket.

A használatával az extension remove --name azure-cli-iot-ext eltávolíthatja a bővítmény régi verzióját.

A bővítmény új verziójának hozzáadásához használja az extension add --name azure-iot a parancsot.

A telepített bővítmények megtekintéséhez használja a következőt az extension list: .
Nyissa meg a második CLI-munkamenetet. Ha böngészőben használja a Cloud Shell, használja az Új munkamenet megnyitása gombot. Ha helyileg használja a PARANCSSORI-t, nyisson meg egy második CLI-példányt.

IoT Hub létrehozása

Ebben a szakaszban az Azure CLI használatával fog létrehozni egy erőforráscsoportot és egy IoT Hubot. Az Azure-erőforráscsoport olyan logikai tároló, amelybe a rendszer üzembe helyezi és kezeli az Azure-erőforrásokat. Az IoT Hub központi üzenetközpontként szolgál az IoT-alkalmazás és az eszközök közötti kétirányú kommunikációhoz.

Tipp

Igény szerint létrehozhat egy Azure-erőforráscsoportot, egy IoT Hubot és más erőforrásokat a Azure Portal, a Visual Studio Code vagy más programozott módszerek használatával.

Az első CLI-munkamenetben futtassa az az group create parancsot egy erőforráscsoport létrehozásához. A következő parancs létrehoz egy MyResourceGroup nevű erőforráscsoportot az eastus helyen.
```
az group create --name MyResourceGroup --location eastus
```
Az első CLI-munkamenetben futtassa az Az PowerShell-modul iot hub create parancsát egy IoT Hub létrehozásához. Az IoT Hub létrehozása eltarthat néhány percig.

YourIotHubName. Cserélje le ezt a helyőrzőt és a környező kapcsos zárójeleket a következő parancsban az IoT Hubhoz választott névvel. Az IoT Hub nevének globálisan egyedinek kell lennie az Azure-ban. Használja az IoT Hub nevét a rövid útmutató többi részében, ahol a helyőrzőt látja.
```
az iot hub create --resource-group MyResourceGroup --name {YourIoTHubName}
```

Eszköz létrehozása és monitorozása

Ebben a szakaszban egy szimulált eszközt hoz létre az első CLI-munkamenetben. A szimulált eszköz eszköz telemetriát küld az IoT Hubnak. A második CLI-munkamenetben eseményeket és telemetriát figyelhet.

Szimulált eszköz létrehozása és elindítása:

Az első CLI-munkamenetben futtassa az az iot hub device-identity create parancsot. Ez a parancs létrehozza a szimulált eszközidentitást.

YourIotHubName. Cserélje le az alábbi helyőrzőt az IoT Hubhoz választott névre.

simDevice. Ezt a nevet közvetlenül a szimulált eszközhöz használhatja a rövid útmutató további részében. Ha szeretné, használjon másik nevet.
```
az iot hub device-identity create -d simDevice -n {YourIoTHubName} 
```
Az első CLI-munkamenetben futtassa az az iot device simulate parancsot. Ez a parancs elindítja a szimulált eszközt. Az eszköz telemetriát küld az IoT Hubnak, és üzeneteket fogad tőle.

YourIotHubName. Cserélje le az alábbi helyőrzőt az IoT Hubhoz választott névre.
```
az iot device simulate -d simDevice -n {YourIoTHubName}
```

Eszköz monitorozása:

A második CLI-munkamenetben futtassa az az iot hub monitor-events parancsot. Ez a parancs folyamatosan figyeli a szimulált eszközt. A kimenet telemetriai adatokat jelenít meg, például eseményeket és tulajdonságállapot-módosításokat, amelyeket a szimulált eszköz küld az IoT Hubnak.

YourIotHubName. Cserélje le az alábbi helyőrzőt az IoT Hubhoz választott névre.
```
az iot hub monitor-events --output table -p all -n {YourIoTHubName}
```
Miután monitorozza a szimulált eszközt a második CLI-munkamenetben, a Ctrl+C billentyűkombinációt lenyomva állítsa le a monitorozást. Tartsa nyitva a második CLI-munkamenetet a későbbi lépésekben való használathoz.

Üzenet küldése a parancssori felület használatával

Ebben a szakaszban egy üzenetet küld a szimulált eszköznek.

Az első CLI-munkamenetben győződjön meg arról, hogy a szimulált eszköz továbbra is fut. Ha az eszköz leállt, futtassa a következő parancsot az újraindításához:

YourIotHubName. Cserélje le az alábbi helyőrzőt az IoT Hubhoz választott névre.
```
az iot device simulate -d simDevice -n {YourIoTHubName}
```
A második PARANCSSOR-munkamenetben futtassa az az iot device c2d-message send parancsot. Ez a parancs egy felhőből eszközre irányuló üzenetet küld az IoT Hubról a szimulált eszközre. Az üzenet tartalmaz egy sztringet és két kulcs-érték párot.

YourIotHubName. Cserélje le az alábbi helyőrzőt az IoT Hubhoz választott névre.
```
az iot device c2d-message send -d simDevice --data "Hello World" --props "key0=value0;key1=value1" -n {YourIoTHubName}
```
A felhőből az eszközre irányuló üzeneteket a Azure Portal használatával is küldheti. Ehhez keresse meg a IoT Hub áttekintési oldalát, válassza az IoT-eszközök lehetőséget, válassza ki a szimulált eszközt, és válassza az Üzenet eszközre lehetőséget.
Az első CLI-munkamenetben győződjön meg arról, hogy a szimulált eszköz megkapta az üzenetet.

Eszközmetódus meghívása a parancssori felület használatával

Ebben a szakaszban egy közvetlen metódust hív meg a szimulált eszközön.

Ahogy korábban is tette, ellenőrizze, hogy fut-e a szimulált eszköz az első CLI-munkamenetben. Ha nem, indítsa újra.
A második CLI-munkamenetben futtassa az az iot hub invoke-device-method parancsot. Ebben a példában nincs már létezik metódus az eszközhöz. A parancs meghív egy példametódusnevet a szimulált eszközön, és hasznos adatokat ad vissza.

YourIotHubName. Cserélje le az alábbi helyőrzőt az IoT Hubhoz választott névre.
```
az iot hub invoke-device-method --mn MySampleMethod -d simDevice -n {YourIoTHubName}
```
Az első CLI-munkamenetben ellenőrizze, hogy a kimenet megjeleníti-e a metódushívást.

Eszköztulajdonságok frissítése a parancssori felület használatával

Ebben a szakaszban a szimulált eszköz állapotát a tulajdonságértékek beállításával frissítheti.

Ahogy korábban is tette, ellenőrizze, hogy fut-e a szimulált eszköz az első CLI-munkamenetben. Ha nem, indítsa újra.
A második CLI-munkamenetben futtassa az az iot hub device-twin update parancsot. Ez a parancs frissíti a tulajdonságokat a szimulált eszköznek megfelelő IoT Hub-ikereszköz kívánt állapotára. Ebben az esetben a parancs beállítja a példa hőmérsékleti feltétel tulajdonságait.

Fontos

Ha a Parancssori felületen használja a PowerShellt, használja az alábbi parancs PowerShell-verzióját. A PowerShell megköveteli, hogy elkerülje a JSON hasznos adatban lévő karaktereket.

YourIotHubName. Cserélje le az alábbi helyőrzőt az IoT Hubhoz választott névre.
```
az iot hub device-twin update -d simDevice --desired '{"conditions":{"temperature":{"warning":98, "critical":107}}}' -n {YourIoTHubName}
```
```
az iot hub device-twin update -d simDevice --desired '{\"conditions\":{\"temperature\":{\"warning\":98, \"critical\":107}}}' -n {YourIoTHubName}
```
Az első CLI-munkamenetben győződjön meg arról, hogy a szimulált eszköz a tulajdonságfrissítést adja ki.
A második CLI-munkamenetben futtassa az az iot hub device-twin show parancsot. Ez a parancs az eszköz tulajdonságainak változásait jelenti.

YourIotHubName. Cserélje le az alábbi helyőrzőt az IoT Hubhoz választott névre.
```
az iot hub device-twin show -d simDevice --query properties.reported -n {YourIoTHubName}
```

Üzenetkezelési metrikák megtekintése a portálon

A Azure Portal lehetővé teszi az IoT Hub és az eszközök minden aspektusának kezelését. Egy tipikus IoT Hub alkalmazásokban, amelyek telemetriát dolgoznak fel az eszközökről, érdemes lehet figyelni az eszközöket, vagy megtekinteni a metrikákat az eszköz telemetriáin.

Üzenetkezelési metrikák megjelenítése a Azure Portal:

A portál bal oldali navigációs menüjében válassza a Minden erőforrás lehetőséget. Ezen a lapon az előfizetés összes erőforrása megtalálható, beleértve a létrehozott IoT Hubot is.
Válassza ki a létrehozott IoT Hub hivatkozását. A portál megjeleníti a központ áttekintési oldalát.
A IoT Hub bal oldali ablaktábláján válassza a Metrikák lehetőséget.
A Hatókör mezőben adja meg az IoT Hub nevét.
A Metrikanévtér mezőben válassza az Iot Hub Standard metrikák lehetőséget.
A Metrika mezőben válassza a Felhasznált üzenetek teljes száma lehetőséget.
Vigye az egérmutatót annak az idővonalnak a területére, amelyben az eszköz üzeneteket küldött. Az adott időpontban lévő üzenetek teljes száma az idősor bal alsó sarkában jelenik meg.
A Metrika legördülő menüben más metrikákat is megjeleníthet a szimulált eszközön. Például befejeződött a C2d-üzenetszállítások vagy az Összes eszköz (előzetes verzió).

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

Ha már nincs szüksége az ebben a rövid útmutatóban létrehozott Azure-erőforrásokra, az Azure CLI használatával törölheti őket.

Ha folytatja a következő javasolt cikket, megtarthatja a már létrehozott erőforrásokat, és újra felhasználhatja őket.

Fontos

Az erőforráscsoport törlése nem vonható vissza. Az erőforráscsoport és a benne foglalt erőforrások véglegesen törlődnek. Figyeljen arra, hogy ne töröljön véletlenül erőforráscsoportot vagy erőforrásokat.

Erőforráscsoport törlése név alapján:

Futtassa az az group delete parancsot. Ez a parancs eltávolítja az erőforráscsoportot, az IoT Hubot és a létrehozott eszközregisztrációt.
```
az group delete --name MyResourceGroup
```
Futtassa az az group list parancsot az erőforráscsoport törlésének megerősítéséhez.
```
az group list
```

Következő lépések

Ebben a rövid útmutatóban az Azure CLI használatával létrehozott egy IoT Hubot, létrehozott egy szimulált eszközt, telemetriát küldött és figyelt, metódust hívott meg, beállította a kívánt tulajdonságokat, és megtisztította az erőforrásokat. A Azure Portal használta az üzenetkezelési metrikák megjelenítésére az eszközön.

Ha Ön eszközfejlesztő, a következő javasolt lépés a C-hez készült Azure IoT Device SDK-t használó telemetriai gyorsútmutató megtekintése. Ha szeretné, tekintse meg az egyik elérhető Azure IoT Hub telemetriai gyorsútmutatót a kívánt nyelven vagy SDK-ban.

Ha meg szeretné tudni, hogyan vezérelheti a szimulált eszközt egy háttéralkalmazáson keresztül, folytassa a következő oktatóanyaggal.

Rövid útmutató: IoT Hubhoz csatlakozó eszköz vezérlése