IoT Platform:Gérer les groupes de consommateurs

Fonctionnalités

Utilisez l'une des méthodes suivantes pour écouter les groupes de consommateurs et obtenir les messages transférés :

• Configurer un abonnement côté serveur AMQP : utilisez un abonnement côté serveur AMQP (Advanced Message Queuing Protocol) pour vous abonner à un type spécifique de messages envoyés par tous les appareils d'un produit et transférez ces messages vers un groupe de consommateurs désigné.

  Pour plus d'informations sur les différences entre les abonnements côté serveur et le transfert de données, consultez la rubrique Comparaison des solutions de transfert de données.

• Configurer une règle de transfert de données : utilisez la fonctionnalité de transfert de données pour acheminer les messages d'un topic spécifié vers un groupe de consommateurs AMQP.

Remarques importantes

Spécifiez un ID de groupe de consommateurs pour un client AMQP afin qu'il se connecte à IoT Platform et reçoive des messages. Pour plus d'informations, consultez la rubrique Connecter un client AMQP.

Un groupe de consommateurs peut contenir jusqu'à 64 clients AMQP. Ces clients partagent l'ID du groupe. Lorsqu'un appareil envoie un message à IoT Platform, la plateforme le transfère à un client aléatoire au sein du groupe.

Créer un groupe de consommateurs

1. Connectez-vous à la console IoT Platform.

2. Sur la page Overview, repérez l'instance à gérer et cliquez sur son ID ou son nom.

3. Dans le volet de navigation de gauche, choisissez Server-side Subscription puis cliquez sur l'onglet Consumer Groups.

4. Cliquez sur Create Consumer Group.

5. Dans la boîte de dialogue Create Consumer Group, saisissez un nom de groupe et cliquez sur OK.

   Le nom du groupe de consommateurs doit comporter entre 4 et 30 caractères. Il peut contenir des lettres, des chiffres et des traits de soulignement (_). Chaque caractère chinois ou japonais compte pour deux caractères.

Consulter et surveiller les groupes de consommateurs

Consultez le taux de consommation des messages et le nombre de messages en attente d'un groupe de consommateurs. Pour surveiller le groupe, configurez une règle d'alerte dans la console Cloud Monitor.

1. Sur l'onglet Consumer Groups, repérez le groupe de consommateurs à gérer et cliquez sur View dans la colonne Actions.

2. Sur l'onglet Consumer Group Status, consultez les valeurs des paramètres Real-time Message Consumption Rate, Accumulated Message Consumption Rate, Accumulated Messages et Last Consumed At. Vous pouvez également afficher la liste des clients connectés.

   Si le nombre de messages en attente est supérieur ou égal à 1, cliquez sur Clear à droite de Accumulated Messages pour effacer ces messages.

   Remarque

   Après la création d'un groupe de consommateurs, l'accumulation de messages dépend de son état d'activation.

   • Si le groupe de consommateurs n'a jamais été activé, il est hors ligne. L'envoi de messages vers ce groupe n'entraîne aucune accumulation.

   • Si le groupe de consommateurs a été activé puis désactivé, il est hors ligne. L'envoi de messages vers ce groupe entraîne leur accumulation.

   L'onglet Consumer Group Status affiche les métriques Real-time Message Consumption Rate, Accumulated Message Consumption Rate, Accumulated Messages et Last Consumed At dans sa zone d'informations de base. Sous ces métriques, la liste Online Clients contient les colonnes Client ID, Client IP/Port, Last Up Time, Per-Connection Real-time Consumption Rate et Per-Connection Accumulated Consumption Rate.

3. Sur l'onglet Consumer Group Status, cliquez sur Alert Settings. Dans le panneau Create Alert Rule, configurez une règle d'alerte pour recevoir des notifications et surveiller le nombre de messages en attente ainsi que le taux de consommation du groupe de consommateurs.

   Définissez le paramètre Product sur IoT Platform-Server subscription. Configurez les autres paramètres selon vos besoins métier. Pour plus d'informations, consultez la rubrique Configurer des règles d'alerte.

4. Sur la page Consumer Group Details, cliquez sur Consumption Logs. Sur l'onglet Consumption Logs, consultez les détails des enregistrements de consommation.

Supprimer un groupe de consommateurs

Vous pouvez supprimer un groupe de consommateurs, à l'exception du groupe par défaut. Après la suppression, tous les clients du groupe ne peuvent plus recevoir de messages.

1. Dissociez l'abonnement. Si un groupe de consommateurs est associé à un abonnement, dissociez d'abord cet abonnement. Si le groupe n'est associé à aucun abonnement, ignorez cette étape.

   1. Sur l'onglet Consumer Groups, repérez le groupe concerné et cliquez sur View dans la colonne Actions.

   2. Sur l'onglet Subscribed Products de la page Consumer Group Details, repérez le produit à gérer et cliquez sur Unsubscribe dans la colonne Actions. Dans le message qui s'affiche, cliquez sur OK.

      Remarque

      Si un seul groupe de consommateurs est associé à un abonnement côté serveur, l'action de désabonnement n'est pas disponible sur la page Consumer Group Details. Modifiez ou supprimez l'abonnement depuis l'onglet Subscriptions de la page Server-side Subscription.

2. Sur l'onglet Consumer Groups de la page Server-side Subscription, repérez le groupe de consommateurs à supprimer et cliquez sur Delete dans la colonne Actions. Dans le message qui s'affiche, cliquez sur OK.

Références

Pour savoir comment spécifier un ID de groupe de consommateurs pour un client AMQP et utiliser ce client pour recevoir des messages, consultez les rubriques suivantes :

• Connecter un client AMQP

• Exemple de connexion avec le SDK Java

• Exemple de connexion avec le SDK Node.js

• Connecter un client à IoT Platform avec le SDK .NET

• Connecter un client à IoT Platform avec le SDK Python 2.7

• Exemple : connexion avec le SDK Python 3

• Exemple de connexion avec le SDK PHP

• Exemple de connexion avec le SDK Go

Opérations API associées