Ajouter une source d’événement Event Hub à votre environnement Azure Time Series InsightsAdd an event hub event source to your Azure Time Series Insights environment

Cet article explique comment utiliser le Portail Azure pour ajouter une source d’événement qui lit des données à partir d’Azure Event Hubs dans votre environnement Azure Time Series Insights.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.

Notes

Les étapes décrites dans cet article s’appliquent à la fois aux environnements Azure Time Series Insights Gen 1 et Azure Time Series Insights Gen2.The steps that are described in this article apply both to the Azure Time Series Insights Gen 1 and Azure Time Series Insights Gen 2 environments.

PrérequisPrerequisites

Ajouter un groupe de consommateurs à votre Event HubAdd a consumer group to your event hub

Les applications utilisent des groupes de consommateurs pour extraire des données d’Azure Event Hubs.Applications use consumer groups to pull data from Azure Event Hubs. Indiquez un groupe de consommateurs dédiés, qui sera utilisé par cet environnement Azure Time Series Insights uniquement, pour lire les données de manière fiable à partir de votre Event Hub.To reliably read data from your event hub, provide a dedicated consumer group that's used only by this Azure Time Series Insights environment.

Pour ajouter un groupe de consommateurs dans votre Event Hub :To add a new consumer group in your event hub:

  1. Dans le portail Azure, recherchez et ouvrez l’instance de votre hub d’événements à partir du volet Vue d’ensemble de l’espace de noms Event Hub.In the Azure portal, locate and open your event hub instance from the Overview pane of your event hub namespace. Sélectionnez Entités > Event Hubs ou recherchez votre instance sous Nom.Select Entities > Event Hubs or find your instance under Name.

    Ouvrez votre espace de noms Event HubOpen your event hub namespace

  2. Dans l’instance de votre hub d’événements, sélectionnez Entités > Groupes de consommateurs.In your event hub instance, select Entities > Consumer groups. Ensuite, sélectionnez + Groupe de consommateurs pour ajouter un nouveau groupe de consommateurs.Then, select + Consumer group to add a new consumer group.

    Event Hub - Ajouter un groupe de consommateursEvent hub - Add a consumer group

    Sinon, sélectionnez un groupe de consommateurs existant et passez à la section suivante.Otherwise, select an existing consumer group and skip to the next section.

  3. Sur la page Groupes de consommateurs, indiquez une valeur unique pour Nom.On the Consumer groups page, enter a new unique value for Name. Utilisez le même nom lorsque vous créez une source d’événement dans l’environnement Azure Time Series Insights.Use this same name when you create a new event source in the Azure Time Series Insights environment.

  4. Sélectionnez Create (Créer).Select Create.

Ajouter une nouvelle source d’événementAdd a new event source

  1. Connectez-vous au portail Azure.Sign in to the Azure portal.

  2. Recherchez votre environnement Azure Time Series Insights existant.Locate your existing Azure Time Series Insights environment. Dans le menu de gauche, sélectionnez Toutes les ressources, puis sélectionnez votre environnement Azure Time Series Insights.In the left menu, select All resources, and then select your Azure Time Series Insights environment.

  3. Sélectionnez Sources d’événements, puis sélectionnez Ajouter.Select Event Sources, and then select Add.

    Sous Sources d’événements, sélectionnez le bouton AjouterUnder Event Sources, select the Add button

  4. Sous Nom de la source de l’événement, indiquez une valeur unique pour cet environnement Azure Time Series Insights, comme Contoso-TSI-Gen 1-Event-Hub-ES.Enter a value for Event source name that is unique to this Azure Time Series Insights environment, such as Contoso-TSI-Gen 1-Event-Hub-ES.

  5. Pour Source, sélectionnez Event Hub.For Source, select Event Hub.

  6. Sélectionnez les valeurs appropriées sous Option d’importation :Select the appropriate values for Import option:

    • Si un Event Hub est déjà présent dans l’un de vos abonnements, sélectionnez Utiliser un Event Hub à partir des abonnements disponibles.If you have an existing event hub in one of your subscriptions, select Use Event Hub from available subscriptions. Il s’agit de l’approche la plus simple.This option is the easiest approach.

      Sélectionnez une option d’importation de source d’événementSelect an Event Source import option

    • Le tableau suivant décrit les propriétés requises pour l’option Utiliser un Event Hub à partir des abonnements disponibles :The following table describes the required properties for the Use Event Hub from available subscriptions option:

      Détails sur l’abonnement et Event HubSubscription and event hub details

      PropriétéProperty DescriptionDescription
      AbonnementSubscription Abonnement auquel appartiennent l’espace de noms et l’instance Event Hub souhaités.The subscription the desired event hub instance and namespace belongs to.
      Espace de noms Event HubEvent Hub namespace Espace de noms Event Hub auquel appartient l’instance Event Hub souhaitée.The event hub namespace the desired event hub instance belongs to.
      Nom de l’Event HubEvent Hub name Nom de l’instance Event Hub souhaitée.The name of the desired event hub instance.
      Valeur de stratégie Event HubEvent Hub policy value Sélectionnez la stratégie d’accès partagé souhaitée.Select the desired shared access policy. Vous pouvez créer la stratégie d’accès partagé dans l’onglet Configurer de l’Event Hub. Chaque stratégie d’accès partagé a un nom, les autorisations que vous définissez ainsi que des clés d’accès.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. La stratégie d’accès partagé pour votre source d’événements doit avoir des autorisations de lecture.The shared access policy for your event source must have read permissions.
      Clé de stratégie Event HubEvent Hub policy key Prérempli à partir de la valeur de stratégie de hub d’événements sélectionnée.Pre-populated from the selected Event Hub policy value.
    • Sélectionnez Indiquez manuellement les paramètres Event Hub si l’Event Hub est externe à vos abonnements ou si vous souhaitez choisir des options avancées.If the event hub is external to your subscriptions or if you want to select advanced options, select Provide Event Hub settings manually.

      Le tableau suivant décrit les propriétés requises pour l’option Indiquez manuellement les paramètres Event Hub :The following table describes the required properties for the Provide Event Hub settings manually option:

      PropriétéProperty DescriptionDescription
      Identifiant d’abonnementSubscription ID Abonnement auquel appartiennent l’espace de noms et l’instance Event Hub souhaités.The subscription the desired event hub instance and namespace belongs to.
      Resource groupResource group Groupe de ressources auquel appartiennent l’espace de noms et l’instance Event Hub souhaités.The resource group the desired event hub instance and namespace belongs to.
      Espace de noms Event HubEvent Hub namespace Espace de noms Event Hub auquel appartient l’instance Event Hub souhaitée.The event hub namespace the desired event hub instance belongs to.
      Nom de l’Event HubEvent Hub name Nom de l’instance Event Hub souhaitée.The name of the desired event hub instance.
      Valeur de stratégie Event HubEvent Hub policy value Sélectionnez la stratégie d’accès partagé souhaitée.Select the desired shared access policy. Vous pouvez créer la stratégie d’accès partagé dans l’onglet Configurer de l’Event Hub. Chaque stratégie d’accès partagé a un nom, les autorisations que vous définissez ainsi que des clés d’accès.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. La stratégie d’accès partagé pour votre source d’événements doit avoir des autorisations de lecture.The shared access policy for your event source must have read permissions.
      Clé de stratégie Event HubEvent Hub policy key Clé d’accès partagé qui permet d’authentifier l’accès à l’espace de noms Service Bus.The shared access key that's used to authenticate access to the Service Bus namespace. Entrez la clé primaire ou secondaire ici.Enter the primary or secondary key here.
    • Les deux options partagent les options de configuration suivantes :Both options share the following configuration options:

      PropriétéProperty DescriptionDescription
      Groupe de consommateurs du hub d’événementsEvent Hub consumer group Groupe de consommateurs qui lit les événements de l’Event Hub.The consumer group that reads events from the event hub. Il est vivement recommandé d’utiliser un groupe de consommateurs dédié pour votre source de l’événement.We highly recommend that you use a dedicated consumer group for your event source.
      Format de sérialisation de l’événementEvent serialization format Actuellement, JSON est le seul format de sérialisation disponible.Currently, JSON is the only available serialization format. Les messages d’événement doivent respecter ce format, sans quoi aucune donnée ne peut être lue.Event messages must be in this format or data can't be read.
      Nom de la propriété d’horodatageTimestamp property name Pour déterminer cette valeur, vous devez comprendre le format de message des données de message envoyées dans l’Event Hub.To determine this value, you need to understand the message format of the message data that's sent to the event hub. Cette valeur est le nom de la propriété d’événement spécifique dans les données de message à utiliser comme horodateur de l’événement.This value is the name of the specific event property in the message data that you want to use as the event timestamp. Cette valeur respecte la casse.The value is case-sensitive. Lorsque ce champ est vide, l’heure de mise en file d’attente de l’événement dans la source de l’événement est utilisée comme timestamp de l’événement.If left blank, the event enqueue time in the event source is used as the event timestamp.
  7. Ajoutez le nom du groupe de consommateurs Azure Time Series Insights dédié que vous avez ajouté à votre Event Hub.Add the dedicated Azure Time Series Insights consumer group name that you added to your event hub.

  8. Sélectionnez Create (Créer).Select Create.

    Après la création de la source d’événement, Azure Time Series Insights démarre automatiquement la diffusion en continu des données dans votre environnement.After the event source is created, Azure Time Series Insights automatically begins streaming data to your environment.

Étapes suivantesNext steps