Partager via


Ajouter une source d’événement Event Hub à votre environnement Azure Time Series Insights

Remarque

Le service Time Series Insights va être mis hors service le 7 juillet 2024. Prévoyez de migrer les environnements existants vers des solutions alternatives dès que possible. Pour plus d’informations sur la dépréciation et la migration, consultez notre documentation.

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.

Remarque

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.

Prérequis

Ajouter un groupe de consommateurs à votre Event Hub

Les applications utilisent des groupes de consommateurs pour extraire des données d’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.

Pour ajouter un groupe de consommateurs dans votre 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. Sélectionnez Entités > Event Hubs ou recherchez votre instance sous Nom.

    Ouvrez votre espace de noms Event Hub

  2. Dans l’instance de votre hub d’événements, sélectionnez Entités > Groupes de consommateurs. Ensuite, sélectionnez + Groupe de consommateurs pour ajouter un nouveau groupe de consommateurs.

    Event Hub - Ajouter un groupe de consommateurs

    Sinon, sélectionnez un groupe de consommateurs existant et passez à la section suivante.

  3. Sur la page Groupes de consommateurs, indiquez une valeur unique pour Nom. Utilisez le même nom lorsque vous créez une source d’événement dans l’environnement Azure Time Series Insights.

  4. Sélectionnez Créer.

Ajouter une nouvelle source d’événement

  1. Connectez-vous au portail Azure.

  2. Recherchez votre environnement Azure Time Series Insights existant. Dans le menu de gauche, sélectionnez Toutes les ressources, puis sélectionnez votre environnement Azure Time Series Insights.

  3. Sélectionnez Sources d’événements, puis sélectionnez Ajouter.

    Sous Sources d’événements, sélectionnez le bouton Ajouter

  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.

  5. Pour Source, sélectionnez Event Hub.

  6. Sélectionnez les valeurs appropriées sous Option d’importation :

    • 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. Il s’agit de l’approche la plus simple.

      Sélectionnez une option d’importation de source d’événement

    • Le tableau suivant décrit les propriétés requises pour l’option Utiliser un Event Hub à partir des abonnements disponibles :

      Détails sur l’abonnement et Event Hub

      Propriété Description
      Abonnement Abonnement auquel appartiennent l’espace de noms et l’instance Event Hub souhaités.
      Espace de noms Event Hub Espace de noms Event Hub auquel appartient l’instance Event Hub souhaitée.
      Nom de l’Event Hub Nom de l’instance Event Hub souhaitée.
      Valeur de stratégie Event Hub Sélectionnez la stratégie d’accès partagé souhaitée. 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. La stratégie d’accès partagé pour votre source d’événements doit avoir des autorisations de lecture.
      Clé de stratégie Event Hub Prérempli à partir de la valeur de stratégie de hub d’événements sélectionnée.
    • 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.

      Le tableau suivant décrit les propriétés requises pour l’option Indiquez manuellement les paramètres Event Hub :

      Propriété Description
      Identifiant d’abonnement Abonnement auquel appartiennent l’espace de noms et l’instance Event Hub souhaités.
      Resource group Groupe de ressources auquel appartiennent l’espace de noms et l’instance Event Hub souhaités.
      Espace de noms Event Hub Espace de noms Event Hub auquel appartient l’instance Event Hub souhaitée.
      Nom de l’Event Hub Nom de l’instance Event Hub souhaitée.
      Valeur de stratégie Event Hub Sélectionnez la stratégie d’accès partagé souhaitée. 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. La stratégie d’accès partagé pour votre source d’événements doit avoir des autorisations de lecture.
      Clé de stratégie Event Hub Clé d’accès partagé qui permet d’authentifier l’accès à l’espace de noms Service Bus. Entrez la clé primaire ou secondaire ici.
    • Les deux options partagent les options de configuration suivantes :

      Propriété Description
      Groupe de consommateurs du hub d’événements Groupe de consommateurs qui lit les événements de l’Event Hub. Il est vivement recommandé d’utiliser un groupe de consommateurs dédié pour votre source de l’événement.
      Format de sérialisation de l’événement Actuellement, JSON est le seul format de sérialisation disponible. Les messages d’événement doivent respecter ce format, sans quoi aucune donnée ne peut être lue.
      Nom de la propriété d’horodatage Pour déterminer cette valeur, vous devez comprendre le format de message des données de message envoyées dans l’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. Cette valeur respecte la casse. 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.
  7. Ajoutez le nom du groupe de consommateurs Azure Time Series Insights dédié que vous avez ajouté à votre Event Hub.

  8. Sélectionnez Créer.

    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.

Étapes suivantes