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

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 cliente, consulte Executado o Utilitário do Cliente MQTT. Dentro do escopo desta tarefa, o utilitário do 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 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

  1. 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.
  2. 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.
  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 Conectar para estabelecer uma conexão com o canal de telemetria PlainText. Uma nova entrada de evento Connected é exibida no Histórico do Cliente.
  5. 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.
  6. Selecione a qualidade de serviço de assinatura no menu QoS de Pedido.
  7. Clique em Assinar para assinar o tópico testTopic. Uma nova entrada de evento Subscribed é exibida no Histórico do Cliente, com o nome do tópico, o QoS e a hora da assinatura.
  8. 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.
  9. Digite uma mensagem no campo Mensagem. O teste da mensagem padrão é Mensagem de Teste.
  10. Selecione a qualidade de serviço de publicação no menu QoS de Pedido.
  11. Selecione Retido para encaminhar a publicação retida mais recente neste tópico para novos assinantes.
  12. Clique 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 cliente de recebimento, uma nova entrada de evento 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 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.