Usando o Utilitário do Cliente MQTT
Use um ou mais utilitários do cliente MQTT para testar a configuração de telemetria. No escopo desta tarefa, um utilitário cliente é usado para publicar e assinar mensagens.
Antes de Iniciar
- Certifique-se de que o serviço de telemetria (MQXR) esteja em execução.
- Você precisa de pelo menos um canal de telemetria em execução para usar com êxito o utilitário do cliente MQTT.
Sobre Esta Tarefa
PlainText
criado com o assistente Definir Configuração de Amostra.Por padrão, o ID do usuário do MCA do canal PlainText
é configurado como guest
no Windows e como nobody
no Linux®.
Você precisa desses valores padrão para
assinar tópicos.
Procedimento
- Clique com o botão direito do mouse no canal de telemetria
PlainText
; em seguida, clique em Executar Utilitário do Cliente MQTT. A janela do utilitário cliente é aberta. Os campos Host e Porta são definidos automaticamente usando os valores do canal de telemetria selecionado. - Digite um ID de cliente no campo Identificador de Cliente. Um novo identificador de cliente é gerado cada vez que você ativa um utilitário do cliente MQTT em um canal de telemetria. Você pode usar o identificador gerado ou digitar um nome a sua escolha. Se você executar mais de um utilitário cliente em um canal de telemetria, assegure-se de usar diferentes IDs do cliente para cada utilitário cliente. Se dois utilitários do cliente MQTT tiverem o mesmo ID de cliente, o mais recente a conectar-se forçosamente desconectará o anterior. Quando você executa mais de um utilitário do cliente MQTT em um canal de telemetria, o identificador de cliente gerado tem um sufixo numérico que é incrementado toda vez que um novo utilitário cliente é iniciado.
- Clique em Opções para abrir a janela Opções de Conexão. Você pode iniciar o utilitário cliente com uma sessão limpa ou configurar as opções de último desejo e testamento.
- Clique em Conectar para estabelecer uma conexão com o canal
de telemetria
PlainText
. Uma nova entrada de eventoConnected
é exibida no Histórico do Cliente. - Digite um nome de tópico no campo Tópico de
Assinatura.
O nome do tópico padrão é
testTopic
e esse nome é usado em toda esta tarefa. - Selecione a qualidade de serviço de assinatura no menu QoS de Pedido.
- Clique em Assinar para assinar o tópico
testTopic
. Uma nova entrada de eventoSubscribed
é exibida no Histórico do Cliente, com o nome do tópico, o QoS e a hora da assinatura. - Aceite o nome do tópico padrão,
testTopic
, no campo Publicação Tópico. Em geral, assegure que os tópicos de assinatura e publicação correspondam para que o cliente MQTT receba mensagens do tópico correto. - Digite uma mensagem no campo Mensagem.
O teste da mensagem padrão é
Mensagem de Teste
. - Selecione a qualidade de serviço de publicação no menu QoS de Pedido.
- Selecione Retido para encaminhar a publicação retida mais recente neste tópico para novos assinantes.
- Clique Publicar para publicar a mensagem no tópico
testTopic
para assinantes interessados. Uma nova entrada de eventoPublished
é exibida no Histórico do Cliente, com o nome do tópico, o QoS, se a mensagem é retida e a hora da assinatura. No utilitário cliente de recebimento, uma nova entrada de eventoReceived
é exibida no Histórico do Cliente. - Selecione a mensagem recebida no Histórico do Cliente; em seguida, clique em Visualizar Mensagem para visualizar a mensagem integral na janela Visualizador de Mensagem. Como alternativa, selecione a mensagem e pressione Enter, ou dê um clique duplo na mensagem recebida.
Resultados
Publicar mensagens e visualizá-las nos tópicos assinados mostram que você configurou corretamente o gerenciador de filas para Telemetria.