Ir para o conteúdo

Guia de rede · Português (Brasil)

Tópicos de disponibilidade MQTT: entenda o estado offline

Um estado offline em MQTT pode ser um sinal útil, mas não identifica sozinho a causa de uma falha. Este guia ajuda você a verificar, em um ambiente de teste, como a disponibilidade de uma entidade do Home Assistant muda quando um cliente MQTT envia as mensagens configuradas.

Disponibilidade é uma configuração, não um diagnóstico

Entidades MQTT no Home Assistant podem usar um tópico de disponibilidade e conteúdos configurados, como `online` e `offline`. Se a disponibilidade acompanhar as mensagens publicadas durante o teste, isso indica que o Home Assistant recebeu e interpretou os conteúdos configurados. Não mostra, por si só, se o aparelho perdeu energia, se o publicador caiu, se o broker recusou uma conexão ou se o tópico foi escrito de forma diferente.

Separe as perguntas antes de investigar: o Home Assistant criou a entidade esperada? Um publicador conhecido enviou exatamente o conteúdo configurado? A entidade mudou? Uma automação observou essa mudança? Cada resposta depende de uma evidência diferente.

Use um tópico de laboratório

Não comece pelo tópico de um NAS, roteador, tomada ou serviço importante. Escolha um broker que você administra e reserve um prefixo de tópicos para os testes. Crie um tópico temporário, por exemplo lab/disponibilidade-2026-10-27/status. Não inclua senhas, endereços privados, comandos nem dados pessoais.

Anote o tópico exato, os conteúdos que representam disponível e indisponível, se a mensagem é retida, a entidade criada pelo Home Assistant e o horário de cada teste. Um nome de tópico parecido não é suficiente: tópicos e filtros MQTT seguem regras de correspondência definidas pelo protocolo.

Teste as transições de disponibilidade

Envie primeiro o conteúdo configurado como disponível a partir de um publicador de laboratório conhecido. Encontre a entidade no Home Assistant e registre o estado e o horário. Depois envie o conteúdo configurado como indisponível. Use outro valor somente se ele estiver mapeado na configuração; caso contrário, o teste pode medir erro de interpretação em vez de disponibilidade.

Se a entidade não mudar, compare antes o tópico, maiúsculas e minúsculas, o conteúdo e a opção de retenção. Altere uma variável por vez. Uma sequência explícita de `online`, `offline` e `online` ajuda a mostrar se a entidade acompanha as mensagens atuais ou apenas uma informação guardada anteriormente.

  1. Configure uma entidade MQTT de teste com um identificador exclusivo, o tópico de disponibilidade escolhido e os conteúdos que representam disponível e indisponível.
  2. Publique o conteúdo configurado como disponível e registre a mudança da entidade.
  3. Publique o conteúdo configurado como indisponível e registre a segunda mudança.
  4. Publique novamente o conteúdo disponível antes de testar qualquer automação.
  5. Remova a configuração de laboratório e a mensagem retida de teste quando terminar, se isso for adequado no seu broker.

Estado e disponibilidade não são a mesma coisa

Um sensor MQTT pode ter um tópico de estado e outro de disponibilidade. Quando a entidade fica indisponível, seu estado no Home Assistant passa a `unavailable`. Uma leitura anterior no histórico não comprova que o dispositivo continua enviando dados.

Mensagens retidas exigem atenção extra. O broker pode entregar uma mensagem retida a quem assina depois; isso é útil para estado, mas não demonstra que ela foi publicada depois de uma falha. Registre se o teste usou retenção para não confundir estado armazenado com um evento novo.

Faça a primeira automação apenas observar

Depois que a entidade de laboratório alternar como esperado, crie uma automação temporária que apenas faça uma notificação persistente, uma entrada no logbook ou atualize um auxiliar (helper). Um gatilho de estado pode observar a entidade; um gatilho MQTT pode observar a mensagem diretamente. Escolha o que corresponde ao fato que você quer testar.

Envie uma vez o conteúdo configurado para indicar indisponibilidade e confira o rastreamento da automação e o resultado inofensivo. Se houver mudança de entidade sem rastreamento, revise o alvo e o tipo de gatilho. Se houver rastreamento sem o resultado esperado, revise condições e ações. Nenhum desses resultados prova a indisponibilidade de um aparelho real.

Registre uma conclusão limitada

Para produção, trate o estado offline como início de uma verificação. Guarde o identificador da entidade, o valor observado e o horário; depois compare separadamente o log do broker, o log do publicador e o estado do serviço relevante. Não use uma única mensagem de disponibilidade como condição para uma ação com consequência importante.

O DeviceShelf Server pode publicar observações de rede via descoberta MQTT em uma instalação do Home Assistant que você administra. Use a observação para comparar horários e registros, não como garantia de identidade, disponibilidade, entrega MQTT ou êxito de uma automação.

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.

Consultar o fabricante de um endereço MAC

Fontes e referências

Quais dispositivos estão na sua rede?

Demonstração de 52 segundos com dados fictícios e interface em inglês (versões 1.9.23 e 1.9.27). Sem narração; legendas em português.
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

Como saber quem está conectado ao seu Wi-Fi

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.

Baixe e teste na sua própria rede

Escolha o instalador para o seu computador e abra o aplicativo na rede que você administra.

Versão 1.9.83 · Personal: €59 em pagamento único

Teste grátis por 7 dias, sem cartão. Baixar o instalador não ativa uma licença. A interface do aplicativo não está disponível em português.

Instruções de instalação (inglês)