Tutoriel : utiliser des rubriques d’espace de noms pour acheminer des messages MQTT vers Azure Event Hubs (Portail Azure)

Dans ce tutoriel, vous apprenez à utiliser une rubrique d’espace de noms pour acheminer les données de clients MQTT vers Azure Event Hubs. Les étapes principales sont les suivantes :

Prérequis

• Si vous n’en avez pas, créez un compte gratuit Azure avant de commencer.
• Si vous débutez avec Event Grid, lisez la Vue d’ensemble d’Event Grid avant de commencer ce tutoriel.
• Inscrivez le fournisseur de ressources Event Grid en suivant les étapes décrites dans Inscrire le fournisseur de ressources Event Grid.
• Vérifiez que le port 8883 est ouvert dans votre pare-feu. L’exemple dans ce tutoriel utilise le protocole MQTT, lequel communique sur le port 8883. Ce port pourrait être bloqué dans certains environnements réseau professionnels et scolaires.

Créer un espace de noms dans le Portail Azure

Un espace de noms dans Azure Event Grid est un conteneur logique pour une ou plusieurs rubriques, clients, groupes de clients, espaces de rubrique et liaisons d’autorisation. Il fournit un espace de noms unique, ce qui vous permet d’avoir plusieurs ressources dans la même région Azure. Avec un espace de noms Azure Event Grid, vous pouvez regrouper les ressources associées et les gérer en tant qu’unité unique dans votre abonnement Azure.

Suivez les sections suivantes pour créer, afficher et gérer un espace de noms Azure Event Grid.

Pour créer un espace de noms :

1. Connectez-vous au portail Azure.

2. Dans la zone de recherche, entrez Espaces de noms Event Grid et sélectionnez Espaces de noms Event Grid dans les résultats.

   

3. Sur la page Espaces de noms Event Grid, sélectionnez + Créer dans la barre d’outils.

   

4. Dans la page Informations de base, suivez ces étapes.

   1. Sélectionnez l’abonnement Azure dans lequel vous souhaitez créer l’espace de noms.

   2. Sélectionnez un groupe de ressources existant ou créez-en un.

   3. Entrez un nom pour l’espace de noms.

   4. Sélectionnez la région ou l’emplacement où vous souhaitez créer l’espace de noms.

   5. Au bas de la page, sélectionnez Examiner et créer.

      

5. Dans la page Vérifier + créer, passez en revue les paramètres, puis sélectionnez Créer.

6. Sur la page Déploiement réussi, sélectionnez Accéder à la ressource pour accéder à votre espace de noms.

Créez une rubrique d’espace de noms

1. Si vous n’êtes pas dans la page Espace de noms Event Grid, suivez les étapes pour créer, voir et gérer des espaces de noms afin d’afficher l’espace de noms que vous voulez utiliser pour créer la rubrique.

2. Dans la page Espace de noms Event Grid, sélectionnez l’option Rubriques dans la section Événements du menu de gauche.

3. Dans la page Rubriques, sélectionnez le bouton + Rubrique dans la barre de commandes.

   

4. Dans la page Créer une rubrique, tapez le nom de la rubrique à créer, puis sélectionnez Créer.

   

Activer l’identité managée de l’espace de noms Event Grid

1. Dans la page Espace de noms Event Grid, sélectionnez Identité sous Paramètres dans le menu de gauche.

2. Activez le commutateur pour utiliser une identité managée affectée par le système.

3. Sélectionnez Enregistrer dans la barre d’outils pour enregistrer le paramètre.

   

4. Cliquez sur Oui dans le message de confirmation.

5. Vérifiez que vous voyez l’ID d’objet de l’identité managée attribuée par le système, de même qu’un lien permettant d’attribuer des rôles.

   

   Vérifiez les notifications dans le portail pour confirmer l’activation de l’identité managée pour l’espace de noms.

Activer MQTT broker pour l’espace de noms Event Grid

1. Dans la page Espace de noms Event Grid, sélectionnez Configuration sous Paramètres dans le menu de gauche.

2. Cochez la case près de Activer MQTT broker.

3. Sélectionnez Appliquer en bas de la page.

   

   Vérifiez les notifications dans le portail pour confirmer l’activation de MQTT broker pour l’espace de noms.

Dans un onglet distinct du navigateur web ou dans une autre fenêtre, utilisez le Portail Azure pour créer un espace de noms Event Hubs avec un Event Hub.

Créer un espace de noms Event Hubs

Un espace de noms Event Hubs fournit un conteneur délimité unique, dans lequel vous créez un ou plusieurs hubs d’événements. Pour créer un espace de noms dans votre groupe de ressources à l’aide du portail, effectuez les actions suivantes :

1. Dans le portail Azure, sélectionnez Tous les services dans le menu de gauche, puis l’étoile (*) à côté d’Event Hubs dans la catégorie Analytique. Confirmez l’ajout d’Event Hubs dans FAVORIS dans le menu de navigation de gauche.

   

2. Sélectionnez Event Hubs sous FAVORIS dans le menu de navigation de gauche, puis Créer dans la barre d’outils.

   

3. Dans la page Créer un espace de noms, effectuez les étapes suivantes :

   1. Sélectionnez l’abonnement dans lequel vous souhaitez créer l’espace de noms.

   2. Sélectionnez le groupe de ressources que vous avez créé à l’étape précédente.

   3. Entrez un nom pour l’espace de noms. Le système vérifie immédiatement si le nom est disponible.

   4. Sélectionnez un emplacement pour l’espace de noms.

   5. Choisissez De base comme niveau tarifaire. Si vous envisagez d’utiliser l’espace de noms des applications Apache Kafka , utilisez le niveau Standard . Le niveau de base ne prend pas en charge les charges de travail Apache Kafka. Pour en savoir plus sur les différences entre les niveaux, consultez les articles Quotas et limites, Event Hubs Premium et Event Hubs Dedicated.

   6. Ne changez pas les paramètres Unités de débit (pour le niveau Standard) ou Unités de traitement (pour le niveau Premium). Pour en savoir plus sur les unités de débit ou de traitement, consultez Scalabilité avec Event Hubs.

   7. Au bas de la page, sélectionnez Vérifier + créer.

      

   8. Dans la page Vérifier + créer, passez en revue les paramètres, puis sélectionnez Créer. Attendez la fin du déploiement.

4. Dans la page Déploiement, sélectionnez Accéder à la ressource pour accéder à la page de votre espace de noms.

   

5. Vérifiez que la page Espace de noms Event Hubs qui s’affiche est similaire à l’exemple suivant :

   

Créer un hub d’événements

Pour créer un Event Hub dans l’espace de noms, effectuez les actions suivantes :

1. Dans la page Présentation, sélectionnez + Event Hub dans la barre de commandes.

   

2. Tapez un nom pour votre Event Hub, puis sélectionnez Vérifier + créer.

   

3. Dans la page Vérifier + créer, sélectionnez Créer.

4. Vous pouvez examiner l’état de la création du hub d’événements dans les alertes. Une fois créé, le hub d’événements apparaît dans la liste.

   

Autoriser l’espace de noms Event Grid à envoyer des événements à Event Hub

1. Sur la page Espace de noms Event Hubs, sélectionnez Contrôle d’accès (IAM) dans le menu de gauche.

2. Dans la page Contrôle d’accès, sélectionnez + Ajouter sur la barre de commandes, puis Ajouter une attribution de rôle.

   

3. Dans la page Ajouter une attribution de rôle, sélectionnez Expéditeur de données Event Hubs dans la liste des rôles, puis Suivant en bas de la page.

   

4. Dans la page Membres, suivez les étapes suivantes :

   1. Pour le champ Attribuer l’accès à, sélectionnez Identité managée.

   2. Choisissez + Sélectionner des membres.

      

5. Dans la page Sélectionner des identités managées, procédez comme suit :

   1. Sélectionnez votre abonnement Azure.

   2. Pour l’Identité managée, sélectionnez Espace de noms Event Grid.

   3. Sélectionnez l’identité managée ayant le même nom que l’espace de noms Event Grid.

   4. Choisissez Sélectionner en bas de la page.

      

6. Dans la page Ajouter une attribution de rôle, sélectionnez Vérifier + attribuer en bas de la page.

7. Sur la page Vérifier + attribuer, sélectionnez Vérifier + attribuer.

Créer un abonnement aux événements avec Event Hubs comme point de terminaison

1. Passez à l’onglet de votre fenêtre de navigateur web ayant l’espace de noms Event Grid ouvert.

2. Dans la page Espace de noms Event Grid, sélectionnez Rubriques dans le menu de gauche.

3. Dans la page Rubriques, sélectionnez la rubrique d’espace de noms que vous avez créée plus tôt.

   

4. Dans la page Rubrique d’espace de noms Event Grid, sélectionnez + Abonnement sur la barre de commandes du haut.

   

5. Dans la page Créer un abonnement, procédez comme suit :

   1. Entrez un nom pour l’abonnement aux événements.

   2. Pour Mode de remise, sélectionnez Push.

   3. Vérifiez que Type de point de terminaison est défini sur Event Hub.

   4. Sélectionnez Configurer un point de terminaison.

      

   5. Dans Sélectionner Event Hub, suivez ces étapes :

      1. Sélectionnez l’abonnement Azure qui contient l’Event Hub.

      2. Sélectionnez le groupe de ressources qui contient l’Event Hub.

      3. Sélectionner Espace de noms Event Hubs.

      4. Sélectionnez l’Event Hub dans l’espace de noms Event Hubs.

      5. Sélectionnez ensuite Confirmer la sélection.

         

   6. De retour dans la page Créer un abonnement, sélectionnez Affectée par le système pour Type d’identité managée.

   7. Au bas de la page, sélectionnez Créer.

      

Configurer le routage dans l’espace de noms Event Grid

1. Revenez à la page Espace de noms Event Grid en sélectionnant l’espace de noms dans la section Essentials de la page Rubrique d’espace de noms Event Grid ou en sélectionnant le nom d’espace de noms dans le menu de navigation en haut.

2. Dans la page Espace de noms Event Grid, sélectionnez l’option Routage dans le menu de gauche de la section MQTT broker.

3. Dans la page Routage, sélectionnez Activer le routage.

4. Pour Type de rubrique, sélectionnez Rubrique d’espace de noms.

5. Sous Rubrique, sélectionnez la rubrique d’espace de noms de service Event Grid créée où tous les messages MQTT vont être acheminés.

6. Sélectionnez Appliquer.

   

   Vérifiez les notifications pour confirmer l’activation de l’espace de noms avec les informations de routage.

Créer des clients, un espace de rubrique et des liaisons d’autorisations

Suivez les étapes du démarrage rapide : Publier et s’abonner à une rubrique MQTT pour effectuer ce qui suit :

1. Créer un client. Vous pouvez créer un deuxième client si vous le souhaitez, mais il s’agit d’une option facultative.

2. Créer un espace de rubrique.

3. Créez des liaisons d’autorisations éditeur et abonné.

4. Utilisez MQTTX pour envoyer quelques messages.

5. Vérifiez que l’Event Hub a reçu ces messages dans la page Vue d’ensemble de votre espace de noms Event Hubs.

   

Afficher les messages MQTT acheminés dans Event Hubs à l’aide d’une requête Stream Analytics

Accédez à l’instance Event Hubs (Event Hub) dans votre abonnement aux événements dans le Portail Azure. Traitez les données de votre Event Hub avec Stream Analytics. Pour obtenir plus d’informations, consultez Traiter des données d’Azure Event Hubs avec Stream Analytics – Azure Event Hubs | Microsoft Learn. Vous pouvez voir les messages MQTT dans la requête.

Étapes suivantes

Si vous souhaitez obtenir des exemples de code, accédez à ce référentiel GitHub.