Share via

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

  • Artikel

In deze zelfstudie leert u hoe u een naamruimteonderwerp gebruikt om gegevens van MQTT-clients naar Azure Event Hubs te routeren. Dit zijn de stappen op hoog niveau:

Vereisten

  • Als u geen Azure-abonnement hebt, maakt u een gratis Azure-account voordat u begint.
  • Als u niet eerder met Event Grid werkt, leest u het Event Grid-overzicht voordat u aan deze zelfstudie begint.
  • 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. Het biedt een unieke naamruimte, zodat u meerdere resources in dezelfde Azure-regio kunt hebben. Met een Azure Event Grid-naamruimte kunt u nu gerelateerde resources groeperen en beheren als één eenheid in uw Azure-abonnement.

Volg de volgende secties om een Azure Event Grid-naamruimte te maken, weer te geven en te beheren.

Ga als volgt te werk om een naamruimte te maken:

  1. Meld u aan bij Azure Portal.

  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 werkbalk 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 regio of locatie waar u de naamruimte wilt maken.

    5. Selecteer Controleren en maken onderaan de pagina.

      Schermopname van het tabblad Basis van de pagina Naamruimte maken.

  5. Controleer uw instellingen op het tabblad Controleren en maken en selecteer 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 op de pagina Event Grid-naamruimte de optie Onderwerpen in de sectie Eventing in het menu links.

  3. Selecteer op de pagina Onderwerpen de knop + Onderwerp op de opdrachtbalk.

    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 onder Instellingen in het linkermenu op de pagina Event Grid-naamruimte.

  2. Schakel de schakeloptie in om een door het systeem toegewezen beheerde identiteit in te schakelen.

  3. Selecteer Opslaan op de werkbalk 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 de portal om te bevestigen dat de beheerde identiteit is ingeschakeld voor de naamruimte.

MQTT-broker inschakelen voor de Event Grid-naamruimte

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

  2. Schakel het selectievakje in naast MQTT-broker inschakelen.

  3. Selecteer Toepassen onderaan de pagina.

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

    Controleer meldingen in de 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 unieke scopingcontainer waarin u een of meer event hubs kunt maken. Ga als volgt te werk om een ​​naamruimte in uw resourcegroep te maken met behulp van de portal:

  1. Selecteer in Azure Portal alle services in het linkermenu en selecteer ster (*) naast Event Hubs in de categorie Analyse . Controleer of Event Hubs is toegevoegd aan FAVORIETEN in het navigatiemenu aan de linkerkant.

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

  2. Selecteer Event Hubs onder FAVORIETEN in het navigatiemenu links en selecteer Maken op de werkbalk.

    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 locatie voor de naamruimte.

    5. Kies Basic voor de prijscategorie. 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 standard-laag) of verwerkingseenheden (voor Premium-laag) instellingen staan. Voor meer informatie over doorvoereenheden of verwerkingseenheden: Schaalbaarheid van Event Hubs.

    7. Selecteer Controleren en maken onderaan de pagina.

      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 opdrachtbalk 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. Selecteer op de pagina Event Hubs-naamruimte toegangsbeheer (IAM) in het linkermenu.

  2. Selecteer + Toevoegen op de opdrachtbalk 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 azure Event Hubs-gegevenszender in de lijst met rollen en selecteer vervolgens Volgende onderaan de pagina.

    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 Selecteren onder aan de pagina.

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

  6. Selecteer Op de pagina Roltoewijzing toevoegen de optie Controleren en toewijzen onderaan de pagina.

  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 in het linkermenu 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 opdrachtbalk bovenaan 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 in de 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. Selecteer Maken onderaan de pagina.

      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 in het linkermenu in de sectie MQTT-broker op de pagina Event Grid-naamruimte.

  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 de 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) binnen uw gebeurtenisabonnement in Azure Portal. Gegevens van uw Event Hub verwerken met behulp van Stream Analytics. Zie Procesgegevens van Azure Event Hubs met behulp van Stream Analytics - Azure Event Hubs | Microsoft Learn. 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 stappen

Ga naar deze GitHub-opslagplaats voor codevoorbeelden.