Hinzufügen einer Event Hub-Ereignisquelle zu einer Time Series Insights-UmgebungAdd an event hub event source to your Time Series Insights environment

In diesem Artikel wird beschrieben, wie im Azure-Portal eine Ereignisquelle hinzugefügt wird, die Daten aus Azure Event Hubs in Ihre Azure Time Series Insights-Umgebung einliest.This article describes how to use the Azure portal to add an event source that reads data from Azure Event Hubs to your Azure Time Series Insights environment.

Hinweis

Die in diesem Artikel beschriebenen Schritte gelten sowohl für Azure Time Series Insights (allgemein verfügbar)- als auch für Time Series Insights Preview-Umgebungen.The steps that are described in this article apply both to the Time Series Insights GA and Time Series Insights Preview environments.

VoraussetzungenPrerequisites

Hinzufügen einer Consumergruppe zum Event HubAdd a consumer group to your event hub

Anwendungen verwenden Consumergruppen, um Daten aus Azure Event Hubs abzurufen.Applications use consumer groups to pull data from Azure Event Hubs. Für ein zuverlässiges Lesen von Daten aus Ihrem Event Hub geben Sie eine dedizierte Consumergruppe an, die nur von dieser Time Series Insights-Umgebung verwendet wird.To reliably read data from your event hub, provide a dedicated consumer group that's used only by this Time Series Insights environment.

So fügen Sie Ihrem Event Hub eine neue Consumergruppe hinzuTo add a new consumer group in your event hub:

  1. Suchen Sie im Azure-Portal Ihren Event Hub im Event Hub-Namespace, und öffnen Sie ihn.In the Azure portal, locate and open your event hub from the event hub namespace.

    Öffnen Ihres Event Hub-NamespaceOpen your event hub namespace

  2. Wählen Sie unter Entitäten Consumergruppen aus, und wählen Sie dann Consumergruppe aus.Under Entities, select Consumer groups, and then select Consumer Group.

    Event hub - Add a consumer group (Event Hub – Consumergruppe hinzufügen)Event hub - Add a consumer group

  3. Geben Sie auf der Seite Consumergruppen einen neuen eindeutigen Wert für Name an.On the Consumer groups page, enter a new unique value for Name. Verwenden Sie diesen Namen, wenn Sie eine neue Ereignisquelle in der Time Series Insights-Umgebung erstellen.Use this same name when you create a new event source in the Time Series Insights environment.

  4. Klicken Sie auf Erstellen.Select Create.

Hinzufügen einer neuen EreignisquelleAdd a new event source

  1. Melden Sie sich beim Azure-Portal an.Sign in to the Azure portal.

  2. Suchen Sie die vorhandene Time Series Insights-Umgebung.Locate your existing Time Series Insights environment. Wählen Sie im linken Menü Alle Ressourcen, und wählen Sie dann Ihre Time Series Insights-Umgebung aus.In the left menu, select All resources, and then select your Time Series Insights environment.

  3. Wählen Sie unter Umgebungstopologie den Eintrag Ereignisquellen und dann Hinzufügen aus.Under Environment Topology, select Event Sources, and then select Add.

    Wählen Sie unter „Ereignisquellen“ die Schaltfläche „Hinzufügen“ aus.Under Event Sources, select the Add button

  4. Geben Sie einen Namen der Ereignisquelle ein, der eindeutig Namen für diese Time Series Insights-Umgebung ist, z. B. event-stream.Enter a value for Event source name that is unique to this Time Series Insights environment, such as event-stream.

  5. Wählen Sie für Quelle die Option Event Hub aus.For Source, select Event Hub.

  6. Wählen Sie die geeigneten Werte für Importoption aus:Select the appropriate values for Import option:

    • Wenn Sie in einem Ihrer Abonnements bereits über einen Event Hub verfügen, wählen Sie Verwenden Sie einen Event Hub aus verfügbaren Abonnements aus.If you have an existing event hub in one of your subscriptions, select Use Event Hub from available subscriptions. Diese Option stellt den einfachsten Ansatz dar.This option is the easiest approach.

      Auswählen einer Importoption für EreignisquellenSelect an Event Source import option

    • In der folgenden Tabelle werden die Eigenschaften beschrieben, die für die Option Event Hub aus verfügbaren Abonnements verwenden erforderlich sind:The following table describes the required properties for the Use Event Hub from available subscriptions option:

      Details zu Abonnements und Event HubSubscription and event hub details

      EigenschaftProperty BESCHREIBUNGDescription
      SubscriptionSubscription Das Abonnement, zu dem die gewünschte Event Hub-Instanz und der Namespace gehören.The subscription the desired event hub instance and namespace belongs to.
      Event Hub-NamespaceEvent Hub namespace Der Event Hub-Namespace, zu dem die gewünschte Event Hub-Instanz gehört.The event hub namespace the desired event hub instance belongs to.
      Event Hub-NameEvent Hub name Der Name der gewünschten Event Hub-Instanz.The name of the desired event hub instance.
      Event Hub-RichtlinienwertEvent Hub policy value Wählen Sie die gewünschte SAS-Richtlinie aus.Select the desired shared access policy. Sie können die Richtlinie für den gemeinsamen Zugriff auf der Event Hub-Registerkarte Konfigurieren erstellen. Jede SAS-Richtlinie umfasst einen Namen, die von Ihnen festgelegten Berechtigungen und Zugriffsschlüssel.You can create the shared access policy on the event hub Configure tab. Each shared access policy has a name, permissions that you set, and access keys. Die SAS-Richtlinie für die Ereignisquelle muss über die Berechtigung Lesen verfügen.The shared access policy for your event source must have read permissions.
      Event Hub-RichtlinienschlüsselEvent Hub policy key Voraufgefüllt aus dem ausgewählten Event Hub-Richtlinienwert.Pre-populated from the selected Event Hub policy value.
    • Wenn sich der Event Hub außerhalb Ihrer Abonnements befindet oder Sie erweiterte Optionen auswählen möchten, wählen Sie Event Hub-Einstellungen manuell angeben aus.If the event hub is external to your subscriptions or if you want to select advanced options, select Provide Event Hub settings manually.

      In der folgenden Tabelle werden die für die Option Event Hub-Einstellungen manuell angeben erforderlichen Eigenschaften beschrieben:The following table describes the required properties for the Provide Event Hub settings manually option:

      EigenschaftProperty BESCHREIBUNGDescription
      Abonnement-IDSubscription ID Das Abonnement, zu dem die gewünschte Event Hub-Instanz und der Namespace gehören.The subscription the desired event hub instance and namespace belongs to.
      Resource groupResource group Die Ressourcengruppe, zu der die gewünschte Event Hub-Instanz und der Namespace gehören.The resource group the desired event hub instance and namespace belongs to.
      Event Hub-NamespaceEvent Hub namespace Der Event Hub-Namespace, zu dem die gewünschte Event Hub-Instanz gehört.The event hub namespace the desired event hub instance belongs to.
      Event Hub-NameEvent Hub name Der Name der gewünschten Event Hub-Instanz.The name of the desired event hub instance.
      Event Hub-RichtlinienwertEvent Hub policy value Wählen Sie die gewünschte SAS-Richtlinie aus.Select the desired shared access policy. Sie können die Richtlinie für den gemeinsamen Zugriff auf der Event Hub-Registerkarte Konfigurieren erstellen. Jede SAS-Richtlinie umfasst einen Namen, die von Ihnen festgelegten Berechtigungen und Zugriffsschlüssel.You can create the shared access policy on the event hub Configure tab. Each shared access policy has a name, permissions that you set, and access keys. Die SAS-Richtlinie für die Ereignisquelle muss über die Berechtigung Lesen verfügen.The shared access policy for your event source must have read permissions.
      Event Hub-RichtlinienschlüsselEvent Hub policy key Der Schlüssel für den gemeinsamen Zugriff, der für die Authentifizierung des Zugriffs auf den Service Bus-Namespace verwendet wird.The shared access key that's used to authenticate access to the Service Bus namespace. Geben Sie hier den primären oder sekundären Schlüssel ein.Enter the primary or secondary key here.
    • Beide Optionen teilen die folgenden Konfigurationsoptionen:Both options share the following configuration options:

      EigenschaftProperty BESCHREIBUNGDescription
      Event Hub-ConsumergruppeEvent Hub consumer group Die Consumergruppe, die Ereignisse aus dem Event Hub liest.The consumer group that reads events from the event hub. Wir empfehlen ausdrücklich, dass Sie eine dedizierte Consumergruppe für Ihre Ereignisquelle verwenden.We highly recommend that you use a dedicated consumer group for your event source.
      EreignisserialisierungsformatEvent serialization format Zurzeit ist JSON das einzige verfügbare Serialisierungsformat.Currently, JSON is the only available serialization format. Ereignismeldungen müssen in diesem Format vorliegen, damit Daten gelesen werden können.Event messages must be in this format or data can't be read.
      Name der Timestamp-EigenschaftTimestamp property name Um diesen Wert ermitteln, müssen Sie das Nachrichtenformat der Nachrichtendaten kennen, die an den Event Hub gesendet werden.To determine this value, you need to understand the message format of the message data that's sent to the event hub. Dieser Wert entspricht name der spezifischen Ereigniseigenschaft in den Nachrichtendaten, die Sie als Ereigniszeitstempel verwenden möchten.This value is the name of the specific event property in the message data that you want to use as the event timestamp. Bei dem Wert wird die Groß-/Kleinschreibung beachtet.The value is case-sensitive. Wenn dieser Wert nicht angegeben wird, wird der Zeitpunkt der Einreihung des Ereignisses in die Warteschlange in der Ereignisquelle als Ereigniszeitstempel verwendet.If left blank, the event enqueue time in the event source is used as the event timestamp.
  7. Fügen Sie den dedizierten Time Series Insights-Consumergruppennamen hinzu, den Sie Ihrem Event Hub hinzugefügt haben.Add the dedicated Time Series Insights consumer group name that you added to your event hub.

  8. Klicken Sie auf Erstellen.Select Create.

    Nach der Erstellung der Ereignisquelle beginnt Time Series Insights automatisch damit, Daten in Ihre Umgebung zu streamen.After the event source is created, Time Series Insights automatically begins streaming data to your environment.

Nächste SchritteNext steps