Tutorial: Weiterleiten von MQTT-Nachrichten an Azure Event Hubs mithilfe von Namespacethemen (Azure-Portal)

In diesem Tutorial verwenden Sie ein Namespace-Thema, um Daten von MQTT-Clients zu Azure Event Hubs weiterzuleiten. Wenn Sie Ihre MQTT-Nachrichten an Event Hubs weiterleiten, können Sie große Mengen an Gerätetelemetrie zu nachgelagerten Diensten zur Analyse, Speicherung und Verarbeitung streamen.

Voraussetzungen

  • Wenn Sie kein Azure-Abonnement haben, erstellen Sie ein kostenloses Azure-Konto, bevor Sie beginnen.
  • Wenn Sie noch nicht im Ereignisraster sind, lesen Sie die Übersicht über das Ereignisraster , bevor Sie beginnen.
  • Stellen Sie sicher, dass Port 8883 in Ihrer Firewall geöffnet ist. Für das Beispiel in diesem Tutorial wird das MQTT-Protokoll verwendet, das über Port 8883 kommuniziert. In einigen Netzwerkumgebungen von Unternehmen oder Bildungseinrichtungen könnte dieser Port unter Umständen blockiert sein.

Erstellen eines Namespace im Azure-Portal

Ein Namespace in Azure Event Grid ist ein logischer Container für ein oder mehrere Themen, Clients, Clientgruppen, Themenplätze und Berechtigungsbindungen. Mit einem Azure Event Grid-Namespace können Sie verwandte Ressourcen gruppieren und als einzelne Einheit in Ihrem Azure-Abonnement verwalten. Mit einem eindeutigen Namespace können Sie über mehrere Ressourcen in derselben Azure-Region verfügen.

So erstellen Sie einen Namespace

  1. Melden Sie sich beim Azure-Portal an.

  2. Geben Sie im Suchfeld Event Grid-Namespaces ein und wählen Sie Event Grid-Namespaces aus den Ergebnissen aus.

    Screenshot von Event Grid-Namespaces in den Suchergebnissen

  3. Wählen Sie auf der Seite "Event Grid Namespaces " die Option +Erstellen aus.

    Screenshot der Seite „Event Grid-Namespaces“ mit der ausgewählten Schaltfläche „Erstellen“ auf der Symbolleiste

  4. Führen Sie auf der Seite Grundlagen die folgenden Schritte aus.

    1. Wählen Sie das Azure-Abonnement aus, in dem der Namespace erstellt werden soll.

    2. Wählen Sie eine vorhandene Ressourcengruppe aus, oder erstellen Sie eine Ressourcengruppe.

    3. Geben Sie einen Namen für den Namespace ein.

    4. Wählen Sie den Standort für den Namespace aus.

    5. Klicken Sie auf Überprüfen + erstellen.

      Screenshot der Registerkarte „Grundlagen“ der Seite „Namespace erstellen“

  5. Überprüfen Sie Ihre Einstellungen auf der Registerkarte Überprüfen + Erstellen. Wählen Sie dann Erstellen aus.

  6. Wählen Sie auf der Seite Bereitstellung erfolgreich die Option Zu Ressource wechseln aus, um zu Ihrem Namespace zu navigieren.

Erstellen eines Namespacethemas

  1. Wenn Sie nicht auf der Event Grid-Namespace-Seite sind, führen Sie die Schritte zum Erstellen, Anzeigen und Verwalten von Namespaces aus, um den Namespace anzuzeigen, den Sie zum Erstellen des Themas verwenden möchten.

  2. Wählen Sie auf der Seite "Event Grid Namespace" unter "Ereignisbroker" die Option "Themen" aus.

  3. Wählen Sie auf der Seite "Themen"+Thema aus.

    Screenshot: Erstellung des Event Grid-Namespacethemas

  4. Geben Sie auf der Registerkarte Thema erstellen den Namen des Themas ein, das Sie erstellen möchten, und wählen Sie dann Erstellen aus.

    Screenshot: Grundlagen der Erstellung des Event Grid-Namespacethemas

Aktivieren der verwalteten Identität für den Event Grid-Namespace

  1. Wählen Sie auf der Seite "Event Grid Namespace " unter "Einstellungen" die Option "Identität" aus.

  2. Um eine vom System zugewiesene verwaltete Identität zu aktivieren, wählen Sie "Ein" aus.

  3. Wählen Sie "Speichern" aus, um die Einstellung zu speichern.

    Screenshot der Seite einer systemseitig zugewiesenen Identität für einen Event Grid-Namespace

  4. Wählen Sie in der Bestätigungsmeldung "Ja" aus.

  5. Bestätigen Sie, dass Sie die Objekt-ID der vom System zugewiesenen verwalteten Identität sehen und einen Link zum Zuweisen von Rollen sehen.

    Screenshot, der den Abschluss der Zuweisung einer Identität zu einem Namespace zeigt

    Überprüfen Sie Benachrichtigungen im Azure-Portal, um zu bestätigen, dass die verwaltete Identität für den Namespace aktiviert ist.

Aktivieren von MQTT Vermittler für den Event Grid-Namespace

  1. Wählen Sie auf der Seite "Event Grid Namespace " unter "Einstellungen" die Option "Konfiguration" aus.

  2. Wählen Sie "MQTT-Broker aktivieren" aus.

  3. Wählen Sie Übernehmen.

    Screenshot: Konfigurationsseite für den Event Grid-Namespace zur Aktivierung von MQTT

    Überprüfen Sie Benachrichtigungen im Azure-Portal, um zu bestätigen, dass der MQTT-Broker für den Namespace aktiviert ist.

In einem separaten Tab des Webbrowsers oder in einem separaten Fenster verwenden Sie das Azure-Portal, um einen Event Hubs-Namensraum mit einem Event Hub zu erstellen.

Erstellen eines Event Hubs-Namespace

Ein Event Hubs-Namespace stellt einen eindeutigen Bereichscontainer bereit, in dem Sie Event Hubs erstellen. So erstellen Sie einen Namespace in Ihrer Ressourcengruppe mithilfe des Portals:

  1. Wählen Sie im Azure-Portal im Flyoutmenü "Alle Dienste" aus. Suchen Sie auf der Seite "Alle Dienste " nach "Event Hubs", und wählen Sie sie aus.

    Screenshot: Auswahl von Event Hubs auf der Seite „Alle Dienste“

  2. Wählen Sie auf der Seite "Event Hubs " die Option "Erstellen" aus.

    Screenshot: Ausgewählte Schaltfläche „Erstellen“ auf der Seite „Event Hubs“

  3. Gehen Sie auf der Seite Namespace erstellen wie folgt vor:

    1. Wählen Sie das Abonnement aus, in dem Sie den Namespace erstellen möchten.

    2. Wählen Sie die Im vorherigen Schritt erstellte Ressourcengruppe aus.

    3. Geben Sie einen Namen für den Namespace ein. Das System überprüft sofort, ob dieser Name verfügbar ist.

    4. Wählen Sie eine Region für den Namespace aus.

    5. Wählen Sie für das Preisniveau " Einfach" aus.

      Hinweis

      Wenn Sie den Namespace aus Apache Kafka-Apps verwenden möchten, verwenden Sie den Standard-Tarif. Der Basic-Tarif unterstützt keine Apache Kafka-Workloads. Informationen zu den Unterschieden zwischen den Tarifen finden Sie in den Artikeln Kontingente und Grenzwerte, Event Hubs Premium und Event Hubs Dedicated.

    6. Lassen Sie die Durchsatzeinheiten (für die Standard-Ebene) oder Verarbeitungseinheiten (für die Premium-Ebene) so belassen, wie sie sind. Informationen zu Durchsatzeinheiten oder Verarbeitungseinheiten finden Sie unter Event Hubs Skalierbarkeit.

    7. Wählen Sie Überprüfen + Erstellen aus.

      Screenshot: Seite „Namespace erstellen“ im Azure-Portal

    8. Überprüfen Sie die Einstellungen auf der Seite Bewerten + erstellen, und wählen Sie Erstellen aus. Warten Sie, bis die Bereitstellung abgeschlossen ist.

  4. Wählen Sie auf der Seite Bereitstellung die Option Zu Ressource wechseln aus, um zur Seite für Ihren Namespace zu navigieren.

    Screenshot: Seite „Bereitstellung abgeschlossen“ mit dem Link zur Ressource

  5. Vergewissern Sie sich, dass die Seite Event Hubs-Namespace in etwa aussieht wie das folgende Beispiel:

    Screenshot: Homepage für Ihren Event Hubs-Namespace im Portal

Erstellen eines Ereignis-Hubs

Führen Sie die folgenden Schritte aus, um im Namespace einen Event Hub zu erstellen:

  1. Wählen Sie auf der Seite Übersicht+ Event Hub aus.

    Screenshot: Ausgewählte Schaltfläche „Event Hub hinzufügen“ auf der Befehlsleiste

  2. Geben Sie einen Namen für den Event Hub ein, und wählen Sie dann Überprüfen und erstellen aus.

    Screenshot: Seite „Event Hub erstellen“

  3. Wählen Sie auf der Seite Überprüfen + erstellen die Option Erstellen aus.

  4. Sie können den Status der Event Hub-Erstellung in den Warnungen überprüfen. Nachdem der Event Hub erstellt wurde, wird er in der Liste der Event Hubs angezeigt.

    Screenshot: Liste der Event Hubs

Geben Sie dem Event Grid Namensraum Zugang, um Ereignisse an den Event Hub zu senden

  1. Wählen Sie auf der Seite "Event Hubs Namespace"die Option Access Control (IAM) aus.

  2. Wählen Sie auf der Access-Steuerelementseite+Hinzufügen und dann " Rollenzuweisung hinzufügen" aus.

    Screenshot der Seite „Zugriffssteuerung“ für den Event Hubs-Namespace

  3. Wählen Sie auf der Seite " Rollenzuweisung hinzufügen " in der Liste der Rollen azure Event Hubs Data Sender aus, und wählen Sie dann "Weiter" aus.

    Screenshot der Seite „Rollenzuweisung hinzufügen“ mit ausgewählter Option „Azure Event Hubs-Datensender“

  4. Führen Sie auf der Seite Mitglieder die folgenden Schritte aus:

    1. Wählen Sie für das Feld Zugriff zuweisen zu die Option Verwaltete Identität aus.

    2. Wählen Sie + Mitglieder hinzufügen.

      Screenshot der Seite „Rollenzuweisung hinzufügen“ mit ausgewählter verwalteter Identität

  5. Führen Sie auf der Seite Verwaltete Identitäten auswählen die folgenden Schritte aus:

    1. Wählen Sie Ihr Azure-Abonnement.

    2. Wählen Sie für Verwaltete Identität die Option Event Grid-Namespace aus.

    3. Wählen Sie die verwaltete Identität aus, die denselben Namen wie der Event Grid-Namespace hat.

    4. Wählen Sie Select aus.

      Screenshot der Seite „Verwaltete Identitäten auswählen“ mit ausgewählter verwalteter Identität des Event Grid-Namespace

  6. Wählen Sie auf der Seite "Rollenzuweisung hinzufügen" die Option "Überprüfen+ Zuweisen" aus.

  7. Wählen Sie auf der Seite Überprüfen + zuweisen die Option Überprüfen + zuweisen aus.

Erstellen eines Ereignisabonnements mit Event Hubs als Endpunkt

  1. Wechsle zum Tab deines Webbrowser-Fensters, in dem der Event Grid-Namensraum geöffnet ist.

  2. Wählen Sie auf der Seite Event Grid-Namespace die Option Themen aus.

  3. Wählen Sie auf der Seite Themen das Namespacethema aus, das Sie zuvor erstellt haben.

    Screenshot der Seite „Themen“, auf der das Namespace-Thema ausgewählt ist.

  4. Wählen Sie auf der Seite "Event Grid Namespace Topic " die Option +Abonnement aus.

    Screenshot, der die Abonnementseite zeigt.

  5. Führen Sie auf der Seite Abonnement erstellen die folgenden Schritte aus:

    1. Geben Sie einen Namen für das Ereignisabonnement ein.

    2. Wählen Sie für Übermittlungsmodus die Option Push aus.

    3. Vergewissern Sie sich, dass der Endpunkttyp auf Event Hub festgelegt ist.

    4. Wählen Sie Endpunkt konfigurieren aus.

      Screenshot der Seite „Abonnement erstellen“

    5. Führen Sie auf der Seite "Event Hub auswählen " die folgenden Schritte aus:

      1. Wählen Sie das Azure-Abonnement mit dem Event Hub aus.

      2. Wählen Sie die Ressourcengruppe mit dem Event Hub aus.

      3. Wählen Sie den Event Hubs-Namespace aus.

      4. Wählen Sie den Event Hub im Event Hubs-Namespace aus.

      5. Wählen Sie " Auswahl bestätigen" aus.

        Screenshot der Seite „Event Hub auswählen“.

    6. Wählen Sie auf der Seite Abonnement erstellen unter Verwalteter Identitätstyp die Option Systemseitig zugewiesen aus.

    7. Wählen Sie "Erstellen" aus.

      Screenshot der Seite „Abonnement erstellen“ mit ausgewählter Schaltfläche „Erstellen“.

Konfigurieren des Routings im Event Grid-Namespace

  1. Gehen Sie zurück zur Seite Event Grid Namespace , indem Sie den Namensraum im Bereich Essentials der Event Grid Namespace Topic-Seite auswählen oder den Namen des Namensraums im Breadcrumb-Menü oben auswählen.

  2. Wählen Sie auf der Seite "Event Grid Namespace " unter MQTT-Broker"Routing" aus.

  3. Wählen Sie auf der Seite Routing die Option Routing aktivieren aus.

  4. Wählen Sie für Thementyp die Option Namespacethema aus.

  5. Für Thema wählen Sie das Event Grid Namespace-Thema, das Sie erstellt haben, bei dem Event Grid alle MQTT-Nachrichten leitet.

  6. Wählen Sie Übernehmen.

    Screenshot der Seite „Routing“ mit ausgewähltem Namespacethema

    Überprüfe die Benachrichtigungen, um zu bestätigen, dass Event Grid Routing für den Namensraum aktiviert hat.

Erstellen von Clients, Themenbereich und Berechtigungsbindungen

Befolgen Sie die Schritte in diesem Quickstart: Veröffentlichen und abonnieren Sie ein MQTT-Thema:

  1. Erstellen Sie einen Client. Optional erstellen Sie einen zweiten Client.

  2. Erstellen Sie einen Themenbereich.

  3. Erstellen Sie Herausgeber- und Abonnentenberechtigungsbindungen.

  4. Verwenden Sie MQTTX, um einige Nachrichten zu senden.

  5. Stellen Sie auf der Seite Übersicht für Ihren Event Hubs-Namespace sicher, dass der Event Hub diese Nachrichten empfangen hat.

    Screenshot: Seite „Übersicht“ des Ereignishubs mit der Anzahl eingehender Nachrichten

Anzeigen der weitergeleiteten MQTT-Nachrichten in Event Hubs mithilfe einer Stream Analytics-Abfrage

Im Azure-Portal gehen Sie zur Event Hubs-Instanz (Event Hub) in Ihrem Event-Abonnement. Nutzen Sie Stream Analytics, um Daten von Ihrem Event Hub zu verarbeiten. Weitere Informationen finden Sie unter Verarbeiten von Daten aus Ihrem Event Hub mithilfe von Azure Stream Analytics. Die MQTT-Nachrichten erscheinen in der Abfrage.

Screenshot der MQTT-Nachrichtendaten in Event Hubs mithilfe des Stream Analytics-Abfragetools.

Nächster Schritt

Für Codebeispiele wechseln Sie zum MqttApplicationSamples GitHub-Repository.

  • Last updated on