670 sintomas catalogados

Cada sintoma com causa provável e correção, ligado à lição da trilha Supermercados que explica o porquê. Descreva o sintoma para filtrar.

Sintoma	Causa provável	Correção	Lição
O comando remoto não executa	EnableRemoteCommands não está ativado ou firewall bloqueando porta do agente	Verifique configuração do agente e regras de firewall	Ações automáticas: scripts e comandos remotos no Zabbix
Permissão negada ao executar comando	Usuário do agente não tem permissão sudo para o comando	Ajuste o /etc/sudoers corretamente	Ações automáticas: scripts e comandos remotos no Zabbix
Script executa mas não resolve o problema	Script não é idempotente ou não trata todos os casos	Revise o script para garantir robustez e múltiplas execuções	Ações automáticas: scripts e comandos remotos no Zabbix
Dashboards travando ou não carregam	Consulta lenta ou falta de índice	Use EXPLAIN ANALYZE e crie índices apropriados	Acompanhando performance do Metabase e PostgreSQL
Erro de 'too many connections'	max_connections baixo ou pool do Metabase alto	Ajuste max_connections e o pool do Metabase	Acompanhando performance do Metabase e PostgreSQL
Banco travando após ajuste de conexões	max_connections alto demais para a RAM	Reduza o limite e monitore uso de memória	Acompanhando performance do Metabase e PostgreSQL
Consultas rápidas no banco, mas lentas no Metabase	Transformações pesadas no Metabase	Simplifique filtros e agregações nos dashboards	Acompanhando performance do Metabase e PostgreSQL
Novo AP não aparece no controlador	DHCP não está entregando a opção do controlador ou AP está em VLAN errada	Verifique configuração DHCP e VLAN da porta onde o AP foi conectado	Adicionando mais PDVs, APs e câmeras sem parar a loja
PDV não recebe IP	Pool DHCP esgotado ou conflito de sub-rede	Amplie o pool DHCP ou revise o planejamento de sub-redes	Adicionando mais PDVs, APs e câmeras sem parar a loja
Rede fica lenta após adicionar switches	Loop de rede ou STP desativado	Ative o Spanning Tree Protocol nos switches	Adicionando mais PDVs, APs e câmeras sem parar a loja
Novo AP não aparece no controlador	DHCP não está entregando a opção do controlador ou AP está em VLAN errada	Verifique configuração DHCP e VLAN da porta onde o AP foi conectado	Adicionando mais PDVs, APs e câmeras sem parar a loja
PDV não recebe IP	Pool DHCP esgotado ou conflito de sub-rede	Amplie o pool DHCP ou revise o planejamento de sub-redes	Adicionando mais PDVs, APs e câmeras sem parar a loja
Rede fica lenta após adicionar switches	Loop de rede ou STP desativado	Ative o Spanning Tree Protocol nos switches	Adicionando mais PDVs, APs e câmeras sem parar a loja
Script não executa pelo cron	Permissões insuficientes ou caminhos relativos no crontab	Use caminhos absolutos e garanta permissões de execução.	Agendamento de ETL: Python, cron e atualização do BI
Logs não são gravados	Diretório de log inexistente ou sem permissão de escrita	Crie o diretório e ajuste permissões para o usuário do cron.	Agendamento de ETL: Python, cron e atualização do BI
Carga incremental não traz dados novos	Campo de data incorreto ou controle de última execução desatualizado	Revise a lógica de atualização e os parâmetros enviados à API.	Agendamento de ETL: Python, cron e atualização do BI
Housekeeping lento ou travando	Tabelas grandes demais sem particionamento	Implemente particionamento e scripts externos de limpeza	Ajustando banco de dados: particionamento e retenção em larg
Erro ao criar partições	Sintaxe incompatível com a versão do banco	Consulte a documentação da sua versão para o comando correto	Ajustando banco de dados: particionamento e retenção em larg
Banco crescendo indefinidamente	Retenção mal configurada ou scripts de limpeza falhando	Revise as configurações de housekeeping e agendamento de scripts	Ajustando banco de dados: particionamento e retenção em larg
Limpeza de dados muito lenta	Housekeeper com poucas threads ou intervalo muito alto	Aumente o número de threads (HousekeeperDelete) e reduza o intervalo (HousekeepingFrequency)	Ajustando parâmetros para desempenho: housekeeper, history e
Banco crescendo sem parar	History e trends com período muito longo	Reduza o período de history e trends nos itens e templates	Ajustando parâmetros para desempenho: housekeeper, history e
Zabbix lento em horários de pico	Housekeeper rodando junto com coleta intensa	Ajuste o horário de execução ou aumente recursos do servidor	Ajustando parâmetros para desempenho: housekeeper, history e
Recebo muitos alertas duplicados	Falta de dependências entre triggers	Configure dependências para filtrar alertas redundantes	Alertas inteligentes: triggers, dependências e notificações
Não recebo notificações	Media type ou ação mal configurada	Revise configuração de Media type, usuário e ação	Alertas inteligentes: triggers, dependências e notificações
Alertas disparam por picos rápidos	Trigger sem função de tempo (avg, min, max)	Use funções temporais nas triggers para suavizar flutuações	Alertas inteligentes: triggers, dependências e notificações
O VIP do CARP não responde após failover	VHID duplicado ou advskew igual nos dois appliances	Ajuste o advskew e confirme VHID único por segmento	Alta disponibilidade: CARP, failover e redundância em superm
Sessões caem no failover	pfsync não configurado ou bloqueado por firewall	Verifique se pfsync está ativo e portas liberadas entre appliances	Alta disponibilidade: CARP, failover e redundância em superm
Configurações não sincronizam	XMLRPC Sync não configurado corretamente	Revise IP do peer e credenciais em System > High Avail. Sync	Alta disponibilidade: CARP, failover e redundância em superm
Collection não aparece na lista após instalar	Instalação falhou ou ambiente virtual incorreto	Reinstale a collection e verifique o ambiente ativo	Ansible Collections e Galaxy: reutilizando e compartilhando
Erro 'collection not found' ao rodar playbook	Namespace ou nome do módulo incorretos	Confirme o nome correto no Galaxy e ajuste o playbook	Ansible Collections e Galaxy: reutilizando e compartilhando
Erro de autenticação ao publicar collection	Token do Galaxy não configurado	Configure o token conforme documentação oficial	Ansible Collections e Galaxy: reutilizando e compartilhando
Interface web não carrega	Porta bloqueada ou container não iniciado	Verifique firewall e status dos containers com 'docker ps'	Ansible Tower/AWX: orquestração e delegação em larga escala
Erro de banco de dados ao iniciar	Volume persistente não criado ou permissão insuficiente	Cheque permissões dos diretórios e reinicie os containers	Ansible Tower/AWX: orquestração e delegação em larga escala
Usuário não consegue executar playbook	Permissão insuficiente no time ou projeto	Ajuste as permissões de RBAC no painel de times	Ansible Tower/AWX: orquestração e delegação em larga escala
Tarefa sempre aparece como 'changed'	Módulo não idempotente ou parâmetros incompletos	Revise o playbook e use módulos idempotentes	Ansible: o que faz, como pensa e por que não é só "rodar scr
Erro de permissão (permission denied)	Usuário remoto sem sudo ou SSH mal configurado	Ajuste permissões e teste SSH manualmente	Ansible: o que faz, como pensa e por que não é só "rodar scr
Servidor não aparece no relatório	IP ou nome errado no inventário	Corrija o inventário e teste conectividade	Ansible: o que faz, como pensa e por que não é só "rodar scr
Pacote não instala	Repositório desatualizado ou bloqueio de rede	Atualize o cache do apt e verifique firewall	Ansible: o que faz, como pensa e por que não é só "rodar scr
Erro 401 Unauthorized	Token inválido, expirado ou ausente no cabeçalho	Gere um novo token e revise o cabeçalho x-CustomToken	APIs REST, OpenAPI e tokens: como funciona a extração de dad
Erro 429 Too Many Requests	Limite de requisições excedido	Implemente backoff e agende extrações fora do horário de pico	APIs REST, OpenAPI e tokens: como funciona a extração de dad
Dados incompletos após extração	Paginação não implementada corretamente	Revise a lógica de iteração conforme parâmetros do OpenAPI	APIs REST, OpenAPI e tokens: como funciona a extração de dad
Campos ausentes na resposta	Recurso da API não expõe todos os dados desejados	Confirme o escopo do recurso na documentação e avalie exportação manual	APIs REST, OpenAPI e tokens: como funciona a extração de dad
Dados incompletos no dashboard	ETL falhou em alguma etapa ou a extração incremental não buscou todos os registros.	Verifique os logs do ETL e ajuste a lógica de extração incremental.	Aprendizados de implantação: erros, acertos e melhorias cont
Dashboards lentos no Superset	Consultas SQL pouco otimizadas ou ausência de índices no PostgreSQL.	Revise queries e crie índices nas colunas mais filtradas.	Aprendizados de implantação: erros, acertos e melhorias cont
Erros de autenticação na API	Token expirado ou mal configurado.	Gere novo token no Bluesoft ERP e atualize a configuração do ETL.	Aprendizados de implantação: erros, acertos e melhorias cont
Serviço não inicia após atualização	Incompatibilidade de versão ou dependências quebradas	Revise logs do serviço e execute rollback automatizado	Atualização coordenada de múltiplas lojas sem downtime
Backup não encontrado para restauração	Falha no fetch ou permissão de escrita no servidor central	Ajuste permissões e revalide playbook de backup	Atualização coordenada de múltiplas lojas sem downtime
Atualização muito lenta	Serial muito baixo ou rede saturada	Aumente o valor do serial ou execute fora do horário de pico	Atualização coordenada de múltiplas lojas sem downtime
OpenVAS não encontra hosts na rede	Firewall bloqueando varredura ou range IP errado	Verifique regras de firewall e range IP configurado	Auditoria e compliance PCI DSS: o que realmente precisa ser
Lynis aponta muitos avisos de permissão	Permissões de arquivos sensíveis estão abertas demais	Ajuste permissões conforme recomendação do Lynis	Auditoria e compliance PCI DSS: o que realmente precisa ser
Logs não chegam ao servidor syslog	IP do syslog remoto incorreto ou firewall bloqueando porta 514	Corrija IP e libere porta 514/UDP no firewall	Auditoria e compliance PCI DSS: o que realmente precisa ser
Wi-Fi do PDV aparece para clientes	SSID não está oculto ou VLAN mal configurada	Ajuste configuração do SSID e VLANs no AP	Auditoria e compliance PCI DSS: o que realmente precisa ser
OpenVAS não encontra hosts na rede	Firewall bloqueando varredura ou range IP errado	Verifique regras de firewall e range IP configurado	Auditoria e compliance PCI DSS: o que realmente precisa ser
Lynis aponta muitos avisos de permissão	Permissões de arquivos sensíveis estão abertas demais	Ajuste permissões conforme recomendação do Lynis	Auditoria e compliance PCI DSS: o que realmente precisa ser
Logs não chegam ao servidor syslog	IP do syslog remoto incorreto ou firewall bloqueando porta 514	Corrija IP e libere porta 514/UDP no firewall	Auditoria e compliance PCI DSS: o que realmente precisa ser
Wi-Fi do PDV aparece para clientes	SSID não está oculto ou VLAN mal configurada	Ajuste configuração do SSID e VLANs no AP	Auditoria e compliance PCI DSS: o que realmente precisa ser
API UniFi retorna erro 401	Token de autenticação expirado ou inválido	Refaça o login e obtenha novo token	Automação avançada, APIs e integração com sistemas de loja
Arquivo de configuração não aplica no OpenWrt	Permissões ou sintaxe incorreta no arquivo	Verifique permissões e valide sintaxe com 'uci show'	Automação avançada, APIs e integração com sistemas de loja
ERP não recebe eventos da rede	Endpoint do ERP incorreto ou bloqueio de firewall	Confirme o endpoint e libere portas necessárias	Automação avançada, APIs e integração com sistemas de loja
API UniFi retorna erro 401	Token de autenticação expirado ou inválido	Refaça o login e obtenha novo token	Automação avançada, APIs e integração com sistemas de loja
Arquivo de configuração não aplica no OpenWrt	Permissões ou sintaxe incorreta no arquivo	Verifique permissões e valide sintaxe com 'uci show'	Automação avançada, APIs e integração com sistemas de loja
ERP não recebe eventos da rede	Endpoint do ERP incorreto ou bloqueio de firewall	Confirme o endpoint e libere portas necessárias	Automação avançada, APIs e integração com sistemas de loja
O pipeline falha na etapa de deploy	Erro de sintaxe no playbook ou variável ausente	Rode ansible-playbook localmente com --syntax-check e revise variáveis obrigatórias	Automação contínua: Ansible em pipelines de CI/CD open sourc
Deploy aplica mudanças em hosts errados	Inventário ou parâmetro -l mal configurado	Revise o inventário e os parâmetros de limitação de hosts no comando	Automação contínua: Ansible em pipelines de CI/CD open sourc
Execução lenta em múltiplas lojas	Paralelismo baixo (forks padrão)	Aumente o valor de forks no ansible.cfg	Automação contínua: Ansible em pipelines de CI/CD open sourc
Playbook falha com erro de conexão SSH	Node está offline ou endereço IP incorreto no inventário	Verifique conectividade e atualize o inventário	Automação de infraestrutura imutável: containers e edge com
Container não inicia após atualização	Imagem corrompida ou variável de ambiente ausente	Remova imagem local e force novo pull; revise variáveis	Automação de infraestrutura imutável: containers e edge com
Atualização não replica em todos os nodes	Timeouts ou falhas intermitentes de rede	Ajuste timeouts e reexecute apenas nos nodes afetados	Automação de infraestrutura imutável: containers e edge com
Playbook não executa após alerta	Permissões incorretas no script externo ou caminho do Ansible errado	Verifique permissões e paths no script de ação do monitoramento	Automatizando alertas e remediação: playbooks reativos
Serviço não reinicia	Nome do serviço incorreto ou usuário sem permissão	Confirme variáveis e permissões de sudo no host	Automatizando alertas e remediação: playbooks reativos
Logs não são gerados	Configuração ausente ou incorreta do log_path no ansible.cfg	Ajuste o ansible.cfg e garanta que o diretório de log existe	Automatizando alertas e remediação: playbooks reativos
Playbook falha com erro de permissão	Usuário SSH sem privilégio root/admin	Ajuste o usuário no inventário ou conceda permissões adequadas	Automatizando configuração de switches e APs com Ansible
Configuração não aplicada em todos os dispositivos	Hosts offline ou SSH bloqueado	Verifique conectividade de rede e firewall	Automatizando configuração de switches e APs com Ansible
Rollback não restaura configuração original	Backup não realizado antes da alteração	Inclua sempre tarefa de backup no início do playbook	Automatizando configuração de switches e APs com Ansible
Playbook falha com erro de permissão	Usuário SSH sem privilégio root/admin	Ajuste o usuário no inventário ou conceda permissões adequadas	Automatizando configuração de switches e APs com Ansible
Configuração não aplicada em todos os dispositivos	Hosts offline ou SSH bloqueado	Verifique conectividade de rede e firewall	Automatizando configuração de switches e APs com Ansible
Rollback não restaura configuração original	Backup não realizado antes da alteração	Inclua sempre tarefa de backup no início do playbook	Automatizando configuração de switches e APs com Ansible
O extrator não roda no horário	Cron mal configurado ou permissões insuficientes	Verifique o crontab com 'crontab -l' e permissões do script	Automatizando o pipeline: agendamento, notificações e reproc
Notificações de erro não chegam	Configuração SMTP incorreta ou bloqueio de porta	Teste envio de e-mail manualmente e ajuste as configurações	Automatizando o pipeline: agendamento, notificações e reproc
Retries não funcionam	Exceções não capturadas corretamente	Garanta que todo erro relevante está dentro do bloco try/except	Automatizando o pipeline: agendamento, notificações e reproc
Dados não atualizam no Superset	Carga no PostgreSQL falhou ou dashboards não foram atualizados	Valide a execução do extrator e a conexão do Superset	Automatizando o pipeline: agendamento, notificações e reproc
Backup não aparece no servidor central	Falha de autenticação ou rede no scp	Verifique conectividade e permissões SSH.	Backup, restore e replicação: pfSense Gold, scripts e API
Restore não aplica configurações	Arquivo config.xml corrompido ou com sintaxe inválida	Valide o XML antes de restaurar.	Backup, restore e replicação: pfSense Gold, scripts e API
Replicação falha em algum firewall	Chave SSH não instalada ou hostname incorreto	Confirme as chaves e nomes dos hosts.	Backup, restore e replicação: pfSense Gold, scripts e API
Rede intermitente ou lenta em alguns pontos	Cabo de rede fora do padrão de comprimento ou mal crimpado	Refaça o cabo e mantenha o comprimento dentro do limite de 90 metros	Cabeamento e racks: erros que custam caro
Switch queimando ou desligando sozinho	Aterramento ausente ou inadequado	Revisar e refazer o aterramento do rack e dos equipamentos	Cabeamento e racks: erros que custam caro
Dificuldade para identificar pontos de rede	Falta de identificação nas pontas dos cabos	Etiquetar todos os cabos conforme padrão definido	Cabeamento e racks: erros que custam caro
Cabos de rede apresentando falhas após manutenção elétrica	Cabos de dados próximos a cabos de energia	Replanejar rotas e garantir distanciamento mínimo	Cabeamento e racks: erros que custam caro
Rede intermitente ou lenta em alguns pontos	Cabo de rede fora do padrão de comprimento ou mal crimpado	Refaça o cabo e mantenha o comprimento dentro do limite de 90 metros	Cabeamento e racks: erros que custam caro
Switch queimando ou desligando sozinho	Aterramento ausente ou inadequado	Revisar e refazer o aterramento do rack e dos equipamentos	Cabeamento e racks: erros que custam caro
Dificuldade para identificar pontos de rede	Falta de identificação nas pontas dos cabos	Etiquetar todos os cabos conforme padrão definido	Cabeamento e racks: erros que custam caro
Cabos de rede apresentando falhas após manutenção elétrica	Cabos de dados próximos a cabos de energia	Replanejar rotas e garantir distanciamento mínimo	Cabeamento e racks: erros que custam caro
Novas conexões são rejeitadas	Limite de estados atingido	Aumente 'Firewall Maximum States' e adicione RAM se necessário	Calculando throughput e limites: o que trava primeiro em um
VPNs caem sob carga	CPU saturada pelo processamento de criptografia	Use algoritmos mais leves ou aumente o poder de CPU	Calculando throughput e limites: o que trava primeiro em um
Lentidão geral em horários de pico	RAM insuficiente ou IDS/IPS sobrecarregado	Reduza regras do IDS/IPS ou aumente a RAM	Calculando throughput e limites: o que trava primeiro em um
Tráfego entre VLANs não passa	Regra de firewall ausente ou bloqueando	Revise as regras na interface de origem e ajuste para permitir o tráfego necessário	Camadas do pfSense: interfaces, regras e fluxos de dados
Dispositivos não acessam a internet	NAT de saída não configurado ou gateway incorreto	Ajuste o Outbound NAT e confira o gateway da interface	Camadas do pfSense: interfaces, regras e fluxos de dados
Rede lenta após criar bridge	Bridge mal dimensionada ou loops	Reveja a topologia, evite bridges desnecessárias e ative STP se aplicável	Camadas do pfSense: interfaces, regras e fluxos de dados
Após atualização, serviço não inicia	Incompatibilidade entre versão do pacote e firmware	Consulte a documentação de compatibilidade antes de atualizar; reverta backup se necessário.	Checklist de manutenção: o que revisar mensalmente no pfSens
Backup não restaura corretamente	Arquivo corrompido ou incompleto	Valide backups em ambiente isolado e automatize cópias externas.	Checklist de manutenção: o que revisar mensalmente no pfSens
Logs cheios rapidamente	Volume excessivo de eventos ou retenção inadequada	Ajuste a rotação de logs em Status > System Logs > Settings.	Checklist de manutenção: o que revisar mensalmente no pfSens
Erro 'UNREACHABLE' ao rodar ansible ping	SSH não configurado ou bloqueado por firewall	Verifique se a porta 22 está aberta e se a chave SSH foi copiada corretamente	Como o Ansible se conecta e opera: agentes, SSH e controle c
Erro 'python not found' nos managed nodes	Python não instalado no servidor remoto	Instale Python 3 com 'sudo apt install python3' no managed node	Como o Ansible se conecta e opera: agentes, SSH e controle c
Timeout nas conexões SSH	Rede lenta ou instável entre control node e managed node	Teste latência com 'ping' e ajuste timeouts no Ansible se necessário	Como o Ansible se conecta e opera: agentes, SSH e controle c
Dashboard do Metabase desatualizado	Falha ou atraso na rotina de extração Python	Verifique logs do extrator e agendamento.	Comparando arquiteturas: BI embarcado vs BI próprio
Dados inconsistentes entre ERP e BI	Transformação ou mapeamento incorreto no ETL	Revise scripts de carga e regras de transformação.	Comparando arquiteturas: BI embarcado vs BI próprio
API do Bluesoft retorna erro 401	Token expirado ou inválido	Renove o token conforme instruções do ERP.	Comparando arquiteturas: BI embarcado vs BI próprio
Erro de autenticação ao salvar fonte de dados	Usuário ou senha incorretos, ou usuário sem permissão CONNECT	Recrie o usuário e revise as permissões com GRANT CONNECT	Conectando Metabase ao PostgreSQL bi_varejo
Tabelas não aparecem no Metabase	Permissão USAGE ou SELECT ausente no schema ou tabelas	Execute GRANT USAGE ON SCHEMA e GRANT SELECT ON ALL TABLES	Conectando Metabase ao PostgreSQL bi_varejo
Erro de conexão por timeout	Host ou porta errados, firewall bloqueando, containers em redes diferentes	Confirme host, porta e rede Docker; ajuste regras de firewall se necessário	Conectando Metabase ao PostgreSQL bi_varejo
Usuário não consegue acessar o painel web	Permissões insuficientes ou grupo mal configurado	Revise as permissões do grupo e do usuário em System > User Manager	Configurando acesso seguro: usuários, senhas e permissões
Acesso SSH negado mesmo com chave correta	Login root bloqueado ou chave não cadastrada corretamente	Habilite o usuário específico para SSH e confira a chave pública	Configurando acesso seguro: usuários, senhas e permissões
Logs não aparecem no painel	Syslog remoto mal configurado ou serviço de log parado	Revise configurações em System Logs > Settings e reinicie o serviço	Configurando acesso seguro: usuários, senhas e permissões
Timezone não altera após playbook	Módulo timezone não suportado ou serviço não reiniciado	Verifique suporte do sistema e reinicie o serviço systemd-timedated	Configurando Linux em produção: do timezone ao firewall
Locale permanece em en_US	Locale não gerado ou variável de ambiente não definida	Reaplique locale-gen e revise /etc/default/locale	Configurando Linux em produção: do timezone ao firewall
Firewall não bloqueia porta como esperado	Regras não aplicadas permanentemente ou conflito entre firewalld e iptables	Garanta que só um firewall está ativo e recarregue as regras	Configurando Linux em produção: do timezone ao firewall
Usuário não consegue sudo	Arquivo sudoers mal formatado	Valide com visudo antes de aplicar	Configurando Linux em produção: do timezone ao firewall
Pacote não instala	Nome do pacote errado ou repositório indisponível	Confirme nome do pacote e conectividade com repositórios	Configurando Linux em produção: do timezone ao firewall
Erro 'No module named psycopg2'	Driver não instalado no container	Confirme o psycopg2 em requirements-local.txt e reinicie o Docker com --build.	Configurando o Apache Superset com PostgreSQL: drivers, URIs
Conexão recusada ao PostgreSQL	Host, porta ou firewall incorretos	Verifique se o banco está acessível e a URI está correta.	Configurando o Apache Superset com PostgreSQL: drivers, URIs
Permissão negada ao acessar tabelas	Usuário sem GRANT SELECT	Aplique os comandos de permissão mínima no PostgreSQL.	Configurando o Apache Superset com PostgreSQL: drivers, URIs
Dispositivo não recebe IP	Porta do switch está na VLAN errada ou DHCP não configurado para a VLAN	Verifique atribuição de VLAN na porta e configuração de DHCP no OpenWrt	Configurando VLANs em switches e OpenWrt
Hosts em VLANs diferentes se comunicam	Porta trunk configurada como access ou ausência de isolamento no roteador	Revise modos das portas e regras de firewall no OpenWrt	Configurando VLANs em switches e OpenWrt
Sem acesso à internet em uma VLAN	Roteamento ou NAT não configurado para a interface VLAN	Adicione interface à zona correta no firewall do OpenWrt e configure NAT se necessário	Configurando VLANs em switches e OpenWrt
Dispositivo não recebe IP	Porta do switch está na VLAN errada ou DHCP não configurado para a VLAN	Verifique atribuição de VLAN na porta e configuração de DHCP no OpenWrt	Configurando VLANs em switches e OpenWrt
Hosts em VLANs diferentes se comunicam	Porta trunk configurada como access ou ausência de isolamento no roteador	Revise modos das portas e regras de firewall no OpenWrt	Configurando VLANs em switches e OpenWrt
Sem acesso à internet em uma VLAN	Roteamento ou NAT não configurado para a interface VLAN	Adicione interface à zona correta no firewall do OpenWrt e configure NAT se necessário	Configurando VLANs em switches e OpenWrt
Erro 401 Unauthorized	Token ou credenciais inválidas.	Verifique variáveis de autenticação e permissões na API.	Consumindo APIs REST com Ansible: integração com sistemas de
Campo json.quantidade não encontrado	Estrutura da resposta JSON diferente do esperado.	Use debug para inspecionar toda a resposta e ajuste o caminho.	Consumindo APIs REST com Ansible: integração com sistemas de
Timeout na requisição	Problema de conectividade ou URL incorreta.	Confirme o endpoint e conectividade de rede.	Consumindo APIs REST com Ansible: integração com sistemas de
Usuário do Metabase não consegue acessar tabelas	Permissão SELECT não concedida ou schema não autorizado	Conceda USAGE no schema e SELECT nas tabelas necessárias	Controle de acesso no PostgreSQL e Metabase
Extrator Python falha ao inserir dados	Permissão de INSERT/UPDATE ausente para a role do extrator	Conceda INSERT/UPDATE apenas nas tabelas necessárias	Controle de acesso no PostgreSQL e Metabase
Usuário comum vê dashboards de produção	Permissão excessiva no grupo do Metabase	Revise permissões dos grupos e restrinja acesso ao ambiente de produção	Controle de acesso no PostgreSQL e Metabase
Dispositivo do Wi-Fi acessa POS	Falta de regra de bloqueio ou ordem incorreta das regras	Adicione regra de bloqueio antes das regras de permissão	Criando VLANs, interfaces e regras para setores: do estoque
POS sem acesso ao servidor de administração	Regra de permissão ausente ou IP incorreto	Revise regras e IPs de destino	Criando VLANs, interfaces e regras para setores: do estoque
Dispositivos não recebem IP	DHCP não ativado ou range incorreto	Ative DHCP e ajuste o range	Criando VLANs, interfaces e regras para setores: do estoque
Produtos ou clientes não aparecem na visualização	Dados não carregados ou erro na query SQL	Confirme se o extrator Python rodou e revise a query.	Curva ABC de produtos e de clientes em SQL no Apache Superse
Classes ABC não estão corretas	Erro nos limites de percentuais na query	Ajuste os valores das faixas A, B, C na cláusula CASE.	Curva ABC de produtos e de clientes em SQL no Apache Superse
Dashboard mostra dados antigos	Carga da API não atualizou o bi_varejo	Verifique logs do extrator e agendamento.	Curva ABC de produtos e de clientes em SQL no Apache Superse
Consulta retorna valores acumulados errados	Função de janela mal configurada ou agrupamento incorreto	Revise a cláusula OVER() e os GROUP BY	Curva ABC de produtos e de clientes em SQL no Metabase sobre
Dashboard não atualiza com novos dados	Pipeline de carga da API não executou recentemente	Verifique logs do extrator Python e agende nova carga	Curva ABC de produtos e de clientes em SQL no Metabase sobre
Filtros do Metabase não afetam a consulta	Variáveis não foram declaradas corretamente na pergunta SQL	Use a sintaxe {{variavel}} e marque como filtro ao criar a pergunta	Curva ABC de produtos e de clientes em SQL no Metabase sobre
Dashboard vazio ou incompleto	Dados não carregados corretamente no PostgreSQL	Verifique logs do extrator e se as tabelas estão populadas.	Dashboard de PDV no Apache Superset a partir da API: vendas
Erro de conexão no Superset	Driver psycopg2 ausente ou string de conexão errada	Confirme dependências e formato da URI.	Dashboard de PDV no Apache Superset a partir da API: vendas
Métricas inconsistentes	Timezone ou datas mal tratadas na extração	Padronize datas e horas no pipeline Python.	Dashboard de PDV no Apache Superset a partir da API: vendas
Dashboard mostra vendas zeradas em horários de pico.	Possível erro no timezone ou filtro de data/hora.	Verifique se o campo data_hora está no timezone correto e revise os filtros no Metabase.	Dashboard de PDV no Metabase a partir da API: vendas por hor
Ticket médio muito abaixo do esperado.	Dados incompletos ou vendas canceladas incluídas.	Revise o processo de extração para filtrar apenas vendas efetivadas.	Dashboard de PDV no Metabase a partir da API: vendas por hor
Itens por cupom sempre igual a 1.	Erro na agregação: pode estar somando por item, não por venda.	Ajuste a query para agrupar por id_venda antes de calcular a média.	Dashboard de PDV no Metabase a partir da API: vendas por hor
Dashboard mostra dados desatualizados	Extrator Python não está rodando ou falhou na última execução	Verifique logs do extrator e agendamento (cron); corrija falhas de autenticação ou conexão	Dashboards de impacto: decisões tomadas a partir do BI própr
Consultas SQL lentas no Metabase	Falta de índices nas tabelas do PostgreSQL ou volume excessivo de dados	Crie índices nos campos de filtro e particione tabelas se necessário	Dashboards de impacto: decisões tomadas a partir do BI própr
Campos importantes ausentes nos dashboards	Extrator Python não está trazendo todos os campos necessários da API	Ajuste o extrator para buscar campos adicionais, conforme a documentação da API	Dashboards de impacto: decisões tomadas a partir do BI própr
O check mode não mostra mudanças em uma tarefa.	O módulo usado não suporta check mode.	Consulte a documentação do módulo e, se necessário, ajuste o playbook para módulos compatíveis.	Debug, check mode e dry-run: enxergando antes de quebrar
O diff não exibe diferenças em arquivos.	A tarefa não está alterando arquivos ou o módulo não implementa diff.	Use módulos como copy ou template, que suportam diff.	Debug, check mode e dry-run: enxergando antes de quebrar
Variáveis aparecem como 'undefined' no debug.	Variável não foi definida ou não está disponível no contexto.	Revise o escopo das variáveis e inicialize valores padrão.	Debug, check mode e dry-run: enxergando antes de quebrar
Usuário remoto não conecta via VPN	Certificado inválido ou regra de firewall ausente	Revise certificados e regras na interface OpenVPN	Definindo políticas: segmentação, VPN e acesso remoto para t
PDV acessando recursos do Wi-Fi	Falta de isolamento entre VLANs	Verifique regras de firewall e configurações de VLAN	Definindo políticas: segmentação, VPN e acesso remoto para t
Fornecedores acessam sistemas além do necessário	Regras de firewall muito permissivas	Ajuste regras para restringir IPs e portas	Definindo políticas: segmentação, VPN e acesso remoto para t
Dados faltando no destino	Paginação incompleta ou erro silencioso em alguma página	Revisar logs, reexecutar extração apenas das páginas faltantes	Desafios de escalabilidade na extração da API: paginação, li
Erro 429 (Too Many Requests)	Limite de requisições do fornecedor excedido	Reduzir concorrência, implementar backoff exponencial	Desafios de escalabilidade na extração da API: paginação, li
Dados duplicados no PostgreSQL	Falta de controle de idempotência nos retries	Adicionar checagem de chave única ou deduplicação na carga	Desafios de escalabilidade na extração da API: paginação, li
Mudança nos parâmetros de paginação	Alteração na API do fornecedor	Atualizar script para ler parâmetros do api-docs em tempo de execução	Desafios de escalabilidade na extração da API: paginação, li
Áreas críticas aparecem em vermelho ou sem cor	APs mal posicionados ou potência insuficiente	Reposicione APs ou aumente a potência, depois refaça o mapeamento	Desenhando mapas de calor Wi-Fi com ferramentas abertas
Sobreposição excessiva de áreas verdes	APs em canais iguais ou muito próximos	Altere canais dos APs para reduzir interferência	Desenhando mapas de calor Wi-Fi com ferramentas abertas
Sinal forte, mas conexão instável	Interferência de outros equipamentos ou excesso de sobreposição	Reduza potência ou reposicione APs	Desenhando mapas de calor Wi-Fi com ferramentas abertas
Áreas críticas aparecem em vermelho ou sem cor	APs mal posicionados ou potência insuficiente	Reposicione APs ou aumente a potência, depois refaça o mapeamento	Desenhando mapas de calor Wi-Fi com ferramentas abertas
Sobreposição excessiva de áreas verdes	APs em canais iguais ou muito próximos	Altere canais dos APs para reduzir interferência	Desenhando mapas de calor Wi-Fi com ferramentas abertas
Sinal forte, mas conexão instável	Interferência de outros equipamentos ou excesso de sobreposição	Reduza potência ou reposicione APs	Desenhando mapas de calor Wi-Fi com ferramentas abertas
Itens aparecem como 'Not supported'	Chave incorreta ou macro não definida no host	Revise a chave do item e defina as macros obrigatórias no host	Desenhando templates e itens: padronização e eficiência
Trigger dispara para todos os hosts ao mesmo tempo	Expressão da trigger genérica demais ou erro de macro	Ajuste a expressão da trigger e confira o valor das macros em cada host	Desenhando templates e itens: padronização e eficiência
Dados não coletados de hosts específicos	Template correto, mas agente ou SNMP não configurado no host	Verifique a configuração do agente Zabbix ou SNMP no host	Desenhando templates e itens: padronização e eficiência
Ping interno funciona, externo não	NAT ou rota default ausente	Revisar configuração de NAT e gateway padrão	Diagnóstico de falhas de conectividade: ferramentas nativas
VPN conecta, mas não trafega	Falta de rota ou regra de firewall	Adicionar rota e liberar tráfego nas regras	Diagnóstico de falhas de conectividade: ferramentas nativas
Rede segmentada não se comunica	Regras de firewall entre VLANs ausentes	Criar regras de passagem entre as VLANs	Diagnóstico de falhas de conectividade: ferramentas nativas
Dashboard não mostra dados	Filtros errados ou tabela vazia	Revise filtros e confirme carga de dados	Diagnóstico de falhas em dashboards e consultas no Metabase
Erro de permissão em consulta	Usuário sem SELECT na tabela	Conceda permissão com GRANT SELECT	Diagnóstico de falhas em dashboards e consultas no Metabase
Dashboard lento	Query sem índice ou mal escrita	Otimizar query e criar índices	Diagnóstico de falhas em dashboards e consultas no Metabase
Erro de sintaxe SQL	Coluna ou tabela inexistente	Verifique nomes no esquema do PostgreSQL	Diagnóstico de falhas em dashboards e consultas no Metabase
Dashboards do Superset lentos ou travando	Falta de RAM ou CPU no servidor PostgreSQL ou Superset.	Aumente recursos ou otimize queries e índices.	Dimensionamento do PostgreSQL e Superset para BI de supermer
Erros de conexão no Superset	Limite de max_connections atingido no PostgreSQL.	Reduza consultas simultâneas ou implemente pool de conexões.	Dimensionamento do PostgreSQL e Superset para BI de supermer
Crescimento rápido do uso de disco	Tabelas fato acumulando dados históricos sem particionamento.	Implemente particionamento ou arquivamento periódico.	Dimensionamento do PostgreSQL e Superset para BI de supermer
Alertas atrasados ou não enviados	Fila de processamento alta, falta de CPU ou disco lento	Aumente CPU/RAM, migre banco para SSD, revise intervalos de coleta	Dimensionando hardware e rede para o Zabbix
Proxy desconectando do Server	Latência de rede alta ou banda insuficiente	Ajuste DataSenderFrequency, melhore o link ou reduza frequência de coleta	Dimensionando hardware e rede para o Zabbix
Servidor com swap constante	RAM insuficiente	Aumente a memória física do servidor	Dimensionando hardware e rede para o Zabbix
Banco de dados crescendo rápido demais	Itens com coleta muito frequente ou retenção alta	Revise intervalos e política de history/trends	Dimensionando hardware e rede para o Zabbix
Consultas lentas mesmo com poucos usuários	Parâmetros de memória subdimensionados ou falta de índices	Aumente shared_buffers e crie índices nas colunas mais filtradas	Dimensionando o PostgreSQL para BI de supermercado
Banco ocupando muito disco rapidamente	Granularidade excessiva ou falta de limpeza de dados antigos	Reveja a granularidade e implemente políticas de retenção	Dimensionando o PostgreSQL para BI de supermercado
Erro de falta de espaço em disco durante carga	Provisionamento inicial insuficiente	Expanda o volume de armazenamento antes de novas cargas	Dimensionando o PostgreSQL para BI de supermercado
Dashboard vazio ou com dados desatualizados	Falha na extração ou agendamento do extrator	Verifique logs do extrator Python e se o cron está ativo	Do dado bruto ao dashboard: fluxo de extração, modelagem e v
Erro de conexão no Superset	Driver psycopg2 ausente ou URI incorreta	Confirme instalação do driver e dados de conexão	Do dado bruto ao dashboard: fluxo de extração, modelagem e v
Dados inconsistentes entre API e banco	Transformação incompleta ou erro de mapeamento	Revise scripts de transformação e tipos de dados	Do dado bruto ao dashboard: fluxo de extração, modelagem e v
Script falha com erro de autenticação	Token expirado ou inválido	Gere um novo token no Bluesoft ERP e atualize o script	Do Python ao dashboard: extração agendada da API, carga incr
Dados duplicados no PostgreSQL	Falta de chave primária ou upsert mal implementado	Implemente ON CONFLICT DO UPDATE e defina chaves primárias	Do Python ao dashboard: extração agendada da API, carga incr
Dashboards não atualizam após carga	Cache do Superset muito longo	Reduza tempo de expiração do cache ou force refresh	Do Python ao dashboard: extração agendada da API, carga incr
Script não roda no horário	Erro na configuração do cron ou permissões	Revise o crontab e permissões do usuário	Do Python ao dashboard: extração agendada da API, carga incr
Equipamento não identificado durante manutenção	Falta de rotulagem física ou lógica	Revisar e padronizar etiquetas e nomes	Documentação e rotulagem: o que nunca pode faltar
Divergência entre IP/documentação	Documentação desatualizada	Atualizar imediatamente após alterações	Documentação e rotulagem: o que nunca pode faltar
Change log incompleto	Falta de disciplina no registro de mudanças	Treinar equipe e auditar periodicamente	Documentação e rotulagem: o que nunca pode faltar
Cabo desconectado errado	Etiqueta ilegível ou ausente	Substituir etiquetas e revisar padrão	Documentação e rotulagem: o que nunca pode faltar
SSID não segue padrão	Configuração manual sem revisão	Padronizar e documentar nomes	Documentação e rotulagem: o que nunca pode faltar
Equipamento não identificado durante manutenção	Falta de rotulagem física ou lógica	Revisar e padronizar etiquetas e nomes	Documentação e rotulagem: o que nunca pode faltar
Divergência entre IP/documentação	Documentação desatualizada	Atualizar imediatamente após alterações	Documentação e rotulagem: o que nunca pode faltar
Change log incompleto	Falta de disciplina no registro de mudanças	Treinar equipe e auditar periodicamente	Documentação e rotulagem: o que nunca pode faltar
Cabo desconectado errado	Etiqueta ilegível ou ausente	Substituir etiquetas e revisar padrão	Documentação e rotulagem: o que nunca pode faltar
SSID não segue padrão	Configuração manual sem revisão	Padronizar e documentar nomes	Documentação e rotulagem: o que nunca pode faltar
Lint acusa falta de documentação em tasks	Ausência de comentários explicativos	Inclua comentários detalhando o objetivo e o motivo da task	Documentação viva: como garantir que playbooks não virem cai
README desatualizado	Mudanças recentes não refletidas no README	Atualize o README sempre que alterar variáveis ou fluxos principais	Documentação viva: como garantir que playbooks não virem cai
Variáveis com nomes confusos	Falta de padrão de nomenclatura	Renomeie variáveis seguindo o padrão escopo_objeto_ação	Documentação viva: como garantir que playbooks não virem cai
Dificuldade para entender o fluxo do playbook	Falta de exemplos e comentários	Inclua exemplos de execução e comentários explicativos	Documentação viva: como garantir que playbooks não virem cai
Script de extração falha após alteração	Alteração não documentada ou parâmetro novo não registrado	Revise changelog e docstring para identificar mudanças recentes	Documentação viva: como manter o pipeline compreensível e au
Dashboard apresenta dados inconsistentes	Query SQL alterada sem registro	Verifique histórico de commits e comentários na query	Documentação viva: como manter o pipeline compreensível e au
Novo analista não entende fluxo de dados	README ou changelog desatualizado	Atualize documentação e padronize nomenclaturas	Documentação viva: como manter o pipeline compreensível e au
Documentação desatualizada após mudanças	Falta de processo de atualização após cada alteração	Implemente checklist obrigatório para atualizar registros após qualquer mudança relevante	Documentação viva: como registrar e padronizar configurações
Confusão com nomes de regras ou interfaces	Ausência de padrão de nomenclatura	Reforce o uso de convenções e revise periodicamente	Documentação viva: como registrar e padronizar configurações
Perda de histórico de configurações	Backups não versionados ou salvos localmente	Centralize backups em repositório git privado	Documentação viva: como registrar e padronizar configurações
Item sem descrição ou com informação desatualizada	Falta de rotina de atualização	Implemente checklist de revisão periódica	Documentação viva: mantendo o monitoramento compreensível
Equipe não encontra documentação	Ferramenta mal divulgada ou acesso restrito	Divulgue o local da documentação e revise permissões	Documentação viva: mantendo o monitoramento compreensível
Desalinhamento entre configuração e documentação	Alterações feitas sem atualizar registro	Inclua atualização documental como etapa obrigatória de mudanças	Documentação viva: mantendo o monitoramento compreensível
Histórico de alterações perdido	Documentação em arquivos soltos sem versionamento	Migre para ferramenta com controle de versão, como Wiki.js ou Git	Documentação viva: mantendo o monitoramento compreensível
Clientes aparecem duplicados nos relatórios	Chave duplicada na importação ou ausência de campo único	Garanta uso de CPF/CNPJ como chave e revise o processo de upsert	Enriquecendo o modelo: integrando clientes, produtos e lojas
Produtos com nomes diferentes mas mesmo código	Atualização incompleta da dimensão produto	Implemente upsert e revise a lógica de atualização	Enriquecendo o modelo: integrando clientes, produtos e lojas
Consultas lentas no Superset	Falta de índices nas tabelas de dimensão ou fato	Crie índices nos campos usados em JOINs e WHERE	Enriquecendo o modelo: integrando clientes, produtos e lojas
Permission denied (publickey,password)	Chave pública ausente ou permissões incorretas	Adicione a chave correta e ajuste permissões dos arquivos	Erros comuns em produção: do SSH ao YAML malformatado
mapping values are not allowed here	Erro de indentação ou uso de tab em YAML	Corrija a indentação, use apenas espaços	Erros comuns em produção: do SSH ao YAML malformatado
Tarefas sempre reportam 'changed'	Módulo ou comando não idempotente	Troque por módulo idempotente adequado	Erros comuns em produção: do SSH ao YAML malformatado
Erro 401 Unauthorized ao acessar a API	Token ausente, inválido ou expirado.	Gere um novo token no ERP e atualize a configuração do extrator.	Erros comuns na extração da API e como resolver
Erro 429 Too Many Requests	Limite de requisições da API excedido.	Implemente espera entre as requisições e monitore o volume de chamadas.	Erros comuns na extração da API e como resolver
Dados incompletos no PostgreSQL após carga	Falta de paginação ou falha silenciosa em algumas páginas.	Revise o loop de extração e valide o total de registros por página.	Erros comuns na extração da API e como resolver
Erro 401 ao acessar a API	Token inválido, expirado ou ausente	Atualize o token e confira se está no cabeçalho x-CustomToken	Erros comuns na integração com a API do Bluesoft ERP: diagnó
Erro 429 Too Many Requests	Excesso de requisições em curto intervalo	Reduza a frequência e implemente espera entre tentativas	Erros comuns na integração com a API do Bluesoft ERP: diagnó
Erro 404 Not Found	Recurso não existe ou endpoint incorreto	Consulte o api-docs do tenant para o caminho correto	Erros comuns na integração com a API do Bluesoft ERP: diagnó
Dados incompletos após extração	Paginação ignorada ou incompleta	Implemente laço para percorrer todas as páginas	Erros comuns na integração com a API do Bluesoft ERP: diagnó
Erro 403 Forbidden	Usuário sem permissão no ERP	Solicite ajuste de permissões ao administrador	Erros comuns na integração com a API do Bluesoft ERP: diagnó
Consultas lentas mesmo após particionamento	Falta de índices adequados ou partições mal definidas	Reveja os índices e a estratégia de particionamento	Escalando o PostgreSQL e Superset: limites práticos e estrat
Erros de conexão no Superset	Pool de conexões excedendo o max_connections do PostgreSQL	Reduza o pool do Superset ou aumente max_connections	Escalando o PostgreSQL e Superset: limites práticos e estrat
Uso excessivo de memória no PostgreSQL	work_mem alto demais para o número de conexões	Ajuste work_mem e monitore o consumo	Escalando o PostgreSQL e Superset: limites práticos e estrat
Consultas continuam lentas após particionamento	Falta de índices adequados ou consultas não filtram pela coluna particionada	Crie índices relevantes e ajuste queries para filtrar por data	Escalando o PostgreSQL: partições, índices e tuning básico
Espaço em disco cresce rapidamente	Vacuum insuficiente ou partições antigas não removidas	Agende vacuum e exclua partições obsoletas	Escalando o PostgreSQL: partições, índices e tuning básico
Erro ao criar partição	Intervalo de valores sobreposto ou já existente	Verifique os intervalos e ajuste as datas das partições	Escalando o PostgreSQL: partições, índices e tuning básico
Failover não funciona após queda do link principal	Monitor IP configurado incorretamente ou NAT mascarando falha	Ajuste o Monitor IP para um endereço externo confiável	Escalando para múltiplas lojas: links, failover e balanceame
Balanceamento não distribui tráfego como esperado	Regras de firewall não usam o grupo de gateways	Configure as regras LAN para usar o gateway group	Escalando para múltiplas lojas: links, failover e balanceame
Alertas de falha falsos	Monitor IP respondendo intermitente ou bloqueado	Troque o Monitor IP para outro destino estável	Escalando para múltiplas lojas: links, failover e balanceame
Firewall lento ou travando em horários de pico	CPU ou RAM insuficientes para o tráfego ou recursos ativados	Rever sizing e migrar para hardware mais potente	Escolha de hardware e sizing: CPU, RAM, interfaces e storage
VPNs caindo sob carga	CPU sem AES-NI ou insuficiente	Trocar por processador com AES-NI e mais núcleos	Escolha de hardware e sizing: CPU, RAM, interfaces e storage
IDS/IPS não inicia	RAM insuficiente para as regras carregadas	Aumentar RAM ou reduzir regras	Escolha de hardware e sizing: CPU, RAM, interfaces e storage
Failover não funciona	Sincronização pfsync/XMLRPC mal configurada ou interfaces diferentes	Rever configuração e garantir hardware idêntico	Escolha de hardware e sizing: CPU, RAM, interfaces e storage
Interfaces de rede instáveis	Uso de placas Realtek ou drivers problemáticos	Trocar por placas Intel/Broadcom	Escolha de hardware e sizing: CPU, RAM, interfaces e storage
Erros de rate limit na extração	Frequência de requisições acima do permitido pela API	Reduza a velocidade do extrator ou aumente o intervalo entre execuções	Estimando volume e frequência: quanto e quando extrair da AP
Dados duplicados no banco	Extração sem controle de última data/hora processada	Implemente checkpoint de última extração e filtros por data	Estimando volume e frequência: quanto e quando extrair da AP
Buracos de dados em períodos de alta venda	Volume por janela maior que o planejado, levando a falhas ou timeouts	Divida a extração em janelas menores e monitore o volume real	Estimando volume e frequência: quanto e quando extrair da AP
Execução lenta ou travada	forks muito baixo ou serial alto demais	Aumente forks ou diminua serial	Estratégias para execução paralela e balanceamento de carga
Erros de conexão em vários hosts	Rede saturada ou forks alto demais	Reduza forks e teste a rede	Estratégias para execução paralela e balanceamento de carga
Control node consumindo toda a RAM	forks alto demais para o hardware disponível	Reduza forks e otimize playbooks	Estratégias para execução paralela e balanceamento de carga
Playbook para em um host problemático	serial igual a 1 ou erro não tratado	Aumente serial ou trate falhas com ignore_errors	Estratégias para execução paralela e balanceamento de carga
Erro de permissão ao acessar arquivos do Vault	Permissões de arquivo ou usuário incorretos	Ajuste as permissões com chmod e garanta que só usuários autorizados tenham acesso	Estrutura de diretórios e arquivos: o que separa um projeto
Inventário não reconhecido pelo Ansible	Caminho incorreto no comando ou ansible.cfg	Verifique o caminho do inventário e ajuste o ansible.cfg se necessário	Estrutura de diretórios e arquivos: o que separa um projeto
Roles não encontradas	Diretório roles fora do caminho padrão	Ajuste o parâmetro roles_path no ansible.cfg ou mova as roles	Estrutura de diretórios e arquivos: o que separa um projeto
Senhas expostas em arquivos versionados	Variáveis sensíveis fora do Vault	Mova todas as variáveis sensíveis para arquivos criptografados e atualize o .gitignore	Estrutura de diretórios e arquivos: o que separa um projeto
PDVs desconectam após queda de energia	Conflito ou ausência de reserva de IP no DHCP	Configure reservas de IP para todos os PDVs	Falhas críticas: aprendendo com os erros dos outros
Rede Wi-Fi lenta em horários de pico	Interferência de canal ou excesso de dispositivos por AP	Redistribua APs e altere canais conforme análise de espectro	Falhas críticas: aprendendo com os erros dos outros
Setor inteiro sem rede	Switch travado ou sem redundância	Implemente redundância e teste failover periodicamente	Falhas críticas: aprendendo com os erros dos outros
PDVs desconectam após queda de energia	Conflito ou ausência de reserva de IP no DHCP	Configure reservas de IP para todos os PDVs	Falhas críticas: aprendendo com os erros dos outros
Rede Wi-Fi lenta em horários de pico	Interferência de canal ou excesso de dispositivos por AP	Redistribua APs e altere canais conforme análise de espectro	Falhas críticas: aprendendo com os erros dos outros
Setor inteiro sem rede	Switch travado ou sem redundância	Implemente redundância e teste failover periodicamente	Falhas críticas: aprendendo com os erros dos outros
Alertas não disparam mesmo com falha real	Trigger mal configurada ou item sem coleta de dados	Revise a expressão da trigger e confirme se o item está coletando dados	Falhas em PDVs e automação: como o Zabbix antecipa o caos
PDV aparece como 'não suportado'	Agente Zabbix não instalado ou configurado incorretamente	Verifique instalação e configuração do agente no PDV	Falhas em PDVs e automação: como o Zabbix antecipa o caos
Balança não responde via SNMP	SNMP desabilitado ou bloqueado por firewall	Habilite SNMP no equipamento e ajuste regras de firewall	Falhas em PDVs e automação: como o Zabbix antecipa o caos
PDV não conecta ao servidor	Gateway ou DNS incorreto	Corrija as configurações de rede do PDV	Falhas em PDVs e balanças: quando o problema é a rede
Balança perde conexão intermitente	Conflito de IP ou sinal Wi-Fi fraco	Ajuste o DHCP e melhore a cobertura Wi-Fi	Falhas em PDVs e balanças: quando o problema é a rede
PDV trava ao emitir nota	Porta do servidor fiscal bloqueada	Libere a porta no firewall	Falhas em PDVs e balanças: quando o problema é a rede
PDV não conecta ao servidor	Gateway ou DNS incorreto	Corrija as configurações de rede do PDV	Falhas em PDVs e balanças: quando o problema é a rede
Balança perde conexão intermitente	Conflito de IP ou sinal Wi-Fi fraco	Ajuste o DHCP e melhore a cobertura Wi-Fi	Falhas em PDVs e balanças: quando o problema é a rede
PDV trava ao emitir nota	Porta do servidor fiscal bloqueada	Libere a porta no firewall	Falhas em PDVs e balanças: quando o problema é a rede
Visitante consegue acessar sistemas internos	Regra de firewall ausente ou mal configurada	Revise as regras em /etc/config/firewall e aplique novamente	Firewall, WPA2-Enterprise e isolamento: bloqueando o que não
Usuário não consegue autenticar no Wi-Fi	Erro na configuração do FreeRADIUS ou credenciais erradas	Verifique logs do FreeRADIUS e revise o arquivo de usuários	Firewall, WPA2-Enterprise e isolamento: bloqueando o que não
Dispositivos ainda se veem na rede Wi-Fi	Isolamento de clientes não ativado	Confirme option isolate '1' no SSID e reinicie o serviço Wi-Fi	Firewall, WPA2-Enterprise e isolamento: bloqueando o que não
Visitante consegue acessar sistemas internos	Regra de firewall ausente ou mal configurada	Revise as regras em /etc/config/firewall e aplique novamente	Firewall, WPA2-Enterprise e isolamento: bloqueando o que não
Usuário não consegue autenticar no Wi-Fi	Erro na configuração do FreeRADIUS ou credenciais erradas	Verifique logs do FreeRADIUS e revise o arquivo de usuários	Firewall, WPA2-Enterprise e isolamento: bloqueando o que não
Dispositivos ainda se veem na rede Wi-Fi	Isolamento de clientes não ativado	Confirme option isolate '1' no SSID e reinicie o serviço Wi-Fi	Firewall, WPA2-Enterprise e isolamento: bloqueando o que não
Script Python retorna 401 Unauthorized	Token de autenticação inválido ou expirado	Gere um novo token no ERP e atualize a configuração	Fluxo de dados: da API do Bluesoft ao dashboard do Superset
Dados duplicados no PostgreSQL	Carregamento sem controle de incrementalidade	Implemente lógica de upsert ou deduplicação no script	Fluxo de dados: da API do Bluesoft ao dashboard do Superset
Superset não conecta ao banco	Driver psycopg2 ausente ou URI incorreta	Instale o driver e revise a string de conexão	Fluxo de dados: da API do Bluesoft ao dashboard do Superset
Aplicação não encontra variável de ambiente	Variável não definida no .env ou não passada para o container	Confirme o nome da variável e se o docker-compose está usando o env_file corretamente	Gerenciando credenciais e variáveis sensíveis: boas práticas
Token de API exposto em logs	Código faz print ou log de headers	Remova prints/logs de variáveis sensíveis do código	Gerenciando credenciais e variáveis sensíveis: boas práticas
Erro de autenticação na API do Bluesoft	Token expirado ou não atualizado após rotação	Gere novo token no ERP, atualize o .env e reinicie os containers	Gerenciando credenciais e variáveis sensíveis: boas práticas
Logs não aparecem no servidor central	Firewall local bloqueando saída UDP/514 ou configuração incorreta do syslog remoto	Libere a porta 514/UDP e revise a configuração em Status > System Logs > Settings	Gerenciando dezenas de firewalls: centralização, padronizaçã
Configuração não é aplicada em todos os firewalls	Falha de comunicação SSH ou erro no playbook Ansible	Teste conexão SSH e revise o playbook	Gerenciando dezenas de firewalls: centralização, padronizaçã
Usuário local consegue alterar regras globais	Permissões do grupo configuradas incorretamente	Revise privilégios em System > User Manager > Groups	Gerenciando dezenas de firewalls: centralização, padronizaçã
Serviço não inicia após playbook	Configuração inválida ou arquivo ausente	Verifique logs em /var/log e revise templates usados no playbook	Gerenciando serviços de loja: banco de dados, web e sistemas
Usuário do banco de dados não consegue conectar	Senha ou permissões incorretas	Reveja variáveis sensíveis e permissões do usuário no playbook	Gerenciando serviços de loja: banco de dados, web e sistemas
Servidor web não responde na porta 80	Firewall bloqueando ou configuração incorreta	Confirme regras de firewall e sintaxe dos arquivos de configuração	Gerenciando serviços de loja: banco de dados, web e sistemas
Erro 'Decryption failed' ao rodar playbook	Senha do Vault incorreta ou arquivo corrompido	Confirme a senha e regrave o arquivo Vault se necessário	Gerenciando variáveis, segredos e inventários em escala
Variáveis erradas aplicadas em hosts	Hierarquia de variáveis mal configurada	Revise nomes e precedência dos arquivos em group_vars e host_vars	Gerenciando variáveis, segredos e inventários em escala
Host novo não aparece no inventário	Script de atualização falhou ou fonte de dados desatualizada	Cheque logs do script e a fonte de dados central	Gerenciando variáveis, segredos e inventários em escala
Carga registrada como 'parcial' ou 'erro' na tabela de controle	Falha de conexão com a API ou erro no script de extração.	Verifique logs do extrator e revise a configuração do token e URL_RECURSO.	Governança de dados em BI: integridade, atualização e contro
Usuário vê dados de outras lojas no dashboard	Falta de configuração do filtro RLS no Superset.	Implemente e teste filtros RLS para cada role.	Governança de dados em BI: integridade, atualização e contro
Dados sensíveis aparecem completos nos dashboards	Falta de anonimização ou máscara no pipeline de dados.	Ajuste o script Python ou a consulta SQL para mascarar os campos sensíveis.	Governança de dados em BI: integridade, atualização e contro
Dados sensíveis ainda aparecem após o prazo de retenção.	Script de anonimização não está rodando ou foi configurado com intervalo incorreto.	Revise a lógica do script e agende execuções periódicas.	Governança de dados: versionamento, documentação e complianc
Token da API exposto no repositório.	Token foi salvo em arquivo versionado por engano.	Remova o arquivo do histórico do Git e reconfigure para usar variáveis de ambiente.	Governança de dados: versionamento, documentação e complianc
Dificuldade em rastrear alterações nos scripts.	Falta de versionamento ou mensagens de commit pouco claras.	Implemente Git e padronize mensagens de commit.	Governança de dados: versionamento, documentação e complianc
Senhas fracas ainda são aceitas	Configuração do PAM não foi aplicada corretamente	Revise o arquivo /etc/security/pwquality.conf e reinicie o serviço de autenticação	Hardening automatizado: reforçando servidores de loja
Serviços desnecessários continuam rodando	Serviço não foi incluído na lista da role ou nome incorreto	Confirme o nome do serviço com 'systemctl list-units --type=service' e ajuste a role	Hardening automatizado: reforçando servidores de loja
Logs não estão sendo gravados	rsyslog ou auditd não estão ativos	Verifique status com 'systemctl status rsyslog auditd' e revise as configurações	Hardening automatizado: reforçando servidores de loja
Não aparecem alertas	Assinaturas desatualizadas ou interface errada selecionada	Atualize as regras e revise a interface configurada	IDS/IPS com pfSense: Snort e Suricata na detecção de ameaças
Muitos falsos positivos	Regras muito genéricas ou não ajustadas ao ambiente	Ajuste as regras e use Suppress List	IDS/IPS com pfSense: Snort e Suricata na detecção de ameaças
Rede fica lenta após ativar IPS	Hardware insuficiente ou muitas regras ativas	Desative regras desnecessárias e avalie upgrade de hardware	IDS/IPS com pfSense: Snort e Suricata na detecção de ameaças
IPS não bloqueia ataques	Modo IPS não ativado ou regra configurada apenas para alertar	Habilite o bloqueio e revise as ações das regras	IDS/IPS com pfSense: Snort e Suricata na detecção de ameaças
Sinal fraco em áreas próximas ao AP	Obstáculo físico entre AP e dispositivo	Reposicione o AP ou remova obstáculos	Instalando access points: altura, posição e fixação
Queda de conexão em horários de pico	Interferência de outros equipamentos ou excesso de clientes conectados	Altere o canal do AP e distribua melhor os APs	Instalando access points: altura, posição e fixação
AP reinicia sozinho	Superaquecimento devido à má ventilação	Garanta espaço livre ao redor do AP e verifique a fonte de alimentação	Instalando access points: altura, posição e fixação
Sinal fraco em áreas próximas ao AP	Obstáculo físico entre AP e dispositivo	Reposicione o AP ou remova obstáculos	Instalando access points: altura, posição e fixação
Queda de conexão em horários de pico	Interferência de outros equipamentos ou excesso de clientes conectados	Altere o canal do AP e distribua melhor os APs	Instalando access points: altura, posição e fixação
AP reinicia sozinho	Superaquecimento devido à má ventilação	Garanta espaço livre ao redor do AP e verifique a fonte de alimentação	Instalando access points: altura, posição e fixação
ansible: command not found	Ansible não está no PATH ou o ambiente virtual não está ativado.	Ative o virtualenv ou adicione o diretório de binários ao PATH.	Instalando Ansible em ambientes Linux: escolha do método e c
Erro de dependência ao instalar via pip	Dependências do sistema ausentes.	Instale pacotes como libffi-dev e libssl-dev antes de rodar o pip.	Instalando Ansible em ambientes Linux: escolha do método e c
Versão do Ansible diferente da esperada	Múltiplas instalações ou conflito entre pip e pacote do sistema.	Remova instalações antigas e limpe o ambiente antes de reinstalar.	Instalando Ansible em ambientes Linux: escolha do método e c
Agente não aparece no servidor	Firewall bloqueando porta ou configuração incorreta do agente	Verifique portas abertas (ex: 10050 TCP Zabbix) e o parâmetro Server no agente.	Instalando e configurando Zabbix ou Prometheus via Ansible
Alertas não disparam	Triggers ou regras mal configuradas	Revise as condições e consulte logs do Zabbix ou Prometheus.	Instalando e configurando Zabbix ou Prometheus via Ansible
Serviço não inicia após instalação	Permissões ou dependências ausentes	Cheque logs do systemd e dependências do pacote.	Instalando e configurando Zabbix ou Prometheus via Ansible
Computador não recebe IP na LAN	Interface LAN não atribuída corretamente ou cabo errado	Revise as atribuições de interface e cabos físicos.	Instalando pfSense: ISO, mídia, primeiros passos e acesso in
Não acessa https://192.168.1.1	Firewall do sistema operacional bloqueando ou IP do computador fora da faixa	Desabilite firewall local e use DHCP.	Instalando pfSense: ISO, mídia, primeiros passos e acesso in
Instalação trava no boot	Mídia mal gravada ou hardware incompatível	Regrave a mídia e confira compatibilidade na documentação.	Instalando pfSense: ISO, mídia, primeiros passos e acesso in
Metabase não carrega no navegador	Container não iniciou ou porta 3000 está ocupada	Verifique logs com 'docker compose logs metabase' e libere a porta	Instalando PostgreSQL e Metabase via Docker: passo a passo
Erro de autenticação ao conectar ao PostgreSQL	Usuário ou senha incorretos nas variáveis de ambiente	Corrija o docker-compose.yml e reinicie os containers	Instalando PostgreSQL e Metabase via Docker: passo a passo
Dados do banco sumiram após reiniciar o container	Volume não foi configurado corretamente	Confirme o mapeamento do volume em docker-compose.yml	Instalando PostgreSQL e Metabase via Docker: passo a passo
Zabbix Server não inicia	Configuração errada do banco de dados ou permissões insuficientes.	Revise /etc/zabbix/zabbix_server.conf e os privilégios do usuário no banco.	Instalando Zabbix Server e Agent no Linux
Agent não responde ao teste	Firewall bloqueando porta 10050 ou serviço não iniciado.	Libere a porta e reinicie o serviço com 'sudo systemctl restart zabbix-agent'.	Instalando Zabbix Server e Agent no Linux
Erro ao importar schema	Senha ou usuário do banco incorretos.	Verifique as credenciais e tente novamente.	Instalando Zabbix Server e Agent no Linux
Carga incompleta ou faltando registros	Falha na paginação ou limite de taxa atingido	Revise o controle de paginação e implemente backoff exponencial para rate limit	Integração Bluesoft ERP + BI próprio: aprendizados de produç
Erros de chave estrangeira no PostgreSQL	Dimensões não carregadas ou dados faltantes	Garanta a carga das dimensões antes dos fatos e trate campos ausentes	Integração Bluesoft ERP + BI próprio: aprendizados de produç
Dashboards sem atualização	Falha no agendamento ou erro silencioso no extrator	Verifique logs de execução e status do agendador	Integração Bluesoft ERP + BI próprio: aprendizados de produç
Campos inesperados ou schema alterado	Mudança na API do Bluesoft	Atualize o extrator para lidar com novos campos e revise o mapeamento	Integração Bluesoft ERP + BI próprio: aprendizados de produç
Chamado não é criado no sistema de chamados	Token de API inválido ou permissão insuficiente.	Revise o token e as permissões do usuário técnico.	Integração com sistemas de chamados: do alerta à abertura au
Campos do chamado aparecem vazios	Macros do Zabbix não foram usadas corretamente no corpo da requisição.	Ajuste o corpo do Webhook para usar as macros corretas (ex: {TRIGGER.NAME}).	Integração com sistemas de chamados: do alerta à abertura au
Zabbix mostra erro HTTP 401 ou 403	Falha de autenticação na API do sistema de chamados.	Verifique headers de autenticação e token.	Integração com sistemas de chamados: do alerta à abertura au
Logs não chegam ao servidor Syslog	Firewall bloqueando porta 514/UDP ou erro no IP configurado	Libere a porta e revise o endereço do servidor	Integração com sistemas externos: Syslog, SNMP e Zabbix
SNMP não responde ao snmpwalk	Community incorreta ou IP do manager não autorizado	Corrija a community e autorize o IP na configuração SNMP	Integração com sistemas externos: Syslog, SNMP e Zabbix
Zabbix não coleta métricas do pfSense	Host SNMP mal configurado ou template incompatível	Revise configuração do host e template no Zabbix	Integração com sistemas externos: Syslog, SNMP e Zabbix
Dados de vendas não aparecem no Metabase	Tabela fato_venda_item vazia ou erro na extração	Revise logs do extrator Python e valide conexão com a API	Integrando dados de clientes, produtos e vendas: visão 360°
Clientes ou produtos aparecem como 'desconhecidos'	IDs não encontrados nas dimensões	Garanta que as tabelas dim_cliente e dim_produto estejam atualizadas antes de importar vendas	Integrando dados de clientes, produtos e vendas: visão 360°
Erro de chave estrangeira ao inserir vendas	Referência a cliente ou produto inexistente	Implemente lógica de carga incremental: carregue dimensões antes dos fatos	Integrando dados de clientes, produtos e vendas: visão 360°
PDV não comunica com servidor	IP mudou ou conflito de IP	Verifique reserva DHCP e se não há IP duplicado	Integrando PDVs e balanças: requisitos de rede e IP fixo
Balança fica offline intermitente	Latência alta ou perda de pacotes	Teste cabos, sinal Wi-Fi e ajuste QoS	Integrando PDVs e balanças: requisitos de rede e IP fixo
PDV aparece em rede de convidados	VLAN ou SSID incorreto	Reconfigure VLAN/SSID e isole o dispositivo	Integrando PDVs e balanças: requisitos de rede e IP fixo
QoS não prioriza PDV	Regra DSCP ausente ou errada	Revise iptables e configuração do sqm-scripts	Integrando PDVs e balanças: requisitos de rede e IP fixo
PDV não comunica com servidor	IP mudou ou conflito de IP	Verifique reserva DHCP e se não há IP duplicado	Integrando PDVs e balanças: requisitos de rede e IP fixo
Balança fica offline intermitente	Latência alta ou perda de pacotes	Teste cabos, sinal Wi-Fi e ajuste QoS	Integrando PDVs e balanças: requisitos de rede e IP fixo
PDV aparece em rede de convidados	VLAN ou SSID incorreto	Reconfigure VLAN/SSID e isole o dispositivo	Integrando PDVs e balanças: requisitos de rede e IP fixo
QoS não prioriza PDV	Regra DSCP ausente ou errada	Revise iptables e configuração do sqm-scripts	Integrando PDVs e balanças: requisitos de rede e IP fixo
Ativo crítico ficou fora do inventário	Levantamento incompleto ou falta de comunicação com áreas envolvidas	Refaça a varredura e consulte todos os responsáveis	Inventário e requisitos: o que monitorar e por quê
Alertas demais sem impacto real	Métricas irrelevantes ou thresholds mal definidos	Revise critérios e ajuste thresholds	Inventário e requisitos: o que monitorar e por quê
Falhas não detectadas pelo Zabbix	Itens de monitoramento ausentes ou configurados de forma inadequada	Inclua itens críticos e valide as configurações	Inventário e requisitos: o que monitorar e por quê
Host não aparece no grupo esperado	Erro de indentação no YAML ou grupo mal definido no INI	Revise a estrutura do arquivo e corrija a indentação ou nomes de grupos	Inventário: a chave para orquestrar ambientes complexos
Variável não aplicada ao host	Variável definida no grupo errado ou sobrescrita por outra	Verifique precedência de variáveis e ajuste o local de definição	Inventário: a chave para orquestrar ambientes complexos
Erro de permissão ao rodar inventário dinâmico	Script sem permissão de execução ou caminho errado para Python	Dê permissão de execução com 'chmod +x' e confira o shebang	Inventário: a chave para orquestrar ambientes complexos
Item ICMP sempre como 'Not supported'	Firewall bloqueando ICMP ou host offline.	Libere ICMP no firewall e teste conectividade.	Itens, triggers e ações: monitoramento que faz sentido
Itens SNMP retornam 'Timeout' ou 'No Such Object'	OID incorreto ou community SNMP errada.	Verifique OID e community no equipamento e no item.	Itens, triggers e ações: monitoramento que faz sentido
Triggers nunca disparam mesmo com falha real	Expressão de trigger errada ou item sem coleta.	Revise expressão e confirme coleta de dados.	Itens, triggers e ações: monitoramento que faz sentido
Dispositivo não conecta em área crítica	Área não foi mapeada corretamente no levantamento	Refaça o mapeamento físico e ajuste o projeto	Levantamento de requisitos: o que perguntar antes de desenha
Rede de convidados interfere nos PDVs	Falta de segmentação ou QoS	Implemente VLANs e priorização de tráfego	Levantamento de requisitos: o que perguntar antes de desenha
Compliance PCI DSS não atendido	Requisitos não levantados ou ignorados	Revise as exigências e ajuste a segmentação e logging	Levantamento de requisitos: o que perguntar antes de desenha
Dispositivo não conecta em área crítica	Área não foi mapeada corretamente no levantamento	Refaça o mapeamento físico e ajuste o projeto	Levantamento de requisitos: o que perguntar antes de desenha
Rede de convidados interfere nos PDVs	Falta de segmentação ou QoS	Implemente VLANs e priorização de tráfego	Levantamento de requisitos: o que perguntar antes de desenha
Compliance PCI DSS não atendido	Requisitos não levantados ou ignorados	Revise as exigências e ajuste a segmentação e logging	Levantamento de requisitos: o que perguntar antes de desenha
Alertas atrasados ou não enviados	Problemas de conexão com agente ou proxy	Verifique logs do agente/proxy e conectividade de rede	Logs do Zabbix: o que procurar quando tudo parece normal (ma
Itens sem dados ou gráficos com buracos	Item mal configurado ou timeout de coleta	Procure mensagens 'unsupported item key' ou 'timeout' no log	Logs do Zabbix: o que procurar quando tudo parece normal (ma
Zabbix não inicia	Permissão incorreta no arquivo de log ou banco de dados indisponível	Ajuste permissões e cheque status do banco	Logs do Zabbix: o que procurar quando tudo parece normal (ma
Logs sumindo rapidamente	Tamanho do arquivo de log muito pequeno	Aumente o 'Log File Size' em Status > System Logs > Settings	Logs, gráficos e relatórios: o que monitorar no dia a dia da
Não recebe alertas por e-mail	Configuração SMTP incorreta ou bloqueio do provedor	Revise usuário, senha, porta e teste com outro servidor SMTP	Logs, gráficos e relatórios: o que monitorar no dia a dia da
Gráficos de tráfego não aparecem	RRD graphs desativados ou problema de permissão	Ative RRD graphs em Status > Monitoring e verifique permissões	Logs, gráficos e relatórios: o que monitorar no dia a dia da
Task com loop executa para todos os itens, mesmo quando não deveria	Condicional mal aplicada ou variável mal definida	Revise o uso do 'when' e garanta que a expressão usa variáveis corretas	Loops, condicionais e handlers: a diferença entre playbook t
Handler executa sempre, mesmo sem mudanças	Task notificadora não está marcada como 'changed_only: true' (padrão), ou módulo sempre marca como mudado	Verifique se o módulo realmente detecta mudanças; prefira módulos idempotentes	Loops, condicionais e handlers: a diferença entre playbook t
Erro de sintaxe em condicional	Uso de '{{ }}' dentro do 'when' ou referência a variável inexistente	Remova as chaves duplas e confira se a variável existe no contexto	Loops, condicionais e handlers: a diferença entre playbook t
Erro de permissão ao restaurar backup	Usuário do PostgreSQL sem privilégio CREATEDB ou acesso ao arquivo	Garanta privilégios adequados e caminho correto do arquivo	Manutenção preventiva e evolução do ambiente BI
Metabase não conecta ao PostgreSQL após atualização	Variáveis de ambiente incorretas ou credenciais inválidas	Revise todas as variáveis MB_DB_* e teste conexão manualmente	Manutenção preventiva e evolução do ambiente BI
Dashboards sumiram após atualização	Banco de dados de aplicação do Metabase não foi apontado corretamente	Confirme que o Metabase está usando o mesmo banco PostgreSQL da instância anterior	Manutenção preventiva e evolução do ambiente BI
Mapa não exibe status atualizado	Trigger mal configurada ou item sem coleta recente	Verifique se o item está ativo e se a trigger está correta	Mapas e dashboards: visualização para operação rápida
Dashboard não mostra widgets	Permissões insuficientes ou filtro incorreto	Revise permissões do usuário e filtros dos widgets	Mapas e dashboards: visualização para operação rápida
Elementos do mapa não mudam de cor	Trigger não atribuída ao link ou elemento	Associe a trigger correta ao link/elemento no mapa	Mapas e dashboards: visualização para operação rápida
Host não aparece online no Zabbix	Agente Zabbix não está rodando ou firewall bloqueando porta	Verifique serviço do agente e libere porta 10050/TCP	Mapeando a rede: dispositivos críticos e pontos de monitoram
Switch não retorna dados SNMP	SNMP não habilitado ou comunidade incorreta	Habilite SNMP no switch e ajuste comunidade para 'public' ou a configurada	Mapeando a rede: dispositivos críticos e pontos de monitoram
Latência alta entre segmentos	Problema de roteamento ou congestionamento de link	Revise rotas, priorize tráfego crítico e monitore uso de banda	Mapeando a rede: dispositivos críticos e pontos de monitoram
Tabelas de RFM ou cesta de compras não atualizam	Falha no agendamento ou erro no script Python	Verifique logs do script, permissões do usuário do banco e status do cron ou APScheduler	Marketing orientado a dados: recorrência, RFM e cesta de com
Dados inconsistentes entre ERP e banco bi_varejo	Erro de extração ou transformação	Reavalie o mapeamento dos campos e revise o script de ETL	Marketing orientado a dados: recorrência, RFM e cesta de com
Listas de clientes não chegam ao CRM	Falha na exportação ou integração com o CRM	Teste a exportação manualmente e revise as credenciais e endpoints do CRM	Marketing orientado a dados: recorrência, RFM e cesta de com
Leads não aparecem no CRM após exportação.	Falha na autenticação da API do CRM ou payload mal formatado.	Verifique o token e o formato dos dados enviados.	Marketing orientado a dados: recorrência, RFM e cesta de com
Consultas SQL retornam resultados vazios.	Dados não carregados corretamente no bi_varejo.	Confirme a execução do ETL e a integridade das tabelas.	Marketing orientado a dados: recorrência, RFM e cesta de com
Script Python falha com erro de conexão.	Credenciais ou parâmetros incorretos na conexão PostgreSQL.	Revise usuário, senha, host e permissões do banco.	Marketing orientado a dados: recorrência, RFM e cesta de com
Dashboards demoram a carregar mesmo com poucos usuários	Pool de conexões baixo ou falta de RAM	Aumente MB_DB_CONNECTION_POOL_SIZE e adicione RAM	Metabase em produção: requisitos e sizing para dashboards rá
Erros de conexão ao banco de aplicação	Credenciais erradas ou banco indisponível	Revise variáveis de ambiente e conectividade do banco	Metabase em produção: requisitos e sizing para dashboards rá
Cache não acelera consultas	Tempo de cache muito baixo ou queries não cacheáveis	Ajuste tempo de cache nas configurações do Metabase	Metabase em produção: requisitos e sizing para dashboards rá
Usuários veem dashboards que não deveriam	Permissões de grupo mal configuradas	Revise permissões em Administração > Grupos	Metabase para múltiplos usuários e dashboards simultâneos
Erros de 'Too many connections'	Limite de conexões do Metabase ou PostgreSQL excedido	Ajuste MB_DB_CONNECTION_POOL_MAX_SIZE e max_connections no PostgreSQL	Metabase para múltiplos usuários e dashboards simultâneos
Dashboards lentos mesmo com poucos dados	Cache desativado ou mal dimensionado	Ajuste MB_CACHE_TTL conforme a frequência de atualização dos dados	Metabase para múltiplos usuários e dashboards simultâneos
Indicadores zerados ou inconsistentes na view	Relacionamento incorreto entre vendas e campanhas	Revise o ETL e as regras de associação entre vendas e campanhas	Métricas para campanhas e marketing: o que medir e como estr
View lenta ou travando no Superset	Falta de índices ou agregações pesadas em tempo real	Crie índices nas tabelas de fato e use views pré-agregadas	Métricas para campanhas e marketing: o que medir e como estr
Campanhas não aparecem nos dashboards	Dados de campanhas não carregados ou não relacionados aos itens vendidos	Verifique se a extração e a carga da dim_campanha estão corretas	Métricas para campanhas e marketing: o que medir e como estr
Consultas retornam valores duplicados ou inflados	JOINs incorretos entre fato_venda e fato_venda_item ou dimensões	Revise as chaves e garanta que os relacionamentos estão corretos	Modelagem de estudo: como o esquema bi_varejo suporta anális
Faltam campos para análise desejada	Campo não extraído da API ou não mapeado no modelo	Verifique a documentação da API e ajuste o extrator Python	Modelagem de estudo: como o esquema bi_varejo suporta anális
Dados de campanhas não aparecem nas vendas	Campanhas não associadas corretamente na extração	Confirme o mapeamento entre vendas e campanhas na API e no modelo	Modelagem de estudo: como o esquema bi_varejo suporta anális
Erro de chave estrangeira ao inserir venda	Cliente, loja ou campanha não existe na dimensão	Insira ou atualize a dimensão antes de inserir o fato	Modelagem do banco bi_varejo: fatos e dimensões para superme
Consultas lentas em dashboards	Falta de índices em colunas de filtro	Crie índices nos campos usados em WHERE e JOIN	Modelagem do banco bi_varejo: fatos e dimensões para superme
Dados duplicados em agregações	Pipeline de ETL inserindo vendas repetidas	Implemente deduplicação no extrator Python	Modelagem do banco bi_varejo: fatos e dimensões para superme
Dashboards do Superset não carregam ou demoram muito	Consultas SQL lentas ou banco sobrecarregado	Analise pg_stat_activity, otimize queries e revise índices	Monitoramento do Superset e PostgreSQL: disponibilidade, uso
Superset retorna erro 500 ou health check falha	Serviço travado ou banco fora do ar	Reinicie o Superset e verifique logs de erro	Monitoramento do Superset e PostgreSQL: disponibilidade, uso
postgres_exporter não coleta métricas	Permissões insuficientes no banco ou string de conexão errada	Ajuste permissões do usuário e revise DATA_SOURCE_NAME	Monitoramento do Superset e PostgreSQL: disponibilidade, uso
Log não é gerado ou está vazio	Handler não configurado ou permissão de escrita insuficiente	Revise configuração do logging e permissões do diretório.	Monitorando extrações da API: logs, alertas e métricas de su
Alertas não chegam	Configuração incorreta do SMTP ou bloqueio de firewall	Teste envio manual de e-mail e ajuste parâmetros do servidor.	Monitorando extrações da API: logs, alertas e métricas de su
Tabela de auditoria não é preenchida	Erro de conexão ou permissão insuficiente no PostgreSQL	Verifique string de conexão e privilégios do usuário.	Monitorando extrações da API: logs, alertas e métricas de su
Logs não aparecem no arquivo.	Handler do logger não configurado corretamente ou permissões de escrita insuficientes.	Revise a configuração do logger e permissões do diretório.	Monitorando extrações e cargas de dados com Python
Alertas não são enviados.	Falha na configuração SMTP ou bloqueio de firewall.	Teste envio manual de e-mail, revise credenciais e portas liberadas.	Monitorando extrações e cargas de dados com Python
Métricas de carga inconsistentes.	Erro na lógica de contagem ou falha silenciosa na inserção.	Inclua logs detalhados antes e depois de cada etapa; revise tratamento de exceções.	Monitorando extrações e cargas de dados com Python
Item SNMP retorna 'Timeout' ou 'No Such Object'	SNMP desativado, OID incorreto ou firewall bloqueando	Verifique SNMP no dispositivo, revise OID, ajuste firewall	Monitorando sistemas legados e automação via SNMP
Valores incoerentes ou zerados	OID errado ou conversão de unidade	Confirme OID e ajuste tipo/unidade no Zabbix	Monitorando sistemas legados e automação via SNMP
SNMPv3 não conecta	Usuário, senha ou protocolo incompatível	Reveja configurações e compatibilidade do dispositivo	Monitorando sistemas legados e automação via SNMP
Proxy aparece como inativo no painel	Firewall bloqueando porta 10051/tcp ou erro de configuração do parâmetro Server	Libere a porta 10051/tcp e revise o endereço do servidor central em zabbix_proxy.conf	Múltiplos proxies e arquitetura distribuída: monitorando dez
Dados dos hosts não aparecem no servidor central	Proxy não consegue enviar dados por falta de conexão ou erro no banco local	Verifique logs em /var/log/zabbix/zabbix_proxy.log e conectividade de rede	Múltiplos proxies e arquitetura distribuída: monitorando dez
Proxy consome muito disco	Volume de dados maior que o esperado ou retenção local insuficiente	Ajuste o espaço em disco ou revise intervalos de coleta e envio	Múltiplos proxies e arquitetura distribuída: monitorando dez
Serviço interno não acessível externamente	Regra de NAT ou firewall ausente ou incorreta	Revise as regras de NAT e firewall, valide portas e IPs	NAT e redirecionamento: acesso controlado a serviços interno
Acesso externo liberado para qualquer IP	Regra de firewall muito ampla (origem 'any')	Restringa a origem na regra de firewall	NAT e redirecionamento: acesso controlado a serviços interno
Dispositivos internos sem acesso à internet	Falta de regra de outbound NAT	Ative ou ajuste outbound NAT para a rede interna	NAT e redirecionamento: acesso controlado a serviços interno
Dashboard não mostra dados recentes	ETL não rodou ou falhou na extração	Verifique logs do ETL e status do cron ou orquestrador	Novidades do Apache Superset e tendências em BI open source
Erro de autenticação na API	Token expirado ou incorreto	Gere novo token no Bluesoft ERP e atualize o extrator	Novidades do Apache Superset e tendências em BI open source
Alertas do Superset não disparam	Condições de alerta mal configuradas ou e-mail não habilitado	Revise configuração dos alertas e SMTP	Novidades do Apache Superset e tendências em BI open source
Dashboard não mostra nova visualização	Versão antiga do Metabase	Atualize para a versão mais recente.	Novidades do Metabase e integração com outras ferramentas op
Dados não atualizam no Metabase	Pipeline ETL falhou ou não rodou	Verifique logs do Airflow e do script Python.	Novidades do Metabase e integração com outras ferramentas op
Erro de autenticação na API do Metabase	Token inválido ou expirado	Gere novo token e atualize o script de integração.	Novidades do Metabase e integração com outras ferramentas op
PDV desconectando frequentemente	Problemas de cabeamento ou switch sobrecarregado	Teste cabos, substitua portas e monitore o uso do switch	O que é uma rede de supermercado: funções e desafios reais
Coletores perdem conexão ao mudar de corredor	Roaming Wi-Fi mal configurado ou falta de overlap entre access points	Ajuste potência dos APs e canais, garanta overlap de 15-20%	O que é uma rede de supermercado: funções e desafios reais
Câmeras com vídeo travando	Banda insuficiente ou congestionamento na VLAN das câmeras	Separe VLANs e priorize tráfego de vídeo via QoS	O que é uma rede de supermercado: funções e desafios reais
Dados de vendas não batem com o relatório do ERP	A API retorna dados agregados ou faltam eventos (ex: cancelamentos)	Confirme a granularidade do recurso e consulte o api-docs para eventos ausentes	O que falta nas APIs de ERP para BI de supermercado: limites
Extração muito lenta	Limite baixo de paginação ou throttling da API	Implemente paralelismo com cautela e negocie aumento de limites com o fornecedor	O que falta nas APIs de ERP para BI de supermercado: limites
Campos importantes ausentes	API não expõe todos os detalhes necessários	Documente o gap e solicite evolução ao fornecedor	O que falta nas APIs de ERP para BI de supermercado: limites
Erro 401 ao acessar a API	Token inválido ou expirado	Gere um novo token e atualize a configuração	OpenAPI, API-first e o futuro da integração de dados em supe
Dados incompletos na extração	Paginação não tratada ou parâmetros incorretos	Revise a documentação e ajuste a lógica de paginação	OpenAPI, API-first e o futuro da integração de dados em supe
Mudança inesperada no formato dos dados	Atualização da API sem ajuste no extrator	Verifique o api-docs do tenant e atualize o script	OpenAPI, API-first e o futuro da integração de dados em supe
Túnel não sobe	Chave compartilhada ou PSK incorreta, IPs errados ou porta bloqueada	Revise a configuração dos peers, chaves e regras de firewall	OpenVPN e IPsec: criando VPN site-to-site entre matriz e fil
Túnel sobe, mas não há tráfego	Faltam regras de firewall ou rotas	Adicione regras de passagem nas interfaces VPN e revise rotas	OpenVPN e IPsec: criando VPN site-to-site entre matriz e fil
Conexão instável ou queda frequente	Problemas de MTU, perda de pacotes ou instabilidade do link	Ajuste MTU, monitore qualidade do link e revise logs	OpenVPN e IPsec: criando VPN site-to-site entre matriz e fil
Host não aparece na busca	Nome fora do padrão ou erro de digitação	Renomeie o host conforme o padrão estabelecido	Padronização de nomenclatura, templates e permissões
Usuário não consegue editar itens	Permissão insuficiente no grupo de usuários	Ajuste permissões em Administration > User groups	Padronização de nomenclatura, templates e permissões
Template foi alterado e hosts pararam de coletar dados	Alteração incompatível ou erro no template	Restaure versão anterior do template a partir do backup XML	Padronização de nomenclatura, templates e permissões
Dispositivo do PDV acessa a internet mas também a rede de visitantes	Firewall ou VLAN mal configurada	Revise as regras de firewall e a atribuição de VLANs no switch e roteador	PDV, PCI DSS e segmentação: por que segurança não é opcional
PDV não acessa o servidor central	Regra de firewall bloqueando tráfego legítimo	Ajuste as regras para permitir apenas o tráfego necessário	PDV, PCI DSS e segmentação: por que segurança não é opcional
Dispositivos não recebem IP nas VLANs	DHCP não configurado para cada VLAN	Configure um pool de DHCP separado por VLAN	PDV, PCI DSS e segmentação: por que segurança não é opcional
Dispositivo do PDV acessa a internet mas também a rede de visitantes	Firewall ou VLAN mal configurada	Revise as regras de firewall e a atribuição de VLANs no switch e roteador	PDV, PCI DSS e segmentação: por que segurança não é opcional
PDV não acessa o servidor central	Regra de firewall bloqueando tráfego legítimo	Ajuste as regras para permitir apenas o tráfego necessário	PDV, PCI DSS e segmentação: por que segurança não é opcional
Dispositivos não recebem IP nas VLANs	DHCP não configurado para cada VLAN	Configure um pool de DHCP separado por VLAN	PDV, PCI DSS e segmentação: por que segurança não é opcional
Conexão cai ao andar pelo supermercado	Roaming mal configurado ou potência excessiva	Ajustar potência dos APs e revisar configuração de Fast Roaming	Perda de conexão, roaming falho e lentidão: diagnóstico rápi
Lentidão mesmo com sinal forte	Interferência ou canal sobreposto	Mudar canal e evitar sobreposição no 2.4 GHz	Perda de conexão, roaming falho e lentidão: diagnóstico rápi
PDV desconecta aleatoriamente	Perda de pacotes ou latência alta	Testar ping e ajustar canais e potência	Perda de conexão, roaming falho e lentidão: diagnóstico rápi
Dispositivo não troca de AP	SSID diferente ou banda incompatível	Padronizar SSID e bandas em todos os APs	Perda de conexão, roaming falho e lentidão: diagnóstico rápi
Conexão cai ao andar pelo supermercado	Roaming mal configurado ou potência excessiva	Ajustar potência dos APs e revisar configuração de Fast Roaming	Perda de conexão, roaming falho e lentidão: diagnóstico rápi
Lentidão mesmo com sinal forte	Interferência ou canal sobreposto	Mudar canal e evitar sobreposição no 2.4 GHz	Perda de conexão, roaming falho e lentidão: diagnóstico rápi
PDV desconecta aleatoriamente	Perda de pacotes ou latência alta	Testar ping e ajustar canais e potência	Perda de conexão, roaming falho e lentidão: diagnóstico rápi
Dispositivo não troca de AP	SSID diferente ou banda incompatível	Padronizar SSID e bandas em todos os APs	Perda de conexão, roaming falho e lentidão: diagnóstico rápi
Playbook falha com erro de autenticação	Token inválido ou permissões insuficientes	Revise o usuário API e permissões no pfSense	pfSense e o futuro: integração com orquestração, nuvem e IoT
Regras não aparecem após execução	API não habilitada ou endpoint incorreto	Confirme instalação e URL da API	pfSense e o futuro: integração com orquestração, nuvem e IoT
Tráfego IoT bloqueado indevidamente	Regra de firewall restritiva demais	Revise escopo e destino das regras de IoT	pfSense e o futuro: integração com orquestração, nuvem e IoT
Dispositivo não recebe IP reservado	MAC cadastrado incorretamente ou conflito de IP	Revise o cadastro do MAC e verifique se o IP está fora do range dinâmico	pfSense: o que é, de onde veio e por que virou padrão open s
Acesso negado mesmo com regra criada	Ordem das regras ou interface errada	Reordene as regras e confira se está aplicando na interface correta	pfSense: o que é, de onde veio e por que virou padrão open s
VPN não conecta	Porta bloqueada ou configuração de túnel incorreta	Libere as portas necessárias e revise a configuração do túnel	pfSense: o que é, de onde veio e por que virou padrão open s
Dados no Metabase não atualizam após a carga	Cache do Metabase ou falha na atualização do banco	Forçar atualização no Metabase e revisar logs do ETL	Pipeline de dados: da API Bluesoft ERP ao PostgreSQL e Metab
Script Python retorna erro 401 ao acessar a API	Token expirado ou inválido	Gerar novo token e atualizar variável de ambiente	Pipeline de dados: da API Bluesoft ERP ao PostgreSQL e Metab
Carga duplicada de registros no PostgreSQL	Falta de controle de atualização incremental	Implementar filtro por data/hora e chaves primárias	Pipeline de dados: da API Bluesoft ERP ao PostgreSQL e Metab
Erro 401 ou 403 ao acessar a API	Token inválido ou expirado	Gere um novo token na interface do Bluesoft ERP e atualize a configuração	Pipeline Python: extraindo dados da API Bluesoft ERP para o
Dados duplicados nas tabelas	Carga não idempotente ou ausência de chave primária	Implemente upsert e defina chaves primárias corretas	Pipeline Python: extraindo dados da API Bluesoft ERP para o
Timeout ou rate limit excedido	Muitas requisições em pouco tempo	Implemente retries com backoff e respeite limites da API	Pipeline Python: extraindo dados da API Bluesoft ERP para o
Falha de conexão com PostgreSQL	Credenciais erradas ou banco indisponível	Verifique usuário, senha e status do serviço PostgreSQL	Pipeline Python: extraindo dados da API Bluesoft ERP para o
Execução lenta mesmo com forks altos	Latência de rede alta ou tasks bloqueando I/O	Reduza forks ou execute por grupos menores	Planejamento de capacidade: limites do Ansible em ambientes
Erros de conexão SSH (Too many open files)	Limite do sistema operacional para arquivos abertos	Aumente o limite com ulimit ou reduza forks	Planejamento de capacidade: limites do Ansible em ambientes
Control node travando ou swapando	Falta de RAM devido a muitos forks	Reduza forks ou aumente RAM	Planejamento de capacidade: limites do Ansible em ambientes
Playbook não aplica em todos os hosts	Hosts não estão no inventário ou sem acesso SSH	Revise o arquivo de inventário e teste conexão com 'ansible all -m ping'	Por que automação é vital em supermercados: do estoque ao PD
Pacote não instala em alguns PDVs	Repositório não configurado ou rede bloqueada	Verifique conectividade e fontes do apt nos terminais	Por que automação é vital em supermercados: do estoque ao PD
Configuração diverge após playbook	Playbook não cobre todos os parâmetros necessários	Revise tasks e adicione verificações de estado	Por que automação é vital em supermercados: do estoque ao PD
Dados incompletos ou desatualizados no BI	Falha na extração ou limite de paginação não tratado	Reveja o script Python para tratar paginação e erros de API	Por que BI próprio? Limites do acesso e integração com Blues
Erro de autenticação ao acessar a API	Token expirado ou inválido	Gere um novo token em Administração > Segurança > Usuário	Por que BI próprio? Limites do acesso e integração com Blues
Tabelas do banco próprio vazias	Falha na conexão entre o script e o PostgreSQL	Teste a conexão e revise as credenciais do banco	Por que BI próprio? Limites do acesso e integração com Blues
Não recebe alerta de queda de PDV	Host não cadastrado corretamente ou trigger mal configurada	Revise o cadastro do host e a trigger no Zabbix	Por que monitorar supermercados: riscos, perdas e oportunida
Câmera aparece online, mas não transmite imagem	Monitoramento verifica só ICMP, não o serviço de vídeo	Inclua checagem de porta ou serviço HTTP/RTSP	Por que monitorar supermercados: riscos, perdas e oportunida
Alerta de temperatura não dispara	OID SNMP incorreto ou falta de permissão	Consulte a documentação do sensor e ajuste o SNMP community	Por que monitorar supermercados: riscos, perdas e oportunida
Resposta 401 Unauthorized ao acessar a API	Token inválido ou ausente no cabeçalho	Gere um novo token e confira o cabeçalho x-CustomToken	Por que não existe acesso direto ao banco do Bluesoft ERP: l
Resposta 404 Not Found para um recurso	Recurso não habilitado ou endpoint incorreto	Consulte o api-docs do seu tenant para o caminho correto	Por que não existe acesso direto ao banco do Bluesoft ERP: l
Dados incompletos ou faltando campos	Permissões insuficientes ou recurso não expõe todos os campos	Revise as permissões do token e consulte a documentação do recurso	Por que não existe acesso direto ao banco do Bluesoft ERP: l
POS não acessa a internet	Regra de firewall bloqueando tráfego de saída	Revise as regras na interface VLAN do POS e permita apenas o tráfego necessário	Por que supermercados precisam de firewall além do roteador:
Wi-Fi de clientes acessa rede interna	Segmentação insuficiente ou regra de firewall ausente	Crie VLAN separada para Wi-Fi de clientes e bloqueie acesso à LAN	Por que supermercados precisam de firewall além do roteador:
Logs não aparecem no servidor central	Configuração incorreta de syslog remoto	Verifique IP e porta do servidor syslog e ajuste em Status > System Logs > Settings	Por que supermercados precisam de firewall além do roteador:
Portal não aparece ao conectar	Interface errada ou domínios de detecção bloqueados	Verifique se o portal está vinculado à interface correta e libere domínios de detecção	Portal cativo para clientes: o que funciona e o que não func
PDVs ou balanças sem acesso à rede	Dispositivos críticos na VLAN de convidados	Mova esses dispositivos para VLAN interna sem portal	Portal cativo para clientes: o que funciona e o que não func
Clientes reclamam de desconexão frequente	Timeout de sessão muito curto	Aumente o tempo de sessão no portal cativo	Portal cativo para clientes: o que funciona e o que não func
Portal não aparece ao conectar	Interface errada ou domínios de detecção bloqueados	Verifique se o portal está vinculado à interface correta e libere domínios de detecção	Portal cativo para clientes: o que funciona e o que não func
PDVs ou balanças sem acesso à rede	Dispositivos críticos na VLAN de convidados	Mova esses dispositivos para VLAN interna sem portal	Portal cativo para clientes: o que funciona e o que não func
Clientes reclamam de desconexão frequente	Timeout de sessão muito curto	Aumente o tempo de sessão no portal cativo	Portal cativo para clientes: o que funciona e o que não func
Falha de autenticação SSH	Chave pública não copiada corretamente ou permissão errada em ~/.ssh/authorized_keys	Reenvie a chave com ssh-copy-id e verifique permissões (chmod 600 authorized_keys)	Primeiro playbook: provisionando servidores de loja via SSH
Erro 'sudo: a password is required'	Usuário remoto não tem sudo sem senha	Configure sudoers para NOPASSWD no usuário do Ansible	Primeiro playbook: provisionando servidores de loja via SSH
Pacote não instalado, mas playbook sem erro	Sistema operacional do host não é Debian/Ubuntu	Adapte o módulo do playbook para o sistema correto (ex: use 'yum' para CentOS)	Primeiro playbook: provisionando servidores de loja via SSH
Itens SNMP aparecem como 'Not supported'	Comunidade SNMP errada ou versão incompatível	Confirme comunidade e versão SNMP no host e no Zabbix	Primeiros passos: conectando dispositivos via SNMP e ICMP
Ping falha no Zabbix mas funciona no terminal	Firewall do host bloqueando ICMP do Zabbix Server	Libere ICMP apenas para o IP do Zabbix Server	Primeiros passos: conectando dispositivos via SNMP e ICMP
Dados SNMP intermitentes	Rede instável ou sobrecarga no dispositivo	Verifique latência e carga do equipamento	Primeiros passos: conectando dispositivos via SNMP e ICMP
Item SNMP retorna 'Timeout' no Zabbix	Comunidade SNMP errada ou porta bloqueada	Revise a configuração SNMP do host e libere UDP 161	Problemas clássicos: SNMP, ICMP e erros de coleta
Host aparece como 'unreachable' no Zabbix	ICMP bloqueado no firewall do host	Libere ICMP echo request	Problemas clássicos: SNMP, ICMP e erros de coleta
Dados SNMP aparecem de forma intermitente	Perda de pacotes ou timeout baixo	Aumente timeout e verifique a qualidade da rede	Problemas clássicos: SNMP, ICMP e erros de coleta
Dashboard demora para carregar	Query sem índice ou banco sobrecarregado	Crie índices e otimize queries	Problemas de performance e dados inconsistentes: onde olhar
Dados do Superset não batem com o ERP	Falha na extração ou lógica de carga	Reveja o extrator Python e compare totais	Problemas de performance e dados inconsistentes: onde olhar
Erro de conexão no Superset	Driver não instalado ou URI errada	Confirme psycopg2 no container e ajuste a URI	Problemas de performance e dados inconsistentes: onde olhar
Extrator Python para sem avisar	Exceções não tratadas	Adicione logs e tratamento de erros	Problemas de performance e dados inconsistentes: onde olhar
Consumo alto de CPU/memória no container	Query pesada ou falta de recursos	Otimize queries e ajuste limites do Docker	Problemas de performance e dados inconsistentes: onde olhar
Backup não restaura corretamente	Versão de firmware incompatível	Atualize o firmware ou use backup compatível	Procedimentos de backup e contingência
Arquivo de backup corrompido	Transferência interrompida ou armazenamento falho	Refaça o backup e valide com hash	Procedimentos de backup e contingência
Configuração restaurada, mas rede não sobe	Permissões ou dependências não restauradas	Verifique permissões e reinicie serviços	Procedimentos de backup e contingência
Backup não restaura corretamente	Versão de firmware incompatível	Atualize o firmware ou use backup compatível	Procedimentos de backup e contingência
Arquivo de backup corrompido	Transferência interrompida ou armazenamento falho	Refaça o backup e valide com hash	Procedimentos de backup e contingência
Configuração restaurada, mas rede não sobe	Permissões ou dependências não restauradas	Verifique permissões e reinicie serviços	Procedimentos de backup e contingência
Host aparece como 'Unavailable' após ativar TLS	Nome no certificado diferente do cadastrado no Host	Ajuste o campo Hostname no Agent e na interface web para coincidir exatamente	Protegendo a comunicação: TLS no Zabbix Server, Proxy e Agen
Erro de 'SSL routines:tls_process_server_certificate:certificate verify failed'	CA não instalada ou caminho errado no TLSCAFile	Verifique o caminho e permissões do arquivo CA	Protegendo a comunicação: TLS no Zabbix Server, Proxy e Agen
Agent ou Proxy não inicia após configuração	Permissões incorretas nos arquivos de chave privada	Aplique chmod 600 nos arquivos .key	Protegendo a comunicação: TLS no Zabbix Server, Proxy e Agen
Acesso administrativo bloqueado após ajuste de firewall	Regra anti-lockout removida sem regra alternativa	Acesse via console local, reative anti-lockout ou crie regra de permissão	Protegendo contra ataques: DoS, spoofing e ameaças internas
Dispositivos legítimos não recebem IP	MAC não cadastrado em ARP estático	Adicione MAC do dispositivo em DHCP Static Mappings	Protegendo contra ataques: DoS, spoofing e ameaças internas
Tráfego legítimo bloqueado por lista negra	IP legítimo adicionado erroneamente à blacklist	Remova IP da lista negra e revise critérios de adição	Protegendo contra ataques: DoS, spoofing e ameaças internas
Usuário do Superset não enxerga tabelas	Permissão insuficiente no PostgreSQL ou role errada no Superset	Revise GRANT no banco e role do usuário no Superset	Protegendo o PostgreSQL e o Superset: autenticação, roles e
Backup falha por permissão negada	Usuário do backup não tem ALL PRIVILEGES	Use admin_bi ou ajuste privilégios	Protegendo o PostgreSQL e o Superset: autenticação, roles e
Ambiente de teste acessa dados reais	Conexão ou role compartilhada entre ambientes	Separe bancos, usuários e senhas para cada ambiente	Protegendo o PostgreSQL e o Superset: autenticação, roles e
Erro 'Decryption failed' ao rodar playbook	Senha do Vault incorreta ou arquivo corrompido	Confirme a senha e tente descriptografar manualmente com 'ansible-vault view'	Protegendo segredos e acessos: Ansible Vault e SSH seguro
Permissão negada ao acessar chave SSH	Permissões do arquivo de chave privada estão incorretas	Ajuste com 'chmod 600 ~/.ssh/id_ed25519'	Protegendo segredos e acessos: Ansible Vault e SSH seguro
Variáveis sensíveis aparecem em texto claro no log	Arquivo não está criptografado ou variável foi definida fora do Vault	Garanta que todas as variáveis sensíveis estejam apenas em arquivos Vault	Protegendo segredos e acessos: Ansible Vault e SSH seguro
Script retorna erro de autenticação na API	Token expirado, inválido ou não informado corretamente	Gere um novo token no painel do ERP e atualize a variável de ambiente	Protegendo tokens e credenciais na extração de dados
Senha do PostgreSQL vazou em log	Print ou log descuidado no código	Remova prints/logs de segredos e rode novamente	Protegendo tokens e credenciais na extração de dados
Arquivo .env acessível por outros usuários	Permissões de arquivo incorretas	Ajuste para chmod 600 .env e revise propriedade	Protegendo tokens e credenciais na extração de dados
Configuração não é aplicada após o upload	Serviço de configuração não foi recarregado	Execute 'pfSsh.php playback configreload'	Provisionamento em massa: pfSense AutoConfigBackup e ferrame
Backup não aparece no servidor central	Permissões ou conectividade SSH insuficiente	Teste conexão SSH manualmente e ajuste permissões	Provisionamento em massa: pfSense AutoConfigBackup e ferrame
Falha de autenticação ao usar Ansible	Chave SSH não instalada corretamente	Reinstale a chave com 'ssh-copy-id'	Provisionamento em massa: pfSense AutoConfigBackup e ferrame
Serviço de PDV não inicia	Configuração ausente ou dependência não instalada	Revise o playbook de instalação e valide logs do serviço	Provisionamento zero-touch: do servidor virgem ao PDV operac
SSH indisponível após provisionamento	Firewall bloqueando porta 22	Ajuste a task de firewall para liberar SSH	Provisionamento zero-touch: do servidor virgem ao PDV operac
Banco de dados sem senha definida	Variável de senha não passada corretamente	Verifique o arquivo de variáveis e reexecute o playbook	Provisionamento zero-touch: do servidor virgem ao PDV operac
Playbook para em erro de permissão	Usuário sem sudo ou become configurado	Ajuste o inventário para incluir become: yes	Provisionamento zero-touch: do servidor virgem ao PDV operac
Áreas sem sinal Wi-Fi	APs insuficientes ou mal posicionados	Revisar mapa de cobertura e instalar APs adicionais	Quantos APs, switches e links? Dimensionamento sem chute
Switch travando ou lentidão geral	Portas ou uplink sobrecarregados	Trocar switch por modelo com mais portas ou uplink mais rápido	Quantos APs, switches e links? Dimensionamento sem chute
Quedas frequentes de conexão	Interferência ou excesso de clientes por AP	Redistribuir APs e limitar conexões por AP	Quantos APs, switches e links? Dimensionamento sem chute
PDV sem rede	Porta de switch ocupada ou cabo desconectado	Verificar cabeamento e disponibilidade de portas	Quantos APs, switches e links? Dimensionamento sem chute
Áreas sem sinal Wi-Fi	APs insuficientes ou mal posicionados	Revisar mapa de cobertura e instalar APs adicionais	Quantos APs, switches e links? Dimensionamento sem chute
Switch travando ou lentidão geral	Portas ou uplink sobrecarregados	Trocar switch por modelo com mais portas ou uplink mais rápido	Quantos APs, switches e links? Dimensionamento sem chute
Quedas frequentes de conexão	Interferência ou excesso de clientes por AP	Redistribuir APs e limitar conexões por AP	Quantos APs, switches e links? Dimensionamento sem chute
PDV sem rede	Porta de switch ocupada ou cabo desconectado	Verificar cabeamento e disponibilidade de portas	Quantos APs, switches e links? Dimensionamento sem chute
Usuário não consegue conectar ao Wi-Fi corporativo	Segredo compartilhado incorreto entre access point e RADIUS	Verifique e corrija o segredo nos dois lados	RADIUS e autenticação centralizada: controle de acesso unifi
Login administrativo no pfSense falha para todos	IP ou porta do servidor RADIUS incorretos na configuração do pfSense	Confirme IP, porta (1812) e conectividade de rede	RADIUS e autenticação centralizada: controle de acesso unifi
Logs do RADIUS não mostram tentativas de autenticação	Firewall bloqueando porta 1812/UDP	Libere a porta 1812/UDP entre pfSense/access points e o servidor RADIUS	RADIUS e autenticação centralizada: controle de acesso unifi
Trigger dispara sem falha real	Trigger sensível demais (parâmetros curtos ou thresholds baixos)	Ajuste o tempo de avaliação ou o valor limite da trigger	Recuperação rápida: exemplos de troubleshooting e automação
Ação automática não executa	Permissões insuficientes no host ou erro de autenticação SSH	Verifique chaves SSH e permissões do usuário Zabbix	Recuperação rápida: exemplos de troubleshooting e automação
Incidente não fecha após automação	Script de recuperação falhou ou trigger secundária mal configurada	Revise logs do Zabbix e do host, corrija o script ou a trigger	Recuperação rápida: exemplos de troubleshooting e automação
Coletores desconectam ao mudar de corredor	Roaming lento ou ausência de 802.11r	Ative 802.11r e ajuste canais para sobreposição adequada	Rede de supermercado de médio porte: problemas e soluções
PDVs travam em horários de pico	Broadcast excessivo ou falta de priorização	Separe VLANs e ative SQM para priorizar PDVs	Rede de supermercado de médio porte: problemas e soluções
Visitantes reclamam de lentidão	Banda mal distribuída	Limite banda da VLAN de convidados via SQM	Rede de supermercado de médio porte: problemas e soluções
Áreas sem sinal Wi-Fi	APs mal posicionados ou potência inadequada	Reposicione APs e ajuste potência	Rede de supermercado de médio porte: problemas e soluções
Coletores desconectam ao mudar de corredor	Roaming lento ou ausência de 802.11r	Ative 802.11r e ajuste canais para sobreposição adequada	Rede de supermercado de médio porte: problemas e soluções
PDVs travam em horários de pico	Broadcast excessivo ou falta de priorização	Separe VLANs e ative SQM para priorizar PDVs	Rede de supermercado de médio porte: problemas e soluções
Visitantes reclamam de lentidão	Banda mal distribuída	Limite banda da VLAN de convidados via SQM	Rede de supermercado de médio porte: problemas e soluções
Áreas sem sinal Wi-Fi	APs mal posicionados ou potência inadequada	Reposicione APs e ajuste potência	Rede de supermercado de médio porte: problemas e soluções
Relatórios automáticos não são enviados	Configuração de e-mail incorreta ou permissão insuficiente	Revise as configurações em Administration > Media types e verifique logs do Zabbix server	Relatórios e tendências: antecipando falhas antes da crise
Dados de tendências não aparecem em períodos longos	Item sem coleta de trends habilitada ou retenção curta	Ajuste a configuração do item e o tempo de retenção em Administration > Items	Relatórios e tendências: antecipando falhas antes da crise
Triggers baseadas em tendência não disparam	Expressão de trigger inadequada ou falta de dados históricos	Revise a expressão e aguarde coleta suficiente para cálculo de tendência	Relatórios e tendências: antecipando falhas antes da crise
Dados de vendas não aparecem para o período desejado	Parâmetros de data incorretos na extração ou limitação da API	Revise os parâmetros e consulte o api-docs para limites de consulta	Resultado de campanhas e promoções: comparar antes, durante
Coluna periodo_campanha não preenchida	Erro no join entre fato_venda_item, fato_venda e dim_campanha	Verifique se as chaves id_venda e id_campanha estão corretas	Resultado de campanhas e promoções: comparar antes, durante
Ordem dos períodos errada no gráfico	ORDER BY inadequado na query	Use CASE no ORDER BY para forçar a ordem lógica	Resultado de campanhas e promoções: comparar antes, durante
Dados de vendas ausentes em certos períodos	Filtro de datas incorreto na extração ou falha de paginação na API.	Revise os parâmetros de data e a lógica de paginação do script Python.	Resultado de campanhas e promoções: comparar antes, durante
Vendas não associadas a campanhas	Falta de vínculo entre vendas e campanhas no modelo.	Ajuste o cruzamento por data ou regras de negócio.	Resultado de campanhas e promoções: comparar antes, durante
Erro de autenticação na API	Token expirado ou inválido.	Gere novo token no ERP e atualize o script.	Resultado de campanhas e promoções: comparar antes, durante
Dispositivo perde conexão ao se mover	Roaming não está ativado ou potência dos APs está alta demais	Reduza a potência dos APs e verifique suporte a 802.11r/k/v	Roaming e densidade: como evitar Wi-Fi lotado e quedas de co
Wi-Fi lento em áreas cheias	Muitos dispositivos no mesmo canal ou AP saturado	Distribua os canais e adicione mais APs conforme necessário	Roaming e densidade: como evitar Wi-Fi lotado e quedas de co
Clientes ficam conectados a AP distante	Potência alta ou falta de política de desconexão	Ajuste potência e ative disassoc_low_ack ou Minimum RSSI	Roaming e densidade: como evitar Wi-Fi lotado e quedas de co
Dispositivo perde conexão ao se mover	Roaming não está ativado ou potência dos APs está alta demais	Reduza a potência dos APs e verifique suporte a 802.11r/k/v	Roaming e densidade: como evitar Wi-Fi lotado e quedas de co
Wi-Fi lento em áreas cheias	Muitos dispositivos no mesmo canal ou AP saturado	Distribua os canais e adicione mais APs conforme necessário	Roaming e densidade: como evitar Wi-Fi lotado e quedas de co
Clientes ficam conectados a AP distante	Potência alta ou falta de política de desconexão	Ajuste potência e ative disassoc_low_ack ou Minimum RSSI	Roaming e densidade: como evitar Wi-Fi lotado e quedas de co
Role não executa tarefas esperadas	tasks/main.yml está vazio ou mal referenciado	Preencha tasks/main.yml corretamente e revise o playbook	Roles e Playbooks: compondo automação reutilizável e legível
Variáveis não aplicadas	Variáveis não definidas ou sobrescritas em outro lugar	Revise defaults/main.yml e a ordem das variáveis	Roles e Playbooks: compondo automação reutilizável e legível
Dependências não instaladas	meta/main.yml não lista dependências corretamente	Adicione dependências no meta/main.yml	Roles e Playbooks: compondo automação reutilizável e legível
Handler não dispara	notify ausente na task ou handler não definido	Inclua notify na task e defina handler em handlers/main.yml	Roles e Playbooks: compondo automação reutilizável e legível
Alertas não chegam no Telegram	Token ou chat_id incorretos, ou bloqueio de firewall	Revise o token, chat_id e teste o curl manualmente	Scripts de monitoramento e alertas automáticos
Script não executa via cron	Permissões ou PATH incorretos	Garanta permissão de execução e use caminhos absolutos	Scripts de monitoramento e alertas automáticos
Eventos não aparecem no Zabbix	Token de autenticação inválido ou endpoint errado	Consulte a documentação da API do Zabbix e valide o token	Scripts de monitoramento e alertas automáticos
Alertas não chegam no Telegram	Token ou chat_id incorretos, ou bloqueio de firewall	Revise o token, chat_id e teste o curl manualmente	Scripts de monitoramento e alertas automáticos
Script não executa via cron	Permissões ou PATH incorretos	Garanta permissão de execução e use caminhos absolutos	Scripts de monitoramento e alertas automáticos
Eventos não aparecem no Zabbix	Token de autenticação inválido ou endpoint errado	Consulte a documentação da API do Zabbix e valide o token	Scripts de monitoramento e alertas automáticos
Failover não ocorre ao cair um link	Monitoramento de gateway não configurado corretamente	Revise IP de monitoramento e ajuste em System > Routing > Gateways	SD-WAN open source com pfSense: quando e como aplicar em sup
Alguns dispositivos perdem conexão durante failover	Sessões persistentes não são mantidas entre links	Configure regras para minimizar sessões críticas ou use VPNs	SD-WAN open source com pfSense: quando e como aplicar em sup
Balanceamento não distribui tráfego como esperado	Regras de firewall não aplicam Gateway Group corretamente	Verifique ordem e escopo das regras em Firewall > Rules	SD-WAN open source com pfSense: quando e como aplicar em sup
Dispositivo de uma VLAN não acessa serviço essencial em outra	Regra de firewall excessivamente restritiva	Revise as regras e adicione exceção apenas para o serviço necessário	Segmentação de redes: lições de um supermercado que sofreu a
Dispositivo de visitante acessa rede interna	Rota ou regra de firewall ausente ou permissiva	Bloqueie todo o tráfego da VLAN de visitantes para redes internas	Segmentação de redes: lições de um supermercado que sofreu a
Logs não mostram tentativas de acesso negadas	Log de firewall desativado para a regra	Ative o logging nas regras de bloqueio	Segmentação de redes: lições de um supermercado que sofreu a
Dispositivo não entra na VLAN correta	Atributo de VLAN ausente ou incorreto no RADIUS	Revise configuração do FreeRADIUS e atributos enviados.	Segmentação dinâmica e balanceamento de carga
Uplink saturado mesmo com LACP	Balanceamento inadequado (por MAC ou porta)	Ajuste método de balanceamento para IP ou aumente número de links.	Segmentação dinâmica e balanceamento de carga
Wi-Fi lento em alguns APs	Canais sobrepostos ou muitos clientes em um só AP	Reforce ajuste automático de canais e redistribua clientes.	Segmentação dinâmica e balanceamento de carga
Dispositivo não entra na VLAN correta	Atributo de VLAN ausente ou incorreto no RADIUS	Revise configuração do FreeRADIUS e atributos enviados.	Segmentação dinâmica e balanceamento de carga
Uplink saturado mesmo com LACP	Balanceamento inadequado (por MAC ou porta)	Ajuste método de balanceamento para IP ou aumente número de links.	Segmentação dinâmica e balanceamento de carga
Wi-Fi lento em alguns APs	Canais sobrepostos ou muitos clientes em um só AP	Reforce ajuste automático de canais e redistribua clientes.	Segmentação dinâmica e balanceamento de carga
Erro 401 Unauthorized ao acessar a API	Token inválido, expirado ou ausente no header	Verifique se o token está correto, ativo e enviado no header x-CustomToken	Segurança na API do Bluesoft ERP: uso correto do x-CustomTok
Token exposto em repositório público	Token salvo em código-fonte ou arquivo sem proteção	Revogue imediatamente o token e gere um novo, revise permissões dos arquivos	Segurança na API do Bluesoft ERP: uso correto do x-CustomTok
Acesso indevido detectado nos logs	Token comprometido ou uso não autorizado	Revogue o token, investigue o incidente e implemente controles adicionais	Segurança na API do Bluesoft ERP: uso correto do x-CustomTok
Métricas não aparecem no dashboard	SNMP não habilitado ou bloqueado pelo firewall	Verifique se o serviço SNMP está ativo e se a porta UDP 161 está liberada	SNMP, Grafana e Zabbix: monitorando tudo que importa
Alertas não são disparados	Triggers mal configuradas ou thresholds incorretos	Revise as expressões das triggers e ajuste os limites	SNMP, Grafana e Zabbix: monitorando tudo que importa
Logs não chegam ao servidor central	IP do syslog remoto incorreto ou firewall bloqueando	Confirme o IP e libere a porta UDP 514	SNMP, Grafana e Zabbix: monitorando tudo que importa
Métricas não aparecem no dashboard	SNMP não habilitado ou bloqueado pelo firewall	Verifique se o serviço SNMP está ativo e se a porta UDP 161 está liberada	SNMP, Grafana e Zabbix: monitorando tudo que importa
Alertas não são disparados	Triggers mal configuradas ou thresholds incorretos	Revise as expressões das triggers e ajuste os limites	SNMP, Grafana e Zabbix: monitorando tudo que importa
Logs não chegam ao servidor central	IP do syslog remoto incorreto ou firewall bloqueando	Confirme o IP e libere a porta UDP 514	SNMP, Grafana e Zabbix: monitorando tudo que importa
Host SNMPv3 aparece como 'Unavailable' no Zabbix	Usuário ou senha SNMPv3 incorretos	Verifique e corrija usuário, senha de autenticação e senha de privacidade	SNMPv3 e controle de acesso: monitoramento sem brechas
Dados SNMPv3 não aparecem em Latest Data	Permissões SNMPv3 insuficientes no dispositivo	Ajuste permissões do usuário SNMPv3 para leitura	SNMPv3 e controle de acesso: monitoramento sem brechas
Muitos erros de 'Authentication failure' no log do Zabbix	Senha de autenticação ou privacidade errada	Atualize as senhas no Zabbix conforme as do dispositivo	SNMPv3 e controle de acesso: monitoramento sem brechas
Usuário consegue ver hosts que não deveria	Permissão global ou de grupo mal configurada	Revise permissões dos grupos e hosts no Zabbix	SNMPv3 e controle de acesso: monitoramento sem brechas
Erro de sintaxe Jinja2 ao aplicar o template	Parênteses, chaves ou comandos mal formatados no template	Revise o template, especialmente os blocos {% %} e {{ }}	Templates Jinja2: configurando arquivos complexos de forma a
Variável não definida no template	Faltou definir a variável no inventário ou playbook	Inclua a variável no local correto e reexecute	Templates Jinja2: configurando arquivos complexos de forma a
Serviço não inicia após aplicar configuração	Arquivo gerado tem valores inválidos ou sintaxe incorreta para o serviço	Valide o arquivo com o comando de teste do serviço e corrija o template	Templates Jinja2: configurando arquivos complexos de forma a
Item external check retorna 'Not supported'	Permissões incorretas ou script com erro.	Verifique permissões do script e rode manualmente para identificar falhas.	Tendências: automação, AIOps e o futuro do monitoramento abe
Trigger dispara sem motivo aparente	Dados históricos inconsistentes ou limiar mal calibrado.	Revise o modelo preditivo e ajuste thresholds na trigger.	Tendências: automação, AIOps e o futuro do monitoramento abe
Action não executa o script externo	Configuração de action incorreta ou falta de permissão.	Revise a configuração da action e permissões do usuário Zabbix.	Tendências: automação, AIOps e o futuro do monitoramento abe
O comando ansible-playbook --syntax-check retorna erro de sintaxe.	YAML mal formatado ou variável não definida.	Revisar indentação e variáveis obrigatórias.	Testes automatizados: evitando que o próximo commit quebre s
ansible-lint aponta uso de módulo depreciado.	Código antigo ou herdado sem atualização.	Atualizar para módulos recomendados na documentação.	Testes automatizados: evitando que o próximo commit quebre s
No segundo run do playbook, tarefas aparecem como changed.	Playbook não idempotente.	Ajustar tarefas para garantir idempotência (ex: checar existência antes de criar).	Testes automatizados: evitando que o próximo commit quebre s
molecule test falha ao criar ambiente.	Dependências do Docker ou drivers não instaladas.	Verificar instalação do Docker e permissões do usuário.	Testes automatizados: evitando que o próximo commit quebre s
POS não comunica com servidor de automação	Regra de firewall ausente ou restritiva na VLAN POS ou DMZ	Ajuste as regras para liberar a porta e IP corretos	Topologias de rede para supermercados: matriz, filiais e DMZ
Wi-Fi de convidados acessa sistemas internos	Regras de firewall permissivas ou ausência de segmentação VLAN	Bloqueie todo tráfego da VLAN de convidados para as demais	Topologias de rede para supermercados: matriz, filiais e DMZ
Filial perde conexão com matriz	Túnel VPN site-to-site inativo ou rota ausente	Reinicie o túnel e revise as rotas no pfSense	Topologias de rede para supermercados: matriz, filiais e DMZ
PDV sem conexão	Cabo rompido ou porta do switch inativa	Teste o cabo, troque de porta e verifique o status no switch	Topologias: cabeamento, Wi-Fi e a mistura inevitável
Wi-Fi com sinal fraco no salão	Access point mal posicionado ou potência inadequada	Reposicione o AP ou ajuste a potência de transmissão	Topologias: cabeamento, Wi-Fi e a mistura inevitável
Câmeras offline	Switch PoE sem energia ou VLAN configurada incorretamente	Cheque a fonte PoE e a configuração de VLAN	Topologias: cabeamento, Wi-Fi e a mistura inevitável
PDV sem conexão	Cabo rompido ou porta do switch inativa	Teste o cabo, troque de porta e verifique o status no switch	Topologias: cabeamento, Wi-Fi e a mistura inevitável
Wi-Fi com sinal fraco no salão	Access point mal posicionado ou potência inadequada	Reposicione o AP ou ajuste a potência de transmissão	Topologias: cabeamento, Wi-Fi e a mistura inevitável
Câmeras offline	Switch PoE sem energia ou VLAN configurada incorretamente	Cheque a fonte PoE e a configuração de VLAN	Topologias: cabeamento, Wi-Fi e a mistura inevitável
Dispositivo não conecta ao SSID	Senha ou autenticação RADIUS incorreta	Revise credenciais e configuração do servidor RADIUS	UniFi Controller: SSID, autenticação e isolamento de cliente
Clientes de SSID visitantes acessam sistemas internos	Guest Control ou VLAN mal configurados	Reveja regras de Guest Control e VLANs no UniFi Controller e switches	UniFi Controller: SSID, autenticação e isolamento de cliente
Tráfego de PDV e coletores misturado	VLANs não aplicadas corretamente no AP ou switch	Verifique se a porta do AP está em trunk/tagged e VLANs corretas	UniFi Controller: SSID, autenticação e isolamento de cliente
Dispositivo não conecta ao SSID	Senha ou autenticação RADIUS incorreta	Revise credenciais e configuração do servidor RADIUS	UniFi Controller: SSID, autenticação e isolamento de cliente
Clientes de SSID visitantes acessam sistemas internos	Guest Control ou VLAN mal configurados	Reveja regras de Guest Control e VLANs no UniFi Controller e switches	UniFi Controller: SSID, autenticação e isolamento de cliente
Tráfego de PDV e coletores misturado	VLANs não aplicadas corretamente no AP ou switch	Verifique se a porta do AP está em trunk/tagged e VLANs corretas	UniFi Controller: SSID, autenticação e isolamento de cliente
Erro de autenticação (code -32602)	Token expirado ou usuário/senha incorretos	Refaça o login e atualize o token	Usando a API REST do Zabbix: integração sem limites
Host não aparece no Zabbix	IDs de grupo ou template incorretos	Confirme os IDs usando hostgroup.get e template.get	Usando a API REST do Zabbix: integração sem limites
Chamado não criado no sistema externo	Script com token inválido ou endpoint errado	Verifique variáveis e endpoint da API do sistema de chamados	Usando a API REST do Zabbix: integração sem limites
Painel mostra vendas zeradas ou incompletas	Falha na extração Python ou erro de paginação na API	Revise logs do extrator, verifique manipulação de páginas e filtros de data.	Varejo na prática: análise diária de vendas e campanhas com
Dashboard lento ou travando	Queries SQL mal otimizadas ou tabelas sem índices	Otimize as queries e crie índices em campos de filtro (data, loja, campanha).	Varejo na prática: análise diária de vendas e campanhas com
Divergência entre painel e ERP	Dados faltando na extração ou erro de mapeamento	Valide o volume de registros, revise filtros e campos extraídos.	Varejo na prática: análise diária de vendas e campanhas com
Dispositivo não recebe IP	DHCP não configurado na subinterface VLAN ou switch não encaminha VLAN correta	Revise a configuração de DHCP e as portas VLAN no switch	VLANs na prática: separando PDV, Wi-Fi e câmeras
Dispositivo de uma VLAN acessa outra	Regras de firewall ausentes ou permissivas no roteador	Ajuste as regras de firewall para bloquear tráfego entre VLANs	VLANs na prática: separando PDV, Wi-Fi e câmeras
SSID não conecta à VLAN correta	SSID não associado à interface VLAN no AP	Verifique a configuração de wireless e option network	VLANs na prática: separando PDV, Wi-Fi e câmeras
Dispositivo não recebe IP	DHCP não configurado na subinterface VLAN ou switch não encaminha VLAN correta	Revise a configuração de DHCP e as portas VLAN no switch	VLANs na prática: separando PDV, Wi-Fi e câmeras
Dispositivo de uma VLAN acessa outra	Regras de firewall ausentes ou permissivas no roteador	Ajuste as regras de firewall para bloquear tráfego entre VLANs	VLANs na prática: separando PDV, Wi-Fi e câmeras
SSID não conecta à VLAN correta	SSID não associado à interface VLAN no AP	Verifique a configuração de wireless e option network	VLANs na prática: separando PDV, Wi-Fi e câmeras
VPN conecta mas não trafega dados	Rotas ou regras de firewall incorretas	Ajuste rotas e regras nas duas pontas	VPN caiu, loja isolada: passos para restaurar a comunicação
Erro AUTH_FAILED no log	PSK ou certificado incorreto	Corrija o segredo compartilhado ou renove o certificado	VPN caiu, loja isolada: passos para restaurar a comunicação
NO_PROPOSAL_CHOSEN no log	Parâmetros de criptografia incompatíveis	Alinhe as propostas de Phase 1 e 2 nas duas pontas	VPN caiu, loja isolada: passos para restaurar a comunicação
VPN não reconecta após queda do link principal	Matriz não aceita IP do link secundário ou configuração do Gateway Group incorreta	Revise Remote Gateway na matriz e ajuste interface da VPN para o Gateway Group	VPN e failover: como uma filial não parou mesmo com queda do
Failover demora ou não ocorre	Intervalo de monitoramento alto ou thresholds inadequados	Reduza Probe Interval e ajuste Packet Loss Threshold	VPN e failover: como uma filial não parou mesmo com queda do
Perda de sessão em aplicações sensíveis	Latência maior no link secundário ou timeout baixo nas aplicações	Ajuste timeout das aplicações e, se possível, otimize rota do link backup	VPN e failover: como uma filial não parou mesmo com queda do
Dispositivo não conecta ao Wi-Fi	Incompatibilidade com WPA3 ou 802.11ax	Ative modo transition (WPA2/WPA3) ou modo misto (ac/ax)	Wi-Fi 6, WPA3 e SDN: o que muda de verdade
Quedas frequentes de conexão	Interferência ou configuração de canal inadequada	Ajuste canais e potência do AP, evite sobreposição	Wi-Fi 6, WPA3 e SDN: o que muda de verdade
Tráfego de visitantes acessando rede de PDV	VLANs configuradas incorretamente	Revise configurações de VLAN e firewall	Wi-Fi 6, WPA3 e SDN: o que muda de verdade
Dispositivo não conecta ao Wi-Fi	Incompatibilidade com WPA3 ou 802.11ax	Ative modo transition (WPA2/WPA3) ou modo misto (ac/ax)	Wi-Fi 6, WPA3 e SDN: o que muda de verdade
Quedas frequentes de conexão	Interferência ou configuração de canal inadequada	Ajuste canais e potência do AP, evite sobreposição	Wi-Fi 6, WPA3 e SDN: o que muda de verdade
Tráfego de visitantes acessando rede de PDV	VLANs configuradas incorretamente	Revise configurações de VLAN e firewall	Wi-Fi 6, WPA3 e SDN: o que muda de verdade
wavemon não mostra dados de sinal	Placa Wi-Fi incompatível ou interface errada	Verifique se a interface correta está selecionada e se o driver suporta monitoramento	Wi-Fi Analyzer, wavemon e tcpdump: diagnóstico em campo
tcpdump não captura pacotes	Permissão insuficiente ou interface errada	Execute como root e confirme o nome da interface Wi-Fi	Wi-Fi Analyzer, wavemon e tcpdump: diagnóstico em campo
Wi-Fi Analyzer mostra todos os canais lotados	Ambiente saturado ou muitos APs próximos	Replaneje canais e reduza potência dos APs	Wi-Fi Analyzer, wavemon e tcpdump: diagnóstico em campo
wavemon não mostra dados de sinal	Placa Wi-Fi incompatível ou interface errada	Verifique se a interface correta está selecionada e se o driver suporta monitoramento	Wi-Fi Analyzer, wavemon e tcpdump: diagnóstico em campo
tcpdump não captura pacotes	Permissão insuficiente ou interface errada	Execute como root e confirme o nome da interface Wi-Fi	Wi-Fi Analyzer, wavemon e tcpdump: diagnóstico em campo
Wi-Fi Analyzer mostra todos os canais lotados	Ambiente saturado ou muitos APs próximos	Replaneje canais e reduza potência dos APs	Wi-Fi Analyzer, wavemon e tcpdump: diagnóstico em campo
Proxy não envia dados	Configuração incorreta de Server ou Hostname no zabbix_proxy.conf	Revise o arquivo de configuração e reinicie o serviço.	Zabbix 6.x: novidades e recursos avançados para supermercado
Dados MQTT não aparecem	Script externo não está rodando ou broker MQTT inacessível	Teste o comando mosquitto_sub manualmente e verifique conectividade.	Zabbix 6.x: novidades e recursos avançados para supermercado
Triggers não disparam	Expressão de trigger incorreta ou itens não vinculados ao host	Revise a expressão e vinculação dos itens no template.	Zabbix 6.x: novidades e recursos avançados para supermercado
Host aparece como 'Unavailable' no painel	Firewall bloqueando porta 10050 ou 10051	Liberar portas no firewall local e na rede	Zabbix Server, Proxy e Agent: papéis e fluxos de dados
Dados de uma loja remota não aparecem	Proxy não consegue se conectar ao Server	Verificar configuração do Server no zabbix_proxy.conf e conectividade de rede	Zabbix Server, Proxy e Agent: papéis e fluxos de dados
Alertas falsos de indisponibilidade em horários de pico	Timeouts por latência alta entre Proxy e Server	Ajustar parâmetros de timeout e considerar aumentar o intervalo de envio do Proxy	Zabbix Server, Proxy e Agent: papéis e fluxos de dados
SNMP não retorna dados	Comunidade SNMP incorreta ou firewall bloqueando porta 161/UDP	Verifique a configuração SNMP do dispositivo e libere a porta no firewall	Zabbix, SNMP e ICMP: o trio fundamental do monitoramento abe
ICMP falha para um host	Host offline ou ICMP bloqueado no firewall	Confirme se o host está ligado e ajuste o firewall para permitir ICMP	Zabbix, SNMP e ICMP: o trio fundamental do monitoramento abe
Itens SNMP aparecem como 'unsupported' no Zabbix	OID incorreto ou versão SNMP incompatível	Revise o OID e a versão SNMP configurada no item	Zabbix, SNMP e ICMP: o trio fundamental do monitoramento abe

Todas as trilhas