Ajouter une source d’événement Event Hub à votre environnement Azure Time Series Insights
Note
Le service Time Series Insights sera mis hors service le 7 juillet 2024. Envisagez de migrer des environnements existants vers d’autres solutions 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énements qui lit les données d’Azure Event Hubs dans votre environnement Azure Time Series Insights.
Note
Les étapes décrites dans cet article s’appliquent à la fois aux environnements Azure Time Series Insights Gen 1 et Azure Time Series Insights Gen 2.
Conditions préalables
- Créez un environnement Azure Time Series Insights comme décrit dans Créer un environnement Azure Time Series Insights.
- Créez un hub d’événements. Consultez pour créer un espace de noms Event Hubs et un hub d’événements à l’aide du portail Azure.
- Le hub d'événements doit recevoir des événements de message actifs. Découvrez comment envoyer des événements à Azure Event Hubs à l’aide du .NET Framework.
- Créez un groupe de consommateurs dédié dans le hub d’événements à partir duquel l’environnement Azure Time Series Insights peut consommer. Chaque source d’événement Azure Time Series Insights doit avoir son propre groupe de consommateurs dédié qui n’est pas partagé avec un autre consommateur. Si plusieurs lecteurs consomment des événements du même groupe de consommateurs, tous les lecteurs sont susceptibles de rencontrer des échecs. Il existe une limite de 20 groupes de consommateurs par hub d’événements. Pour plus d’informations, lisez le guide de programmation Event Hubs.
Ajouter un groupe de consommateurs à votre hub d’événements
Les applications utilisent des groupes de consommateurs pour extraire des données d’Azure Event Hubs. Pour lire de manière fiable les données de votre hub d’événements, fournissez un groupe de consommateurs dédié utilisé uniquement par cet environnement Azure Time Series Insights.
Pour ajouter un nouveau groupe de consommateurs dans votre hub d’événements :
Dans le portail Azure , recherchez et ouvrez votre instance event Hub à partir du volet Vue d’ensemble de votre espace de noms Event Hub. Sélectionnez Entities > Event Hubs ou recherchez votre instance sous Nom.
Dans votre instance Event Hub, sélectionnez Entités > Groupes de consommateurs. Sélectionnez ensuite + groupe de consommateurs pour ajouter un nouveau groupe de consommateurs.
Sinon, sélectionnez un groupe de consommateurs existant et passez à la section suivante.
Sur la page des groupes de consommateurs, entrez une nouvelle valeur unique pour Nom. Utilisez ce même nom lorsque vous créez une source d’événement dans l’environnement Azure Time Series Insights.
Sélectionnez Créer.
Ajouter une nouvelle source d’événement
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.
Sélectionnez sources d’événements, puis sélectionnez Ajouter.
Entrez une valeur pour le nom de source d'événement qui est unique à cet environnement Azure Time Series Insights, tel que
Contoso-TSI-Gen 1-Event-Hub-ES.Pour Source, sélectionnez Event Hub.
Sélectionnez les valeurs appropriées pour l'option d'Importation :
Si vous disposez d’un hub d’événements existant dans l’un de vos abonnements, sélectionnez Utiliser Event Hub à partir des abonnements disponibles. Cette option est l’approche la plus simple.
Le tableau suivant décrit les propriétés requises pour l'option Utiliser Event Hub à partir d’abonnements disponibles :
détails de l’abonnement
Propriété Description Abonnement L’abonnement auquel appartient l’instance et l’espace de noms du hub d’événements souhaités. Espace de noms Event Hub L’espace de noms event Hub auquel appartient l’instance de hub d’événements souhaitée. Nom du hub d’événements Nom de l’instance de hub d’événements 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é sous l’onglet Event Hub Configurer. Chaque stratégie d’accès partagé a un nom, des autorisations que vous définissez et des clés d’accès. La stratégie d’accès partagé pour votre source d’événement doit disposer d’autorisations de lecture. Clé de stratégie Event Hub Les valeurs sont préremplies selon la valeur de stratégie "Event Hub" sélectionnée. Si le hub d’événements est externe à vos abonnements ou si vous souhaitez sélectionner des options avancées, sélectionnez Fournir manuellement les paramètres event Hub.
Le tableau suivant décrit les propriétés requises pour l’option Fournir manuellement les paramètres event Hub :
Propriété Description ID d’abonnement L’abonnement auquel appartient l’instance et l’espace de noms du hub d’événements souhaités. Groupe de ressources Le groupe de ressources auquel appartient l’instance de hub d’événements et l’espace de noms souhaités. Espace de noms Event Hub L’espace de noms event Hub auquel appartient l’instance de hub d’événements souhaitée. Nom du hub d’événements Nom de l’instance de hub d’événements 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é sous l’onglet Event Hub Configurer. Chaque stratégie d’accès partagé a un nom, des autorisations que vous définissez et des clés d’accès. La stratégie d’accès partagé pour votre source d’événement doit disposer d’autorisations de lecture. Clé de stratégie Event Hub Clé d’accès partagé utilisée pour 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 Event Hub Groupe de consommateurs qui lit les événements à partir du hub d’événements. Nous vous recommandons vivement d’utiliser un groupe de consommateurs dédié pour votre source d’événements. Format de sérialisation des événements Actuellement, JSON est le seul format de sérialisation disponible. Les messages d’événement doivent être dans ce format ou les données ne peuvent pas être lues. Nom de la propriété Timestamp Pour déterminer cette valeur, vous devez comprendre le format de message des données de message envoyées au hub d’événements. Cette valeur est le nom de la propriété d’événement spécifique dans les données de message que vous souhaitez utiliser comme horodatage d’événement. La valeur est sensible à la casse. Si elle est vide, l’heure d’attente de l’événement dans la source de l’événement est utilisée comme horodatage d’événement.
Ajoutez le nom de groupe de consommateurs Azure Time Series Insights dédié que vous avez ajouté à votre hub d’événements.
Sélectionnez Créer.
Une fois la source d’événement créée, Azure Time Series Insights commence automatiquement à diffuser en continu des données vers votre environnement.
Étapes suivantes
Définir des stratégies d’accès aux données pour sécuriser les données.
Envoyer des événements à la source de l’événement.