Découvrez comment ajouter une source d’événement de Hub IoT à 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 décrit comment utiliser le portail Azure pour ajouter une source d’événement qui lit des données à partir d’un IoT Hub Azure dans votre environnement Azure Time Series Insights.
Remarque
Les instructions dans cet article s’appliquent à la fois aux environnements Azure Time Series Insights Gen 1 et Time Series Insights Gen 2.
Prérequis
- Créez un environnement Azure Time Series Insights.
- Créez un IoT Hub à l’aide du portail Azure.
- L’IoT Hub doit avoir des événements de message actifs envoyés.
- Créez un groupe de consommateurs dédié dans IoT Hub pour l’environnement Azure Time Series Insights à utiliser. Chaque source d’événement Time Series Insights Azure 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 présenter des défaillances. Pour plus d’informations, consultez le Guide du développeur Azure IoT Hub.
Ajouter un groupe de consommateurs à votre instance IoT Hub
Les applications utilisent des groupes de consommateurs pour extraire des données d’Azure IoT Hub. Indiquez un groupe de consommateurs dédiés, qui sera utilisé par cet environnement Time Series Insights Azure uniquement, pour lire les données de manière fiable à partir de votre Hub IoT.
Pour ajouter un nouveau groupe de consommateurs à votre IoT Hub :
Dans le portail Azure, recherchez et ouvrez votre hub IoT.
Sous Paramètres, sélectionnez Points de terminaison intégrés, puis sélectionnez le point de terminaison Événements.
Sous Groupes de consommateurs, entrez un nom unique pour le groupe de consommateurs. Utilisez le même nom dans votre environnement Time Series Insights Azure lors de la création d’une source d’événement.
Cliquez sur Enregistrer.
Ajouter une nouvelle source d’événement
Connectez-vous au portail Azure.
Dans le menu de gauche, sélectionnez Toutes les ressources. Sélectionnez votre environnement Azure Time Series Insight.
Sous Paramètres, sélectionnez Sources d'événements, puis Ajouter.
Dans le volet Nouvelle source d’événements, pour Nom de source d’événement, entrez un nom unique pour cet environnement Time Series Insights Azure. Par exemple, entrez event-stream.
Pour Source, sélectionnez IoT Hub.
Sélectionnez une valeur pour Option d’importation :
Si vous avez déjà un IoT Hub dans l’un de vos abonnements, sélectionnez Utiliser IoT Hub à partir des abonnements disponibles. Il s’agit de l’approche la plus simple.
Le tableau suivant décrit les propriétés requises pour l’option Utiliser IoT Hub à partir des abonnements disponibles :
Propriété Description Abonnement Abonnement auquel appartient le hub IoT souhaité. Nom de l’IoT Hub Nom du hub IoT sélectionné. Nom de la stratégie IoT Hub Sélectionnez la stratégie d’accès partagé. Vous trouverez la stratégie d’accès partagé dans l’onglet Paramètres IoT 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 connexion au service. Clé de stratégie IoT Hub La clé est déjà renseignée. Sélectionnez Fournir les paramètres d’IoT Hub manuellement si l’IoT 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 Fournir des paramètres IoT Hub manuellement :
Propriété Description Identifiant d’abonnement Abonnement auquel appartient le hub IoT souhaité. Resource group Nom du groupe de ressources dans lequel l’IoT Hub a été créé. Nom de l’IoT Hub Nom de votre IoT Hub. Lorsque vous avez créé votre IoT Hub, vous lui avez donné un nom. Nom de la stratégie IoT Hub Stratégie d’accès partagé. Vous pouvez créer la stratégie d’accès partagé dans l’onglet Paramètres IoT 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 connexion au service. Clé de stratégie IoT Hub Clé d’accès partagé utilisée pour authentifier l’accès à l’espace de noms Azure Service Bus. Entrez la clé primaire ou secondaire ici. Les deux options partagent les options de configuration suivantes :
Propriété Description Groupe de consommateurs IoT Hub Groupe de consommateurs qui lit les événements de l’IoT 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 IoT 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.
Ajoutez le nom du groupe de consommateurs Azure Time Series Insights dédié que vous avez ajouté à votre Hub IoT.
Sélectionnez Créer.
Après la création de la source d’événement, Azure Time Series Insights démarre automatiquement la diffusion de données dans votre environnement.
Étapes suivantes
Définissez les stratégies d’accès aux données pour sécuriser les données.
Envoyez des événements à la source d’événement.