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 Começar

  • 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

Há vários métodos para iniciar o utilitário do cliente MQTT. Para obter mais informações sobre a execução do utilitário do cliente, consulte Executando o utilitário do cliente MQTT. Dentro do escopo desta tarefa, o utilitário cliente é iniciado a partir do canal de telemetria PlainText criado com o assistente Definir configuração de amostra.

Por padrão, o ID do usuário MCA do canal PlainText é configurado como guest no Windows, e nobody no Linux®. Você precisa desses valores padrão para assinar tópicos.

Procedimento

  1. Clique com o botão direito do mouse no canal de telemetria PlainText , em seguida, clique em Run MQTT Client Utility. A janela do utilitário cliente é aberta. Os campos Host e Porta são definidos automaticamente usando os valores do canal de telemetria selecionado.
  2. Digite um ID do cliente no campo Identificador do 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.
  3. 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.
  4. Clique em Connect para estabelecer uma conexão com o canal de telemetria PlainText . Uma nova entrada de eventos de Connected é exibida no Histórico do Cliente.
  5. Digite um nome de tópico no campo Assinar Tópico . O nome do tópico padrão é testTopic e este nome é usado em toda esta tarefa.
  6. Selecione a qualidade de serviço da subscrição no menu Solicitação QoS
  7. Clique em Assinar para assinar o tópico testTopic. Uma nova entrada de evento de Subscribed é exibida no Histórico do Cliente, juntamente com o nome do tópico, QoS, e o horário de subscrição
  8. Aceite o nome de 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.
  9. Digite uma mensagem no campo Mensagem . O teste de mensagem padrão é Test Message.
  10. Selecione a qualidade de serviço da publicação no menu Solicitação QoS .
  11. Selecione Retidas para encaminhá-lo a publicação retida mais recente sobre este tópico para novos assinantes.
  12. Clique em Publicar para publicar a mensagem no tópico testTopic para assinantes interessados. Uma nova entrada de evento Published é 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 do cliente receptor, uma nova entrada de eventos de Received é exibida no Histórico do Cliente.
  13. Selecione a mensagem recebida no Histórico do Cliente, em seguida, clique em Visualizar mensagem para visualizar a mensagem completa na janela Message Viewer . 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.