Share via

Zelfstudie: Azure IoT Hub-berichtverrijkingen gebruiken

Berichtverrijkingen zijn de mogelijkheid van Azure IoT Hub om berichten te stempelen met aanvullende informatie voordat de berichten naar het aangewezen eindpunt worden verzonden. Een van de redenen voor het gebruik van berichtverrijkingen is het opnemen van gegevens die kunnen worden gebruikt om downstreamverwerking te vereenvoudigen. Het verrijken van apparaatberichten met een apparaat-twin tag kan bijvoorbeeld de belasting voor klanten verminderen door API-aanroepen naar apparaattwins voor deze informatie te reduceren. Zie Overzicht van berichtverrijkingen voor meer informatie.

In het eerste deel van deze zelfstudie hebt u gezien hoe u aangepaste eindpunten kunt maken en berichten kunt routeren naar andere Azure-services. In deze zelfstudie ziet u hoe u de extra resources kunt maken en configureren die nodig zijn om berichtverrijkingen voor een IoT-hub te testen. De resources bevatten een tweede opslagcontainer voor een bestaand opslagaccount (gemaakt in het eerste deel van de zelfstudie) voor het opslaan van de verrijkte berichten en een berichtroute om ze daarheen te verzenden. Nadat de configuraties voor de berichtroutering en berichtverrijkingen zijn voltooid, gebruikt u een toepassing om berichten naar de IoT-hub te verzenden. De hub stuurt ze vervolgens naar beide opslagcontainers. Alleen de berichten die naar het eindpunt voor de verrijkte opslagcontainer worden verzonden, worden verrijkt.

In deze zelfstudie voert u de volgende taken uit:

  • Maak een tweede container in uw opslagaccount.
  • Maak een ander aangepast eindpunt en routeer berichten naar het eindpunt vanuit de IoT-hub.
  • Configureer berichtverrijkingen die naar het nieuwe eindpunt worden gerouteerd.
  • Voer een app uit die een IoT-apparaat simuleert dat berichten naar de hub verzendt.
  • Bekijk de resultaten en controleer of de berichtverrijkingen worden toegepast op de doelberichten.

Vereisten

Er zijn geen andere vereisten voor Azure Portal.

Een tweede container maken in uw opslagaccount

In het eerste deel van deze zelfstudie hebt u een opslagaccount en container gemaakt voor gerouteerde berichten. Nu moet u een tweede container maken voor verrijkte berichten.

  1. Zoek in Azure Portal naar Opslagaccounts.

  2. Selecteer het account dat u eerder hebt gemaakt.

  3. Selecteer Containers in het menu opslagaccount in de sectie Gegevensopslag.

  4. Selecteer Container om de nieuwe container te maken.

    Schermopname van het maken van een opslagcontainer.

  5. Geef de container enrichedeen naam en selecteer Maken.

Berichten routeren naar een tweede eindpunt

Maak een tweede eindpunt en route voor de verrijkte berichten.

Belangrijk

Dit artikel bevat stappen voor het maken van verbinding met een service met behulp van een handtekening voor gedeelde toegang. Deze verificatiemethode is handig voor testen en evalueren, maar verificatie bij een service met Microsoft Entra ID of beheerde identiteiten is een veiligere benadering. Zie Best practices voor beveiliging voor Cloudbeveiliging voor IoT-oplossingen >voor meer informatie.

  1. Ga in Azure Portal naar uw IoT-hub.

  2. Selecteer in het resourcemenu onder Hub-instellingen de optie Berichtroutering en selecteer Vervolgens Toevoegen.

    Schermopname van de locatie van de knop Toevoegen om een nieuwe route toe te voegen in uw IoT-hub.

  3. Maak op het tabblad Eindpunt een opslageindpunt door de volgende informatie op te geven:

    Parameter Waarde
    Eindpunttype Selecteer Opslag.
    Eindpuntnaam Voer ContosoStorageEndpointEnriched in.
    Azure Storage-container Selecteer Een container kiezen. Volg de aanwijzingen om het opslagaccount en de verrijkte container te selecteren die u in de vorige sectie hebt gemaakt.
    Codering Selecteer JSON. Als dit veld grijs wordt weergegeven, biedt uw opslagaccountregio geen ondersteuning voor JSON. In dat geval gaat u verder met de standaard AVRO.

    Schermopname van het selecteren van een container voor een eindpunt.

  4. Accepteer de standaardwaarden voor de rest van de parameters en selecteer Maken + volgende.

  5. Ga door met het maken van de nieuwe route, nu u het opslageindpunt hebt toegevoegd. Geef de volgende informatie op voor de nieuwe route:

    Parameter Waarde
    Naam ContosoStorageRouteEnriched
    Gegevensbron Controleer of Apparaattelemetrieberichten is geselecteerd in de vervolgkeuzelijst.
    Route inschakelen Controleer of dit veld is ingesteld op enabled.
    Routeringsvraag Voer level="storage" in als querystring.

    Schermopname van het opslaan van routeringsquerygegevens.

  6. Selecteer Verrijkingen maken en toevoegen.

Berichtverrijking toevoegen aan het nieuwe eindpunt

Maak drie berichtverrijkingen die worden gerouteerd naar de verrijkte opslagcontainer.

  1. Op het tabblad Verrijking van de Een route toevoegen-wizard, voeg drie berichtverrijkingen toe voor de berichten die naar het eindpunt gaan voor de opslagcontainer genaamd verrijkt.

    Voeg deze waarden toe als berichtverrijkingen voor het eindpunt ContosoStorageEndpointEnriched:

    Naam Waarde
    myIotHub $hubname
    Apparatenlocatie $twin.tags.location (gaat ervan uit dat de apparaatdubbel een locatietag heeft)
    klant-ID 6ce345b8-1e4a-411e-9398-d34587459a3a

    Wanneer u klaar bent, moeten uw verrijkingen er ongeveer als volgt uitzien:

    Schermopname van tabel met alle verrijkingen toegevoegd.

  2. Selecteer Toevoegen om de berichtverrijkingen toe te voegen.

U hebt nu berichtverrijkingen ingesteld voor alle berichten die worden doorgestuurd naar het eindpunt dat u hebt gemaakt voor verrijkte berichten. Als u geen lokalisatietag wilt toevoegen aan de device twin, kunt u naar de sectie Berichtverrijkingen testen gaan om de tutorial voort te zetten.

Locatietag toevoegen aan de digitale tweeling van het apparaat

Een van de berichtverrijkingen die op uw IoT-hub zijn geconfigureerd, specificeert een sleutel DeviceLocation met de waarde die wordt bepaald door het volgende pad naar de apparaat-twin: $twin.tags.location. Als uw apparaat-twin geen locatietag heeft, wordt het twin-pad $twin.tags.location, als een tekenreeks voor de DeviceLocation-sleutel in de berichtverrijkingen vastgelegd.

Volg deze stappen om een locatietag toe te voegen aan de tweeling van uw apparaat:

  1. Navigeer naar uw IoT-hub in Azure Portal.

  2. Selecteer Apparaten in het navigatiemenu van de IoT-hub en selecteer vervolgens uw apparaat.

  3. Selecteer het tabblad Apparaattweeling bovenaan de apparaatpagina en voeg de volgende regel toe vlak voor de sluitaccolade onderaan de apparaattweeling. Selecteer vervolgens Opslaan.

      , "tags": {"location": "Plant 43"}

    Schermopname van het toevoegen van een locatietag aan apparaatdubbel in Azure Portal.

Tip

Wacht ongeveer vijf minuten voordat u verdergaat met de volgende sectie. Het kan zolang duren voordat updates van de apparaat-tweeling zichtbaar worden in de waarden voor berichtverrijking.

Voor meer informatie over hoe apparaat-twinpaden worden beheerd met berichtverrijkingen, zie beperkingen van berichtverrijkingen. Zie Apparaatdubbels begrijpen en gebruiken in IoT Hub voor meer informatie over apparaatdubbels.

Verrijkingen van testberichten

Nu de berichtverrijkingen zijn geconfigureerd voor het eindpunt ContosoStorageEndpointEnriched , voert u de toepassing voor het gesimuleerde apparaat uit om berichten naar de IoT-hub te verzenden. Op dit moment is berichtroutering als volgt ingesteld:

  • Berichten die worden doorgestuurd naar het opslageindpunt dat u in het eerste deel van de zelfstudie hebt gemaakt , worden niet verrijkt en worden opgeslagen in de opslagcontainer die u vervolgens hebt gemaakt.

  • Berichten die worden doorgestuurd naar het opslageindpunt ContosoStorageEndpointEnriched , worden verrijkt en opgeslagen in de opslagcontainer verrijkt.

Als u de SimulatedDevice-consoletoepassing nog niet uitvoert vanuit het eerste deel van deze zelfstudie, voert u deze opnieuw uit:

Tip

Als u de Azure CLI-stappen voor deze zelfstudie volgt, voert u de voorbeeldcode uit in een afzonderlijke sessie. Op die manier kunt u toestaan dat de voorbeeldcode wordt uitgevoerd terwijl u de rest van de CLI-stappen volgt.

  1. Navigeer in de voorbeeldmap naar de /iot-hub/Tutorials/Routing/SimulatedDevice/ map.

  2. De variabelendefinities die u eerder hebt bijgewerkt, moeten nog steeds geldig zijn, maar zo niet, bewerk ze in het Program.cs bestand:

    1. Zoek de variabele definities bovenaan de klasse Program. Werk de volgende variabelen bij met uw eigen gegevens:

      • s_myDeviceId: de apparaat-id die u hebt toegewezen bij het registreren van het apparaat bij uw IoT-hub.
      • s_iotHubUri: de hostnaam van uw IoT-hub, die de indeling IOTHUB_NAME.azure-devices.netgebruikt.
      • s_deviceKey: de primaire sleutel van het apparaat in de apparaat-id-gegevens.

    2. Sla het bestand op en sluit het bestand.

  3. Voer de voorbeeldcode uit:

    dotnet run

Nadat u de consoletoepassing een paar minuten hebt laten draaien, bekijkt u de gegevens.

  1. Ga in Azure Portal naar uw opslagaccount.

  2. Selecteer Opslagbrowser in het navigatiemenu. Selecteer Blob-containers om de twee containers te zien die u in de loop van deze zelfstudies hebt gemaakt.

    Schermopname van de blobcontainers in het opslagaccount.

De berichten in de container verrijkt genoemd, bevatten de berichtverrijkingen. De berichten in de container die u eerder hebt gemaakt, bevatten de onbewerkte berichten zonder verrijkingen. Zoom in op de verrijkte container totdat u onderaan komt en open vervolgens het meest recente berichtbestand. Doe hetzelfde voor de andere container om te controleren of de ene is verrijkt en niet.

Wanneer u berichten bekijkt die zijn verrijkt, zou u "myIotHub" moeten zien, samen met de hubnaam, de locatie en de klant-id, zoals dit:

{
  "EnqueuedTimeUtc":"2019-05-10T06:06:32.7220000Z",
  "Properties":
  {
    "level":"storage",
    "myIotHub":"{your hub name}",
    "DeviceLocation":"Plant 43",
    "customerID":"6ce345b8-1e4a-411e-9398-d34587459a3a"
  },
  "SystemProperties":
  {
    "connectionDeviceId":"Contoso-Test-Device",
    "connectionAuthMethod":"{\"scope\":\"device\",\"type\":\"sas\",\"issuer\":\"iothub\",\"acceptingIpFilterRule\":null}",
    "connectionDeviceGenerationId":"636930642531278483",
    "enqueuedTime":"2019-05-10T06:06:32.7220000Z"
  },"Body":"eyJkZXZpY2VJZCI6IkNvbnRvc28tVGVzdC1EZXZpY2UiLCJ0ZW1wZXJhdHVyZSI6MjkuMjMyMDE2ODQ4MDQyNjE1LCJodW1pZGl0eSI6NjQuMzA1MzQ5NjkyODQ0NDg3LCJwb2ludEluZm8iOiJUaGlzIGlzIGEgc3RvcmFnZSBtZXNzYWdlLiJ9"
}

Middelen opschonen

Als u alle resources wilt verwijderen die u in beide delen van deze zelfstudie hebt gemaakt, verwijdert u de resourcegroep. Hiermee verwijdert u alle resources in de groep. Als u de hele resourcegroep niet wilt verwijderen, kunt u afzonderlijke resources selecteren die u wilt verwijderen.

  1. Navigeer in Azure Portal naar de resourcegroep met het IoT-hub- en opslagaccount voor deze zelfstudie.
  2. Bekijk alle resources in de resourcegroep om te bepalen welke u wilt opschonen.
    • Als u alle resources wilt verwijderen, selecteert u Resourcegroep verwijderen.
    • Als u alleen bepaalde resources wilt verwijderen, gebruikt u de selectievakjes naast elke resourcenaam om de resources te selecteren die u wilt verwijderen. Selecteer daarna Verwijderen.

Volgende stappen

In deze zelfstudie hebt u berichtverrijkingen geconfigureerd en getest voor IoT Hub-berichten terwijl ze worden gerouteerd naar een eindpunt.

Zie Overzicht van berichtverrijkingen voor meer informatie over berichtverrijkingen.

Ga verder met de volgende zelfstudie voor meer informatie over IoT Hub.

Zelfstudie: Metrische gegevens en logboeken instellen en gebruiken met een IoT-hub