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
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
- 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é. - 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é.
- 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.
- Cliquez sur Connecter pour établir une connexion
avec le canal de télémétrie
PlainText
. Une nouvelle entrée d'événementConnecté
est affichée dans l'historique client. - 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. - Sélectionnez la qualité de service de l'abonnement à partir du menu Requête QoS.
- Cliquez sur S'abonner pour s'abonner à la rubrique
testTopic
. Une nouvelle entrée d'événementAbonné
est affichée dans l'historique client avec le nom de rubrique, la qualité de service (QoS) et l'heure d'abonnement. - 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. - Tapez le message dans la zone Message.
Le message test par défaut est
Test Message
. - Sélectionnez la qualité de service de la publication à partir du menu Requête QoS.
- Sélectionnez Conservé pour transférer la publication conservée la plus récente sur cette rubrique pour les nouveaux abonnés.
- Cliquez sur Publier pour publier le message
dans la rubrique
testTopic
pour les abonnés intéressés. Une nouvelle entrée d'événementPublié
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énementReçu
est affichée dans l'historique client. - 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.