Découvrez comment ajouter une source d’événement de Hub IoT à votre environnement Azure Time Series InsightsAdd an IoT hub event source to your Azure Time Series Insight environment

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.This article describes how to use the Azure portal to add an event source that reads data from Azure IoT Hub to your Azure Time Series Insights environment.

Notes

Les instructions dans cet article s’appliquent à la fois aux environnements Azure Time Series Insights Gen 1 et Time Series Insights Gen 2.The instructions in this article apply both to Azure Time Series Insights Gen 1 and to Azure Time Series Insight Gen 2 environments.

PrérequisPrerequisites

  • Créez un environnement Azure Time Series Insights.Create an Azure Time Series Insights environment.
  • Créez un IoT Hub à l’aide du portail Azure.Create an IoT hub by using the Azure portal.
  • L’IoT Hub doit avoir des événements de message actifs envoyés.The IoT hub must have active message events being sent in.
  • Créez un groupe de consommateurs dédié dans IoT Hub pour l’environnement Azure Time Series Insights à utiliser.Create a dedicated consumer group in the IoT hub for the Azure Time Series Insight environment to consume from. 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.Each Azure Time Series Insight event source must have its own dedicated consumer group that isn't shared with any other consumer. Si plusieurs lecteurs consomment des événements du même groupe de consommateurs, tous les lecteurs sont susceptibles de présenter des défaillances.If multiple readers consume events from the same consumer group, all readers are likely to exhibit failures. Pour plus d’informations, consultez le Guide du développeur Azure IoT Hub.For details, read the Azure IoT Hub developer guide.

Ajouter un groupe de consommateurs à votre instance IoT HubAdd a consumer group to your IoT hub

Les applications utilisent des groupes de consommateurs pour extraire des données d’Azure IoT Hub.Applications use consumer groups to pull data from 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.To reliably read data from your IoT hub, provide a dedicated consumer group that's used only by this Azure Time Series Insight environment.

Pour ajouter un nouveau groupe de consommateurs à votre IoT Hub :To add a new consumer group to your IoT hub:

  1. Dans le portail Azure, recherchez et ouvrez votre hub IoT.In the Azure portal, find and open your IoT hub.

  2. Sous Paramètres, sélectionnez Points de terminaison intégrés, puis sélectionnez le point de terminaison Événements.Under Settings, select Built-in Endpoints, and then select the Events endpoint.

    Sur la page Points de terminaison intégrés, sélectionnez le bouton ÉvénementsOn the Build-in Endpoints page, select the Events button

  3. Sous Groupes de consommateurs, entrez un nom unique pour le groupe de consommateurs.Under Consumer groups, enter a unique name for the consumer group. Utilisez le même nom dans votre environnement Time Series Insights Azure lors de la création d’une source d’événement.Use this same name in your Azure Time Series Insight environment when you create a new event source.

  4. Sélectionnez Enregistrer.Select Save.

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

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

  2. Dans le menu de gauche, sélectionnez Toutes les ressources.In the left menu, select All resources. Sélectionnez votre environnement Azure Time Series Insight.Select your Azure Time Series Insight environment.

  3. Sous Paramètres, sélectionnez Sources d'événements, puis Ajouter.Under Settings, select Event Sources, and then select Add.

    Sélectionnez Sources d’événements, puis le bouton AjouterSelect Event Sources, and then select the Add button

  4. 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.In the New event source pane, for Event source name, enter a name that's unique to this Azure Time Series Insight environment. Par exemple, entrez event-stream.For example, enter event-stream.

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

  6. Sélectionnez une valeur pour Option d’importation :Select a value for Import option:

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

      Sélectionnez les options dans le volet Nouvelle source d’événementSelect options in the New event source pane

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

      Volet Nouvelle source d’événement : Propriétés à définir dans l’option Utiliser IoT Hub à partir des abonnements disponiblesNew event source pane - Properties to set in the Use IoT Hub from available subscriptions option

      PropriétéProperty DescriptionDescription
      AbonnementSubscription Abonnement auquel appartient le hub IoT souhaité.The subscription the desired iot hub belongs to.
      Nom de l’IoT HubIoT hub name Nom du hub IoT sélectionné.The name of the selected iot hub.
      Nom de la stratégie IoT HubIoT hub policy name Sélectionnez la stratégie d’accès partagé.Select the shared access policy. 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.You can find the shared access policy on the IoT hub settings 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 connexion au service.The shared access policy for your event source must have service connect permissions.
      Clé de stratégie IoT HubIoT hub policy key La clé est déjà renseignée.The key is prepopulated.
    • 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.If the IoT hub is external to your subscriptions, or if you want to choose advanced options, select Provide IoT Hub settings manually.

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

      PropriétéProperty DescriptionDescription
      Identifiant d’abonnementSubscription ID Abonnement auquel appartient le hub IoT souhaité.The subscription the desired iot hub belongs to.
      Resource groupResource group Nom du groupe de ressources dans lequel l’IoT Hub a été créé.The resource group name in which the IoT hub was created.
      Nom de l’IoT HubIoT hub name Nom de votre IoT Hub.The name of your IoT hub. Lorsque vous avez créé votre IoT Hub, vous lui avez donné un nom.When you created your IoT hub, you entered a name for the IoT hub.
      Nom de la stratégie IoT HubIoT hub policy name Stratégie d’accès partagé.The shared access policy. 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.You can create the shared access policy on the IoT hub settings 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 connexion au service.The shared access policy for your event source must have service connect permissions.
      Clé de stratégie IoT HubIoT hub policy key Clé d’accès partagé utilisée pour authentifier l’accès à l’espace de noms Azure Service Bus.The shared access key that's used to authenticate access to the Azure 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 IoT HubIoT hub consumer group Groupe de consommateurs qui lit les événements de l’IoT Hub.The consumer group that reads events from the IoT 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.The event messages must be in this format or no data can 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 IoT Hub.To determine this value, you need to understand the message format of the message data that's sent to the 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.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 Hub IoT.Add the dedicated Azure Time Series Insight consumer group name that you added to your IoT hub.

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

  9. 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.After you create the event source, Azure Time Series Insight automatically starts streaming data to your environment.

Étapes suivantesNext steps