Snabbstart: Skicka telemetri från en enhet till en IoT-hubb och övervaka den med Azure CLI

Artikel
11/25/2021
7 minuter för att läsa

IoT Hub är en Azure-tjänst som gör att du kan mata in stora mängder telemetri från IoT-enheter i molnet för lagring eller bearbetning. I den här snabbstarten använder du Azure CLI för att skapa en IoT Hub och en simulerad enhet, skicka enhettelemetri till hubben och skicka ett moln-till-enhet-meddelande. Du kan också använda Azure Portal för att visualisera enhetsmått. Det här är ett grundläggande arbetsflöde för utvecklare som använder CLI för att interagera med IoT Hub program.

Förutsättningar

Om du inte har en Azure-prenumeration kan du skapa en utan kostnad innan du börjar.
Azure CLI. Du kan köra alla kommandon i den här snabbstarten med Azure Cloud Shell, ett interaktivt CLI-gränssnitt som körs i webbläsaren. Om du använder Cloud Shell behöver du inte installera något. Om du föredrar att använda CLI lokalt kräver den här snabbstarten Azure CLI version 2.0.76 eller senare. Kör az --version för att se versionen. Om du behöver installera eller uppgradera kan du läsa Installera Azure CLI.

Logga in på Azure Portal på https://portal.azure.com.

Oavsett om du kör CLI lokalt eller i Cloud Shell ska du hålla portalen öppen i webbläsaren. Du använder den senare i den här snabbstarten.

Starta Cloud Shell

I det här avsnittet startar du en instans av Azure Cloud Shell. Om du använder CLI lokalt går du vidare till avsnittet Förbereda två CLI-sessioner.

Så här startar du Cloud Shell:

Välj knappen Cloud Shell längst upp till höger i Azure Portal.

Anteckning

Om det är första gången du använder Cloud Shell uppmanas du att skapa lagring, vilket krävs för att använda Cloud Shell. Välj en prenumeration för att skapa ett lagringskonto och Microsoft Azure Files-resurs.
Välj önskad CLI-miljö i listrutan Välj miljö. Den här snabbstarten använder Bash-miljön. Alla följande CLI-kommandon fungerar även i PowerShell-miljön.

Förbereda två CLI-sessioner

I det här avsnittet förbereder du två Azure CLI-sessioner. Om du använder Cloud Shell kör du de två sessionerna på separata webbläsarflikar. Om du använder en lokal CLI-klient kör du två separata CLI-instanser. Du använder den första sessionen som en simulerad enhet och den andra sessionen för att övervaka och skicka meddelanden. Om du vill köra ett kommando väljer du Kopiera för att kopiera ett kodblock i den här snabbstarten, klistrar in det i gränssnittssessionen och kör det.

Azure CLI kräver att du är inloggad på ditt Azure-konto. All kommunikation mellan Din Azure CLI-gränssnittssession och din IoT-hubb autentiseras och krypteras. Därför behöver den här snabbstarten inte ytterligare autentisering som du använder med en riktig enhet, till exempel en anslutningssträng.

Kör kommandot az extension add för att lägga till Microsoft Azure IoT-tillägg för Azure CLI i CLI-gränssnittet. IOT-tillägget lägger IoT Hub, IoT Edge och IoT Device Provisioning Service (DPS) specifika kommandon till Azure CLI.
```
az extension add --name azure-iot
```
När du har installerat Azure IOT-tillägget behöver du inte installera det igen i någon Cloud Shell session.

Anteckning

I den här artikeln används den senaste versionen av Azure IoT-tillägget, som kallas azure-iot . Den äldre versionen kallas azure-cli-iot-ext . Du bör bara ha en version installerad i taget. Du kan använda kommandot az extension list för att validera de installerade tilläggen.

Används az extension remove --name azure-cli-iot-ext för att ta bort den äldre versionen av tillägget.

Använd az extension add --name azure-iot för att lägga till den nya versionen av tillägget.

Om du vill se vilka tillägg du har installerat använder du az extension list .
Öppna en andra CLI-session. Om du använder Cloud Shell väljer du Öppna ny session. Om du använder CLI lokalt öppnar du en andra instans.

Skapa en IoT Hub

I det här avsnittet använder du Azure CLI för att skapa en resursgrupp och en IoT Hub. En Azure-resursgrupp är en logisk container där Azure-resurser distribueras och hanteras. En IoT Hub fungerar som en central meddelandehubb för dubbelriktad kommunikation mellan ditt IoT-program och enheterna.

Tips

Du kan också skapa en Azure-resursgrupp, en IoT Hub och andra resurser med hjälp av Azure Portal, Visual Studio Codeeller andra programmässiga metoder.

Kör kommandot az group create för att skapa en resursgrupp. Följande kommando skapar en resursgrupp med namnet MyResourceGroup på platsen eastus.
```
az group create --name MyResourceGroup --location eastus
```
Kör kommandot az iot hub create för att skapa en IoT-hubb. Det kan ta några minuter att skapa en IoT-hubb.

YourIotHubName. Ersätt platshållaren nedan med det namn som du har valt för din IoT-hubb. Ett IoT-hubbnamn måste vara globalt unikt i Azure. Den här platshållaren används i resten av den här snabbstarten för att representera namnet på din IoT-hubb.
```
az iot hub create --resource-group MyResourceGroup --name {YourIoTHubName}
```

Skapa och övervaka en enhet

I det här avsnittet skapar du en simulerad enhet i den första CLI-sessionen. Den simulerade enheten skickar enhetste telemetri till din IoT-hubb. I den andra CLI-sessionen övervakar du händelser och telemetri och skickar ett moln-till-enhet-meddelande till den simulerade enheten.

Så här skapar och startar du en simulerad enhet:

Kör kommandot az iot hub device-identity create i den första CLI-sessionen. Detta skapar den simulerade enhetsidentiteten.

YourIotHubName. Ersätt platshållaren nedan med det namn som du har valt för din IoT-hubb.

simDevice. Du kan använda det här namnet direkt för den simulerade enheten i resten av den här snabbstarten. Du kan också använda ett annat namn.
```
az iot hub device-identity create --device-id simDevice --hub-name {YourIoTHubName} 
```
Kör kommandot az iot device simulate i den första CLI-sessionen. Detta startar den simulerade enheten. Enheten skickar telemetri till din IoT-hubb och tar emot meddelanden från den.

YourIotHubName. Ersätt platshållaren nedan med det namn som du har valt för din IoT-hubb.
```
az iot device simulate -d simDevice -n {YourIoTHubName}
```

Så här övervakar du en enhet:

I den andra CLI-sessionen kör du kommandot az iot hub monitor-events. Detta börjar övervaka den simulerade enheten. Utdata visar telemetri som den simulerade enheten skickar till IoT-hubben.

YourIotHubName. Ersätt platshållaren nedan med det namn som du har valt för din IoT-hubb.
```
az iot hub monitor-events --output table --hub-name {YourIoTHubName}
```
När du har övervakat den simulerade enheten i den andra CLI-sessionen trycker du på Ctrl+C för att stoppa övervakningen.

Använda CLI för att skicka ett meddelande

I det här avsnittet använder du den andra CLI-sessionen för att skicka ett meddelande till den simulerade enheten.

I den första CLI-sessionen bekräftar du att den simulerade enheten körs. Om enheten har stoppats kör du följande kommando för att starta den:

YourIotHubName. Ersätt platshållaren nedan med det namn som du har valt för din IoT-hubb.
```
az iot device simulate -d simDevice -n {YourIoTHubName}
```
I den andra CLI-sessionen kör du kommandot az iot device c2d-message send. Detta skickar ett moln-till-enhet-meddelande från din IoT-hubb till den simulerade enheten. Meddelandet innehåller en sträng och två nyckel/värde-par.

YourIotHubName. Ersätt platshållaren nedan med det namn som du har valt för din IoT-hubb.
```
az iot device c2d-message send -d simDevice --data "Hello World" --props "key0=value0;key1=value1" -n {YourIoTHubName}
```
Du kan också skicka meddelanden från moln till enhet med hjälp av Azure Portal. Det gör du genom att gå till översiktssidan för IoT Hub, välja IoT-enheter, välja den simulerade enheten och välja Meddelande till enhet.
I den första CLI-sessionen bekräftar du att den simulerade enheten tog emot meddelandet.
När du har tittat på meddelandet stänger du den andra CLI-sessionen. Låt den första CLI-sessionen vara öppen. Du kan använda den för att rensa resurser i ett senare steg.

Visa meddelandemått i portalen

Med Azure Portal kan du hantera alla aspekter av dina IoT Hub och enheter. I ett IoT Hub program som matar in telemetri från enheter kanske du vill övervaka enheter eller visa mått på enhetens telemetri.

Visualisera meddelandemått i Azure Portal:

I den vänstra navigeringsmenyn i portalen väljer du Alla resurser. Då visas alla resurser i din prenumeration, inklusive den IoT-hubb som du skapade.
Välj länken på den IoT-hubb som du skapade. Portalen visar översiktssidan för hubben.
Välj Mått i det vänstra fönstret i IoT Hub.
Ange namnet på din IoT-hubb i Omfång.
Välj Standardmått för IoT Hub i Namnområde för mått.
Välj Totalt antal meddelanden som används i Mått.
Håll muspekaren över området på tidslinjen där enheten skickade meddelanden. Det totala antalet meddelanden vid en tidpunkt visas i det nedre vänstra hörnet på tidslinjen.
Du kan också använda listrutan Mått för att visa andra mått på den simulerade enheten. Till exempel slutförda C2d-meddelandeleveranser eller Totalt antal enheter (förhandsversion).

Rensa resurser

Om du inte längre behöver De Azure-resurser som skapades i den här snabbstarten kan du använda Azure CLI för att ta bort dem.

Om du fortsätter till nästa rekommenderade artikel kan du behålla de resurser som du redan har skapat och återanvända dem.

Viktigt

Att ta bort en resursgrupp kan inte ångras. Resursgruppen och alla resurser som ingår i den tas bort permanent. Kontrollera att du inte av misstag tar bort fel resursgrupp eller resurser.

Ta bort en resursgrupp med namnet:

Kör kommandot az group delete. Detta tar bort resursgruppen, IoT Hub och enhetsregistreringen som du skapade.
```
az group delete --name MyResourceGroup
```
Kör kommandot az group list för att bekräfta att resursgruppen har tagits bort.
```
az group list
```

Nästa steg

I den här snabbstarten använde du Azure CLI för att skapa en IoT-hubb, skapa en simulerad enhet, skicka telemetri, övervaka telemetri, skicka ett moln till enhet-meddelande och rensa resurser. Du använde Azure Portal för att visualisera meddelandemått på enheten.

Om du är enhetsutvecklare föreslår vi att du går vidare med snabbstarten för telemetri som använder Azure IoT Device SDK för C. Om du vill kan du läsa någon av de tillgängliga snabbstartsartiklarna om Azure IoT Hub-telemetri på önskat språk eller SDK.

Om du vill veta hur du kan styra den simulerade enheten från ett serverdelsprogram fortsätter du till nästa snabbstart.

Snabbstart: Kontrollera en enhet ansluten till en IoT-hubb