Utilisation de l'utilitaire client MQTT

Utilisez un ou plusieurs utilitaires client MQTT pour tester votre configuration de télémétrie. Dans le cadre de cette tâche, un utilitaire client est utilisé pour publier des messages et s'y abonner.

Avant de commencer

  • Vérifiez que le service de télémétrie (MQXR) est en cours de fonctionnement.
  • Au moins un canal de télémétrie doit être actif pour utiliser un utilitaire client MQTT.

A propos de cette tâche

Il existe plusieurs méthodes pour démarrer l'utilitaire client MQTT. Pour plus d'informations sur l'exécution de l'utilitaire client, voir Exécution de l'utilitaire client MQTT. Dans le cadre de cette tâche, l'utilitaire client est démarré à partir du canal de télémétrie PlainText créé à l'aide de l'assistant Définition du modèle de configuration.

Par défaut, l' ID utilisateur MCA du canal PlainText est défini sur guest sous Windows et sur nobody sous Linux®. Ces valeurs par défaut sont obligatoires pour s'abonner aux rubriques.

Procédure

  1. Cliquez avec le bouton droit de la souris sur le canal de télémétrie PlainText , puis cliquez sur Exécuter l'utilitaire client MQTT. La fenêtre de l'utilitaire client s'ouvre. Les zones Hôte et Port sont automatiquement définies à l'aide des valeurs provenant du canal de télémétrie sélectionné.
  2. Entrez un ID client dans la zone Identificateur client . Un nouvel identificateur de client est généré chaque fois que vous lancez un utilitaire client MQTT à partir d'un canal de télémétrie. Vous pouvez soit utiliser l'identificateur généré, soit taper un nom de votre choix. Si vous exécutez plusieurs utilitaires client sur un canal de télémétrie, veillez à remplacer l'ID client pour chaque utilisateur client. Si deux utilitaires client MQTT ont le même ID client, le dernier à se connecter force la déconnexion du précédent. Lorsque vous exécutez plusieurs utilitaires client MQTT à partir d'un canal de télémétrie, le suffixe de l'identificateur de client est incrémenté chaque fois qu'un nouvel utilitaire client est démarré.
  3. Cliquez sur Options pour ouvrir la fenêtre Options de connexion . Vous pouvez démarrer l'utilitaire client avec une session propre ou configurer les options Dernière volonté et testament.
  4. Cliquez sur Connexion pour établir une connexion avec le canal de télémétrie PlainText . Une nouvelle entrée d'événement Connected s'affiche dans l' historique client.
  5. Entrez un nom de rubrique dans la zone Abonnement Rubrique . Le nom de rubrique par défaut est testTopic et ce nom est utilisé tout au long de cette tâche.
  6. Sélectionnez la qualité de service de l'abonnement dans le menu Demande de qualité de service .
  7. Cliquez sur S'abonner pour vous abonner à la rubrique testTopic. Une nouvelle entrée d'événement Subscribed s'affiche dans l' historique client, avec le nom de la rubrique, la qualité de service et l'heure de l'abonnement.
  8. Acceptez le nom de la rubrique par défaut, testTopic, dans la zone Publication Rubrique . De manière générale, vérifiez que les rubriques abonnement et publication correspondent pour que le client MQTT reçoive des messages provenant de la rubrique appropriée.
  9. Entrez un message dans la zone Message . Le test de message par défaut est Test Message.
  10. Sélectionnez la qualité de service de publication dans le menu Demande de qualité de service .
  11. Sélectionnez Conservation pour transférer la publication conservée la plus récente sur cette rubrique aux nouveaux abonnés.
  12. Cliquez sur Publier pour publier le message dans la rubrique testTopic pour les abonnés intéressés. Une nouvelle entrée d'événement Published s'affiche dans l' historique client, avec le nom de la rubrique, la qualité de service, la conservation du message et l'heure de l'abonnement. Dans l'utilitaire client récepteur, une nouvelle entrée d'événement Received est affichée dans l' historique client.
  13. Sélectionnez le message reçu dans l' historique client, puis cliquez sur Afficher le message pour afficher le message complet dans la fenêtre Afficheur de messages . Vous pouvez également sélectionner le message et appuyer sur Entrée, ou cliquer deux fois sur le message reçu.

Résultats

La publication et la visualisation des messages à partir des rubriques auxquelles vous êtes abonné indique que vous avez correctement configuré votre gestionnaire de files d'attente pour Telemetry.