Delen via

Zelfstudie: Naamruimteonderwerpen gebruiken om MQTT-berichten te routeren naar Azure Event Hubs (Azure Portal)

In deze zelfstudie leert u hoe u een naamruimteonderwerp gebruikt om gegevens van MQTT-clients naar Azure Event Hubs te routeren.

Vereisten

  • Als u geen Azure-abonnement hebt, maakt u een gratis Azure-account voordat u begint.
  • Lees het Event Grid-overzicht voordat u begint als u nieuw bent bij Event Grid.
  • Registreer de Event Grid-resourceprovider volgens de stappen in De Event Grid-resourceprovider registreren.
  • Zorg ervoor dat poort 8883 is geopend in uw firewall. Het voorbeeld in deze zelfstudie maakt gebruik van het MQTT-protocol, dat communiceert via poort 8883. Deze poort kan worden geblokkeerd in sommige bedrijfs- en onderwijsnetwerkomgevingen.

Een naamruimte in de Azure-portal maken

Een naamruimte in Azure Event Grid is een logische container voor een of meer onderwerpen, clients, clientgroepen, onderwerpruimten en machtigingsbindingen. Met een Azure Event Grid-naamruimte kunt u gerelateerde resources groeperen en beheren als één eenheid in uw Azure-abonnement. Met een unieke naamruimte kunt u meerdere resources in dezelfde Azure-regio hebben.

Ga als volgt te werk om een naamruimte te maken:

  1. Meld u aan bij het Azure-portaal.

  2. Voer in het zoekvak Event Grid-naamruimten in en selecteer Event Grid-naamruimten in de resultaten.

    Schermopname van Event Grid-naamruimten in de zoekresultaten.

  3. Selecteer + Maken op de pagina Event Grid-naamruimten.

    Schermopname van de pagina Event Grid-naamruimten met de knop Maken op de werkbalk geselecteerd.

  4. Volg deze stappen op de pagina Basisbeginselen .

    1. Selecteer het Azure-abonnement waarin u de naamruimte wilt maken.

    2. Selecteer een bestaande resourcegroep of maak een resourcegroep.

    3. Voer een naam in voor de naamruimte.

    4. Selecteer de locatie voor de naamruimte.

    5. Kies Beoordelen + creëren.

      Schermopname van het tabblad Basis van de pagina Naamruimte maken.

  5. Controleer uw instellingen op het tabblad Controleren en maken . Klik vervolgens op Maken.

  6. Selecteer op de pagina Implementatie geslaagd de optie Ga naar de resource om naar uw naamruimte te navigeren.

Een naamruimteonderwerp maken

  1. Als u zich niet op de pagina Event Grid-naamruimte bevindt, volgt u de stappen voor het maken, weergeven en beheren van naamruimten om de naamruimte weer te geven die u wilt gebruiken om het onderwerp te maken.

  2. Selecteer Onderwerpen op de pagina Event Grid-naamruimte onder Event Broker.

  3. Selecteer + Onderwerp op de pagina Onderwerpen.

    Schermopname van het maken van een Event Grid-naamruimteonderwerp.

  4. Typ op de pagina Onderwerp maken de naam van het onderwerp dat u wilt maken en selecteer Maken.

    Schermopname van de basisbeginselen van het maken van event grid-naamruimten.

Beheerde identiteit inschakelen voor de Event Grid-naamruimte

  1. Selecteer Identiteit op de pagina Event Grid-naamruimte onder Instellingen.

  2. Als u een door het systeem toegewezen beheerde identiteit wilt inschakelen, selecteert u Aan.

  3. Selecteer Opslaan om de instelling op te slaan.

    Schermopname van een door het systeem toegewezen identiteitspagina voor een Event Grid-naamruimte.

  4. Selecteer Ja in het bevestigingsbericht.

  5. Controleer of u de object-id van de door het systeem toegewezen beheerde identiteit ziet en bekijk een koppeling om rollen toe te wijzen.

    Schermopname van het toewijzen van identiteit aan een naamruimte is voltooid.

    Controleer meldingen in Azure Portal om te bevestigen dat de beheerde identiteit is ingeschakeld voor de naamruimte.

MQTT-broker inschakelen voor de Event Grid-naamruimte

  1. Selecteer Configuratie op de pagina Event Grid-naamruimte onder Instellingen.

  2. Selecteer MQTT-broker inschakelen.

  3. Selecteer Toepassen.

    Schermopname van de configuratiepagina van de Event Grid-naamruimte om MQTT in te schakelen.

    Controleer meldingen in Azure Portal om te bevestigen dat de MQTT-broker is ingeschakeld voor de naamruimte.

Gebruik Azure Portal op een afzonderlijk tabblad van de webbrowser of in een afzonderlijk venster om een Event Hubs-naamruimte te maken met een Event Hub.

Een Event Hubs-naamruimte maken

Een Event Hubs-naamruimte biedt een uniek bereikkader waarin u Event Hubs maakt. Een naamruimte maken in uw resourcegroep met behulp van de portal:

  1. Selecteer Alle services in azure Portal in het flyoutmenu. Zoek en selecteer Event Hubs op de pagina Alle services.

    Schermopname van de selectie van Event Hubs op de pagina Alle services.

  2. Selecteer Maken op de pagina Event Hubs.

    Schermopname van de selectie van de knop Maken op de pagina Event Hubs.

  3. Voer op de pagina Naamruimte maken de volgende stappen uit:

    1. Selecteer het abonnement waarin u de naamruimte wilt maken.

    2. Selecteer de resourcegroep die u in de vorige stap hebt gemaakt.

    3. Voer een naam in voor de naamruimte. In het systeem wordt onmiddellijk gecontroleerd of de naam beschikbaar is.

    4. Selecteer een regio voor de naamruimte.

    5. Kies Basic voor de prijscategorie.

      Opmerking

      Als u van plan bent om de naamruimte van Apache Kafka-apps te gebruiken, gebruikt u de Standard-laag . De basic-laag biedt geen ondersteuning voor Apache Kafka-workloads. Zie de artikelen Quota en limieten, Event Hubs Premium en Event Hubs Dedicated voor meer informatie over verschillen tussen lagen.

    6. Laat de doorvoereenheden (voor standaardniveau) of verwerkingseenheden (voor premium-tarief) ongewijzigd. Zie De schaalbaarheid van Event Hubs voor meer informatie over doorvoereenheden of verwerkingseenheden.

    7. Selecteer Beoordelen en Creëren.

      Schermopname van de pagina Naamruimte maken in Azure Portal.

    8. Controleer de instellingen op de pagina Controleren en maken, en selecteer Maken. Wacht totdat de installatie is voltooid.

  4. Selecteer op de pagina Implementatie de optie Ga naar resource om naar de pagina voor uw naamruimte te gaan.

    Schermopname van de pagina Implementatie voltooid met de koppeling naar de resource.

  5. Bevestig dat de pagina Naamruimte van Event Hubs lijkt op het volgende voorbeeld:

    Schermopname van de startpagina voor uw Event Hubs-naamruimte in Azure Portal.

Een Event Hub maken

Ga als volgt te werk om een Event Hub in de naamruimte te maken:

  1. Selecteer + Event Hub op de pagina Overzicht.

    Schermopname van de selectie van de knop Event Hub toevoegen op de opdrachtbalk.

  2. Typ een naam voor uw Event Hub en selecteer Vervolgens Beoordelen en maken.

    Schermopname van de pagina Event Hub maken.

  3. Selecteer Maken op de pagina Beoordelen en maken.

  4. U kunt de status van het Event Hub-creatieproces bekijken in de waarschuwingen. Nadat de event hub is gemaakt, wordt deze weergegeven in de lijst met event hubs.

    Schermopname van de lijst met Event Hubs.

Event Grid-naamruimte toegang geven tot het verzenden van gebeurtenissen naar de Event Hub

  1. Op de pagina Event Hubs-naamruimte, selecteer Toegangsbeheer (IAM).

  2. Selecteer + Toevoegen op de pagina Toegangsbeheer en selecteer vervolgens Roltoewijzing toevoegen.

    Schermopname van de pagina Toegangsbeheer voor de Event Hubs-naamruimte.

  3. Selecteer op de pagina Roltoewijzing toevoegen in de lijst met rollen de optie Azure Event Hubs-gegevenszender en selecteer vervolgens Volgende.

    Schermopname van de pagina Roltoewijzing toevoegen met Azure Event Hubs-gegevenszender geselecteerd.

  4. Voer op de pagina Leden de volgende stappen uit:

    1. Selecteer Beheerde identiteit voor het veld Toegang tot het veld Toewijzen.

    2. Kies + Leden selecteren.

      Schermopname van de pagina Roltoewijzing toevoegen met Beheerde identiteit geselecteerd.

  5. Voer op de pagina Beheerde identiteiten selecteren de volgende stappen uit:

    1. Selecteer uw Azure-abonnement.

    2. Selecteer Event Grid-naamruimte voor beheerde identiteit.

    3. Selecteer de beheerde identiteit met dezelfde naam als de Event Grid-naamruimte.

    4. Kies en selecteer.

      Schermopname van de pagina Beheerde identiteiten selecteren met de beheerde identiteit van de Event Grid-naamruimte geselecteerd.

  6. Selecteer Beoordelen en toewijzen op de pagina Roltoewijzing toevoegen.

  7. Selecteer Beoordelen en toewijzen op de pagina Beoordelen en toewijzen.

Een gebeurtenisabonnement maken met Event Hubs als eindpunt

  1. Ga naar het tabblad van uw webbrowservenster waarop de Event Grid-naamruimte is geopend.

  2. Selecteer Onderwerpen op de pagina Event Grid-naamruimte.

  3. Selecteer op de pagina Onderwerpen het naamruimteonderwerp dat u eerder hebt gemaakt.

    Schermopname van de pagina Onderwerpen met het naamruimteonderwerp geselecteerd.

  4. Selecteer + Abonnement op de pagina Event Grid-naamruimteonderwerp.

    Schermopname van de pagina Abonnementen.

  5. Voer op de pagina Abonnement maken de volgende stappen uit:

    1. Voer een naam in voor het gebeurtenisabonnement.

    2. Selecteer Push voor de bezorgingsmodus.

    3. Controleer of het eindpunttype is ingesteld op Event Hub.

    4. Selecteer Een eindpunt configureren.

      Schermopname van de pagina Abonnement maken.

    5. Voer op de pagina Event Hub selecteren de volgende stappen uit:

      1. Selecteer het Azure-abonnement met de Event Hub.

      2. Selecteer de resourcegroep met de Event Hub.

      3. Selecteer de Event Hubs-naamruimte.

      4. Selecteer de Event Hub in de Event Hubs-naamruimte.

      5. Selecteer vervolgens De selectie bevestigen.

        Schermopname van de pagina Event Hub selecteren.

    6. Selecteer op de pagina Abonnement maken de optie Systeem toegewezen voor het type beheerde identiteit.

    7. Klik op Creëren.

      Schermopname van de pagina Abonnement maken met de knop Maken geselecteerd.

Routering configureren in de Event Grid-naamruimte

  1. Ga terug naar de pagina Event Grid-naamruimte door de naamruimte te selecteren in de sectie Essentials van de event grid-naamruimteonderwerppagina of door de naamruimtenaam in het breadcrumb-menu bovenaan te selecteren.

  2. Selecteer Routering op de pagina Event Grid-naamruimte onder MQTT-broker.

  3. Selecteer routering inschakelen op de pagina Routering.

  4. Voor onderwerptype selecteert u het onderwerp Naamruimte.

  5. Selecteer voor Onderwerp het Event Grid-naamruimteonderwerp dat u hebt gemaakt waar alle MQTT-berichten worden gerouteerd.

  6. Selecteer Toepassen.

    Schermopname van de pagina Routering met het onderwerp naamruimte geselecteerd.

    Controleer meldingen om te bevestigen dat de naamruimte is ingeschakeld met de routeringsgegevens.

Clients, onderwerpruimte en machtigingsbindingen maken

Volg de stappen in deze quickstart: Publiceren en abonneren op een MQTT-onderwerp voor:

  1. Maak een client. U kunt desgewenst de tweede client maken, maar dit is optioneel.

  2. Maak een onderwerpruimte.

  3. Maak machtigingenbindingen voor uitgevers en abonnees.

  4. Gebruik MQTTX om een paar berichten te verzenden.

  5. Controleer of de Event Hub deze berichten heeft ontvangen op de pagina Overzicht voor uw Event Hubs-naamruimte.

    Schermopname van de overzichtspagina van de Event Hub met het aantal binnenkomende berichten.

Gerouteerde MQTT-berichten in Event Hubs weergeven met behulp van een Stream Analytics-query

Navigeer naar het Event Hubs-exemplaar (event hub) in uw gebeurtenisabonnement in de Azure-portal. Gegevens van uw Event Hub verwerken met behulp van Stream Analytics. Zie Gegevens van uw Event Hub verwerken met behulp van Azure Stream Analytics voor meer informatie. U kunt de MQTT-berichten in de query zien.

Schermopname van de MQTT-berichtengegevens in Event Hubs met behulp van het stream analytics-queryhulpprogramma.

Volgende stap

Ga voor codevoorbeelden naar de GitHub-opslagplaats MqttApplicationSamples.