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.

Pourquoi et quand exécuter 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, reportez-vous à la section 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 a pour valeur guest sous Windows, et 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. Tapez un ID client dans la zone Identificateur de 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 Connecter pour établir une connexion avec le canal de télémétrie PlainText. Une nouvelle entrée d'événement Connecté est affichée dans l'historique client.
  5. Tapez un nom de rubrique dans la zone Rubrique de l'abonnement. Le nom de la rubrique par défaut est testTopic et le nom est utilisé tout au long de cette tâche.
  6. Sélectionnez la qualité de service de l'abonnement à partir du menu Requête QoS.
  7. Cliquez sur S'abonner pour s'abonner à la rubrique testTopic. Une nouvelle entrée d'événement Abonné est affichée dans l'historique client avec le nom de rubrique, la qualité de service (QoS) et l'heure d'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. Tapez le message dans la zone Message. Le message test par défaut est Test Message.
  10. Sélectionnez la qualité de service de la publication à partir du menu Requête QoS.
  11. Sélectionnez Conservé pour transférer la publication conservée la plus récente sur cette rubrique pour les 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 Publié est affichée dans l'historique client, avec le nom de rubrique, la qualité de service (QoS), si le message est conservé, et l'heure de l'abonnement. Sur le client destinataire, une nouvelle entrée d'événement Reçu 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 l'intégralité du message dans la fenêtre Afficheur de message. 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.