O que uma mensagem retida informa
No MQTT, um publicador pode marcar uma mensagem como retida. O broker guarda a última mensagem daquele tópico e a entrega quando um cliente faz uma nova assinatura nesse tópico. Assim, um painel recém-aberto pode receber imediatamente um valor como online, mesmo que esse valor tenha sido publicado horas antes.
A mensagem retida comprova que o broker guardou aquele último valor. Ela não comprova sozinha que o aparelho está ligado, conectado ao Wi-Fi, respondendo na rede ou oferecendo um serviço. Antes de interpretar um estado, anote o tópico, o conteúdo, o horário de recebimento da mensagem e o que aquele publicador realmente mede. Distinga esse horário do horário da medição informado pelo publicador.
Diferencie estado, conexão e disponibilidade
Um tópico de estado pode representar uma leitura, uma troca de modo ou o resultado de uma verificação. A conexão MQTT do cliente ao broker é outra informação. Por exemplo, um NAS pode manter uma conexão MQTT ativa enquanto um compartilhamento de arquivos falha; o contrário também pode acontecer.
O Home Assistant documenta tópicos de disponibilidade para entidades MQTT. Eles permitem mostrar uma entidade como indisponível segundo um sinal definido pelo publicador. Leia a configuração do seu dispositivo antes de usar esse sinal: disponibilidade MQTT não substitui um teste do serviço específico que você quer acompanhar.
Faça um teste pequeno em um tópico de laboratório
Teste somente em um broker, tópico e rede que você administra. Não use tópico de comando, nem curingas, nem dados de aparelhos críticos. Publique um valor de teste claramente identificado com retenção ativada, conecte um cliente de teste com sessão limpa e faça uma nova assinatura no tópico. No MQTT 5, confirme que a opção Retain Handling da assinatura está em 0 (receber mensagens retidas ao assinar), que é o padrão. Observe se o valor chega antes de uma nova publicação.
O teste mostra o comportamento de retenção daquele tópico e broker. Ele não demonstra que todos os assinantes recebem mensagens, nem que uma automação executou alguma ação. Use um horário ou número de sequência no conteúdo de teste se você controla o publicador; isso ajuda a distinguir uma leitura recente de uma leitura antiga.
- Escolha um tópico exclusivo de teste, por exemplo test/lab/retained-status, sem dados pessoais ou credenciais.
- Publique um texto identificável com a opção de retenção e anote a hora local.
- Conecte um cliente de teste com sessão limpa e faça uma nova assinatura no tópico; no MQTT 5, confirme que a opção Retain Handling da assinatura está em 0 (receber mensagens retidas ao assinar), que é o padrão. Confira se ele recebeu a mensagem antes de uma nova publicação.
- Limpe a mensagem retida publicando uma mensagem vazia com retenção no mesmo tópico e confirme o resultado antes de encerrar o teste.
Evite alertas causados por informação antiga
Uma automação pode receber uma mensagem retida depois que o Home Assistant inicia ou volta a se inscrever. Antes de enviar notificação, gravar um evento ou mudar outro aparelho, adicione uma condição adequada ao risco. Para verificar a idade da leitura, compare a data e a hora da medição, incluídas pelo publicador, com um limite definido para a automação. Inclua um número de sequência em cada mensagem e guarde o último número processado pela automação para reconhecer mensagens repetidas. Avalie a disponibilidade separadamente.
Em uma instância de laboratório do Home Assistant, comece com uma ação reversível, como uma entrada no logbook ou uma notificação persistente de teste. Faça a própria integração MQTT estabelecer uma nova assinatura no tópico de teste e confira no rastreamento da automação se uma mensagem retida com data e hora de medição recentes aciona a regra. Repita com uma data e hora de medição deliberadamente antigas, estabelecendo novamente uma nova assinatura, e confirme no rastreamento que a condição rejeita a mensagem.
Registre uma conclusão verificável
Quando um aparelho parecer ativo de modo inesperado, registre quatro fatos: o tópico exato, o conteúdo e os campos de hora, se a mensagem era retida e qual foi a verificação independente. Para um NAS, a verificação pode ser a interface de administração autorizada ou um serviço que ele normalmente oferece.
DeviceShelf Server pode publicar observações de rede em uma instalação do Home Assistant que você administra. Trate cada evento ou estado MQTT como uma entrada para comparar com o horário observado e com os registros do próprio aparelho; ele não é garantia de disponibilidade, identidade ou segurança.
Ferramentas de rede gratuitas
A consulta acontece no navegador. Uma atribuição IEEE é uma pista, não uma prova do modelo ou de quem usa o aparelho.
Fontes e referências
Quais dispositivos estão na sua rede?
Ler a transcrição
Quais dispositivos estão na sua rede? Uma breve demonstração do DeviceShelf.
Faça uma varredura na sua rede local e confira os dispositivos encontrados.
Compare nomes, fabricantes e endereços IP no mesmo inventário.
Abra um dispositivo para consultar os detalhes e as portas abertas.
A IA opcional oferece pistas de identificação. Confira as evidências antes de concluir.
Confira a disponibilidade, os tempos de resposta e as quedas registradas.
A edição para servidor reúne o inventário da rede em um só lugar.
Confira eventos de conexão, desconexão e novos dispositivos.
Teste o DeviceShelf grátis por 7 dias. Licença Personal: €59 em pagamento único · deviceshelf.app
Continue a leitura
Confira sua rede com DeviceShelf
Teste a lista de aparelhos e o monitoramento por 7 dias em Windows, macOS ou Linux. Depois, a licença Personal custa €59 em pagamento único. A varredura básica funciona sem conta e sem IA. Este guia em português não indica que a interface do aplicativo tenha tradução para português.