Självstudie: Skicka enhetsdata till Azure Storage med hjälp av IoT Hub meddelandedirigering

Använd meddelanderoutning i Azure IoT Hub för att skicka telemetridata från dina IoT-enheter till Azure-tjänster som bloblagring, Service Bus-köer, Service Bus-ämnen och Event Hubs. Varje IoT-hubb har en inbyggd standardslutpunkt som är kompatibel med Event Hubs. Du kan också skapa anpassade slutpunkter och dirigera meddelanden till andra Azure-tjänster genom att definiera routningsfrågor. Varje meddelande som kommer till IoT-hubben dirigeras till alla slutpunkter vars routningsfrågor den matchar. Om ett meddelande inte matchar någon av de definierade routningsfrågorna dirigeras det till standardslutpunkten.

I den här självstudien utför du följande åtgärder:

• Skapa en IoT-hubb och skicka enhetsmeddelanden till den.
• Skapa ett lagringskonto.
• Skapa en anpassad slutpunkt för lagringskontot och dirigera meddelanden till det från IoT-hubben.
• Visa enhetsmeddelanden i lagringskontobloben.

Förutsättningar

• En Azure-prenumeration. Om du inte har någon Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.

• En IoT-hubb i din Azure-prenumeration. Om du inte har någon hubb ännu kan du följa stegen i Skapa en IoT-hubb.

• I den här självstudien används exempelkod från Azure IoT SDK för C#.

  • Ladda ned eller klona SDK-lagringsplatsen till utvecklingsdatorn.
  • Ha .NET Core 3.0.0 eller senare på utvecklingsdatorn. Kontrollera din version genom att köra dotnet --version och ladda ned .NET om det behövs.

• Kontrollera att port 8883 är öppen i brandväggen. Exemplet i den här självstudien använder MQTT-protokollet, som kommunicerar via port 8883. Den här porten kan blockeras i vissa företags- och utbildningsnätverksmiljöer. Mer information och sätt att kringgå det här problemet finns i Ansluta till IoT Hub (MQTT).

• Du kan också installera Azure IoT Explorer. Det här verktyget hjälper dig att observera meddelandena när de kommer till din IoT-hubb. Den här artikeln använder Azure IoT Explorer.

Azure-portalen

Det finns inga andra krav för Azure Portal.

Azure CLI

• Använd Bash-miljön i Azure Cloud Shell. Mer information finns i Snabbstart för Bash i Azure Cloud Shell.

  

• Om du föredrar att köra CLI-referenskommandon lokalt installerar du Azure CLI. Om du kör i Windows eller macOS kan du köra Azure CLI i en Docker-container. Mer information finns i Så här kör du Azure CLI i en Docker-container.

  • Om du använder en lokal installation loggar du in på Azure CLI med hjälp av kommandot az login. Slutför autentiseringsprocessen genom att följa stegen som visas i terminalen. Andra inloggningsalternativ finns i Logga in med Azure CLI.

  • När du uppmanas att göra det installerar du Azure CLI-tillägget vid första användning. Mer information om tillägg finns i Använda tillägg med Azure CLI.

  • Kör az version om du vill hitta versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.

Registrera en enhet och skicka meddelanden till IoT Hub

Registrera en ny enhet i din IoT-hubb.

Azure-portalen

1. Logga in på Azure Portal och gå till din IoT-hubb.

2. Välj Enheter i avsnittet Enhetshantering på menyn.

3. Välj Lägg till enhet.

   

4. Ange ett enhets-ID och välj Spara.

5. Den nya enheten ska finnas i listan över enheter nu. Om den inte är det uppdaterar du sidan. Välj enhets-ID för att öppna sidan med enhetsinformation.

6. Kopiera en av enhetsnycklarna och spara den. Du använder det här värdet för att konfigurera exempelkoden som genererar simulerade meddelanden om enhetstelemetri.

   

Azure CLI

Tips

Många av de CLI-kommandon som används i den här självstudien använder samma parametrar. För din bekvämlighet har vi dig att definiera lokala variabler som kan anropas efter behov. Se till att köra alla kommandon i samma session, annars måste du omdefiniera variablerna.

1. Definiera variabler för din IoT-hubb och enhet.

   IOTHUB_NAME: Ersätt den här platshållaren med namnet på din IoT-hubb.

   DEVICE_NAME: Ersätt den här platshållaren med ett namn som du vill använda för enheten i den här självstudien.

   hubName=IOTHUB_NAME
   deviceName=DEVICE_NAME
   

2. Kör kommandot az iot hub device-identity create i CLI-gränssnittet . Det här kommandot skapar enhetsidentiteten.

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

3. Från enhetsidentitetens utdata kopierar du värdet primaryKey utan de omgivande citattecknen och sparar det. Du använder det här värdet för att konfigurera exempelkoden som genererar simulerade meddelanden om enhetstelemetri.

Nu när du har ett enhets-ID och en nyckel använder du exempelkoden för att börja skicka enhetstelemetrimeddelanden till IoT Hub.

Tips

Om du följer Azure CLI-stegen för den här självstudien kör du exempelkoden i en separat session. På så sätt kan du tillåta att exempelkoden fortsätter att köras medan du följer resten av CLI-stegen.

1. Om du inte gjorde det som en del av förutsättningarna laddar du ned eller klonar Azure IoT SDK för C#-lagringsplatsen från GitHub nu.

2. Från mappen där du laddade ned eller klonade SDK:t navigerar du till azure-iot-sdk-csharp\iothub\device\samples\how to guides\HubRoutingSample mappen .

3. Installera Azure IoT C# SDK och nödvändiga beroenden enligt vad som anges i HubRoutingSample.csproj filen:

   dotnet restore
   

4. Öppna filen i Parameters.cs valfri redigerare. Den här filen visar de parametrar som stöds av exemplet. Endast parametern PrimaryConnectionString används i den här artikeln när du kör exemplet. Granska koden i den här filen. Inga ändringar behövs.

5. Skapa och kör exempelkoden med följande kommando:

   Ersätt <myDevicePrimaryConnectionString> med din primära anslutningssträng från enheten i IoT-hubben.

   dotnet run --PrimaryConnectionString <myDevicePrimaryConnectionString>
   

6. Du bör börja se meddelanden som skrivs ut till utdata när de skickas till IoT Hub. Låt det här programmet köras under självstudien.

Konfigurera IoT Explorer för att visa meddelanden

Konfigurera IoT Explorer för att ansluta till din IoT-hubb och läsa meddelanden när de kommer till den inbyggda slutpunkten.

Hämta först anslutningssträngen för din IoT-hubb.

Azure-portalen

1. Gå till din IoT-hubb på Azure Portal.

2. Välj Principer för delad åtkomst i avsnittet Säkerhetsinställningar på menyn.

3. Välj principen iothubowner .

   

4. Kopiera den primära anslutningssträngen.

   

Azure CLI

1. Kör kommandot az iot hub connection-string show :

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

2. Kopiera anslutningssträngen utan de omgivande citattecknen.

Använd nu anslutningssträngen för att konfigurera IoT Explorer för din IoT-hubb.

1. Öppna IoT Explorer på utvecklingsdatorn.

2. Välj Lägg till anslutning.

   

3. Klistra in hubbens anslutningssträng i textrutan.

4. Välj Spara.

5. När du ansluter till din IoT-hubb bör du se en lista över enheter. Välj det enhets-ID som du skapade för den här självstudien.

6. Välj Telemetri.

7. När enheten fortfarande körs väljer du Starta. Om enheten inte körs visas inte telemetri.

   

8. Du bör se de meddelanden som kommer från enheten, och de senaste visas längst upp.

   

   Titta på inkommande meddelanden en liten stund för att kontrollera att du ser tre olika typer av meddelanden: normal, lagring och kritisk. När du har sett detta kan du stoppa enheten.

Alla dessa meddelanden kommer till den inbyggda standardslutpunkten för din IoT-hubb. I nästa avsnitt ska vi skapa en anpassad slutpunkt och dirigera några av dessa meddelanden till lagring baserat på meddelandeegenskaperna. Dessa meddelanden slutar att visas i IoT Explorer eftersom meddelanden endast går till den inbyggda slutpunkten när de inte matchar några andra vägar i IoT Hub.

Konfigurera meddelandedirigering

Du kommer att dirigera meddelanden till olika resurser baserat på egenskaper som är kopplade till meddelandet av den simulerade enheten. Meddelanden som inte är anpassade dirigeras skickas till standardslutpunkten (meddelanden/händelser).

Exempelappen för den här självstudien tilldelar en nivåegenskap till varje meddelande som skickas till IoT Hub. Varje meddelande tilldelas slumpmässigt en nivå av normal, lagring eller kritisk.

Det första steget är att konfigurera slutpunkten som data ska dirigeras till. Det andra steget är att konfigurera meddelandevägen som använder slutpunkten. När du har konfigurerat routningen kan du visa slutpunkter och meddelandevägar i portalen.

Skapa ett lagringskonto

Skapa ett Azure Storage-konto och en container i det kontot, som innehåller de enhetsmeddelanden som dirigeras till det.

Azure-portalen

1. I Azure Portal söker du efter Lagringskonton.

2. Välj Skapa.

3. Ange följande värden för ditt lagringskonto:

   Parameter	Värde
   Prenumeration	Välj samma prenumeration som innehåller din IoT-hubb.
   Resursgrupp	Välj samma resursgrupp som innehåller din IoT-hubb.
   Namn på lagringskonto	Ange ett globalt unikt namn för ditt lagringskonto.
   Prestanda	Acceptera standardvärdet Standard .

   

4. Du kan acceptera alla andra standardvärden genom att välja Granska + skapa.

5. När verifieringen är klar väljer du Skapa.

6. När distributionen är klar väljer du Gå till resurs.

7. I menyn för lagringskontot väljer du Containrar i avsnittet Datalagring .

8. Välj + Container för att skapa en ny container.

   

9. Ange ett namn för containern och välj Skapa.

Azure CLI

1. Definiera variablerna för ditt lagringskonto och din container.

   GROUP_NAME: Ersätt den här platshållaren med namnet på resursgruppen som innehåller din IoT-hubb.

   STORAGE_NAME: Ersätt den här platshållaren med ett namn på ditt lagringskonto. Lagringskontonamn måste vara gemener och globalt unika.

   CONTAINER_NAME: Ersätt den här platshållaren med ett namn på containern.

   resourceGroup=GROUP_NAME
   storageName=STORAGE_NAME
   containerName=CONTAINER_NAME
   

2. Använd kommandot az storage account create för att skapa ett standardlagringskonto för generell användning v2.

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

3. Använd az storage container create för att lägga till en container i ditt lagringskonto.

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

Dirigera till ett lagringskonto

Konfigurera nu routning för lagringskontot. I det här avsnittet definierar du en ny slutpunkt som pekar på det lagringskonto som du skapade. Skapa sedan en väg som filtrerar för meddelanden där nivåegenskapen är inställd på lagring och dirigerar dem till lagringsslutpunkten.

Anteckning

Data kan skrivas till Blob Storage i antingen Apache Avro-format , som är standard, eller JSON.

Kodningsformatet kan bara anges när bloblagringsslutpunkten har konfigurerats. Det går inte att ändra formatet för en slutpunkt som redan har konfigurerats. När du använder JSON-kodning måste du ange contentType till JSON och contentEncoding till UTF-8 i egenskaperna för meddelandesystemet.

Mer detaljerad information om hur du använder en bloblagringsslutpunkt finns i vägledningen om routning till lagring.

Azure-portalen

1. I Azure Portal går du till din IoT-hubb.

2. I resursmenyn under Hubbinställningar väljer du Meddelandedirigering och sedan Lägg till.

   

3. På fliken Slutpunkt skapar du en Lagringsslutpunkt genom att ange följande information:

   Parameter	Värde
   Slutpunktstyp	Välj Lagring.
   Slutpunktsnamn	Ange ett unikt namn för den här slutpunkten.
   Azure Storage-container	Välj Välj en container. Följ anvisningarna för att välja lagringskontot och containern som du skapade i föregående avsnitt.
   Kodning	Välj JSON. Om det här fältet är nedtonat stöder inte lagringskontots region JSON. I så fall fortsätter du med standard-AVRO.

   

4. Acceptera standardvärdena för resten av parametrarna och välj Skapa + nästa.

5. På fliken Väg anger du följande information för att skapa en väg som pekar på lagringsslutpunkten som du skapade:

   Parameter	Värde
   Namn	Skapa ett namn för din väg.
   Datakälla	Kontrollera att Enhetstelemetrimeddelanden har valts i listrutan.
   Aktivera väg	Kontrollera att det här fältet är markerat.
   Routningsfråga	Ange level="storage" som frågesträng.

   

6. Välj Skapa + hoppa över berikanden.

Azure CLI

1. Konfigurera de variabler som du behöver för slutpunkts- och vägkommandona.

   ENDPOINT_NAME: Ange ett namn för slutpunkten som representerar lagringscontainern.

   ROUTE_NAME: Ange ett namn för den väg som filtrerar meddelanden för lagringsslutpunkten

   endpointName=ENDPOINT_NAME
   routeName=ROUTE_NAME
   

2. Använd kommandot az iot hub routing-endpoint create för att skapa en anpassad slutpunkt som pekar på lagringscontainern som du skapade i föregående avsnitt.

   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. Använd kommandot az iot hub route create för att skapa en väg som skickar ett meddelande till level=storage lagringscontainerns slutpunkt.

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

Visa dirigerade meddelanden

När vägen har skapats i IoT Hub och aktiverats börjar den omedelbart dirigera meddelanden som uppfyller frågevillkoret till lagringsslutpunkten.

Övervaka den inbyggda slutpunkten med IoT Explorer

Gå tillbaka till IoT Explorer-sessionen på utvecklingsdatorn. Kom ihåg att IoT Explorer övervakar den inbyggda slutpunkten för din IoT-hubb. Det innebär att du nu bara bör se de meddelanden som inte dirigeras av den anpassade vägen som vi skapade.

Starta exemplet igen genom att köra koden. Titta på inkommande meddelanden en liten stund och du bör bara se meddelanden där level är inställt på normal eller critical.

Visa meddelanden i lagringscontainern

Kontrollera att meddelandena kommer till lagringscontainern.

1. Navigera till ditt lagringskonto på Azure-portalen.

2. Välj Containrar i avsnittet Datalagring på menyn.

3. Välj den container som du skapade för den här självstudien.

4. Det bör finnas en mapp med namnet på din IoT-hubb. Öka detaljnivån i filstrukturen tills du kommer till en .json-fil .

   

5. Välj JSON-filen och välj sedan Ladda ned för att ladda ned JSON-filen. Bekräfta att filen innehåller meddelanden från enheten som har level egenskapen inställd på storage.

6. Sluta köra exemplet.

Rensa resurser

Om du vill ta bort alla Azure-resurser som du använde för den här självstudien tar du bort resursgruppen. Detta tar även bort alla resurser som ingår i gruppen. Om du inte vill ta bort hela resursgruppen använder du Azure Portal för att hitta och ta bort de enskilda resurserna.

Om du tänker fortsätta till nästa självstudie behåller du de resurser som du skapade här.

Azure-portalen

1. I Azure Portal går du till den resursgrupp som innehåller IoT-hubben och lagringskontot för den här självstudien.
2. Granska alla resurser som finns i resursgruppen för att avgöra vilka du vill rensa.
   • Om du vill ta bort alla resurser väljer du Ta bort resursgrupp.
   • Om du bara vill ta bort vissa resurser använder du kryssrutorna bredvid varje resursnamn för att markera de som du vill ta bort. Välj sedan Ta bort.

Azure CLI

1. Använd kommandot az resource list för att visa alla resurser i resursgruppen.

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

2. Granska alla resurser som finns i resursgruppen för att avgöra vilka du vill rensa.

   • Om du vill ta bort alla resurser använder du kommandot az group delete .

     az group delete --name $resourceGroup
     

   • Om du bara vill ta bort vissa resurser använder du kommandot az resource delete . Exempel:

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

Nästa steg

I den här självstudien har du lärt dig hur du skapar en anpassad slutpunkt för en Azure-resurs och sedan skapar en väg för att skicka enhetsmeddelanden till den slutpunkten. Fortsätt till nästa självstudie om du vill lära dig hur du utökar meddelanden med extra data som kan användas för att förenkla nedströmsbearbetning

Använda Azure IoT Hub meddelandeberikningar