Freigeben über


Verwenden des Event Hubs-Daten-Explorers zum Ausführen von Datenvorgängen in Event Hubs

Azure Event Hubs ist ein skalierbarer Ereignisverarbeitungsdienst, der große Mengen von Ereignissen und Daten mit kurzer Wartezeit und hoher Zuverlässigkeit erfasst und verarbeitet. Unter Was ist Event Hubs? finden Sie einen allgemeinen Überblick über den Dienst.

Entwickler und Operatoren suchen häufig nach einem einfachen Tool, um Beispieldaten an ihren Event Hub zu senden, damit sie oft danach den End-to-End-Flow testen oder Ereignisse zu einem bestimmten Offset oder Zeitpunkt für das leichte Debuggen anzeigen können. Der Event Hubs-Daten-Explorer vereinfacht diese gängigen Workflows, da keine individuellen Clientanwendungen geschrieben werden müssen, um die Daten auf dem Event Hub zu testen und zu prüfen.

In diesem Artikel wird die Funktionalität des Azure Event Hubs-Daten-Explorers hervorgehoben, der im Azure-Portal zur Verfügung gestellt wurde.

Wichtig

Wenn auf Ihren Event Hubs-Namespace nur über einen privaten Endpunkt zugegriffen werden kann, greifen Sie von einem virtuellen Computer in demselben virtuellen Netzwerk mit dem privaten Endpunkt auf Event Hubs-Daten-Explorer zu, wodurch sichergestellt wird, dass der Webbrowser Zugriff auf den privaten Endpunkt benötigt.

Es gibt zwei Typen von Vorgängen, die für Azure Event Hubs-Namespaces ausgeführt werden können.

  • Verwaltungsvorgänge: Erstellen, Aktualisieren, Löschen von Event Hubs-Namespaces und Event Hubs
  • Datenvorgänge: Senden und Anzeigen von Ereignissen aus einem Event Hub

Wichtig

  • Der Event Hubs-Daten-Explorer unterstützt keine Verwaltungsvorgänge. Der Event Hub muss erstellt werden, bevor der Daten-Explorer Ereignisse von diesem senden oder anzeigen kann.
  • Während Eventnutzlasten (auch als Werte bezeichnet in Kafka) gesendet werden, die mithilfe des Kafka-Protokolls über den Daten-Explorer angezeigt werden, ist der Schlüssel für das bestimmte Ereignis nicht sichtbar.
  • Es wird davon abgeraten, den Event Hubs-Daten-Explorer für größere Nachrichten zu verwenden, da dies je nach Nachrichtengröße, Netzwerklatenz zwischen Client und Service Bus-Dienst usw. zu Timeouts führen kann. Stattdessen wird empfohlen, dass Sie Ihren eigenen Client verwenden, um mit größeren Nachrichten zu arbeiten. So können Sie eigene Timeoutwerte angeben.
  • Die Vorgänge, die Benutzende mit dem Event Hubs-Daten-Explorer ausführen können, werden durch die rollenbasierte Zugriffssteuerungsrolle (RBAC) bestimmt, der den Benutzenden zugewiesen ist.

Voraussetzungen

Um den Event Hubs-Daten-Explorer zu verwenden, erstellen Sie einen Azure Event Hubs-Namespace und einen Event Hub.

Verwenden des Event Hubs-Daten-Explorers

Um den Event Hubs-Daten-Explorer zu verwenden, navigieren Sie zum Event Hubs-Namespace, in dem Sie die Datenvorgänge ausführen möchten.

Navigieren Sie entweder direkt zum Data Explorer, in dem Sie den Event Hub auswählen können, oder wählen Sie den Event Hub aus den entities aus, und wählen Sie dann im Navigationsmenü Data Explorer aus.

Screenshot: Navigation im linken Bereich mit ausgewählter Option „Daten-Explorer“

Senden von Ereignissen

Sie können entweder benutzerdefinierte Nutzdaten oder Musterdatasets mithilfe von Send events an den ausgewählten Event Hub senden.

Wählen Sie dazu die Schaltfläche send events aus, die den rechten Bereich aktiviert.

Screenshot: Daten-Explorer-Bereich mit ausgewählter Option „Ereignisse senden“

Senden von benutzerdefinierter Nutzdaten

So senden Sie benutzerdefinierte Nutzdaten:

  1. Wählen Sie Dataset aus. Wählen Sie Custom payload aus. Sie können auch vordefinierte Datasets wie Yellow Taxi-Daten, Wetterdaten usw. auswählen, wie im nächsten Abschnitt gezeigt.
  2. Wählen Sie den Inhaltstyp aus: entweder aus Text/Plain, JSON oder XML.
  3. Laden Sie entweder eine JSON-Datei hoch, oder geben Sie die Nutzdaten im Feld Nutzdaten eingeben ein.
  4. [Optional] Geben Sie die Systemeigenschaften an.
  5. [Optional] Geben Sie benutzerdefinierte Eigenschaften an, verfügbar als Schlüsselwertpaar.
  6. [Optional] Wenn Sie mehrere Nutzdaten senden möchten, aktivieren Sie das Kontrollkästchen Senden wiederholen, und geben Sie die Anzahl der wiederholten Sendevorgänge – d. h. die Anzahl der zu sendenden Nutzdaten – und das Intervall zwischen den wiederholten Sendevorgängen in ms an.

Nachdem die Nutzdatendetails definiert wurden, wählen Sie Senden aus, um die Ereignisnutzdaten wie definiert zu senden.

Screenshot: Schaltfläche „Ereignis senden“ für benutzerdefinierte Nutzdaten

Senden von Musterdatasets

So senden Sie Ereignisnutzdaten aus einem Musterdataset:

  1. Auswählen des Datasets: Wählen Sie eines der Musterdatasetsaus, zum Beispiel Gelbes Taxi, Wetterdaten etc.
  2. [Optional] Geben Sie die Systemeigenschaften an.
  3. [Optional] Geben Sie benutzerdefinierte Eigenschaften an, verfügbar als Schlüsselwertpaare.
  4. [Optional] Wenn Sie mehrere Nutzdaten senden möchten, aktivieren Sie das Kontrollkästchen Senden wiederholen, und geben Sie die Anzahl der wiederholten Sendevorgänge – d. h. die Anzahl der zu sendenden Nutzdaten – und das Intervall zwischen den wiederholten Sendevorgängen in ms an.

Nachdem die Nutzdatendetails definiert wurden, wählen Sie Senden aus, um die Ereignisnutzdaten wie definiert zu senden.

Screenshot: Schaltfläche „Ereignis senden“ für Musternutzdaten

Ereignisse anzeigen

Der Event Hubs-Daten-Explorer ermöglicht das Anzeigen der Ereignisse, um die Daten zu prüfen, die den Kriterien entsprechen.

Zum Anzeigen von Ereignissen können Sie die folgenden Eigenschaften definieren oder die Standardwerte nutzen:

Screenshot: Daten-Explorer-Menü mit ausgewählter Option „Ereignisse anzeigen“

  1. Partitions-ID: Wählen Sie entweder eine bestimmte Partition aus, oder wählen Sie Alle Partitions-IDs aus.
  2. Consumergruppe: Wählen Sie $Default oder eine andere Consumergruppe aus, oder erstellen Sie spontan eine.
  3. Ereignisposition: Wählen Sie die älteste Position (den Beginn des Event Hubs), die neueste Position (die aktuelle) oder eine benutzerdefinierte Position aus (für einen bestimmten Offset, eine Sequenznummer oder einen Zeitstempel).
    1. Älteste Position: Beginnen Sie mit dem Empfangen von Events aus dem ersten Event in der Partition, das aufgrund der Aufbewahrungsrichtlinie nicht abgelaufen war.
    2. Benutzerdefinierte Position: Fügen Sie Filter hinzu, um die Position in der Partition anzugeben, von der Events empfangen werden sollen.
    3. Neueste Position: Beginnen Sie mit dem Empfangen von Events aus dem Event, das direkt nach dem Ansichtsaufruf abgefragt wird. Nur Events, die nach dem letzten Anzeigen von Events gesendet wurden, werden empfangen.
  4. Erweiterte Eigenschaften: Geben Sie die maximale Batchgröße und die maximale Wartezeit in Sekunden an.

Nachdem die oben genannten Optionen festgelegt wurden, wählen Sie Ereignisse anzeigen aus, um die Ereignisse zu pullen und im Daten-Explorer zu rendern.

Screenshot: Tabelle mit den Ereignissen

Nachdem die Ereignisse geladen wurden, können Sie Nächsten Ereignisse anzeigen auswählen, um erneut Ereignisse mithilfe derselben Abfrage zu pullen, oder mit Alle löschen die Tabelle aktualisieren.

Herunterladen der Ereignisnutzdaten

Beim Anzeigen der Ereignisse in einem bestimmten Event Hub können die Ereignisnutzdaten zur weiteren Überprüfung heruntergeladen werden.

Um die Ereignisnutzdaten herunterzuladen, wählen Sie das jeweilige Ereignis aus, und klicken Sie auf die Schaltfläche Herunterladen, die über dem Ereignisnutzdatentext angezeigt wird.

Screenshot: Tabelle mit den Ereignissen mit ausgewähltem Ereignis und hervorgehobener Schaltfläche zum Herunterladen