400 sintomas catalogados
Cada sintoma com causa provável e correção, ligado à lição da trilha IoT que explica o porquê. Descreva o sintoma para filtrar.
| Sintoma | Causa provável | Correção | Lição |
|---|---|---|---|
| Fluxo não dispara no horário | Configuração incorreta do node inject ou do sistema horário | Confirme o fuso horário do servidor e a configuração do node inject. | Agendamento e timers: controle preciso no Node-RED |
| Mensagens duplicadas | Debounce mal configurado ou ausente | Revise o node delay e ajuste o tempo de rate limit. | Agendamento e timers: controle preciso no Node-RED |
| Logs não aparecem | Node debug não conectado ou arquivo inacessível | Verifique conexões e permissões do arquivo de log. | Agendamento e timers: controle preciso no Node-RED |
| Usuário recebe 'Not authorized' ao publicar | Permissão ausente ou ACL mal configurada | Verifique o arquivo de ACL e se o usuário está correto | Autenticação e ACLs: quem pode publicar e assinar o quê |
| Conexão recusada pelo broker | Senha errada ou usuário não cadastrado | Confirme usuário e senha no arquivo de senhas | Autenticação e ACLs: quem pode publicar e assinar o quê |
| Node-RED não pede senha | Configuração de adminAuth ausente ou mal formatada | Revise o settings.js e reinicie o Node-RED | Autenticação e ACLs: quem pode publicar e assinar o quê |
| Sensor não dispara evento no OpenHAB | Configuração errada do tópico MQTT ou falha de comunicação | Revise o tópico e teste a conexão do broker | Automação baseada em eventos externos e sensores inteligente |
| Dados do calendário não aparecem | URL ou formato ICS inválido | Use um arquivo .ics válido e revise a configuração do binding | Automação baseada em eventos externos e sensores inteligente |
| Temperatura externa não atualiza | Erro na transformação JSONPATH ou API fora do ar | Teste a URL manualmente e ajuste o caminho da transformação | Automação baseada em eventos externos e sensores inteligente |
| Logs não mostram eventos esperados | Nível de log ou logger mal configurado | Ajuste o arquivo log4j2.xml para incluir sua regra | Automação baseada em eventos externos e sensores inteligente |
| O item MQTT_Consumo_Predito não atualiza. | Problema na configuração do canal MQTT ou no broker. | Revise a configuração do item e do canal MQTT no OpenHAB. Teste a publicação manual via MQTT. | Automação baseada em IA e machine learning com OpenHAB |
| A regra não dispara mesmo com valor alto. | Erro de tipo ou comparação no script da regra. | Confirme que o item está como Number e revise a lógica da regra. | Automação baseada em IA e machine learning com OpenHAB |
| O script Python não publica no tópico. | Falta de conexão ou autenticação no broker MQTT. | Verifique endereço, porta e credenciais do broker. Use client.loop_start() e client.disconnect() corretamente. | Automação baseada em IA e machine learning com OpenHAB |
| Sensor não aparece no painel | Configuração do canal MQTT ou Modbus incorreta | Revise tópicos MQTT ou endereços Modbus e reinicie o serviço | Automação de ambientes de TI: salas técnicas e data centers |
| Regra não dispara | Sintaxe incorreta ou item não atualizado | Cheque logs de erro e revise a lógica da regra | Automação de ambientes de TI: salas técnicas e data centers |
| Alerta não chega | Configuração de binding de notificação incompleta | Verifique chaves de API e conectividade do serviço de alerta | Automação de ambientes de TI: salas técnicas e data centers |
| Luzes não respondem ao comando | Configuração errada do channel ou falha de comunicação Z-Wave | Revise o channel do item e verifique o status do dispositivo na interface OpenHAB | Automação predial corporativa: prédios, escritórios e filiai |
| Dados de uso não aparecem nos relatórios | Persistence não configurada corretamente | Consulte a documentação de persistence e ajuste o arquivo de configuração | Automação predial corporativa: prédios, escritórios e filiai |
| Comando centralizado não chega à filial | Tópico MQTT incorreto ou broker inacessível | Verifique o tópico e conectividade entre brokers | Automação predial corporativa: prédios, escritórios e filiai |
| Sensor não aparece no dashboard | Tópico MQTT incorreto ou sensor desconectado | Verifique o tópico no firmware e a conexão Wi-Fi do sensor | Automação predial: integração de sensores, atuadores e dashb |
| Atuador não responde ao comando | Assinatura do tópico errada ou falha no firmware | Confirme o tópico de comando e revise o código do atuador | Automação predial: integração de sensores, atuadores e dashb |
| Dashboard não atualiza em tempo real | Node-RED desconectado do broker ou fluxo com erro | Cheque logs do Node-RED e reinicie o serviço | Automação predial: integração de sensores, atuadores e dashb |
| Sensor não aparece no dashboard | Tópico MQTT incorreto ou sensor desconectado | Verifique o tópico no firmware e a conexão Wi-Fi do sensor | Automação predial: integração de sensores, atuadores e dashb |
| Atuador não responde ao comando | Assinatura do tópico errada ou falha no firmware | Confirme o tópico de comando e revise o código do atuador | Automação predial: integração de sensores, atuadores e dashb |
| Dashboard não atualiza em tempo real | Node-RED desconectado do broker ou fluxo com erro | Cheque logs do Node-RED e reinicie o serviço | Automação predial: integração de sensores, atuadores e dashb |
| Script não reage a eventos MQTT | Tópico incorreto ou broker MQTT inacessível | Verifique nomes dos tópicos e conectividade com o broker | Automatizando processos industriais com Zigbee, MQTT e scrip |
| Ação não é executada mesmo com condição satisfeita | Erro de lógica no script ou payload inesperado | Inspecione payloads recebidos e revise a lógica do script | Automatizando processos industriais com Zigbee, MQTT e scrip |
| Alertas não chegam por e-mail | Configuração de e-mail ou permissão do sistema | Teste envio de e-mail manualmente e ajuste permissões | Automatizando processos industriais com Zigbee, MQTT e scrip |
| Dispositivos ficam offline após falha de gateway | Não há roteadores ou rotas alternativas suficientes | Adicione mais roteadores e redistribua dispositivos | Balanceamento de carga e redundância em redes Zigbee industr |
| Latência alta em parte da rede | Roteador sobrecarregado ou mal posicionado | Reposicione roteadores e distribua a carga | Balanceamento de carga e redundância em redes Zigbee industr |
| Falha no failover automático | Monitoramento MQTT não está integrado corretamente | Revise scripts e permissões MQTT | Balanceamento de carga e redundância em redes Zigbee industr |
| Cliente não conecta via TLS | Certificado da CA não confiável ou caminho incorreto no cafile | Verifique se o cliente usa a mesma CA e se o caminho do cafile está correto | Cifrando o tráfego MQTT e controlando acesso à rede Zigbee |
| Usuário não consegue publicar em tópico permitido | Erro na ACL ou usuário digitado errado | Revise o arquivo de ACL e o nome do usuário | Cifrando o tráfego MQTT e controlando acesso à rede Zigbee |
| Broker aceita conexões anônimas | allow_anonymous não está como false | Confirme a configuração no mosquitto.conf | Cifrando o tráfego MQTT e controlando acesso à rede Zigbee |
| EdgeNode não aparece como Ready | Configuração incorreta do edgehub ou falha de conexão com CloudCore | Verifique logs do EdgeCore em /var/log/kubeedge/edgecore.log e ajuste o endpoint do CloudCore | CloudCore, EdgeCore e EdgeMesh: como tudo se conecta |
| Pods não iniciam na borda | edged não está rodando ou configuração de runtime container inválida | Confirme se o edged está ativo e revise a configuração do container runtime | CloudCore, EdgeCore e EdgeMesh: como tudo se conecta |
| Serviços entre EdgeNodes não se comunicam | EdgeMesh não habilitado ou portas bloqueadas | Habilite EdgeMesh e libere as portas configuradas (ex: 40001) no firewall | CloudCore, EdgeCore e EdgeMesh: como tudo se conecta |
| Status de pods não sincroniza após reconexão | Buffer do metaManager insuficiente ou falha de sincronização | Aumente buffers em edgecore.yaml e monitore logs de metaManager | CloudCore, EdgeCore e EdgeMesh: como tudo se conecta |
| Dispositivos perdem conexão em horários de pico | Interferência de Wi-Fi ou Bluetooth em horários de uso intenso | Mude o canal Zigbee para um menos congestionado e repita a medição | Cobertura e interferência: como planejar o alcance real do Z |
| Áreas sem cobertura mesmo com roteadores próximos | Obstáculo físico denso (metal, concreto armado) bloqueando sinal | Reposicione roteadores ou adicione mais pontos intermediários | Cobertura e interferência: como planejar o alcance real do Z |
| Sinal forte mas instabilidade de rede | Ruído de RF de fontes industriais (motores, inversores) | Identifique e isole a fonte de ruído, ou mude o canal Zigbee | Cobertura e interferência: como planejar o alcance real do Z |
| Dashboard sem dados | Persistência ou binding não configurados corretamente. | Revise configurações do arquivo .persist ou do binding openhab-metrics. | Coleta e visualização de métricas com Grafana |
| Métricas faltando no Prometheus | Scrape endpoint incorreto ou firewall bloqueando. | Verifique a URL e libere a porta 8080. | Coleta e visualização de métricas com Grafana |
| Alertas não disparam | Condições de alerta mal definidas ou queries erradas. | Ajuste as queries e teste manualmente os limites. | Coleta e visualização de métricas com Grafana |
| Logs do zigbee2mqtt não aparecem no arquivo | Caminho do log_file incorreto ou permissões insuficientes | Verifique o caminho em configuration.yaml e ajuste permissões do diretório /var/log | Coletando e analisando logs: do zigbee2mqtt ao Linux |
| Logs antigos não são rotacionados | logrotate não está configurado ou não roda via cron | Crie /etc/logrotate.d/zigbee2mqtt e teste com logrotate -f | Coletando e analisando logs: do zigbee2mqtt ao Linux |
| journalctl não mostra logs do serviço | Service file do systemd não define StandardOutput=syslog | Ajuste o arquivo de serviço e reinicie o daemon | Coletando e analisando logs: do zigbee2mqtt ao Linux |
| Arquivo de log cresce muito rápido | Nível de log muito detalhado (debug) em produção | Reduza para 'info' após troubleshooting | Coletando e analisando logs: do zigbee2mqtt ao Linux |
| Dispositivo não aparece na rede | Fora de alcance ou canal incorreto | Reaproxime do roteador ou ajuste o canal no coordenador | Como Zigbee realmente funciona: camadas, espectro e topologi |
| Rede instável, perda de pacotes | Interferência de Wi-Fi ou poucos roteadores | Mude o canal Zigbee e adicione mais roteadores | Como Zigbee realmente funciona: camadas, espectro e topologi |
| Latência alta na resposta de sensores | Muitos saltos mesh ou congestionamento | Reposicione roteadores para reduzir saltos | Como Zigbee realmente funciona: camadas, espectro e topologi |
| ESP32 não conecta ao broker | Credenciais erradas ou firewall bloqueando porta 1883 | Corrija usuário/senha e libere a porta no firewall | Conexão caiu? Debug prático de MQTT, Mosquitto e ESP32 |
| Mensagem publicada não chega ao assinante | Tópico diferente ou QoS incompatível | Verifique o nome do tópico e ajuste o QoS | Conexão caiu? Debug prático de MQTT, Mosquitto e ESP32 |
| Mosquitto loga 'Connection Refused' | Configuração de autenticação ou ACL incorreta | Revise usuários e permissões no broker | Conexão caiu? Debug prático de MQTT, Mosquitto e ESP32 |
| Tópicos MQTT não aparecem após alteração | Erro de sintaxe no configuration.yaml ou serviço não reiniciado | Valide o YAML, corrija erros e reinicie o zigbee2mqtt | Configuração avançada do zigbee2mqtt: tópicos, nomes e grupo |
| Dispositivo não responde ao novo nome | friendly_name duplicado ou erro de digitação | Garanta unicidade dos nomes e revise a configuração | Configuração avançada do zigbee2mqtt: tópicos, nomes e grupo |
| Grupo não executa comandos em todos os dispositivos | Dispositivo não incluído corretamente no grupo | Revise a lista de devices do grupo no configuration.yaml | Configuração avançada do zigbee2mqtt: tópicos, nomes e grupo |
| Cenas não alteram todos os dispositivos | Itens não associados corretamente ao grupo ou erro na regra | Revise a associação dos itens e a lógica das regras | Configuração de regras, grupos e cenas |
| Regra dispara em horários errados | Expressão cron mal configurada | Ajuste a expressão cron conforme a documentação | Configuração de regras, grupos e cenas |
| Grupo não reflete estado real dos itens | Tipo de agregação inadequado | Use operadores de grupo adequados (OR, AND, etc.) | Configuração de regras, grupos e cenas |
| Mensagens de buffer overflow nos logs | Buffer de mensagens subdimensionado | Aumente o parâmetro dataBuffer no edgecore.yaml | Configurando CloudCore e EdgeCore: flags, arquivos e variáve |
| Conexão entre Edge e Cloud caindo frequentemente | Timeouts muito agressivos ou heartbeat longo demais | Reduza o intervalo de heartbeat e aumente o timeout | Configurando CloudCore e EdgeCore: flags, arquivos e variáve |
| Logs ocupando muito espaço em disco | Nível de log muito detalhado (DEBUG/INFO) em produção | Ajuste logLevel para WARN ou ERROR | Configurando CloudCore e EdgeCore: flags, arquivos e variáve |
| Alterações não persistem após reboot | Configuração feita apenas via flag de linha de comando | Ajuste o arquivo YAML correspondente | Configurando CloudCore e EdgeCore: flags, arquivos e variáve |
| mosquitto_sub não recebe mensagens | Broker não está rodando ou firewall bloqueando a porta | Verifique status do serviço e regras de firewall | Configurando o Mosquitto: do zero à primeira mensagem |
| Erro de permissão ao iniciar Mosquitto | Usuário sem privilégios necessários | Execute comandos administrativos com sudo | Configurando o Mosquitto: do zero à primeira mensagem |
| Porta 1883 já em uso | Outro serviço está usando a porta padrão | Altere a porta no mosquitto.conf ou pare o serviço conflitante | Configurando o Mosquitto: do zero à primeira mensagem |
| O serviço não inicia, erro de permissão no /dev/ttyACM0 | Usuário sem acesso ao grupo dialout ou permissões do dispositivo inadequadas | Adicione o usuário ao grupo dialout e ajuste as permissões do dispositivo | Configurando um coordenador Zigbee com Linux e zigbee2mqtt |
| Dispositivos não pareiam mesmo com permit_join: true | Firmware do dongle desatualizado ou canal Zigbee congestionado | Atualize o firmware e altere o canal Zigbee | Configurando um coordenador Zigbee com Linux e zigbee2mqtt |
| Dispositivo pareia mas não responde a comandos MQTT | Configuração MQTT incorreta ou firewall bloqueando porta 1883 | Revise as configurações e libere a porta no firewall | Configurando um coordenador Zigbee com Linux e zigbee2mqtt |
| A luz não liga mesmo com movimento detectado | Payload do sensor não contém occupancy true ou iluminância acima do limite | Verifique o payload recebido e ajuste a lógica do nó function. | Criando automações industriais com Zigbee, MQTT e Node-RED |
| A luz não apaga após 5 minutos | O nó delay não está corretamente conectado ao fluxo de desligamento | Reveja a conexão entre os nós e a lógica de verificação de occupancy. | Criando automações industriais com Zigbee, MQTT e Node-RED |
| Mensagens MQTT não chegam ao atuador | Broker MQTT não está acessível ou tópico incorreto | Confirme o endereço do broker e os tópicos usados nos nós MQTT. | Criando automações industriais com Zigbee, MQTT e Node-RED |
| Painéis exibem 'No data' | Datasource Prometheus mal configurado ou endpoint incorreto. | Reverifique a URL do Prometheus e a conectividade entre Grafana e Prometheus. | Dashboards e visualização: Grafana para IoT distribuída |
| Métricas customizadas não aparecem | Exporter ou aplicação não está expondo as métricas ou não foi configurado no Prometheus. | Confirme que o exporter está rodando e que os jobs estão no scrape_config do Prometheus. | Dashboards e visualização: Grafana para IoT distribuída |
| Latência dos gráficos é alta | Intervalo de scraping do Prometheus muito longo ou sobrecarga no cluster. | Ajuste o scrape_interval no Prometheus e monitore o uso de recursos. | Dashboards e visualização: Grafana para IoT distribuída |
| Dashboard não aparece após instalação | Node-RED não foi reiniciado ou instalação falhou | Reinicie o Node-RED e confira logs de erro | Dashboards em Node-RED: do dado ao painel visual |
| Widgets não atualizam com novos dados MQTT | Fluxo não está conectado corretamente ou broker indisponível | Verifique conexões entre mqtt in e widgets, e status do broker | Dashboards em Node-RED: do dado ao painel visual |
| Dashboard acessível sem senha | Configuração de autenticação ausente ou incorreta | Revise o arquivo settings.js e reinicie o Node-RED | Dashboards em Node-RED: do dado ao painel visual |
| Workload não inicia no edge node | Label ou taint incompatível | Ajuste labels/taints e revise o nodeSelector do pod | Definindo requisitos: conectividade, energia, segurança e es |
| Consumo de energia acima do esperado | Workload mal dimensionado | Reduza recursos alocados ou duty-cycle | Definindo requisitos: conectividade, energia, segurança e es |
| Falha na conexão edge-cloud | Certificados TLS inválidos | Regenere e reinstale os certificados | Definindo requisitos: conectividade, energia, segurança e es |
| Dispositivo perde conexão frequentemente | Banda insuficiente ou duty-cycle agressivo | Ajuste frequência de transmissão ou otimize payload | Definindo requisitos: conectividade, energia, segurança e es |
| Pods não iniciam após update | Imagem incorreta ou incompatível | Verifique o nome e tag da imagem; corrija e re-aplique o deployment | Deploys automáticos de workloads na borda |
| Rollout trava em determinado pod | EdgeNode offline ou sem recursos | Checar status do node com 'kubectl get nodes'; reative ou redistribua pods | Deploys automáticos de workloads na borda |
| Rollback não restaura versão anterior | Histórico de rollout insuficiente | Consulte a documentação sobre limites de histórico e ajuste se necessário | Deploys automáticos de workloads na borda |
| Node-RED não recebe mensagens MQTT | Broker ou tópico configurado errado | Verifique IP do broker e nome do tópico no nó MQTT-in | Desenhando a arquitetura: do ESP32 ao Node-RED via Mosquitto |
| ESP32 não conecta ao broker | Firewall bloqueando porta 1883 | Libere a porta 1883 no firewall do servidor | Desenhando a arquitetura: do ESP32 ao Node-RED via Mosquitto |
| Mensagens não aparecem no mosquitto_sub | ESP32 não está publicando ou broker caiu | Reinicie o ESP32 e verifique status do serviço Mosquitto | Desenhando a arquitetura: do ESP32 ao Node-RED via Mosquitto |
| Dispositivo não aparece na rede | Fora de alcance ou bloqueado por obstáculo | Aproxime o dispositivo do coordenador ou adicione roteadores intermediários | Diagnóstico de falhas de pareamento e roteamento Zigbee |
| Pareamento falha com 'Timeout' | Firmware incompatível ou sinal fraco | Atualize o firmware e teste em local sem obstáculos | Diagnóstico de falhas de pareamento e roteamento Zigbee |
| Dispositivo some após reinício | Cache corrompido ou rota instável | Limpe o cache do Zigbee2MQTT e refaça o pareamento | Diagnóstico de falhas de pareamento e roteamento Zigbee |
| Mensagens MQTT não chegam ao OpenHAB | Broker MQTT inacessível ou configuração de tópico incorreta | Teste broker com mosquitto_pub/sub e revise configuração do binding MQTT | Diagnóstico de falhas em integrações MQTT, Z-Wave e REST |
| Dispositivo Z-Wave aparece como OFFLINE | Perda de comunicação ou falha no nó | Reentreviste o nó com zwave-js-cli e verifique alimentação do dispositivo | Diagnóstico de falhas em integrações MQTT, Z-Wave e REST |
| REST API retorna erro 401 | Credenciais inválidas ou token expirado | Atualize credenciais e gere novo token de acesso | Diagnóstico de falhas em integrações MQTT, Z-Wave e REST |
| Regras demoram a executar | Pool de threads insuficiente ou CPU saturada | Ajuste o pool em conf/services/runtime.cfg e monitore o uso de CPU | Dimensionando hardware e rede para OpenHAB em produção |
| Eventos são perdidos ou atrasados | Rede instável ou sobrecarga de eventos | Teste a latência de rede e reduza a frequência de eventos desnecessários | Dimensionando hardware e rede para OpenHAB em produção |
| Logs mostram erros de gravação em disco | Armazenamento insuficiente ou falha de mídia | Libere espaço ou troque o disco por SSD/HDD confiável | Dimensionando hardware e rede para OpenHAB em produção |
| Dispositivos Zigbee não aparecem após restart | Volume de dados não mapeado corretamente | Verifique o parâmetro -v e a existência dos arquivos em /opt/zigbee2mqtt/data | Dockerizando o zigbee2mqtt: isolamento e portabilidade |
| Erro de permissão ao acessar /dev/ttyACM0 | Usuário Docker sem permissão de acesso ao dispositivo | Adicione o usuário ao grupo dialout ou execute com --privileged | Dockerizando o zigbee2mqtt: isolamento e portabilidade |
| Interface web não abre na porta 8080 | Porta não mapeada ou bloqueada por firewall | Confirme o parâmetro -p e libere a porta no firewall | Dockerizando o zigbee2mqtt: isolamento e portabilidade |
| Dispositivos sumiram após alteração de configuração | Mudança incorreta de canal ou topologia não documentada | Restaure backup anterior e revise documentação | Documentação e gestão de configuração: evite surpresas na op |
| Rollback não devolve rede ao estado anterior | Backup desatualizado ou volume não persistente | Implemente rotina de backup automático e revise montagem de volumes | Documentação e gestão de configuração: evite surpresas na op |
| Logs de mudança incompletos | Falta de padronização ou esquecimento de registro | Use templates obrigatórios e checklist de mudanças | Documentação e gestão de configuração: evite surpresas na op |
| Auditoria não identifica autor da mudança | Log sem campo de usuário ou acesso compartilhado | Exija autenticação e registro de usuário em todas as alterações | Documentação e gestão de configuração: evite surpresas na op |
| Alterações sumiram após atualização | Configurações não estavam versionadas ou não foram commitadas | Garanta commit e push frequentes das alterações | Documentação e versionamento de projetos OpenHAB |
| Conflitos de merge ao integrar mudanças | Múltiplas pessoas editaram o mesmo arquivo sem padronização | Implemente padrões rígidos e revise antes de mergear | Documentação e versionamento de projetos OpenHAB |
| Ambiente restaurado não funciona igual ao original | Dependências externas ou parâmetros não documentados | Documente todas as dependências e variáveis de ambiente | Documentação e versionamento de projetos OpenHAB |
| Documentação desatualizada após deploy | Pipeline CI/CD não inclui etapa de build/publicação | Adicione etapa automatizada para build e deploy da documentação | Documentação viva: versionamento, observabilidade e handover |
| Métricas ausentes nos dashboards | Prometheus não está coletando do endpoint correto ou Node Exporter não instalado | Verifique scrape_configs e instalação dos exporters | Documentação viva: versionamento, observabilidade e handover |
| Confusão sobre versão do ambiente | Documentação não está vinculada ao commit do código | Inclua hash do commit ou tag na documentação gerada | Documentação viva: versionamento, observabilidade e handover |
| Equipe não encontra histórico de incidentes | Histórico não documentado ou fora do repositório oficial | Padronize registro de incidentes no mesmo repositório da documentação | Documentação viva: versionamento, observabilidade e handover |
| Serviços não são resolvidos pelo nome | DNS do EdgeMesh desativado ou porta errada | Habilite o DNS e ajuste a porta para 53 | EdgeMesh: roteamento, balanceamento e DNS distribuído |
| Tráfego não é balanceado entre pods | Estratégia de balanceamento não configurada ou serviços não estão como ClusterIP | Defina o balanceamento para roundRobin e ajuste o tipo do serviço | EdgeMesh: roteamento, balanceamento e DNS distribuído |
| EdgeMesh não inicia | Configuração inválida no edgecore.yaml | Revise o arquivo e consulte a documentação | EdgeMesh: roteamento, balanceamento e DNS distribuído |
| Dispositivo final não aparece na rede | Fora de alcance ou roteador inativo | Reposicione o dispositivo ou verifique a alimentação do roteador | Elementos de uma rede Zigbee: coordenador, roteador e dispos |
| Pacotes não chegam ao coordenador | Roteador intermediário falhou | Reinicie ou substitua o roteador afetado | Elementos de uma rede Zigbee: coordenador, roteador e dispos |
| Rede Zigbee instável | Poucos roteadores ou interferência | Adicione mais roteadores e mude o canal Zigbee | Elementos de uma rede Zigbee: coordenador, roteador e dispos |
| Dispositivo não aparece no zigbee2mqtt | Firmware incompatível ou dispositivo não suportado | Reflashe o firmware ou escolha um modelo listado como compatível | Escolha de dispositivos e gateways: critérios técnicos que i |
| Gateway não é detectado na porta serial | Permissões do sistema operacional ou porta errada | Ajuste permissões com 'chmod' ou corrija o caminho da porta serial | Escolha de dispositivos e gateways: critérios técnicos que i |
| Dispositivos perdem conexão frequentemente | Roteadores insuficientes ou mal posicionados | Adicione mais roteadores alimentados por energia contínua | Escolha de dispositivos e gateways: critérios técnicos que i |
| Dados não aparecem no broker | Problema de conexão Wi-Fi ou configuração errada do broker | Revise SSID, senha e IP do broker no código | Escolhendo sensores, microcontroladores e fontes de dados |
| Leitura do sensor retorna valores nulos ou extremos | Fiação incorreta ou sensor incompatível | Cheque ligações e documentação do sensor | Escolhendo sensores, microcontroladores e fontes de dados |
| Microcontrolador reinicia frequentemente | Fonte de alimentação insuficiente | Use fonte com corrente adequada e estável | Escolhendo sensores, microcontroladores e fontes de dados |
| ESP32 não conecta ao Wi-Fi | SSID ou senha incorretos | Verifique credenciais e proximidade do roteador | ESP32 com MQTT: firmware mínimo para publicar dados reais |
| Não publica no broker | IP do broker errado ou broker offline | Confirme IP e se o Mosquitto está rodando | ESP32 com MQTT: firmware mínimo para publicar dados reais |
| Mensagens não aparecem no tópico | Tópico digitado errado ou payload inválido | Revise o nome do tópico e o formato dos dados | ESP32 com MQTT: firmware mínimo para publicar dados reais |
| ESP32 reinicia sozinho | Falta de tratamento de reconexão ou watchdog | Implemente reconexão robusta e monitore consumo de memória | ESP32 com MQTT: firmware mínimo para publicar dados reais |
| Dispositivos de um prédio não aparecem no painel central | MQTT não configurado corretamente ou firewall bloqueando portas | Revise configuração MQTT e regras de firewall | Estratégias de expansão: particionamento, load balancing e m |
| Painel OpenHAB lento ou travando | Sobrecarga em uma instância ou falta de balanceamento | Verifique uso de CPU/memória e ajuste o balanceador | Estratégias de expansão: particionamento, load balancing e m |
| Configurações divergentes entre instâncias | Sincronização de arquivos falhou | Automatize o rsync ou revise permissões de acesso | Estratégias de expansão: particionamento, load balancing e m |
| Dispositivo não aparece na rede | Pareamento não concluído ou firmware incompatível | Reinicie o dispositivo, atualize o firmware e repita o pareamento | Estudo de caso: automação de iluminação industrial com Zigbe |
| Comandos com atraso ou falha | Roteador fora de alcance ou canal Zigbee com interferência | Reposicione roteadores, troque para canal Zigbee menos congestionado | Estudo de caso: automação de iluminação industrial com Zigbe |
| Queda de dispositivos após falta de energia | Endpoints sem backup de configuração | Habilite backup automático no Zigbee2MQTT e atualize o firmware dos endpoints | Estudo de caso: automação de iluminação industrial com Zigbe |
| Sensores offline ou não pareiam | Distância excessiva ou canal Zigbee congestionado | Reaproxime os sensores ou altere o canal Zigbee | Estudo de caso: monitoramento ambiental em rede Zigbee multi |
| Dados não chegam ao broker MQTT | Configuração incorreta de rede ou firewall bloqueando porta 1883 | Revise configuração de rede e libere porta no firewall | Estudo de caso: monitoramento ambiental em rede Zigbee multi |
| Latência alta na atualização dos dados | Gateway sobrecarregado ou buffer MQTT pequeno | Aumente recursos do gateway e ajuste buffer no broker | Estudo de caso: monitoramento ambiental em rede Zigbee multi |
| Dispositivos não aparecem no tópico MQTT esperado | base_topic incorreto ou conflito de configuração | Revise o configuration.yaml de cada gateway e reinicie a instância | Expandindo a rede: múltiplos gateways e segmentação |
| Interferência entre redes Zigbee | Canais Zigbee sobrepostos | Ajuste os canais de cada gateway para valores distintos e distantes | Expandindo a rede: múltiplos gateways e segmentação |
| Mensagens MQTT atrasadas ou perdidas | Broker MQTT sobrecarregado | Dimensione o broker ou distribua a carga entre múltiplos brokers | Expandindo a rede: múltiplos gateways e segmentação |
| Item não recebe valor do sensor | Erro no tópico MQTT ou no mapeamento do canal | Revise o tópico no sensor e no arquivo de Thing; use um cliente MQTT para testar a publicação. | Fluxo de dados e integração: do sensor ao dashboard |
| Dados não aparecem no Grafana | Datasource mal configurado ou persistência ausente | Cheque logs do OpenHAB e do Grafana; valide o arquivo de persistência e o datasource. | Fluxo de dados e integração: do sensor ao dashboard |
| Regra não dispara | Erro de sintaxe ou nome incorreto do Item | Verifique logs do OpenHAB e revise o nome dos Items e a lógica da regra. | Fluxo de dados e integração: do sensor ao dashboard |
| Frames não chegam ao destino | Falha de rota ou nó fora do alcance | Verifique a topologia, reposicione roteadores e confira tabelas de vizinhança | Fluxos de dados Zigbee: como frames circulam na malha |
| Latência alta e instável | Excesso de hops ou interferência | Reduza a quantidade de saltos e minimize fontes de ruído | Fluxos de dados Zigbee: como frames circulam na malha |
| Perda de pacotes frequente | Links de baixa qualidade | Aumente a potência de transmissão ou aproxime os nós | Fluxos de dados Zigbee: como frames circulam na malha |
| Métricas de um ambiente não aparecem no Grafana | Firewall bloqueando porta ou erro na configuração do Prometheus | Libere a porta 8080 e revise o arquivo scrape_configs | Gerenciamento centralizado de múltiplos ambientes OpenHAB |
| Configuração não replica para todos os ambientes | Falha no rsync ou permissão insuficiente | Verifique logs do rsync e permissões SSH | Gerenciamento centralizado de múltiplos ambientes OpenHAB |
| Usuário não consegue autenticar | Erro na configuração do OAuth2/LDAP | Consulte a documentação e revise parâmetros de autenticação | Gerenciamento centralizado de múltiplos ambientes OpenHAB |
| EdgeCore não reconecta após queda de rede | Configuração incorreta de reconexão ou corrupção do banco local | Revisar logs do EdgeCore e restaurar configuração padrão | Gerenciamento remoto de frota de dispositivos em ambiente ho |
| Pods param de rodar durante desconexão | EdgeCore parou ou falha de hardware | Verificar status do serviço e reiniciar dispositivo se necessário | Gerenciamento remoto de frota de dispositivos em ambiente ho |
| Métricas não sincronizam após reconexão | Prometheus não configurado para remote_write | Ajustar configuração do Prometheus conforme documentação | Gerenciamento remoto de frota de dispositivos em ambiente ho |
| Dispositivos não aparecem no EdgeNode correto | nodeSelector ou labels inconsistentes | Revise labels dos EdgeNodes e nodeSelector dos manifests | Gerenciando milhares de dispositivos: sharding, particioname |
| Workloads ultrapassam limites de recursos | ResourceQuota não aplicada ou mal configurada | Aplique o manifest de quota e valide com kubectl describe | Gerenciando milhares de dispositivos: sharding, particioname |
| Failover lento ou incompleto | Falta de automação ou scripts desatualizados | Atualize scripts e teste failover periodicamente | Gerenciando milhares de dispositivos: sharding, particioname |
| Rollback não restaura configuração esperada | Commit incorreto selecionado ou arquivos não versionados | Use 'git log' para identificar o commit correto e garanta que todos os arquivos estejam sob versionamento | Gestão de mudanças e controle de acesso |
| Usuário não autorizado consegue alterar configurações | Permissões mal configuradas no arquivo de usuários | Revise o arquivo org.openhab.core.auth.User.json e ajuste os papéis | Gestão de mudanças e controle de acesso |
| Logs não aparecem no sistema externo | Integração de logs mal configurada | Consulte a documentação do Grafana Loki para corrigir a configuração | Gestão de mudanças e controle de acesso |
| HTTPS não sobe ou retorna erro de certificado | Keystore ausente, senha incorreta ou alias errado | Revise o caminho, senha e alias no runtime.cfg; gere/import novamente o keystore | Hardening do OpenHAB: autenticação, criptografia e isolament |
| Usuários não conseguem logar | Senha incorreta ou arquivo users.json mal formatado | Redefina a senha via UI ou corrija o JSON | Hardening do OpenHAB: autenticação, criptografia e isolament |
| OpenHAB roda como root após atualização | Override systemd ausente ou sobrescrito | Refaça o 'systemctl edit openhab' e reinicie o serviço | Hardening do OpenHAB: autenticação, criptografia e isolament |
| Permissões negadas em arquivos de configuração | Diretórios não pertencem ao usuário openhab | Ajuste propriedade com 'chown -R openhab:openhab /etc/openhab /var/lib/openhab' | Hardening do OpenHAB: autenticação, criptografia e isolament |
| EdgeNode não aparece como Ready | Token inválido ou configuração de rede incorreta | Gere novo token no cloudcore e revise edgecore.yaml | Horizontal scaling: adicionando nós e balanceando cargas |
| Workloads não são agendados no novo EdgeNode | Taints ou labels impedindo agendamento | Ajuste tolerations e labels nos deployments | Horizontal scaling: adicionando nós e balanceando cargas |
| Latência alta entre EdgeNodes | EdgeMesh não ativado ou rede subdimensionada | Habilite EdgeMesh e revise configuração de rede física | Horizontal scaling: adicionando nós e balanceando cargas |
| A interface web não abre na porta 8080 | Serviço não está rodando ou firewall bloqueando a porta | Verifique status do serviço com 'systemctl status openhab' e libere a porta no firewall | Instalação do OpenHAB: do zero ao funcionamento básico |
| Log mostra erro de Java | Versão do Java incompatível ou não instalada | Garanta que o openjdk-17-jre-headless está instalado e configurado | Instalação do OpenHAB: do zero ao funcionamento básico |
| Permissões negadas ao acessar dispositivos seriais | Usuário openhab sem permissão nos grupos 'dialout' ou 'tty' | Adicione o usuário openhab aos grupos necessários com 'sudo usermod -aG dialout,tty openhab' | Instalação do OpenHAB: do zero ao funcionamento básico |
| OpenHAB não recebe mensagens MQTT | Broker não configurado ou credenciais erradas | Revise usuário/senha e o endereço do broker no binding MQTT | Instalando e configurando MQTT, Z-Wave e REST API |
| Dispositivos Z-Wave não aparecem | Porta serial errada ou permissão insuficiente | Cheque o device correto (ex: /dev/ttyACM0) e adicione o usuário openhab ao grupo dialout | Instalando e configurando MQTT, Z-Wave e REST API |
| REST API retorna erro 401 | Autenticação não configurada ou token inválido | Consulte a documentação sobre autenticação e gere novo token | Instalando e configurando MQTT, Z-Wave e REST API |
| EdgeCore não conecta ao CloudCore | Portas de firewall fechadas ou token inválido | Verifique as portas 10000, 10001, 10003, 10004 e gere novo token | Instalando KubeEdge: do kubeadm ao keadm |
| CloudCore não inicia | Cluster Kubernetes ausente ou versão incompatível | Confirme se o Kubernetes está rodando e se a versão é suportada | Instalando KubeEdge: do kubeadm ao keadm |
| Edge node não aparece no 'kubectl get nodes' | Problema de rede ou configuração incorreta do EdgeCore | Cheque logs do EdgeCore em /var/log/kubeedge/edgecore.log | Instalando KubeEdge: do kubeadm ao keadm |
| zigbee2mqtt não conecta ao broker | Endereço, porta ou credenciais incorretos | Revise server, user e password no configuration.yaml | Integração com brokers MQTT: requisitos, segurança e trouble |
| Erro de certificado TLS | CA ou certificado do cliente inválido ou ausente | Verifique caminhos dos arquivos e validade dos certificados | Integração com brokers MQTT: requisitos, segurança e trouble |
| Mensagens não aparecem no subscriber | Permissões insuficientes do usuário MQTT | Ajuste ACLs no broker para liberar tópicos necessários | Integração com brokers MQTT: requisitos, segurança e trouble |
| Banco de dados não inicia no pod da borda | Permissões de volume ou falta de diretório local | Verifique se o diretório /var/lib/mongodb-edge existe e tem permissão adequada | Integrando bancos de dados e sistemas legados à borda |
| Gateway Modbus não responde | Porta serial não montada ou permissões insuficientes | Confirme o caminho do device e rode o pod com securityContext privilegiado | Integrando bancos de dados e sistemas legados à borda |
| Sincronização de dados falha após reconexão | CDC não configurado corretamente ou fila de eventos perdida | Revise a configuração do CDC e garanta logs locais persistentes | Integrando bancos de dados e sistemas legados à borda |
| Item no OpenHAB não atualiza com valor externo | Erro de configuração do HTTP Binding ou endpoint inacessível | Revise a URL, autenticação e parâmetros do Thing HTTP | Integrando OpenHAB com sistemas legados via REST API |
| Erro 401 ao acessar API REST | Credenciais incorretas ou usuário sem permissão | Verifique usuário, senha e perfil de permissões | Integrando OpenHAB com sistemas legados via REST API |
| Comando enviado via API REST não executa ação | Item não vinculado corretamente ou regra ausente | Confirme vinculação do item e existência da regra | Integrando OpenHAB com sistemas legados via REST API |
| HTTP request retorna erro 401 | Falta de autenticação ou token inválido | Adicione cabeçalhos de autenticação no node HTTP request | Integrando REST, HTTP e bancos de dados ao Node-RED |
| Dados não aparecem no banco | Query SQL ou payload mal formatado | Revise a função de transformação e o comando SQL | Integrando REST, HTTP e bancos de dados ao Node-RED |
| Node-RED trava ao gravar em banco | Concorrência alta ou banco bloqueado | Implemente filas ou use um banco mais robusto | Integrando REST, HTTP e bancos de dados ao Node-RED |
| Usuário consegue acessar recursos de outro namespace | RoleBinding ou ClusterRoleBinding excessivamente permissivo | Revise e restrinja os RoleBindings ao namespace correto | Isolamento, RBAC e políticas de acesso na borda |
| Pods se comunicam livremente apesar das NetworkPolicies | CNI da borda não suporta NetworkPolicy | Consulte a documentação do CNI e troque por um compatível, como Calico | Isolamento, RBAC e políticas de acesso na borda |
| Logs de auditoria não aparecem | Audit logging não configurado ou caminho de log incorreto | Verifique flags do kube-apiserver e permissões do diretório de log | Isolamento, RBAC e políticas de acesso na borda |
| Pod edge não comunica com outros nodes | EdgeMesh não configurado para interface 5G ou firewall bloqueando | Revise ConfigMap do EdgeMesh e regras de firewall | KubeEdge em ambientes multicloud, 5G e AI na borda |
| Workload AI não inicia | Recursos insuficientes ou imagem incompatível | Ajuste requests/limits e verifique compatibilidade da imagem | KubeEdge em ambientes multicloud, 5G e AI na borda |
| Prometheus não coleta métricas dos nodes edge | Porta 9100 não exposta ou scrape_configs incorreto | Confirme exposição da porta e revise scrape_configs | KubeEdge em ambientes multicloud, 5G e AI na borda |
| EdgeCore não recebe workloads | Problema de conexão com CloudCore ou configuração incorreta do EdgeHub | Revise as configurações de endereço e porta do EdgeHub e certifique-se de que o TLS está habilitado. | KubeEdge: o que é, para que serve e onde se encaixa na arqui |
| Mensagens MQTT não chegam ao broker local | Configuração errada do EventBus ou conflito de portas | Verifique o arquivo de configuração do EventBus e ajuste as portas. | KubeEdge: o que é, para que serve e onde se encaixa na arqui |
| Sincronização de estado falha após reconexão | Cache local corrompido ou versão incompatível | Limpe o cache do EdgeCore e consulte a documentação para compatibilidade de versões. | KubeEdge: o que é, para que serve e onde se encaixa na arqui |
| Dispositivo não aparece no OpenHAB | Binding não instalado ou incompatibilidade de protocolo | Verifique suporte na documentação oficial do OpenHAB e instale o binding correto | Levantamento de requisitos: do escopo ao inventário de dispo |
| Dados de sensores não são atualizados | Configuração incorreta de tópicos MQTT ou polling Z-Wave | Revise tópicos MQTT e parâmetros de polling no arquivo de configuração | Levantamento de requisitos: do escopo ao inventário de dispo |
| SLIs não aparecem no dashboard | Integração com InfluxDB ou Grafana mal configurada | Cheque logs do OpenHAB e do InfluxDB; revise credenciais e endpoints | Levantamento de requisitos: do escopo ao inventário de dispo |
| Mensagens MQTT não chegam ao destino. | Fila do broker cheia ou limite de sessões atingido. | Aumente max_queued_messages e revise ulimit. | Limites práticos de MQTT, Z-Wave e REST API |
| Dispositivos Z-Wave não respondem. | Excesso de hops ou nós fora de alcance. | Reposicione dispositivos e reduza hops. | Limites práticos de MQTT, Z-Wave e REST API |
| REST API retorna erro 503. | Sobrecarga de conexões simultâneas. | Limite o número de requisições e aumente recursos do servidor. | Limites práticos de MQTT, Z-Wave e REST API |
| Dispositivos desconectam aleatoriamente | Coordenador ou roteador sobrecarregado | Reduza o número de filhos por nó ou adicione mais roteadores | Limites práticos: quantos dispositivos cabem na sua rede Zig |
| Comandos demoram a ser executados | Tráfego excessivo ou muitos hops | Distribua melhor os roteadores e reduza intervalos de envio | Limites práticos: quantos dispositivos cabem na sua rede Zig |
| Perda de mensagens em horários de pico | Canal Zigbee saturado | Ajuste o tráfego dos dispositivos e evite canais sobrepostos | Limites práticos: quantos dispositivos cabem na sua rede Zig |
| Logs não aparecem no syslog central | Configuração incorreta do appender syslog ou firewall bloqueando porta 514 | Revise o arquivo de configuração e libere a porta no firewall | Logs, eventos e rastreamento de falhas |
| Excesso de logs dificulta análise | Nível de log muito detalhado (DEBUG/TRACE) em produção | Reduza para WARN ou INFO apenas nos bundles necessários | Logs, eventos e rastreamento de falhas |
| Alertas de anomalia não são enviados | Script de monitoramento não está rodando ou serviço de e-mail não configurado | Verifique permissões, logs do script e configuração do mail | Logs, eventos e rastreamento de falhas |
| Mensagens MQTT não chegam ao edge | Desconexão do broker ou tópico incorreto | Verifique logs do edgecore e broker MQTT, confira configuração de tópicos | Logs, eventos e tracing: onde encontrar a verdade |
| Node edge aparece como NotReady | Perda de comunicação com cloudcore | Cheque logs do edgecore e eventos do node | Logs, eventos e tracing: onde encontrar a verdade |
| Logs do edgecore muito grandes | Nível de log muito detalhado (DEBUG) | Reduza para INFO após diagnóstico | Logs, eventos e tracing: onde encontrar a verdade |
| Eventos não aparecem no kubectl | Integração falha entre edgecore e cloudcore | Reinicie edgecore e valide conectividade | Logs, eventos e tracing: onde encontrar a verdade |
| Métricas não expostas | Falha na configuração do metrics endpoint | Ajuste configuração do edgecore e reinicie | Logs, eventos e tracing: onde encontrar a verdade |
| Log não está sendo gravado | Permissões incorretas no diretório de log ou erro no caminho configurado | Ajuste permissões e confira o caminho em log_dest | Logs, métricas e status do Mosquitto: o que olhar de verdade |
| mosquitto_ctrl retorna erro de autenticação | Usuário ou senha incorretos, ou broker sem suporte ao comando | Revise credenciais e consulte a documentação sobre permissões | Logs, métricas e status do Mosquitto: o que olhar de verdade |
| Logs cheios de mensagens debug | log_type debug ativado por engano | Remova log_type debug do mosquitto.conf e reinicie | Logs, métricas e status do Mosquitto: o que olhar de verdade |
| Dispositivo não responde após atualização OTA | Firmware incompatível ou falha durante o processo | Consulte a documentação do fabricante e tente reverter para a versão anterior | Manutenção preventiva: atualizações, backup e testes periódi |
| Backup não aparece no diretório esperado | Permissões insuficientes ou erro no caminho | Ajuste permissões e revise o comando de backup | Manutenção preventiva: atualizações, backup e testes periódi |
| Teste de comunicação falha para múltiplos dispositivos | Coordenador Zigbee sobrecarregado ou interferência RF | Reduza o número de comandos simultâneos e revise o ambiente RF | Manutenção preventiva: atualizações, backup e testes periódi |
| Edgecore não inicia após restauração de backup | Banco SQLite corrompido por backup feito com edgecore online | Refaça o backup com edgecore parado; restaure backup íntegro | Manutenção zero-downtime: upgrades, backups e rollback |
| Workloads sumiram após rollback | Rollback parcial ou inconsistência de versões entre cloudcore e edgecore | Restaure todos os componentes para o mesmo ponto no tempo | Manutenção zero-downtime: upgrades, backups e rollback |
| Edge node não reconecta após upgrade | Versão incompatível entre cloudcore e edgecore | Consulte a matriz de compatibilidade e ajuste as versões | Manutenção zero-downtime: upgrades, backups e rollback |
| Mensagens atrasadas ou perdidas | Broker sobrecarregado ou fila de mensagens cheia | Reduza o número de mensagens, aumente recursos do servidor ou ajuste max_queued_messages | Mensagens por segundo, payloads e latência: o que realmente |
| Latência alta mesmo com poucos dispositivos | Rede congestionada ou QoS elevado | Teste com QoS 0 ou 1, verifique a qualidade da rede | Mensagens por segundo, payloads e latência: o que realmente |
| Mosquitto não inicia após ajuste | Erro de sintaxe no arquivo de configuração | Verifique logs em /var/log/mosquitto/mosquitto.log e corrija o arquivo | Mensagens por segundo, payloads e latência: o que realmente |
| Item não atualiza após envio MQTT | Tópico ou channel configurado incorretamente | Verifique se o stateTopic no thing e o channel no item estão corretos | Modelagem de itens, things e channels no OpenHAB |
| Thing aparece como OFFLINE | Problema de comunicação com o broker ou dispositivo | Cheque conexão do broker e credenciais | Modelagem de itens, things e channels no OpenHAB |
| Item aparece duplicado na interface | Criação automática e manual do mesmo item | Remova duplicatas e padronize o método de criação | Modelagem de itens, things e channels no OpenHAB |
| Leituras não aparecem no dashboard | Falha de conexão MQTT ou ACL bloqueando o tópico | Revise configuração de ACL e logs do Mosquitto. | Monitoramento ambiental em tempo real: arquitetura de referê |
| Mensagens duplicadas | QoS 1 sem de-duplicação no Node-RED | Implemente lógica de deduplicação no fluxo. | Monitoramento ambiental em tempo real: arquitetura de referê |
| Broker Mosquitto travando | Excesso de conexões ou falta de recursos | Aumente limites de conexão e monitore uso de CPU/memória. | Monitoramento ambiental em tempo real: arquitetura de referê |
| Alertas não são enviados | Node-RED mal configurado ou serviço externo inativo | Teste envio manual e revise logs do Node-RED. | Monitoramento ambiental em tempo real: arquitetura de referê |
| Leituras não aparecem no dashboard | Falha de conexão MQTT ou ACL bloqueando o tópico | Revise configuração de ACL e logs do Mosquitto. | Monitoramento ambiental em tempo real: arquitetura de referê |
| Mensagens duplicadas | QoS 1 sem de-duplicação no Node-RED | Implemente lógica de deduplicação no fluxo. | Monitoramento ambiental em tempo real: arquitetura de referê |
| Broker Mosquitto travando | Excesso de conexões ou falta de recursos | Aumente limites de conexão e monitore uso de CPU/memória. | Monitoramento ambiental em tempo real: arquitetura de referê |
| Alertas não são enviados | Node-RED mal configurado ou serviço externo inativo | Teste envio manual e revise logs do Node-RED. | Monitoramento ambiental em tempo real: arquitetura de referê |
| Métricas não aparecem no Prometheus | Endpoint de métricas não habilitado ou porta incorreta | Habilite metrics no configuration.yaml e reinicie o zigbee2mqtt | Monitorando a saúde da rede Zigbee: status, métricas e alert |
| Alertas não são publicados | Script não está rodando ou broker MQTT inacessível | Verifique logs do script e conectividade com o broker | Monitorando a saúde da rede Zigbee: status, métricas e alert |
| Dispositivos aparecem offline no dashboard | Problemas de alcance ou interferência | Reveja topologia Zigbee e posicione melhor os roteadores | Monitorando a saúde da rede Zigbee: status, métricas e alert |
| Alertas não aparecem no dashboard | Função de comparação de last seen está errada ou variável não está sendo atualizada | Revise o código da função e verifique se o heartbeat está chegando | Monitorando fluxos e dispositivos no Node-RED |
| Status dos dispositivos não muda | Node status não está vinculado ao node correto ou MQTT não está emitindo eventos | Reconfigure o node status e teste o fluxo | Monitorando fluxos e dispositivos no Node-RED |
| Métricas não chegam ao banco externo | Configuração do node de exportação (InfluxDB/MQTT) está incorreta | Verifique credenciais, endereço e conectividade | Monitorando fluxos e dispositivos no Node-RED |
| Mensagens não chegam no broker remoto via bridge | Configuração de tópicos ou endereço incorreta | Revise os parâmetros 'topic' e 'address' no mosquitto.conf | Mosquitto em cluster? O que é possível e o que não é |
| Clientes perdem sessão após falha de broker | Sessão não é replicada entre brokers Mosquitto | Considere brokers com clusterização nativa | Mosquitto em cluster? O que é possível e o que não é |
| Balanceador TCP não distribui conexões | Configuração errada no HAProxy | Verifique se o backend está correto e os brokers estão online | Mosquitto em cluster? O que é possível e o que não é |
| Mosquitto não inicia após edição | Erro de sintaxe no mosquitto.conf | Revise o arquivo e rode 'mosquitto -c /etc/mosquitto/mosquitto.conf -v' para identificar o erro. | Mosquitto.conf: parâmetros que você precisa entender |
| Usuário não consegue conectar | Senha ou ACL incorreta | Verifique o arquivo de senhas e o ACL. | Mosquitto.conf: parâmetros que você precisa entender |
| Mensagens retain somem após reboot | Persistência desabilitada | Habilite 'persistence true' e defina o diretório. | Mosquitto.conf: parâmetros que você precisa entender |
| Logs não aparecem | log_dest mal configurado ou permissões de arquivo | Corrija o caminho e permissões do arquivo de log. | Mosquitto.conf: parâmetros que você precisa entender |
| Cliente não conecta via Websockets | Porta ou protocolo não habilitado no broker | Revise o arquivo de configuração e reinicie o Mosquitto. | MQTT 5.0, Websockets e integração com nuvem aberta |
| Mensagens MQTT 5.0 não chegam ao destino | Broker ou cliente usando versão antiga do protocolo | Confirme que ambos suportam MQTT 5.0. | MQTT 5.0, Websockets e integração com nuvem aberta |
| Falha de autenticação na integração com nuvem | Credenciais ou certificados inválidos | Revise configuração de autenticação e certificados TLS. | MQTT 5.0, Websockets e integração com nuvem aberta |
| Cliente não conecta via Websockets | Porta ou protocolo não habilitado no broker | Revise o arquivo de configuração e reinicie o Mosquitto. | MQTT 5.0, Websockets e integração com nuvem aberta |
| Mensagens MQTT 5.0 não chegam ao destino | Broker ou cliente usando versão antiga do protocolo | Confirme que ambos suportam MQTT 5.0. | MQTT 5.0, Websockets e integração com nuvem aberta |
| Falha de autenticação na integração com nuvem | Credenciais ou certificados inválidos | Revise configuração de autenticação e certificados TLS. | MQTT 5.0, Websockets e integração com nuvem aberta |
| Mensagens não chegam ao destino | Broker MQTT inacessível ou configuração de tópico incorreta | Verifique o endereço do broker no edgecore.yaml e os nomes dos tópicos | MQTT e comunicação bidirecional: eventos, comandos e telemet |
| EdgeCore não conecta ao broker | Firewall bloqueando porta 1883 ou credenciais inválidas | Libere a porta no firewall e revise usuário/senha do broker | MQTT e comunicação bidirecional: eventos, comandos e telemet |
| Mensagens duplicadas | QoS configurado como 1 ou 2 | Ajuste o QoS conforme a criticidade da mensagem | MQTT e comunicação bidirecional: eventos, comandos e telemet |
| Novo cliente não recebe valor esperado ao assinar tópico | Retenção não foi ativada na publicação | Publique novamente com o flag -r | MQTT e Mosquitto: padrões que evitam dor de cabeça |
| Status de dispositivo não muda para offline após queda | LWT não configurado corretamente | Revise parâmetros --will-topic e --will-message | MQTT e Mosquitto: padrões que evitam dor de cabeça |
| Atualização do Mosquitto quebrou configuração antiga | Mudança de sintaxe ou flags na nova versão | Consulte a documentação e ajuste o arquivo de configuração | MQTT e Mosquitto: padrões que evitam dor de cabeça |
| Novo cliente não recebe valor esperado ao assinar tópico | Retenção não foi ativada na publicação | Publique novamente com o flag -r | MQTT e Mosquitto: padrões que evitam dor de cabeça |
| Status de dispositivo não muda para offline após queda | LWT não configurado corretamente | Revise parâmetros --will-topic e --will-message | MQTT e Mosquitto: padrões que evitam dor de cabeça |
| Atualização do Mosquitto quebrou configuração antiga | Mudança de sintaxe ou flags na nova versão | Consulte a documentação e ajuste o arquivo de configuração | MQTT e Mosquitto: padrões que evitam dor de cabeça |
| Subscriber não recebe mensagens | Broker não iniciado ou firewall bloqueando porta 1883 | Verifique se o serviço mosquitto está rodando e libere a porta no firewall | MQTT sem mágica: publish, subscribe, tópicos e QoS na prátic |
| Mensagem chega duplicada | QoS 1 ou 2 em ambiente instável pode gerar duplicidade | Implemente deduplicação na aplicação ou use QoS 2 com cautela | MQTT sem mágica: publish, subscribe, tópicos e QoS na prátic |
| Subscriber recebe mensagens antigas ao conectar | Flag retained foi usada na publicação | Publique uma mensagem vazia com retained para limpar o tópico | MQTT sem mágica: publish, subscribe, tópicos e QoS na prátic |
| Um time vê fluxos de outro | Instâncias não estão isoladas corretamente ou projetos estão misturados | Verifique portas e pastas de dados de cada instância, separe projetos no settings.js | Node-RED em escala: múltiplos fluxos, múltiplos times |
| Erro ao commitar mudanças | Repositório Git não inicializado ou permissões erradas | Inicialize o repositório e ajuste permissões de arquivos | Node-RED em escala: múltiplos fluxos, múltiplos times |
| Interface Node-RED sem HTTPS | Certificados não configurados ou caminho incorreto | Revise paths de key.pem e cert.pem em settings.js | Node-RED em escala: múltiplos fluxos, múltiplos times |
| Um time vê fluxos de outro | Instâncias não estão isoladas corretamente ou projetos estão misturados | Verifique portas e pastas de dados de cada instância, separe projetos no settings.js | Node-RED em escala: múltiplos fluxos, múltiplos times |
| Erro ao commitar mudanças | Repositório Git não inicializado ou permissões erradas | Inicialize o repositório e ajuste permissões de arquivos | Node-RED em escala: múltiplos fluxos, múltiplos times |
| Interface Node-RED sem HTTPS | Certificados não configurados ou caminho incorreto | Revise paths de key.pem e cert.pem em settings.js | Node-RED em escala: múltiplos fluxos, múltiplos times |
| Node-RED não conecta ao Mosquitto | Endereço, porta ou autenticação incorretos | Revise a configuração do node MQTT e do broker | Node-RED na prática: configurando fluxos e persistência |
| Variáveis de contexto somem após reinício | Persistência não ativada ou erro no settings.js | Verifique se contextStorage está corretamente configurado | Node-RED na prática: configurando fluxos e persistência |
| Fluxos antigos não podem ser restaurados | Fluxos não versionados ou backups ausentes | Implemente versionamento com Git imediatamente | Node-RED na prática: configurando fluxos e persistência |
| Fluxo não carrega após restauração | Arquivo de fluxo corrompido ou incompatível | Restaure backup anterior ou valide o JSON | Node-RED: fluxos limpos, seguros e fáceis de manter |
| Credenciais aparecem em texto claro | Campos de credencial não utilizados ou variáveis de ambiente ausentes | Reconfigure os nós para usar campos de credencial ou defina as variáveis | Node-RED: fluxos limpos, seguros e fáceis de manter |
| Dificuldade para entender o fluxo após semanas | Falta de nomes e comentários | Renomeie nós e adicione comentários explicativos | Node-RED: fluxos limpos, seguros e fáceis de manter |
| Fluxo não carrega após restauração | Arquivo de fluxo corrompido ou incompatível | Restaure backup anterior ou valide o JSON | Node-RED: fluxos limpos, seguros e fáceis de manter |
| Credenciais aparecem em texto claro | Campos de credencial não utilizados ou variáveis de ambiente ausentes | Reconfigure os nós para usar campos de credencial ou defina as variáveis | Node-RED: fluxos limpos, seguros e fáceis de manter |
| Dificuldade para entender o fluxo após semanas | Falta de nomes e comentários | Renomeie nós e adicione comentários explicativos | Node-RED: fluxos limpos, seguros e fáceis de manter |
| Edge node não aparece como conectado | Problema de rede ou flags incorretas no EdgeCore | Verifique conectividade e flags de inicialização | Novidades do KubeEdge: recursos experimentais e roadmap |
| Recursos experimentais não funcionam | Versão do KubeEdge desatualizada ou flag ausente | Atualize para a versão mais recente e revise as flags | Novidades do KubeEdge: recursos experimentais e roadmap |
| Métricas não aparecem no Prometheus | Endpoint de métricas não habilitado ou firewall bloqueando porta | Habilite o endpoint e libere a porta 10350 | Novidades do KubeEdge: recursos experimentais e roadmap |
| Dispositivo Zigbee não aparece no MQTT | Configuração incorreta do broker ou network_key incompatível | Revise network_key e parâmetros MQTT no gateway | O futuro do Zigbee: interoperabilidade, segurança e novos pe |
| Dispositivo Zigbee não responde a comandos Matter | Limitação de interoperabilidade ou firmware desatualizado | Consulte a documentação sobre suporte Matter e atualize firmware | O futuro do Zigbee: interoperabilidade, segurança e novos pe |
| Logs mostram tentativas de join não autorizadas | permit_join ativado ou network_key padrão | Desative permit_join e use network_key personalizada | O futuro do Zigbee: interoperabilidade, segurança e novos pe |
| Dados do sensor não aparecem no dashboard | Microcontrolador não está publicando corretamente ou tópico está errado | Verifique a configuração do tópico e se o microcontrolador está conectado ao broker | O que realmente é IoT: sensores, atuadores e a lógica do dad |
| Mensagens MQTT chegam com atraso | Rede congestionada ou broker sobrecarregado | Monitore o uso de banda e recursos do broker, otimize o fluxo de dados | O que realmente é IoT: sensores, atuadores e a lógica do dad |
| Atuador não responde ao comando | Problema na lógica do microcontrolador ou falha elétrica | Teste o atuador localmente e revise o código do microcontrolador | O que realmente é IoT: sensores, atuadores e a lógica do dad |
| Binding não aparece após instalação via CLI | Comando incorreto ou cache do OpenHAB desatualizado | Reinicie o serviço com 'sudo systemctl restart openhab' e verifique logs em '/var/log/openhab/openhab.log' | OpenHAB 4.x e beyond: novidades, tendências e roadmap |
| Itens ou regras não atualizam na interface | Erro de sintaxe nos arquivos de configuração | Valide a sintaxe e monitore o log para mensagens de erro | OpenHAB 4.x e beyond: novidades, tendências e roadmap |
| Integração MQTT não conecta ao broker | Configuração errada de host, porta ou credenciais | Revise o arquivo de configuração e teste conectividade com 'mosquitto_sub' ou ferramenta similar | OpenHAB 4.x e beyond: novidades, tendências e roadmap |
| Sensores não reportam dados | Bridge MQTT ou conversor Modbus-TCP não está rodando ou mal configurado | Verifique logs do container e a configuração do endpoint do sensor | Orquestração de sensores industriais em rede de fibra dedica |
| EdgeCore não conecta ao CloudCore | Problemas de certificado TLS ou firewall bloqueando porta | Revise paths dos certificados e regras de firewall | Orquestração de sensores industriais em rede de fibra dedica |
| Atualização de aplicação falha no edge | Recursos insuficientes no gateway ou erro no manifest | Ajuste limites de recursos e valide o manifest com kubectl | Orquestração de sensores industriais em rede de fibra dedica |
| Item não responde após alteração | Nome incorreto ou configuração fora do padrão | Revise o padrão de nomenclatura e valide o arquivo | Padronização, documentação e testes em ambientes OpenHAB |
| Testes automatizados falham | Mudança não documentada ou erro de sintaxe | Cheque o CHANGELOG.md e valide os arquivos com 'openhab-cli --validate' | Padronização, documentação e testes em ambientes OpenHAB |
| Ambiente fora do ar após deploy | Deploy sem checklist ou sem backup | Implemente checklist e sempre faça backup antes | Padronização, documentação e testes em ambientes OpenHAB |
| Comandos demoram ou não chegam ao destino | Interferência de canal ou sinal fraco | Troque canal Zigbee e reposicione dispositivos | Perda de pacotes e latência: causas e soluções práticas |
| Dispositivo some da rede após troca de canal | Dispositivo não migrou corretamente | Reinicie o dispositivo e refaça o pareamento | Perda de pacotes e latência: causas e soluções práticas |
| Oscilação de latência em horários de pico | Saturação da malha ou excesso de tráfego | Distribua melhor os roteadores e reconfigure a malha | Perda de pacotes e latência: causas e soluções práticas |
| Dispositivo Zigbee não responde a comandos básicos | Perfil de aplicação incompatível ou clusters obrigatórios ausentes | Verifique o perfil implementado e compare com a documentação oficial | Perfis de aplicação Zigbee: interoperabilidade e limitações |
| Funções extras do dispositivo não aparecem no gateway | Clusters proprietários ou extensões fora do perfil público | Consulte a documentação do fabricante e avalie a necessidade de integração customizada | Perfis de aplicação Zigbee: interoperabilidade e limitações |
| Dispositivo pareia mas não executa ações | Versão do perfil não suportada pelo gateway | Atualize o firmware do gateway ou do dispositivo, se possível | Perfis de aplicação Zigbee: interoperabilidade e limitações |
| Dispositivos Zigbee desconectam após troca de canal. | Alguns dispositivos não suportam canais altos (25, 26). | Teste canais intermediários (15, 20) e consulte a documentação dos dispositivos. | Planejamento de canais e mitigação de interferências |
| Alta latência ou perda de pacotes Zigbee. | Canal Zigbee sobreposto a Wi-Fi intenso. | Remapeie o espectro e escolha outro canal Zigbee. | Planejamento de canais e mitigação de interferências |
| Rede Zigbee instável após instalar novo ponto Wi-Fi. | Novo Wi-Fi interfere no canal Zigbee. | Repita o mapeamento e ajuste o canal Zigbee conforme necessário. | Planejamento de canais e mitigação de interferências |
| Dados não aparecem no Node-RED | Tópico MQTT incorreto ou broker inacessível | Revise tópicos e conexão do nó mqtt in | Planejando fluxos: do dado bruto ao insight |
| Dados duplicados ou ruidosos | Falta de filtragem ou agregação | Adicione nós rbe ou smooth | Planejando fluxos: do dado bruto ao insight |
| Dashboard mostra valores antigos | Persistência mal configurada ou fluxo travado | Cheque nós de arquivo/banco e reinicie fluxo | Planejando fluxos: do dado bruto ao insight |
| Arquivo de histórico cresce demais | Sem rotação de logs | Implemente rotação ou limite de tamanho | Planejando fluxos: do dado bruto ao insight |
| Nó marcado como NotReady frequentemente | Latência ou desconexão da borda | Kubernetes não tolera desconexão prolongada; use KubeEdge para cenários de borda | Por que Kubernetes não resolve IoT: limites, latência e cone |
| Pods sumindo ou sendo realocados sem motivo aparente | Perda de heartbeat do kubelet | Verifique conectividade; considere protocolos tolerantes a falhas | Por que Kubernetes não resolve IoT: limites, latência e cone |
| Dispositivo IoT não aparece como node no cluster | Requisitos de hardware ou sistema operacional não atendidos | Consulte a documentação do kubelet e compare com o hardware do dispositivo | Por que Kubernetes não resolve IoT: limites, latência e cone |
| Add-on não aparece após instalação | Versão incompatível ou dependências ausentes | Verifique logs em /var/log/openhab/openhab.log e consulte a documentação do add-on | Por que OpenHAB? Filosofia, comunidade e casos de uso corpor |
| Integração não reconhece dispositivo | Configuração incorreta ou suporte ausente | Revise parâmetros e consulte a lista de dispositivos suportados | Por que OpenHAB? Filosofia, comunidade e casos de uso corpor |
| Problemas de performance com muitos dispositivos | Recursos insuficientes ou tuning inadequado | Ajuste heap JVM e revise regras automáticas | Por que OpenHAB? Filosofia, comunidade e casos de uso corpor |
| Node edge NotReady | Desconexão de rede ou falha no EdgeCore | Verifique conectividade, reinicie edgecore.service | Problemas comuns: desconexão, buffer overflow e drift de est |
| Mensagens MQTT perdidas | Buffer overflow ou broker travado | Aumente messageQSize, monitore recursos do broker | Problemas comuns: desconexão, buffer overflow e drift de est |
| Pod aparece na nuvem, mas não roda no edge | Drift de estado por desconexão prolongada | Forçar reconciliação, revisar nodeStatusUpdateFrequency | Problemas comuns: desconexão, buffer overflow e drift de est |
| Mensagens não chegam ao destino | Node intermediário travado ou erro de lógica | Use debug para identificar onde a mensagem some e revise a lógica | Problemas em fluxos Node-RED: onde olhar primeiro |
| CPU alta e interface travando | Loop infinito ou função bloqueante | Insira delay ou revise funções para evitar loops | Problemas em fluxos Node-RED: onde olhar primeiro |
| Erros aparecem só no console | Exceções não tratadas em funções | Adicione node catch e trate erros em funções | Problemas em fluxos Node-RED: onde olhar primeiro |
| O Prometheus não coleta métricas do edgecore | Endpoint de métricas inacessível ou endereço errado | Verifique se o edgecore está rodando e se o target está correto em prometheus.yml | Prometheus na borda: métricas, scraping e alertas |
| Alertas não aparecem na interface | Arquivo de alertas não referenciado ou sintaxe incorreta | Confirme a inclusão do arquivo de alertas na configuração e valide a sintaxe YAML | Prometheus na borda: métricas, scraping e alertas |
| Métricas não chegam ao Prometheus central | Problema de conectividade ou configuração de remote_write | Teste a conexão entre borda e central e revise a configuração remote_write | Prometheus na borda: métricas, scraping e alertas |
| Sensores MQTT não aparecem no OpenHAB | Configuração errada do broker ou tópicos incorretos | Revise mqtt.cfg e os tópicos usados nos sensores | Protocolos IoT em OpenHAB: MQTT, Z-Wave e REST API na prátic |
| Dispositivos Z-Wave não são reconhecidos | Serial port incorreto ou dongle mal conectado | Confirme o caminho do device e conexões físicas | Protocolos IoT em OpenHAB: MQTT, Z-Wave e REST API na prátic |
| REST API retorna erro 401 | Permissões ou autenticação mal configurada | Consulte a documentação para configurar autenticação | Protocolos IoT em OpenHAB: MQTT, Z-Wave e REST API na prátic |
| Device não conecta ao edgecore | Certificado inválido ou não registrado corretamente | Regenere o certificado e confira se o fingerprint bate com o inventário | Provisionamento automatizado de dispositivos IoT |
| Device aparece duplicado no inventário | Script de provisionamento não valida unicidade do ID | Implemente checagem prévia de existência no inventário antes de registrar | Provisionamento automatizado de dispositivos IoT |
| Falha ao registrar device via API | Endpoint ou payload incorreto | Revise a documentação da API de inventário e ajuste o script | Provisionamento automatizado de dispositivos IoT |
| Eventos duplicados na API REST | Ausência de controle de idempotência | Implemente verificação de IDs únicos no backend | Publicando dados IoT na nuvem: pipelines e APIs REST |
| Dados não chegam ao broker externo | Erro na configuração da bridge MQTT | Revise o arquivo de configuração e verifique conectividade | Publicando dados IoT na nuvem: pipelines e APIs REST |
| API REST inacessível externamente | Ingress mal configurado ou firewall bloqueando | Verifique regras de Ingress e portas abertas | Publicando dados IoT na nuvem: pipelines e APIs REST |
| Perda de mensagens MQTT | QoS inadequado ou falhas de rede | Ajuste o QoS para 1 ou 2 e monitore estabilidade da conexão | Publicando dados IoT na nuvem: pipelines e APIs REST |
| Item não atualiza com mensagem MQTT | Tópico configurado incorretamente ou payload incompatível | Revise os tópicos nos arquivos .things e .items e ajuste transformações se necessário | Publicando e consumindo dados MQTT no OpenHAB |
| Comando do OpenHAB não chega ao dispositivo | commandTopic errado ou broker inativo | Verifique o tópico de comando e se o broker está rodando | Publicando e consumindo dados MQTT no OpenHAB |
| Mensagens duplicadas ou fora de ordem | QoS inadequado ou dispositivos publicando em tópicos errados | Ajuste o QoS e padronize os tópicos | Publicando e consumindo dados MQTT no OpenHAB |
| Erro de autenticação no broker | Usuário/senha inválidos ou não configurados | Configure corretamente as credenciais no bridge MQTT | Publicando e consumindo dados MQTT no OpenHAB |
| Não aparecem mensagens no cliente MQTT | Broker incorreto ou Zigbee2MQTT não está publicando | Verifique o endereço do broker no config do Zigbee2MQTT e se o serviço está rodando | Publicando e consumindo dados Zigbee em sistemas industriais |
| Payload JSON vazio ou incompleto | Dispositivo Zigbee não pareado corretamente | Repareie o dispositivo e monitore o log do Zigbee2MQTT | Publicando e consumindo dados Zigbee em sistemas industriais |
| Node-RED não recebe dados | Configuração errada do nó mqtt in (tópico ou broker) | Ajuste o tópico e as credenciais do broker no Node-RED | Publicando e consumindo dados Zigbee em sistemas industriais |
| Erro de autenticação no MQTT | Usuário/senha do broker incorretos | Corrija as credenciais no Zigbee2MQTT e nos consumidores | Publicando e consumindo dados Zigbee em sistemas industriais |
| Mosquitto recusa novas conexões | Limite de arquivos abertos atingido | Aumente o ulimit e reinicie o serviço | Quantos dispositivos? Dimensionando Mosquitto e ESP32 para o |
| ESP32 desconecta frequentemente | Falta de memória ou uso de TLS excessivo | Reduza uso de TLS ou simplifique o código | Quantos dispositivos? Dimensionando Mosquitto e ESP32 para o |
| Mensagens atrasadas ou perdidas | Broker sobrecarregado ou QoS alto demais | Reduza QoS e otimize configuração do Mosquitto | Quantos dispositivos? Dimensionando Mosquitto e ESP32 para o |
| Mensagens de dispositivos não chegam ao CloudCore | Saturação de rede ou CloudCore sobrecarregado | Reduza o número de dispositivos ou aumente recursos do CloudCore | Quantos nós de borda cabem? Limites práticos e teóricos do K |
| EdgeCore desconecta frequentemente | Latência alta ou perda de pacotes na rede | Melhore a qualidade do link entre Edge e Cloud | Quantos nós de borda cabem? Limites práticos e teóricos do K |
| Pods não sobem nos nós de borda | Limite de pods do kubelet atingido ou falta de recursos | Ajuste o limite de pods ou aumente CPU/RAM do nó | Quantos nós de borda cabem? Limites práticos e teóricos do K |
| Backup falha com erro de permissão | Usuário sem permissão de leitura em diretórios do OpenHAB | Execute o comando como root ou ajuste permissões dos diretórios | Recuperação e continuidade em ambientes críticos |
| Restore não recupera integrações | Backup incompleto ou addons não incluídos | Verifique se o backup inclui a pasta addons e repita o processo | Recuperação e continuidade em ambientes críticos |
| Servidor de failover não inicia OpenHAB corretamente | Versão diferente do OpenHAB ou dependências ausentes | Padronize versões e dependências entre os servidores | Recuperação e continuidade em ambientes críticos |
| Automação não dispara após restore | Banco de dados de persistência não foi restaurado | Inclua o diretório de dados no backup e restore | Recuperação e continuidade em ambientes críticos |
| Device não aparece em 'kubectl get device' | CRD não aplicado ou erro de sintaxe no YAML. | Revise o YAML e aplique novamente. Use 'kubectl describe' para detalhes do erro. | Registrando dispositivos IoT no KubeEdge |
| Device com status pendente | EdgeNode offline ou nome incorreto no nodeSelector. | Verifique se o EdgeNode está online e o nome está correto. | Registrando dispositivos IoT no KubeEdge |
| DeviceTwin não sincroniza | Problema de comunicação entre EdgeCore e CloudCore. | Cheque logs do EdgeCore e conectividade de rede. | Registrando dispositivos IoT no KubeEdge |
| Comando não chega ao atuador | Tópico MQTT incorreto ou node MQTT out mal configurado | Revise os tópicos e a configuração do node MQTT out | Regras automáticas: do sensor ao atuador sem intervenção hum |
| A automação dispara repetidamente sem motivo | Falta de filtragem de mudanças de valor | Adicione um node rbe para evitar publicações redundantes | Regras automáticas: do sensor ao atuador sem intervenção hum |
| Estado do dispositivo se perde após reiniciar | Persistência de contexto não ativada | Configure contextStorage no settings.js do Node-RED | Regras automáticas: do sensor ao atuador sem intervenção hum |
| A regra não dispara nunca | Condições lógicas nunca satisfeitas ou erro de sintaxe | Revise operadores lógicos e tipos de dados; verifique logs de erro | Regras avançadas: scripts, timers e integrações condicionais |
| Ação dispara múltiplas vezes | Timers não cancelados ou lógica de controle de estado ausente | Implemente controle de timers e variáveis de estado | Regras avançadas: scripts, timers e integrações condicionais |
| Integração externa falha | URL incorreta, HTTP Actions não ativado ou payload inválido | Consulte a documentação, valide URL e formato do conteúdo | Regras avançadas: scripts, timers e integrações condicionais |
| Comando enviado, mas dispositivo não responde | Tópico ou payload incorreto, ou comando não suportado | Revise o nome do dispositivo, o comando enviado e consulte a lista de comandos suportados | Scripts e APIs: controle programático de dispositivos Zigbee |
| Script Python não publica comandos | Falha de conexão MQTT ou erro de autenticação | Verifique host, porta e credenciais do broker MQTT | Scripts e APIs: controle programático de dispositivos Zigbee |
| Estado do dispositivo não muda no tópico | Dispositivo fora da rede Zigbee ou problema no zigbee2mqtt | Repare o dispositivo e reinicie o serviço zigbee2mqtt | Scripts e APIs: controle programático de dispositivos Zigbee |
| Dispositivos MQTT não conectam após ativar TLS | Clientes ainda tentam porta sem TLS ou não aceitam certificados | Atualize clientes para usar porta 8883 e aceite o certificado da CA | Segurança em MQTT, Z-Wave e REST API |
| REST API responde 401 Unauthorized | Token ausente, expirado ou inválido | Gere novo token e envie no cabeçalho Authorization | Segurança em MQTT, Z-Wave e REST API |
| Dispositivo Z-Wave aparece como não seguro | NetworkKey ausente ou dispositivo não suporta S2 | Repareie com S2 ou troque por dispositivo compatível | Segurança em MQTT, Z-Wave e REST API |
| Dispositivo não consegue parear | Chave de rede incorreta ou pareamento fechado | Revise a chave no dispositivo e libere o pareamento temporariamente | Segurança no pareamento Zigbee: chaves de rede e vulnerabili |
| Inclusão de dispositivo desconhecido | Pareamento ficou aberto além do necessário | Reduza o tempo de permit_join e revise logs | Segurança no pareamento Zigbee: chaves de rede e vulnerabili |
| Logs não mostram eventos de pareamento | Nível de log insuficiente ou diretório errado | Ajuste o nível de log e o caminho no Zigbee2MQTT | Segurança no pareamento Zigbee: chaves de rede e vulnerabili |
| EdgeCore reinicia frequentemente | Falta de RAM ou CPU | Aumente recursos ou limite workloads. | Sizing de hardware e rede: CPU, RAM, armazenamento e backbon |
| CloudCore apresenta alta latência | CPU saturada ou rede congestionada | Aumente vCPU ou otimize rede. | Sizing de hardware e rede: CPU, RAM, armazenamento e backbon |
| Logs ocupam todo o disco do EdgeCore | Rotação de logs desabilitada | Ative rotação e monitore uso de disco. | Sizing de hardware e rede: CPU, RAM, armazenamento e backbon |
| Node-RED não inicia após atualização | Incompatibilidade de nodes antigos | Atualize ou remova nodes incompatíveis usando 'npm update' na pasta ~/.node-red | Tendências em Node-RED, Mosquitto e IoT livre |
| Mosquitto rejeita conexões | Erro na configuração do plugin de autenticação | Revise o caminho do plugin e o arquivo de configuração | Tendências em Node-RED, Mosquitto e IoT livre |
| Bridge MQTT não conecta | Endereço ou porta incorretos | Confirme o endereço do broker central e liberação da porta 1883 | Tendências em Node-RED, Mosquitto e IoT livre |
| Node-RED não inicia após atualização | Incompatibilidade de nodes antigos | Atualize ou remova nodes incompatíveis usando 'npm update' na pasta ~/.node-red | Tendências em Node-RED, Mosquitto e IoT livre |
| Mosquitto rejeita conexões | Erro na configuração do plugin de autenticação | Revise o caminho do plugin e o arquivo de configuração | Tendências em Node-RED, Mosquitto e IoT livre |
| Bridge MQTT não conecta | Endereço ou porta incorretos | Confirme o endereço do broker central e liberação da porta 1883 | Tendências em Node-RED, Mosquitto e IoT livre |
| Erro: 'unable to get local issuer certificate' | O parâmetro 'cafile' está apontando para o arquivo errado ou o cliente não confia na CA. | Verifique se '--cafile' e 'cafile' apontam para o certificado da CA que assinou o certificado do broker. | TLS no Mosquitto: criptografia de verdade, não só teoria |
| Erro: 'hostname does not match certificate' | O CN do certificado não bate com o hostname usado na conexão. | Use o mesmo hostname do CN ou adicione '--insecure' para testes (não recomendado em produção). | TLS no Mosquitto: criptografia de verdade, não só teoria |
| Conexão recusada na porta 8883 | Listener TLS não está configurado ou o Mosquitto não foi reiniciado. | Revise a configuração e reinicie o serviço. | TLS no Mosquitto: criptografia de verdade, não só teoria |
| Falha na conexão TLS entre CloudCore e EdgeCore | Certificado inválido, expirado ou CA não reconhecida | Verifique datas de validade, caminhos dos arquivos e se ambos usam a mesma CA | TLS, autenticação mútua e certificados no KubeEdge |
| EdgeCore não autentica no CloudCore | CN do certificado não corresponde ao esperado | Recrie o certificado com o CN correto | TLS, autenticação mútua e certificados no KubeEdge |
| Dispositivo IoT não conecta via MQTT | Certificado do dispositivo ausente ou não assinado pela CA | Gere e instale um certificado válido para o dispositivo | TLS, autenticação mútua e certificados no KubeEdge |
| Não recebe mensagens ao assinar um wildcard. | Hierarquia dos tópicos não segue o padrão ou há erro de digitação. | Revise a nomenclatura dos tópicos publicados e assinados. | Tópicos MQTT e namespaces: como organizar seu sistema para c |
| Recebe mensagens demais ao assinar com #. | Wildcard muito amplo. | Use + para filtrar apenas o nível desejado. | Tópicos MQTT e namespaces: como organizar seu sistema para c |
| Dashboard não mostra dados de um setor. | Tópico do setor está diferente do padrão. | Padronize a nomenclatura e corrija nos dispositivos e dashboards. | Tópicos MQTT e namespaces: como organizar seu sistema para c |
| EdgeNode não aparece no cluster | Configuração incorreta do edgecore.yaml ou problema de rede | Revise o arquivo de configuração e teste conectividade TCP com o CloudCore | Topologias IoT com KubeEdge: single-edge, multi-edge e mesh |
| Serviços não acessíveis entre EdgeNodes em mesh | EdgeMesh não habilitado ou portas bloqueadas | Confirme que 'edgemesh.enable' está true e libere as portas necessárias | Topologias IoT com KubeEdge: single-edge, multi-edge e mesh |
| Alta latência na comunicação | EdgeNode sobrecarregado ou link de baixa qualidade | Monitore recursos do node e avalie balanceamento de carga | Topologias IoT com KubeEdge: single-edge, multi-edge e mesh |
| OpenHAB não recebe eventos MQTT | Configuração de broker incorreta ou serviço Mosquitto parado | Revise o IP e porta no mqtt.cfg e reinicie o Mosquitto | Topologias OpenHAB: standalone, distribuída e em cluster |
| Dashboard não atualiza após falha de gateway Z-Wave | Gateway offline ou porta TCP bloqueada | Cheque conectividade com 'telnet IP 3333' e reinicie o gateway | Topologias OpenHAB: standalone, distribuída e em cluster |
| Dados do dashboard sumiram após reboot | Banco de dados não persistente ou não configurado | Configure persistência externa (InfluxDB, PostgreSQL) e agende backups | Topologias OpenHAB: standalone, distribuída e em cluster |
| Dispositivo Zigbee não aparece no MQTT | Problema de pareamento ou configuração do Zigbee2MQTT | Reinicie o serviço e refaça o pareamento; revise logs em /opt/zigbee2mqtt/data/log | Zigbee frente a Thread, Wi-SUN e Matter: comparação técnica |
| Latência alta em comandos Zigbee | Rede mesh sobrecarregada ou interferência 2.4GHz | Reduza saltos mesh ou mude canal Zigbee | Zigbee frente a Thread, Wi-SUN e Matter: comparação técnica |
| Integração Matter falha | Versão incompatível ou suporte parcial no stack | Consulte a documentação oficial para releases compatíveis | Zigbee frente a Thread, Wi-SUN e Matter: comparação técnica |
