848 sintomas catalogados
Cada sintoma com causa provável e correção, ligado à lição da trilha Varejo que explica o porquê. Descreva o sintoma para filtrar.
| Sintoma | Causa provável | Correção | Lição |
|---|---|---|---|
| Não consigo acessar o Metabase remotamente | VPN não conectada ou firewall bloqueando | Verifique se a VPN está ativa e se o IP está liberado no firewall | Acesso seguro: VPN, firewall e roles restritivas no Metabase |
| Usuário do Metabase não consegue consultar dados | Permissões insuficientes no PostgreSQL | Revise os GRANTs para o usuário somente leitura | Acesso seguro: VPN, firewall e roles restritivas no Metabase |
| Logs do Metabase não mostram acessos | Configuração de log insuficiente ou log externo não habilitado | Ajuste o nível de log do Metabase e redirecione para sistema centralizado, se necessário | Acesso seguro: VPN, firewall e roles restritivas no Metabase |
| Usuários conseguem acessar o Metabase de fora da VPN | Firewall não está bloqueando conexões externas corretamente | Revise as regras do firewall e restrinja o acesso à porta 3000 apenas à rede VPN | Acesso seguro: VPN, firewalls e isolamento de ambiente |
| Consultas do BI deixam o ERP lento | Metabase está conectado ao banco de produção, não à réplica | Configure o Metabase para usar apenas a réplica BI | Acesso seguro: VPN, firewalls e isolamento de ambiente |
| Tentativas de login suspeitas não são detectadas | Logs de acesso não estão habilitados ou não são monitorados | Ative logs no Metabase e configure alertas para acessos suspeitos | Acesso seguro: VPN, firewalls e isolamento de ambiente |
| E-mail não chega aos destinatários | Configuração SMTP incorreta ou bloqueio de firewall | Revise as credenciais SMTP e teste o envio em Administração > Configurações > E-mail. | Agendamento de atualizações e envio de relatórios no Metabas |
| Relatório chega com dados desatualizados | Banco de réplica não atualizado no momento da consulta | Ajuste o horário do agendamento para após a atualização do banco. | Agendamento de atualizações e envio de relatórios no Metabas |
| Consulta demora ou falha | Consulta pesada ou concorrência com outros processos | Otimize a consulta, crie agregações ou agende para horários de menor uso. | Agendamento de atualizações e envio de relatórios no Metabas |
| Carga não roda no horário agendado | Permissões do cron ou do script, ou erro de sintaxe no agendamento | Revise o crontab com crontab -l e teste o script manualmente | Agendamento de cargas: ETL e atualização incremental do BI |
| Volume de dados extraído é zero | Campo de data/hora usado incorretamente ou controle de última carga desatualizado | Confirme o campo correto no dicionário SX2 ou ajuste o parâmetro de data | Agendamento de cargas: ETL e atualização incremental do BI |
| Carga sobrecarrega o banco de produção | Consulta sem filtro ou horário inadequado | Implemente filtros de data e agende para horários de baixa demanda | Agendamento de cargas: ETL e atualização incremental do BI |
| Consultas do Metabase lentas ou travando | Falta de índices nos campos filtrados ou agrupados | Crie índices conforme o padrão de uso e monitore com EXPLAIN ANALYZE | Ajustando PostgreSQL para BI: roles, índices e limites de co |
| Erro de permissão ao conectar pelo Metabase | Usuário do Metabase sem GRANT SELECT ou sem USAGE no schema | Revise os GRANTs para o usuário e role de BI | Ajustando PostgreSQL para BI: roles, índices e limites de co |
| Banco travando por excesso de conexões | max_connections baixo ou ausência de CONNECTION LIMIT no usuário BI | Ajuste max_connections e defina CONNECTION LIMIT para o usuário do Metabase | Ajustando PostgreSQL para BI: roles, índices e limites de co |
| Consultas lentas ou travando o banco | Execução em ambiente de produção ou queries sem índices | Use réplica dedicada e otimize os índices das tabelas de BI | Além do dashboard: análises preditivas e machine learning (c |
| Erro de conexão Python-PostgreSQL | Credenciais ou parâmetros incorretos | Revise usuário, senha, host e porta; teste conexão com psql | Além do dashboard: análises preditivas e machine learning (c |
| Metabase não encontra a tabela de previsão | Tabela criada em schema diferente ou falta de permissões | Confirme o schema e ajuste permissões de leitura no PostgreSQL | Além do dashboard: análises preditivas e machine learning (c |
| Alerta não chega ao destinatário. | Configuração errada de Media Type ou endereço de destino. | Revise SMTP, webhook e períodos de recebimento. | Alertas que fazem sentido: ações, usuários e notificações |
| Alerta chega para todos, mesmo sem responsabilidade. | Condições de ação muito amplas ou ausência de filtros. | Ajuste condições e grupos de usuários. | Alertas que fazem sentido: ações, usuários e notificações |
| Alerta chega com atraso. | Fila de e-mails ou sobrecarga do servidor. | Monitore fila SMTP e recursos do Zabbix server. | Alertas que fazem sentido: ações, usuários e notificações |
| Relatório mostra disponibilidade 100% mesmo após falha | Trigger mal configurada ou não associada ao serviço correto | Revise a lógica da trigger e associe ao item correto | Análise de disponibilidade e SLA: o que o Zabbix pode mostra |
| Períodos de manutenção aparecem como indisponibilidade | Manutenção não configurada ou aplicada ao host errado | Configure corretamente os períodos de manutenção | Análise de disponibilidade e SLA: o que o Zabbix pode mostra |
| Exportação CSV gera arquivo vazio | Filtro de relatório sem dados no período selecionado | Ajuste o período ou revise filtros | Análise de disponibilidade e SLA: o que o Zabbix pode mostra |
| SLA não considera dependências entre serviços | Triggers independentes ou IT Services não configurados | Modelar dependências usando IT Services | Análise de disponibilidade e SLA: o que o Zabbix pode mostra |
| Erro 500 ao salvar vendas | Query lenta ou travada no banco | Verifique queries lentas, limpe conexões zumbis, reinicie o PostgreSQL se necessário | Análise de falhas: identificando gargalos e indisponibilidad |
| Odoo não carrega após pico de vendas | Exaustão de workers ou memória | Reduza carga, reinicie serviço, ajuste número de workers | Análise de falhas: identificando gargalos e indisponibilidad |
| Time-out ao acessar banco | Latência de rede ou banco travado | Teste conectividade, reinicie banco, verifique firewall | Análise de falhas: identificando gargalos e indisponibilidad |
| Erros de deadlock | Concorrência excessiva em tabelas | Revise transações, otimize queries, avalie isolamento de módulos | Análise de falhas: identificando gargalos e indisponibilidad |
| Consulta lenta ou travando | Consulta sobre grande volume de dados em produção ou sem índices | Execute em réplica, otimize índices e filtre períodos menores | Análise de vendas em supermercados: sazonalidade e ruptura d |
| Dados de estoque não batem com o ERP | Extração desatualizada ou janela de carga inadequada | Ajuste a rotina de extração e sincronização | Análise de vendas em supermercados: sazonalidade e ruptura d |
| Metabase não conecta ao banco | Driver ausente ou credenciais incorretas | Verifique driver JDBC, usuário e permissões | Análise de vendas em supermercados: sazonalidade e ruptura d |
| Alertas não são enviados | Configuração de e-mail ou regras de alerta incorretas | Revise as configurações de notificação e os critérios dos alertas | Análise de vendas em supermercados: sazonalidade e ruptura d |
| Dashboard mostra dados antigos | Falha na carga incremental ou erro de conexão com o repositório | Verifique logs do ETL, monitore a última data_carga e teste a conexão do Superset | Análise de vendas em tempo quase real: limites e possibilida |
| ERP fica lento durante a carga | Extração feita diretamente do banco de produção em horário crítico | Ajuste a janela de carga para horários de menor movimento ou use réplica de leitura | Análise de vendas em tempo quase real: limites e possibilida |
| Dados inconsistentes entre ERP e BI | Carga incompleta ou transações não consolidadas no ERP | Implemente validações de integridade e ajuste o processo de extração | Análise de vendas em tempo quase real: limites e possibilida |
| Arquivo de captura vazio | Interface errada ou modo monitor não habilitado | Confirme o nome da interface Wi-Fi e ative o modo monitor | Analytics de presença: capturando e analisando dados do Wi-F |
| Poucos dispositivos detectados | Dispositivos usam randomização de MAC | Ajuste expectativas e combine com outras métricas | Analytics de presença: capturando e analisando dados do Wi-F |
| Dados não aparecem no dashboard | Erro na etapa de anonimização ou parsing | Revise scripts e valide hashes gerados | Analytics de presença: capturando e analisando dados do Wi-F |
| Arquivo de captura vazio | Interface errada ou modo monitor não habilitado | Confirme o nome da interface Wi-Fi e ative o modo monitor | Analytics de presença: capturando e analisando dados do Wi-F |
| Poucos dispositivos detectados | Dispositivos usam randomização de MAC | Ajuste expectativas e combine com outras métricas | Analytics de presença: capturando e analisando dados do Wi-F |
| Dados não aparecem no dashboard | Erro na etapa de anonimização ou parsing | Revise scripts e valide hashes gerados | Analytics de presença: capturando e analisando dados do Wi-F |
| Erro de permissão SSH | Chave SSH não autorizada ou senha incorreta | Adicione a chave pública ao arquivo ~/.ssh/authorized_keys do equipamento | Ansible, YAML e SSH: o tripé da automação de redes abertas |
| Comando não encontrado no playbook | Módulo ou comando ausente no sistema de destino | Verifique se o pacote ou utilitário está instalado no OpenWrt | Ansible, YAML e SSH: o tripé da automação de redes abertas |
| Playbook não executa em todos os hosts | Hosts não listados corretamente no inventário | Confirme o inventário e teste acesso individualmente | Ansible, YAML e SSH: o tripé da automação de redes abertas |
| Logs não são gravados no disco | Volume de logs não montado ou variável de ambiente MB_LOG_FILE ausente | Revise o comando Docker e as permissões do diretório de logs | Auditoria de painéis e queries: quem acessa o quê |
| Usuários aparecem apenas por ID nos logs | Falta de consulta à tabela core_user | Faça join entre logs e core_user para identificar nomes | Auditoria de painéis e queries: quem acessa o quê |
| Exportações não aparecem nos logs | Versão antiga do Metabase ou configuração incorreta de logs | Atualize o Metabase e revise as configurações de logging | Auditoria de painéis e queries: quem acessa o quê |
| O playbook não é executado após o alerta. | Webhook não está configurado corretamente ou serviço intermediário não está rodando. | Revise a configuração do Alertmanager ou do Media Type e reinicie o serviço intermediário. | Automação baseada em eventos: integração com sistemas de mon |
| O playbook executa, mas não corrige o problema. | O playbook não está idempotente ou não cobre o cenário do evento. | Ajuste o playbook para garantir que ele trata o evento corretamente. | Automação baseada em eventos: integração com sistemas de mon |
| Execuções concorrentes causam conflitos. | Vários eventos disparam o mesmo playbook simultaneamente. | Implemente controle de concorrência no serviço intermediário ou use locks. | Automação baseada em eventos: integração com sistemas de mon |
| Playbook executa tarefas fora de ordem | Dependências mal definidas ou uso incorreto de include/import | Revise o fluxo e use when/handlers para controlar a ordem | Automação orquestrada: dependências e execução em múltiplos |
| Variáveis erradas em produção | Mistura de inventários ou group_vars | Separe e valide os arquivos de inventário por ambiente | Automação orquestrada: dependências e execução em múltiplos |
| Handler não dispara | Tarefa anterior não mudou nada | Verifique se a tarefa realmente altera o estado do sistema | Automação orquestrada: dependências e execução em múltiplos |
| Testes automatizados falham só em produção | Diferenças não simuladas no ambiente de teste | Ajuste o ambiente de teste para refletir produção o máximo possível | Automação orquestrada: dependências e execução em múltiplos |
| Dispositivo não volta após upgrade | Firmware incompatível ou imagem corrompida | Reverta para backup anterior via TFTP ou modo failsafe | Automatizando atualizações de firmware OpenWrt em massa |
| Checksum inválido | Download corrompido ou imagem errada | Baixe novamente a imagem e o checksum do site oficial | Automatizando atualizações de firmware OpenWrt em massa |
| SSH não responde após reboot | Configuração de rede perdida ou IP alterado | Verifique DHCP, IP estático e conectividade física | Automatizando atualizações de firmware OpenWrt em massa |
| Versão do firmware não corresponde | Sysupgrade não foi executado ou falhou | Revise logs do Ansible e do sistema, repita o processo | Automatizando atualizações de firmware OpenWrt em massa |
| Backup não aparece no servidor | Falha na conexão SSH ou permissão de gravação | Teste o scp manualmente e ajuste permissões | Automatizando backups, atualizações e provisionamento |
| Atualização de firmware falha | Firmware incompatível ou falta de espaço | Consulte a documentação e libere espaço antes de atualizar | Automatizando backups, atualizações e provisionamento |
| AP UniFi não aparece no controlador | DHCP Option 43 não configurado ou firewall bloqueando porta | Reveja configuração DHCP e libere portas necessárias | Automatizando backups, atualizações e provisionamento |
| Backup não aparece no servidor | Falha na conexão SSH ou permissão de gravação | Teste o scp manualmente e ajuste permissões | Automatizando backups, atualizações e provisionamento |
| Atualização de firmware falha | Firmware incompatível ou falta de espaço | Consulte a documentação e libere espaço antes de atualizar | Automatizando backups, atualizações e provisionamento |
| AP UniFi não aparece no controlador | DHCP Option 43 não configurado ou firewall bloqueando porta | Reveja configuração DHCP e libere portas necessárias | Automatizando backups, atualizações e provisionamento |
| Carga não executa no horário | Erro na configuração do cron ou DAG do Airflow. | Revise a sintaxe do agendamento e permissões de execução. | Automatizando cargas de dados do ERP para o PostgreSQL |
| Dados incompletos no PostgreSQL | Extração parcial ou erro de transformação. | Cheque logs e valide o arquivo de origem. | Automatizando cargas de dados do ERP para o PostgreSQL |
| Notificação de falha não chega | Configuração incorreta de e-mail ou webhook. | Teste envio manual e ajuste parâmetros. | Automatizando cargas de dados do ERP para o PostgreSQL |
| Carga não roda no horário agendado | Permissões do cron ou do script | Confirme permissões de execução e agendamento com 'crontab -l' e 'ls -l'. | Automatizando cargas do ERP para PostgreSQL: agendamento e l |
| Log não é gerado | Caminho ou permissões do arquivo de log | Verifique se o diretório /var/log/etl existe e tem permissão de escrita. | Automatizando cargas do ERP para PostgreSQL: agendamento e l |
| Carga roda duas vezes ao mesmo tempo | Falta de controle de concorrência | Implemente lockfile ou ajuste configuração do ETL. | Automatizando cargas do ERP para PostgreSQL: agendamento e l |
| O ETL não roda no horário agendado | Permissão do cron ou script incorreta | Verifique permissões e se o cron está ativo para o usuário correto | Automatizando cargas e alertas: quando o BI avisa antes do p |
| O alerta do Superset não dispara | Consulta SQL sem resultado ou condição mal definida | Revise a consulta e a expressão de trigger | Automatizando cargas e alertas: quando o BI avisa antes do p |
| Não recebe e-mail de alerta | Configuração de SMTP incorreta no Superset | Ajuste as variáveis de e-mail no Superset e teste envio manual | Automatizando cargas e alertas: quando o BI avisa antes do p |
| Ordens de compra não são geradas | Regras de reabastecimento mal configuradas ou agendador desativado | Revise os parâmetros das regras e o status do agendador | Automatizando estoque e vendas: regras e agendamentos |
| Notificações não chegam | Ação automatizada com condição incorreta ou e-mail mal configurado | Ajuste a condição e teste o envio de e-mail no Odoo | Automatizando estoque e vendas: regras e agendamentos |
| Execuções atrasadas | Intervalo de agendamento muito longo ou servidor sobrecarregado | Reduza o intervalo e monitore o uso de recursos | Automatizando estoque e vendas: regras e agendamentos |
| Logs mostram erros de permissão | Usuário do Odoo sem permissão suficiente no sistema operacional ou banco | Ajuste permissões do usuário Odoo | Automatizando estoque e vendas: regras e agendamentos |
| VLAN não aparece no swconfig | Erro no template ou reload não aplicado | Revise o template, aplique novamente e recarregue a rede | Automatizando VLANs e interfaces em switches OpenWrt |
| Perda de conectividade após reload | Configuração de porta errada ou VLAN ausente | Restaure o backup do /etc/config/network e recarregue | Automatizando VLANs e interfaces em switches OpenWrt |
| Erro de sintaxe ao aplicar template | Variável mal definida ou loop Jinja2 incorreto | Corrija o template, valide com 'ansible-playbook --check' antes de aplicar | Automatizando VLANs e interfaces em switches OpenWrt |
| Frontend Zabbix não carrega após atualização | Versão do frontend incompatível com o backend | Atualize também o pacote zabbix-frontend-php para a mesma versão do servidor | Backup e atualização: evitando surpresas no Zabbix |
| Triggers não disparam após restauração | Banco restaurado parcialmente ou schema corrompido | Restaure o backup completo e verifique integridade do banco | Backup e atualização: evitando surpresas no Zabbix |
| Erro de conexão ao banco após atualização | Arquivo de configuração zabbix_server.conf sobrescrito ou alterado | Restaure o arquivo de configuração salvo no backup | Backup e atualização: evitando surpresas no Zabbix |
| Failover não ocorre ao cair o link principal | Configuração incorreta do mwan3 ou monitoramento de link mal definido | Revise o arquivo /etc/config/mwan3 e ajuste os alvos de monitoramento | Balanceamento de carga e alta disponibilidade na prática |
| Clientes Wi-Fi continuam presos ao mesmo AP mesmo com congestionamento | usteer não está ativo ou limites de clientes não foram configurados | Verifique status do serviço usteer e revise /etc/config/usteer | Balanceamento de carga e alta disponibilidade na prática |
| Gateway virtual não assume após falha do roteador principal | keepalived mal configurado ou conflito de IP | Ajuste o arquivo keepalived.conf e teste failover manualmente | Balanceamento de carga e alta disponibilidade na prática |
| Failover não ocorre ao cair o link principal | Configuração incorreta do mwan3 ou monitoramento de link mal definido | Revise o arquivo /etc/config/mwan3 e ajuste os alvos de monitoramento | Balanceamento de carga e alta disponibilidade na prática |
| Clientes Wi-Fi continuam presos ao mesmo AP mesmo com congestionamento | usteer não está ativo ou limites de clientes não foram configurados | Verifique status do serviço usteer e revise /etc/config/usteer | Balanceamento de carga e alta disponibilidade na prática |
| Gateway virtual não assume após falha do roteador principal | keepalived mal configurado ou conflito de IP | Ajuste o arquivo keepalived.conf e teste failover manualmente | Balanceamento de carga e alta disponibilidade na prática |
| Frontend exibe erro 'Unable to connect to database'. | Configuração de conexão incorreta ou serviço MySQL parado. | Verifique credenciais em zabbix.conf.php e se o MySQL está rodando. | Banco de dados e frontend: onde moram os dados e as telas |
| Frontend lento ou travando ao carregar gráficos. | Banco de dados sobrecarregado ou disco lento. | Ajuste buffers do MySQL e verifique uso de disco. | Banco de dados e frontend: onde moram os dados e as telas |
| Dados antigos não são removidos do banco. | Housekeeping desativado ou mal configurado. | Revise as configurações de housekeeping no frontend. | Banco de dados e frontend: onde moram os dados e as telas |
| Consultas do Zabbix lentas ou travando | Tabelas históricas muito grandes ou falta de RAM para o buffer pool | Reduza a retenção de dados e aumente o innodb_buffer_pool_size | Banco de dados: como não travar o MySQL do Zabbix |
| MySQL usando swap intensamente | innodb_buffer_pool_size maior que a RAM disponível | Reduza o buffer pool para caber na RAM física | Banco de dados: como não travar o MySQL do Zabbix |
| Erro de conexão do Zabbix com o banco | max_connections atingido ou MySQL travado | Aumente max_connections e investigue queries lentas | Banco de dados: como não travar o MySQL do Zabbix |
| Erro de conexão ao banco | Driver Python ausente ou string de conexão incorreta | Instale o driver correto e revise a string de conexão | BI open source vs. soluções proprietárias: Apache Superset e |
| Tabelas do bi_varejo não aparecem | Permissões insuficientes ou schema não criado | Garanta que o usuário tem acesso ao schema e que ele existe | BI open source vs. soluções proprietárias: Apache Superset e |
| Consultas lentas ou travando | Executando em produção ou sem índices | Use réplica/extrator e otimize índices no modelo simulado | BI open source vs. soluções proprietárias: Apache Superset e |
| API responde '403 Forbidden' mesmo com token válido | IP não está na whitelist do Nginx | Adicione o IP correto no bloco 'allow' da configuração Nginx | Blindando integrações: HTTPS, tokens e restrição de IP |
| API responde '401 Unauthorized' | Token de autenticação ausente ou inválido | Confirme o token e envie no header Authorization | Blindando integrações: HTTPS, tokens e restrição de IP |
| Conexão recusada ao acessar via HTTPS | Certificado SSL ausente ou mal configurado | Verifique caminhos dos arquivos do certificado e reinicie o Nginx | Blindando integrações: HTTPS, tokens e restrição de IP |
| Usuário consegue ver dados de outra loja | Falta de domínio correto na regra de acesso | Revisar e ajustar o domínio da ACL para filtrar pelo campo company_id | Bootstrap do ambiente: módulos, usuários e permissões |
| Usuário não consegue acessar nem sua própria loja | Permissão insuficiente ou grupo errado | Verifique se o usuário está no grupo correto e se as permissões básicas estão atribuídas | Bootstrap do ambiente: módulos, usuários e permissões |
| Módulo não aparece para instalar | Filtro de apps ocultando módulos já instalados ou não disponíveis na Community | Remova filtros e confirme se o módulo faz parte da versão Community | Bootstrap do ambiente: módulos, usuários e permissões |
| Painel não atualiza com os dados recentes | Extração do ERP está atrasada ou falhou | Verifique logs do job de extração e ajuste o agendamento | Campanhas de marketing: mensuração de impacto e ajuste em te |
| KPIs de campanha aparecem zerados | Vendas não estão vinculadas corretamente à campanha na base de dados | Revise o processo de cadastro e extração das campanhas | Campanhas de marketing: mensuração de impacto e ajuste em te |
| Consultas do Metabase estão lentas | Banco de BI sobrecarregado ou consultas mal otimizadas | Otimize índices e revise as consultas SQL | Campanhas de marketing: mensuração de impacto e ajuste em te |
| Dashboard não mostra dados atualizados | Carga de dados da réplica ou extração está atrasada | Verifique o agendamento da carga e execute manualmente se necessário | Campanhas e promoções: aprendizados de dashboards de marketi |
| Erro de conexão no Superset | Driver DB-API ausente ou string de conexão incorreta | Instale o driver correto e revise a URI de conexão | Campanhas e promoções: aprendizados de dashboards de marketi |
| Indicadores inconsistentes | Consulta SQL com filtros errados ou dados incompletos | Revise as queries e confirme o modelo de dados com o DBA | Campanhas e promoções: aprendizados de dashboards de marketi |
| Dispositivo não responde após upgrade | Firmware incompatível ou erro durante o processo | Aplique rollback via console serial ou TFTP, usando o backup realizado | Case: atualização de firmware e rollback sem downtime crític |
| Configurações perdidas após upgrade | Upgrade executado sem preservar configs | Restaure o backup das configurações com 'scp' ou playbook de restore | Case: atualização de firmware e rollback sem downtime crític |
| Playbook trava em wait_for | Dispositivo demorando para reiniciar ou problema de rede | Aumente o timeout ou verifique conectividade física | Case: atualização de firmware e rollback sem downtime crític |
| Rollback automático falha | Dispositivo sem suporte a fallback ou sem acesso remoto | Recuperação manual via bootloader ou assistência técnica | Case: atualização de firmware e rollback sem downtime crític |
| Wi-Fi não aparece após o deploy | Erro na configuração do arquivo wireless ou VLAN não ativa | Revise o template e valide com 'uci show wireless' e 'ip link' | Case: padronizando Wi-Fi e VLANs em 50 lojas |
| Perda total de conectividade após o playbook | Arquivo de rede corrompido ou sintaxe inválida | Restaure backup anterior e valide sintaxe antes do próximo deploy | Case: padronizando Wi-Fi e VLANs em 50 lojas |
| VLAN criada, mas sem tráfego | Tag de VLAN incompatível com o switch | Ajuste a configuração para o padrão aceito pelo modelo do switch | Case: padronizando Wi-Fi e VLANs em 50 lojas |
| Usuário do Metabase consegue editar dados no banco. | Permissão de escrita concedida por engano. | Revogue todas as permissões de escrita e conceda apenas SELECT. | Checklist de BI seguro: do acesso à exportação |
| Consultas do BI deixam o ERP lento. | BI consultando banco de produção em horário de pico. | Configure réplica ou extração agendada para BI. | Checklist de BI seguro: do acesso à exportação |
| Exportações não aparecem nos logs do Metabase. | Logs desativados ou configuração incorreta. | Ative e revise configuração de logs no Metabase e no banco. | Checklist de BI seguro: do acesso à exportação |
| Arquivo de log não aparece no servidor central | Permissões insuficientes ou caminho incorreto no fetch | Ajuste permissões e revise o caminho src/dest no playbook | Coleta automatizada de logs e diagnósticos de rede |
| Saída de comando incompleta | Timeout ou limitação de buffer SSH | Aumente o timeout do Ansible e revise as configurações de buffer | Coleta automatizada de logs e diagnósticos de rede |
| Logs não chegam ao servidor central em tempo real | Configuração incorreta do rsyslog ou firewall bloqueando porta 514 | Revise o /etc/rsyslog.conf e libere a porta no firewall | Coleta automatizada de logs e diagnósticos de rede |
| Comando falha em alguns dispositivos | Comando não disponível ou diferença de sistema operacional | Ajuste o playbook para checar o tipo de sistema antes de executar | Coleta automatizada de logs e diagnósticos de rede |
| Coleta pós-falha não dispara | Integração com monitoramento ausente ou mal configurada | Verifique integração entre ferramenta de monitoramento e Ansible | Coleta automatizada de logs e diagnósticos de rede |
| Playbook retorna erro de autenticação SNMP | Credenciais SNMP incorretas ou versão incompatível. | Verifique a comunidade SNMP, versão e permissões no dispositivo. | Coletando métricas de rede com Ansible e SNMP |
| Sem resposta do host SNMP | Firewall bloqueando porta UDP 161 ou SNMP desabilitado. | Libere a porta 161/UDP e ative SNMP no dispositivo. | Coletando métricas de rede com Ansible e SNMP |
| Dados incompletos ou ausentes | OID inicial errado ou dispositivo não implementa todos os OIDs. | Ajuste o start_oid e consulte a documentação do fabricante. | Coletando métricas de rede com Ansible e SNMP |
| Venda não aparece no Odoo | Falha de comunicação PDV-API ou autenticação inválida | Verifique logs do Odoo e do PDV, teste endpoint REST manualmente | Componentes críticos: Odoo, PostgreSQL e APIs REST no varejo |
| Estoque não atualiza após venda | Workflow de estoque não configurado ou erro de permissão | Reveja permissões do usuário API e regras de estoque no Odoo | Componentes críticos: Odoo, PostgreSQL e APIs REST no varejo |
| Odoo lento em horários de pico | Workers insuficientes ou banco sobrecarregado | Ajuste número de workers e monitore uso de CPU/memória | Componentes críticos: Odoo, PostgreSQL e APIs REST no varejo |
| Erros de autenticação na API REST | Token expirado ou configuração incorreta | Gere novo token e revise configuração de autenticação | Componentes críticos: Odoo, PostgreSQL e APIs REST no varejo |
| PDV sem acesso à internet | VLAN ou regra de firewall bloqueando tráfego | Revise configuração de VLAN e regras de firewall | Componentes essenciais: switches, roteadores, APs, servidore |
| AP não distribui IP para clientes | DHCP não configurado na VLAN correta | Ajuste o escopo DHCP para a VLAN do Wi-Fi | Componentes essenciais: switches, roteadores, APs, servidore |
| Servidor inacessível de estações administrativas | Porta do switch ou VLAN errada | Verifique o mapeamento de portas e VLANs | Componentes essenciais: switches, roteadores, APs, servidore |
| Erro de autenticação | Usuário ou senha incorretos, ou permissão insuficiente | Confirme credenciais e permissões com o DBA | Conectando Metabase a réplicas de SQL Server, Oracle, Postgr |
| Driver não encontrado (Oracle ou Db2) | JAR ausente ou em pasta errada | Coloque o JAR correto na pasta plugins e reinicie | Conectando Metabase a réplicas de SQL Server, Oracle, Postgr |
| Timeout na conexão | Firewall bloqueando porta ou host incorreto | Libere a porta no firewall e revise o endereço | Conectando Metabase a réplicas de SQL Server, Oracle, Postgr |
| Tabelas não aparecem | Permissão insuficiente no usuário | Solicite acesso às tabelas necessárias ao DBA | Conectando Metabase a réplicas de SQL Server, Oracle, Postgr |
| Erro 'driver não encontrado' ao testar conexão | Driver DB-API não instalado no container | Adicione o driver ao requirements-local.txt e reconstrua o container | Conectando o Superset ao banco: drivers, URIs e permissões s |
| Permissão negada ao consultar tabela | Usuário não tem permissão SELECT na tabela | Solicite ao DBA revisão das permissões | Conectando o Superset ao banco: drivers, URIs e permissões s |
| Timeout ao conectar | Firewall bloqueando porta do banco | Peça liberação da porta e teste conectividade com telnet ou nc | Conectando o Superset ao banco: drivers, URIs e permissões s |
| Erro de driver ausente ao conectar Oracle | ojdbc8.jar não está na pasta plugins ou está na versão errada | Coloque o driver correto na pasta plugins e reinicie o Metabase | Conectores Metabase: PostgreSQL, SQL Server, Oracle e limita |
| Conexão SQL Server falha com instância nomeada | Porta ou nome da instância incorretos | Confirme porta e nome da instância com o DBA | Conectores Metabase: PostgreSQL, SQL Server, Oracle e limita |
| Permissão negada ao acessar tabelas | Usuário sem permissão de leitura | Ajuste permissões no banco, garantindo acesso somente leitura | Conectores Metabase: PostgreSQL, SQL Server, Oracle e limita |
| Conexão lenta ou travando | Consultas pesadas no banco de produção | Use réplica ou extração agendada para BI | Conectores Metabase: PostgreSQL, SQL Server, Oracle e limita |
| Erro 'No suitable driver found' ao conectar Oracle | Driver JDBC ausente ou mal posicionado | Confirme que o ojdbc8.jar está no diretório plugins e reinicie o container. | Configuração do Metabase para bancos TOTVS: Docker, plugins |
| Metabase não inicia ou reinicia em loop | Variáveis de ambiente obrigatórias ausentes ou conflito de portas/volumes | Revise as variáveis e os volumes montados, ajuste se necessário. | Configuração do Metabase para bancos TOTVS: Docker, plugins |
| Conexão ao banco falha com timeout | Firewall ou rede bloqueando porta do banco | Libere a porta no firewall e teste a conectividade com telnet ou nc. | Configuração do Metabase para bancos TOTVS: Docker, plugins |
| Usuário não consegue acessar determinado dashboard | Permissão insuficiente no grupo ou coleção | Revise as permissões do grupo e da coleção no menu de administração | Configuração inicial do Metabase: usuários, permissões e idi |
| Datas dos relatórios aparecem erradas | Fuso horário incorreto no perfil do usuário ou na configuração global | Ajuste o fuso horário em 'Minha Conta' e em 'Configurações Gerais' | Configuração inicial do Metabase: usuários, permissões e idi |
| Usuário recebe erro de senha fraca ao criar conta | Política de senha mínima ativada | Oriente o usuário a criar uma senha mais forte | Configuração inicial do Metabase: usuários, permissões e idi |
| Usuário vê dashboards de outra loja | Permissão de role configurada de forma ampla demais | Revise as permissões da role e restrinja ao schema correto | Configuração multi-loja: separando acessos e dashboards |
| Usuário não vê nenhum dashboard | Role sem permissão para dashboards ou schema | Inclua permissões de acesso ao schema e dashboards | Configuração multi-loja: separando acessos e dashboards |
| Filtro dinâmico não funciona | Variável Jinja não suportada no ambiente | Consulte a documentação para variáveis disponíveis e ajuste o filtro | Configuração multi-loja: separando acessos e dashboards |
| Erro 'Access denied for user' | Usuário ou senha errados, ou permissões insuficientes | Revise o comando GRANT e o arquivo zabbix_server.conf | Configurando o MySQL para o Zabbix: do zero ao primeiro logi |
| Erro 'Unknown database zabbix' | Banco não criado ou nome errado no conf | Crie o banco e ajuste o DBName | Configurando o MySQL para o Zabbix: do zero ao primeiro logi |
| Frontend não conecta ao banco | Serviço MySQL parado ou firewall bloqueando | Verifique se o MySQL está rodando e portas abertas | Configurando o MySQL para o Zabbix: do zero ao primeiro logi |
| Erro 'table already exists' ao importar schema | Schema já importado antes | Apague o banco e recomece a importação | Configurando o MySQL para o Zabbix: do zero ao primeiro logi |
| Dashboard trava ou retorna timeout | Query sem índice ou com join pesado | Analise com EXPLAIN e crie índices nos campos filtrados | Consultas lentas e dashboards travando: análise e otimização |
| Consulta rápida no banco, mas lenta no Superset | Superset configurado com timeout baixo ou excesso de filtros | Ajuste o timeout e simplifique o dashboard | Consultas lentas e dashboards travando: análise e otimização |
| Materialized view desatualizada | View não foi atualizada após carga de dados | Execute REFRESH MATERIALIZED VIEW nome_view | Consultas lentas e dashboards travando: análise e otimização |
| Host unreachable | Problema de rede ou SSH bloqueado | Verifique firewall e conectividade IP | Control node, inventário e delegação: como o Ansible enxerga |
| Inventário dinâmico não retorna hosts | Erro no script ou fonte de dados externa | Revise o script e teste manualmente a consulta | Control node, inventário e delegação: como o Ansible enxerga |
| Tarefa delegada não executa | Host delegado inacessível ou mal configurado | Teste SSH e revise as permissões do usuário | Control node, inventário e delegação: como o Ansible enxerga |
| Playbook lento | Paralelismo baixo ou gargalo de rede | Ajuste forks no ansible.cfg e monitore largura de banda | Control node, inventário e delegação: como o Ansible enxerga |
| Usuário vê hosts que não deveria | Permissão excessiva em algum grupo de usuários | Revise permissões de todos os grupos aos quais o usuário pertence | Controle de acesso: usuários, permissões e auditoria |
| Alterações não aparecem no log de auditoria | Auditoria não ativada ou versão do Zabbix sem suporte | Ative auditoria e consulte a documentação da sua versão | Controle de acesso: usuários, permissões e auditoria |
| Usuário não consegue acessar dashboards permitidos | Role ou permissão de grupo restritiva demais | Ajuste user role e permissões de grupo de hosts | Controle de acesso: usuários, permissões e auditoria |
| Host aparece como 'Unavailable' | IP ou interface configurada incorretamente | Verifique o endereço IP e o tipo de interface (Agent ou SNMP) no cadastro do host | Criando hosts, itens e triggers para PDVs e switches |
| Itens SNMP não coletam dados | SNMP não habilitado ou comunidade incorreta | Confirme SNMP ativo no dispositivo e comunidade correta no item | Criando hosts, itens e triggers para PDVs e switches |
| Trigger dispara sem motivo aparente | Condições da trigger muito sensíveis | Ajuste o tempo ou valor de comparação da trigger | Criando hosts, itens e triggers para PDVs e switches |
| Consulta retorna zero resultados | Filtros muito restritivos ou joins errados | Revise condições WHERE e ON, amplie filtros para testar | Cruzando dados de clientes, produtos e lojas: segmentação pa |
| Coluna de loja não encontrada | Campo pode estar em outra tabela (fato_venda ou fato_venda_item) | Confirme o modelo com o DBA e ajuste o SQL | Cruzando dados de clientes, produtos e lojas: segmentação pa |
| Exportação falha ou arquivo vazio | Consulta não retorna linhas ou há erro de permissão | Rode a consulta direto no Metabase, revise permissões e filtros | Cruzando dados de clientes, produtos e lojas: segmentação pa |
| Consulta lenta ou travando | Consulta executada em banco de produção ou sem índices | Use réplica, otimize índices, revise joins | Curva ABC de produtos e de clientes em SQL no Apache Superse |
| Erro de conexão no Superset | Driver não instalado ou URI incorreta | Verifique o requirements-local.txt e a string de conexão | Curva ABC de produtos e de clientes em SQL no Apache Superse |
| Campos não encontrados | Nomes de campos diferentes no ambiente | Consulte o dicionário SX2 do seu ambiente | Curva ABC de produtos e de clientes em SQL no Apache Superse |
| Resultados inconsistentes | Dados incompletos ou extração parcial | Reveja o processo de ETL e a cobertura dos dados | Curva ABC de produtos e de clientes em SQL no Apache Superse |
| Consulta retorna erro de permissão. | Usuário sem acesso de leitura à tabela ou esquema. | Solicite ao DBA ajuste de permissão somente leitura na réplica autorizada. | Curva ABC de produtos e de clientes em SQL no Apache Superse |
| Percentual acumulado ultrapassa 1 (100%). | Erro no cálculo do acumulado; provavelmente uso incorreto de OVER(). | Revise a consulta, garanta que o acumulado está sobre o ORDER BY correto. | Curva ABC de produtos e de clientes em SQL no Apache Superse |
| Gráfico não mostra as classes ABC corretamente. | Coluna de classe_abc ausente ou erro no CASE. | Inclua o CASE na consulta, revise os limites de corte. | Curva ABC de produtos e de clientes em SQL no Apache Superse |
| Consulta lenta ou travando o banco | Execução em produção sem índices ou horários de pico | Execute em réplica ou extraia para banco dedicado ao BI | Curva ABC de produtos e de clientes em SQL no Metabase sobre |
| Campos retornando nulo ou erro de coluna inexistente | Campo não existe ou nome diferente no ambiente | Consulte o dicionário SX2 do seu ambiente para os nomes corretos | Curva ABC de produtos e de clientes em SQL no Metabase sobre |
| Resultados inconsistentes com relatórios oficiais | Filtros ou joins incorretos na consulta | Revise a lógica SQL e compare com o processo de fechamento do ERP | Curva ABC de produtos e de clientes em SQL no Metabase sobre |
| Erro de permissão ao executar a consulta | Usuário sem acesso às tabelas necessárias | Solicite ao DBA permissão de leitura nas tabelas SD2, SB1 e SA1 | Curva ABC de produtos e de clientes em SQL no Metabase sobre |
| Consulta SQL retorna erro de sintaxe | Função de janela ou agregação mal utilizada | Revise a ordem dos GROUP BY e das funções OVER; consulte a documentação do PostgreSQL | Curva ABC de produtos e de clientes em SQL no Metabase: a co |
| Gráfico não mostra curva ABC esperada | Campos de percentual acumulado ou ranking calculados incorretamente | Valide os cálculos de SUM e OVER; confira se os dados de entrada estão corretos | Curva ABC de produtos e de clientes em SQL no Metabase: a co |
| Classe ABC não aparece na tabela | CASE mal implementado ou campo de percentual acumulado fora do range | Revise a lógica do CASE e os valores de perc_acumulado | Curva ABC de produtos e de clientes em SQL no Metabase: a co |
| Faltam registros recentes na réplica | Janela de carga desatualizada ou processo de ETL atrasado | Ajustar agendamento da carga e validar logs | Dados inconsistentes ou faltantes: causas e validação na rép |
| Campos aparecem vazios ou cortados | Truncamento por tipo de campo inadequado | Aumentar tamanho do campo na réplica e revisar ETL | Dados inconsistentes ou faltantes: causas e validação na rép |
| Tabelas inteiras sem dados | Permissão insuficiente do usuário de leitura | Revisar permissões no SGBD | Dados inconsistentes ou faltantes: causas e validação na rép |
| Diferença grande entre produção e réplica | Falha parcial ou total na extração | Reexecutar carga e revisar logs | Dados inconsistentes ou faltantes: causas e validação na rép |
| Registros com caracteres estranhos ou corrompidos | Problema de encoding na extração | Padronizar encoding para UTF-8 | Dados inconsistentes ou faltantes: causas e validação na rép |
| Campos sensíveis aparecem completos no dashboard | View SQL sem anonimização ou dataset conectado à tabela original | Recrie a view com anonimização e aponte o dataset para ela | Dados sensíveis: anonimização e compliance em dashboards |
| Erro ao criar view com funções de string | Sintaxe incompatível com o banco (funções diferentes em Oracle, PostgreSQL, SQL Server) | Adapte as funções conforme o banco; consulte a documentação oficial | Dados sensíveis: anonimização e compliance em dashboards |
| Usuário sem permissão visualiza dados sensíveis | Permissões mal configuradas no Superset | Revise os grupos e restrinja o acesso aos datasets sensíveis | Dados sensíveis: anonimização e compliance em dashboards |
| Erro de conexão no Superset | Driver Python ausente ou URI incorreta | Verifique o requirements-local.txt e a string de conexão | Dashboard de PDV no Apache Superset: vendas por hora, ticket |
| Gráficos vazios | Query SQL errada ou tabela/dado ausente | Teste a consulta no SQL Lab e revise o modelo | Dashboard de PDV no Apache Superset: vendas por hora, ticket |
| Filtros não afetam todos os gráficos | Filtros não vinculados corretamente | Configure o Filter Box para afetar todos os componentes relevantes | Dashboard de PDV no Apache Superset: vendas por hora, ticket |
| Dashboard vazio ou com erro | Consulta SQL com erro de sintaxe ou campos inexistentes | Revise os nomes de tabelas e campos no modelo bi_varejo | Dashboard de PDV no Metabase: vendas por hora, ticket médio |
| Valores muito baixos ou altos | Filtro de data incorreto ou ausência de dados no período | Ajuste o filtro de data e valide se há dados carregados | Dashboard de PDV no Metabase: vendas por hora, ticket médio |
| Gráficos truncados | Limite de linhas ou agrupamento inadequado | Revise o GROUP BY e o ORDER BY nas consultas | Dashboard de PDV no Metabase: vendas por hora, ticket médio |
| Números do dashboard não batem com o ERP | Filtro de status incorreto, inclusão de notas canceladas ou atraso na replicação | Revise os filtros SQL e confirme a atualização da réplica | Dashboards de vendas processadas: SF2 e SD2 como fonte confi |
| Metabase não conecta ao Oracle | Driver JDBC ausente ou versão incompatível | Baixe o ojdbc8.jar da Oracle 19c, coloque na pasta plugins e reinicie o Metabase | Dashboards de vendas processadas: SF2 e SD2 como fonte confi |
| Consulta SQL lenta ou travando | Execução no banco de produção ou falta de índices | Use réplica, revise índices e otimize a query | Dashboards de vendas processadas: SF2 e SD2 como fonte confi |
| Dashboard apresenta dados desatualizados | Falha no processo de ETL ou atraso na réplica | Verifique logs do ETL e sincronização da réplica | De planilha a dashboard: evolução real de BI em supermercado |
| Erro de conexão no Superset | Driver DB-API não instalado ou string de conexão incorreta | Confirme instalação do psycopg2 e revise a URI | De planilha a dashboard: evolução real de BI em supermercado |
| Consultas lentas ou travando | Queries mal otimizadas ou falta de índices no PostgreSQL | Reveja o SQL, crie índices e limite o volume de dados exibidos | De planilha a dashboard: evolução real de BI em supermercado |
| Hosts não aparecem após conectar à rede | Range de IPs ou método de verificação incorretos | Revise a configuração da discovery rule e o acesso SNMP/ICMP | Descoberta automática: monitorando novos dispositivos sem in |
| Hosts irrelevantes adicionados | Condições de ação muito amplas | Ajuste filtros e condições nas ações automáticas | Descoberta automática: monitorando novos dispositivos sem in |
| Carga alta no Zabbix ou na rede durante a descoberta | Intervalo de varredura muito curto ou range muito grande | Aumente o intervalo e restrinja o range de IPs | Descoberta automática: monitorando novos dispositivos sem in |
| Campo customizado não aparece na tela de produto | O módulo customizado não foi instalado ou atualizado | Execute 'odoo -u nome_do_modulo' e limpe o cache do navegador | Desenho do escopo: módulos, customizações e MVP viável |
| Relatórios de vendas não trazem dados por loja | Falta configuração de multi-company ou multi-warehouse | Revise a configuração de empresas e armazéns no Odoo | Desenho do escopo: módulos, customizações e MVP viável |
| Erro ao transferir estoque entre lojas | Permissões do usuário ou configuração de rotas incompleta | Ajuste permissões e revise as rotas de transferência em Inventory | Desenho do escopo: módulos, customizações e MVP viável |
| Sinal fraco em áreas críticas mesmo após instalação | Barreiras físicas não consideradas no projeto | Reveja a planta, adicione APs ou reposicione equipamentos | Desenho do projeto: plantas, zonas e mapas de calor |
| Interferência entre APs próximos | Sobreposição excessiva de canais | Ajuste canais manualmente e reduza potência dos APs | Desenho do projeto: plantas, zonas e mapas de calor |
| Zonas de sombra não previstas no mapa de calor | Coleta de dados insuficiente ou planta desatualizada | Refaça a coleta e atualize a documentação | Desenho do projeto: plantas, zonas e mapas de calor |
| Sinal fraco em áreas críticas mesmo após instalação | Barreiras físicas não consideradas no projeto | Reveja a planta, adicione APs ou reposicione equipamentos | Desenho do projeto: plantas, zonas e mapas de calor |
| Interferência entre APs próximos | Sobreposição excessiva de canais | Ajuste canais manualmente e reduza potência dos APs | Desenho do projeto: plantas, zonas e mapas de calor |
| Zonas de sombra não previstas no mapa de calor | Coleta de dados insuficiente ou planta desatualizada | Refaça a coleta e atualize a documentação | Desenho do projeto: plantas, zonas e mapas de calor |
| Sem acesso à internet, mas ping local funciona | Problema no roteador ou link externo | Verifique logs do roteador e status do link WAN | Diagnóstico de falhas: do cabo ao Wi-Fi |
| Cliente Wi-Fi cai frequentemente | Sinal fraco ou interferência | Realoque o AP ou ajuste o canal de operação | Diagnóstico de falhas: do cabo ao Wi-Fi |
| Porta do switch sem link | Cabo rompido ou porta defeituosa | Troque o cabo e teste em outra porta | Diagnóstico de falhas: do cabo ao Wi-Fi |
| Sem acesso à internet, mas ping local funciona | Problema no roteador ou link externo | Verifique logs do roteador e status do link WAN | Diagnóstico de falhas: do cabo ao Wi-Fi |
| Cliente Wi-Fi cai frequentemente | Sinal fraco ou interferência | Realoque o AP ou ajuste o canal de operação | Diagnóstico de falhas: do cabo ao Wi-Fi |
| Porta do switch sem link | Cabo rompido ou porta defeituosa | Troque o cabo e teste em outra porta | Diagnóstico de falhas: do cabo ao Wi-Fi |
| Coletas atrasadas ou faltando | Polling interval baixo demais ou poucos pollers | Aumente StartPollers ou aumente o polling interval | Dimensionamento de hardware e rede para Zabbix em lojas |
| Alto uso de CPU | Itens demais ou polling muito frequente | Reduza itens ou aumente o polling interval | Dimensionamento de hardware e rede para Zabbix em lojas |
| Disco enchendo rápido | Retenção alta ou coleta de muitos itens | Reduza retenção ou aumente espaço em disco | Dimensionamento de hardware e rede para Zabbix em lojas |
| Alertas de pollers ocupados | StartPollers insuficiente | Aumente o parâmetro StartPollers no arquivo de configuração | Dimensionamento de hardware e rede para Zabbix em lojas |
| Dashboards lentos ou travando | Falta de RAM ou CPU no servidor do Metabase ou banco de dados | Aumente recursos e otimize queries | Dimensionando a infraestrutura: Metabase, banco e rede |
| Erro de conexão entre Metabase e banco | Firewall bloqueando porta do banco ou latência alta | Libere portas e reduza saltos de rede | Dimensionando a infraestrutura: Metabase, banco e rede |
| Queries demoradas no PostgreSQL | Falta de índices ou disco lento | Crie índices e use SSD dedicado | Dimensionando a infraestrutura: Metabase, banco e rede |
| Metabase fica lento ou trava em horários de pico | CPU ou RAM insuficientes para a carga de trabalho | Aumente mem_limit e cpus no Docker Compose e reinicie os containers | Dimensionando Metabase e PostgreSQL em Docker: CPU, RAM e st |
| PostgreSQL para de responder e logs mostram erro de disco cheio | Logs e dados no mesmo volume, sem monitoramento do crescimento | Separe volumes de logs e dados e limpe logs antigos | Dimensionando Metabase e PostgreSQL em Docker: CPU, RAM e st |
| Containers caem sem aviso | Host Docker sem RAM suficiente para todos os containers | Aumente a RAM do host ou reduza o número de containers | Dimensionando Metabase e PostgreSQL em Docker: CPU, RAM e st |
| Dashboards lentos ou travando | Falta de RAM ou disco lento no PostgreSQL | Aumente RAM, migre para SSD, ajuste work_mem | Dimensionando o Superset e o PostgreSQL para BI de varejo |
| Erros de conexão no Superset | Limite de max_connections atingido no PostgreSQL | Aumente max_connections ou reduza workers | Dimensionando o Superset e o PostgreSQL para BI de varejo |
| Consumo alto de CPU no Superset | Consultas SQL mal otimizadas ou dashboards muito pesados | Revise queries e simplifique painéis | Dimensionando o Superset e o PostgreSQL para BI de varejo |
| Consultas no Superset estão lentas ou travam | Consulta sendo executada no banco de produção, sem réplica ou extração | Redirecione o BI para uma réplica ou banco dedicado | Do Protheus ao Superset: fluxo real dos dados e riscos do ac |
| Dados inconsistentes ou incompletos nos dashboards | Extração feita antes do processamento completo das vendas (job LJGRVBATCH não rodou) | Ajuste o agendamento da extração para após o processamento | Do Protheus ao Superset: fluxo real dos dados e riscos do ac |
| Erro de permissão ao conectar o Superset | Usuário sem permissão de leitura nas tabelas necessárias | Solicite ao DBA a revisão das permissões | Do Protheus ao Superset: fluxo real dos dados e riscos do ac |
| Superset não sobe ou dá erro de driver | Driver não listado no requirements-local.txt ou erro de sintaxe | Revise o requirements-local.txt e reconstrua o contêiner | Dockerizando o BI: Superset em contêiner para varejo |
| Dados e dashboards somem após reiniciar | Volumes não mapeados corretamente | Garanta que os volumes ./superset_home e ./db_data estão definidos no docker-compose | Dockerizando o BI: Superset em contêiner para varejo |
| Erro ao conectar ao banco de dados externo | URI de conexão incorreta ou firewall bloqueando porta | Confirme a URI e libere as portas necessárias no firewall | Dockerizando o BI: Superset em contêiner para varejo |
| Painel apresenta valores inconsistentes após atualização do ERP | Mudança em campos ou lógica de negócio não refletida na query | Revisar queries e atualizar conforme o novo modelo; consultar o SX2 atualizado | Documentação e governança de dados no BI de varejo |
| Consulta retorna erro de permissão | Acesso não autorizado ao banco ou tabela restrita | Solicitar liberação ao DBA e revisar política de acesso | Documentação e governança de dados no BI de varejo |
| Analistas usam campos com nomes diferentes para o mesmo conceito | Falta de catálogo de dados unificado | Centralizar documentação e padronizar nomenclatura conforme o SX2 | Documentação e governança de dados no BI de varejo |
| Campo sem descrição no dicionário | Levantamento incompleto ou falta de validação com o time funcional | Revisar com o time e atualizar o dicionário imediatamente | Documentação viva: dicionário de dados, queries e dashboards |
| Query sem histórico de alterações | Script não versionado ou versionamento manual | Migrar scripts para repositório Git e padronizar commits | Documentação viva: dicionário de dados, queries e dashboards |
| Dashboard compartilhado mostra dados sensíveis | Permissões mal configuradas ou falta de anonimização | Rever grupos de acesso e anonimizar dados pessoais | Documentação viva: dicionário de dados, queries e dashboards |
| Equipamento não aparece no inventário | Cadastro desatualizado ou falha de comunicação | Refaça o levantamento físico e atualize o inventário | Documentação, inventário e gestão de mudanças |
| Rollback não funciona | Backup corrompido ou incompatível | Teste backups regularmente e documente o procedimento de restauração | Documentação, inventário e gestão de mudanças |
| Equipe não sabe de mudanças recentes | Falta de comunicação formal | Implemente avisos obrigatórios antes de qualquer alteração | Documentação, inventário e gestão de mudanças |
| Equipamento não aparece no inventário | Cadastro desatualizado ou falha de comunicação | Refaça o levantamento físico e atualize o inventário | Documentação, inventário e gestão de mudanças |
| Rollback não funciona | Backup corrompido ou incompatível | Teste backups regularmente e documente o procedimento de restauração | Documentação, inventário e gestão de mudanças |
| Equipe não sabe de mudanças recentes | Falta de comunicação formal | Implemente avisos obrigatórios antes de qualquer alteração | Documentação, inventário e gestão de mudanças |
| Erro 'No module named ...' ao conectar | Driver Python não instalado no container. | Adicione o driver ao requirements-local.txt e reconstrua o container. | Drivers, dialetos e conexões: SQL Server, Oracle, PostgreSQL |
| Timeout ao tentar conectar ao banco | Firewall ou rede bloqueando a porta do SGBD. | Verifique conectividade de rede e libere as portas necessárias. | Drivers, dialetos e conexões: SQL Server, Oracle, PostgreSQL |
| Mensagem de 'Invalid connection string' no Superset | URI de conexão malformada ou dialeto errado. | Revise o formato da URI conforme a documentação oficial. | Drivers, dialetos e conexões: SQL Server, Oracle, PostgreSQL |
| Erro de 'missing shared libraries' ao usar cx_Oracle | Oracle Instant Client não instalado no container. | Instale as bibliotecas do Oracle Instant Client conforme documentação. | Drivers, dialetos e conexões: SQL Server, Oracle, PostgreSQL |
| Venda registrada mas estoque não reduz | Integração entre módulos não ativada ou erro de configuração | Verifique se os módulos 'Sales' e 'Inventory' estão instalados e vinculados. | ERP, estoque e vendas: por que integrar tudo no varejo digit |
| Estoque negativo após vendas | Permissão para estoque negativo habilitada | Desative a opção de permitir estoque negativo nas configurações de estoque. | ERP, estoque e vendas: por que integrar tudo no varejo digit |
| Produtos duplicados no cadastro | Cadastro descentralizado ou importação duplicada | Unifique os cadastros e use identificadores únicos (SKU). | ERP, estoque e vendas: por que integrar tudo no varejo digit |
| Erro de autenticação | Usuário ou senha incorretos, ou permissão insuficiente | Confirme usuário, senha e permissões com o DBA | Erros comuns de conexão: JDBC, SSL e permissões nos SGBDs su |
| Driver JDBC não encontrado | Driver ausente ou versão incompatível | Baixe o driver correto e coloque na pasta plugins, depois reinicie o Metabase | Erros comuns de conexão: JDBC, SSL e permissões nos SGBDs su |
| Erro de SSL handshake | Banco exige SSL e certificado não confiável | Ajuste a string de conexão e valide certificados no Java | Erros comuns de conexão: JDBC, SSL e permissões nos SGBDs su |
| Erro 'No suitable driver found' ao conectar Oracle | Driver JDBC ausente ou em versão errada | Baixe o ojdbc8.jar 19c ou superior e coloque na pasta plugins | Erros comuns de conexão: Oracle, SQL Server, PostgreSQL no M |
| Erro 'Connection refused' ao conectar PostgreSQL | Porta 5432 bloqueada ou listen_addresses restrito | Libere a porta no firewall e ajuste listen_addresses para '*' ou IP do Metabase | Erros comuns de conexão: Oracle, SQL Server, PostgreSQL no M |
| Erro 'Login failed for user' no SQL Server | Usuário ou senha incorretos, ou permissão insuficiente | Confirme credenciais e atribua permissões de leitura | Erros comuns de conexão: Oracle, SQL Server, PostgreSQL no M |
| Erro 'ORA-12514' no Oracle | Service Name incorreto ou listener mal configurado | Confirme Service Name e status do listener no Oracle | Erros comuns de conexão: Oracle, SQL Server, PostgreSQL no M |
| Erro 'FATAL: password authentication failed' no PostgreSQL | Senha errada ou método de autenticação incompatível | Verifique senha e método em pg_hba.conf | Erros comuns de conexão: Oracle, SQL Server, PostgreSQL no M |
| Odoo não inicia | Dependência do sistema ou módulo ausente | Instale dependências e verifique logs em /var/log/odoo/odoo-server.log | Erros comuns: instalação, módulos e integrações |
| Erro 'Unmet dependency' ao instalar módulo | Módulo requerido não está instalado ou versão incompatível | Instale o módulo dependente ou ajuste a versão | Erros comuns: instalação, módulos e integrações |
| Falha na integração REST (401 Unauthorized) | Token de autenticação inválido ou endpoint incorreto | Atualize o token e valide o endpoint | Erros comuns: instalação, módulos e integrações |
| Permissão negada ao gravar log | Permissões erradas no diretório de logs | Ajuste permissões com chown para o usuário do Odoo | Erros comuns: instalação, módulos e integrações |
| Timeout ao conectar | Firewall bloqueando porta ou banco fora do ar | Confirme se a porta está aberta com telnet e peça liberação à equipe de rede | Erros de conexão: causas, logs e soluções rápidas |
| Erro de autenticação | Usuário ou senha incorretos | Revise credenciais e peça ao DBA para resetar a senha se necessário | Erros de conexão: causas, logs e soluções rápidas |
| Driver não encontrado | Pacote Python ausente no ambiente Superset | Adicione o driver correto em requirements-local.txt e reinicie o Superset | Erros de conexão: causas, logs e soluções rápidas |
| Permissão negada em tabela | Usuário sem permissão de leitura | Solicite ao DBA a permissão SELECT nas tabelas necessárias | Erros de conexão: causas, logs e soluções rápidas |
| Erro 'No module named ...' | Driver Python não instalado no ambiente do Superset. | Adicione o driver ao requirements-local.txt e reconstrua o contêiner. | Erros de conexão: drivers, URIs e autenticação no Superset |
| Erro 'Can't connect to ...' | URI malformada, host/porta errados, firewall bloqueando ou credenciais inválidas. | Revise a URI, teste conexão via shell, confirme rede e credenciais. | Erros de conexão: drivers, URIs e autenticação no Superset |
| Erro de autenticação (password authentication failed, login failed) | Usuário ou senha errados, ou permissão insuficiente. | Confirme usuário, senha e privilégios com o DBA. | Erros de conexão: drivers, URIs e autenticação no Superset |
| Dashboards lentos ou travando | Queries pesadas ou falta de índices no banco | Otimizar queries e criar índices apropriados | Escalando Metabase: múltiplos usuários, dashboards e fontes |
| Erros de conexão ao banco | Credenciais incorretas ou banco fora do ar | Verificar usuário, senha e status da réplica | Escalando Metabase: múltiplos usuários, dashboards e fontes |
| Usuários vendo dashboards de outras áreas | Permissões mal configuradas | Revisar grupos e permissões nas coleções | Escalando Metabase: múltiplos usuários, dashboards e fontes |
| Conexão falha ao adicionar banco Oracle | Driver JDBC ausente ou incompatível | Baixe o ojdbc8.jar da Oracle, coloque na pasta plugins e reinicie o Metabase | Escalando o Metabase: múltiplas filiais, múltiplos bancos |
| Consultas lentas em dashboards históricos | Falta de particionamento ou índices no banco BI | Implemente particionamento por data e revise os índices das tabelas | Escalando o Metabase: múltiplas filiais, múltiplos bancos |
| Usuário vê dados de todas as filiais | Falta de filtro ou controle de acesso por filial | Adicione filtros por filial nos dashboards e revise permissões | Escalando o Metabase: múltiplas filiais, múltiplos bancos |
| Dashboards lentos ou travando | Poucos workers configurados ou queries pesadas sem cache | Aumente workers e ative cache | Escalando o Superset: múltiplos workers e balanceamento de c |
| Erros 502/504 no browser | Timeout entre Nginx e Gunicorn ou workers travados | Aumente timeout do Nginx e otimize queries | Escalando o Superset: múltiplos workers e balanceamento de c |
| Consumo de memória muito alto | Workers demais para a RAM disponível | Reduza workers ou aumente memória | Escalando o Superset: múltiplos workers e balanceamento de c |
| Workers Gunicorn morrendo | Falta de recursos ou queries muito pesadas | Otimize queries e dashboards, aumente recursos | Escalando o Superset: múltiplos workers e balanceamento de c |
| Cache não funciona | Configuração incorreta do Redis/Memcached | Revise CACHE_CONFIG e conectividade | Escalando o Superset: múltiplos workers e balanceamento de c |
| Tabela ou campo não encontrado na extração. | Permissão insuficiente ou nome diferente do esperado. | Confirme com o DBA e a CISS o nome correto e revise permissões. | Escolhendo o que carregar: vendas, itens, produtos e cliente |
| Dados pessoais sensíveis aparecem na extração. | Seleção de campos excessiva ou falta de anonimização. | Revise os campos extraídos e aplique anonimização onde necessário. | Escolhendo o que carregar: vendas, itens, produtos e cliente |
| Carga muito lenta ou falha por volume de dados. | Extração de dados desnecessários ou em horário de pico. | Reduza os campos/tabelas extraídos e agende fora do pico. | Escolhendo o que carregar: vendas, itens, produtos e cliente |
| Carga demora mais do que a janela permitida | Volume de dados maior que o estimado ou infraestrutura subdimensionada | Reduza o histórico, otimize queries ou aumente recursos do PostgreSQL | Estimando volume e frequência de carga: vendas, itens e hist |
| Dados inconsistentes entre ERP e BI | Extração feita sem filtros corretos ou durante movimentação no ERP | Garanta carga incremental apenas de dados consolidados e fora do horário de pico | Estimando volume e frequência de carga: vendas, itens e hist |
| Consultas lentas no Metabase | Tabelas de vendas e itens muito grandes sem índices | Implemente índices em campos de data e chaves de busca | Estimando volume e frequência de carga: vendas, itens e hist |
| VPN conecta, mas não pinga IP remoto | Rotas ou firewall bloqueando tráfego | Reveja rotas estáticas e regras de firewall no OpenWrt | Expandindo para múltiplas filiais: VPN, roteamento e gestão |
| AP não aparece no UniFi Controller | AP não consegue alcançar o Controller via VPN | Teste conectividade e revise regras de firewall e DNS | Expandindo para múltiplas filiais: VPN, roteamento e gestão |
| Conexão VPN instável | Problemas de MTU ou perda de pacotes | Ajuste MTU da interface WireGuard e monitore latência | Expandindo para múltiplas filiais: VPN, roteamento e gestão |
| VPN conecta, mas não pinga IP remoto | Rotas ou firewall bloqueando tráfego | Reveja rotas estáticas e regras de firewall no OpenWrt | Expandindo para múltiplas filiais: VPN, roteamento e gestão |
| AP não aparece no UniFi Controller | AP não consegue alcançar o Controller via VPN | Teste conectividade e revise regras de firewall e DNS | Expandindo para múltiplas filiais: VPN, roteamento e gestão |
| Conexão VPN instável | Problemas de MTU ou perda de pacotes | Ajuste MTU da interface WireGuard e monitore latência | Expandindo para múltiplas filiais: VPN, roteamento e gestão |
| Hosts aparecem como 'não suportado' | Template incompatível ou serviço não disponível | Revise o template e verifique se o serviço está ativo no host. | Expansão rápida: como integrar novas lojas sem perder o cont |
| Proxy aparece como 'inativo' | Problema de rede ou configuração incorreta do proxy | Cheque firewall, IPs e parâmetros Server/Hostname no proxy. | Expansão rápida: como integrar novas lojas sem perder o cont |
| Dados dos hosts não chegam ao servidor | Configuração errada do agente (Server/ServerActive) | Confirme que ambos apontam para o IP do proxy correto. | Expansão rápida: como integrar novas lojas sem perder o cont |
| Arquivo CSV com caracteres estranhos ou acentuação errada | Problema de encoding (UTF-8 vs ANSI) | Abra o arquivo em editor que suporte UTF-8 ou converta o encoding antes de importar | Exportação de dados do Metabase: integração com CRM e market |
| Erro de autenticação na API do Metabase | Token de sessão expirado ou credenciais incorretas | Gere um novo token de sessão e revise usuário/senha | Exportação de dados do Metabase: integração com CRM e market |
| Consulta lenta ou travando exportação | Consulta pesada executada em banco de produção | Execute em réplica ou otimize a consulta; evite horários de pico | Exportação de dados do Metabase: integração com CRM e market |
| Host não muda para vermelho após queda | Intervalo de checagem muito alto ou trigger mal configurada | Reduza o intervalo e revise a expressão da trigger | Falha de rede em loja: detecção, resposta e lições aprendida |
| Alertas não chegam à equipe | Action ou media type mal configurados | Verifique as configurações de action e teste o envio de mensagens | Falha de rede em loja: detecção, resposta e lições aprendida |
| Alertas duplicados para o mesmo evento | Triggers sem dependências | Configure dependências entre triggers relacionadas | Falha de rede em loja: detecção, resposta e lições aprendida |
| SNMP não coleta dados | SNMP desabilitado no roteador ou firewall bloqueando | Habilite SNMP e libere portas necessárias | Falha de rede em loja: detecção, resposta e lições aprendida |
| Tempo de detecção maior que o esperado | Intervalo de checagem alto | Reduza o intervalo dos itens críticos | Falha de rede em loja: detecção, resposta e lições aprendida |
| Venda não aparece no Odoo | Falha de comunicação com PDV | Reprocessar pedido e revisar logs de integração | Falhas e recuperações: aprendendo com erros em produção |
| Estoque negativo inesperado | Movimentação não registrada | Reprocessar movimentação e ajustar saldo manualmente | Falhas e recuperações: aprendendo com erros em produção |
| Sistema lento em horário de pico | Consultas sem índice ou excesso de conexões | Criar índices e limitar conexões simultâneas | Falhas e recuperações: aprendendo com erros em produção |
| Host aparece como 'não disponível' no Zabbix | SNMP não habilitado ou firewall bloqueando porta 161/UDP | Verifique SNMP no equipamento e libere a porta no firewall | Ferramentas abertas de monitoramento: Zabbix, Grafana e Netd |
| Netdata não mostra dados de rede | Permissões insuficientes ou driver de rede não suportado | Execute Netdata como root e atualize o sistema | Ferramentas abertas de monitoramento: Zabbix, Grafana e Netd |
| Dashboards do Grafana sem dados | Fonte de dados mal configurada | Reveja as configurações de integração entre Grafana e Zabbix/Netdata | Ferramentas abertas de monitoramento: Zabbix, Grafana e Netd |
| Host aparece como 'não disponível' no Zabbix | SNMP não habilitado ou firewall bloqueando porta 161/UDP | Verifique SNMP no equipamento e libere a porta no firewall | Ferramentas abertas de monitoramento: Zabbix, Grafana e Netd |
| Netdata não mostra dados de rede | Permissões insuficientes ou driver de rede não suportado | Execute Netdata como root e atualize o sistema | Ferramentas abertas de monitoramento: Zabbix, Grafana e Netd |
| Dashboards do Grafana sem dados | Fonte de dados mal configurada | Reveja as configurações de integração entre Grafana e Zabbix/Netdata | Ferramentas abertas de monitoramento: Zabbix, Grafana e Netd |
| Filtro não altera os gráficos | Filtro não está vinculado aos gráficos ou fonte de dados diferente | Verifique se todos os gráficos usam a mesma fonte e estão conectados ao filtro | Filtros e drill-down: explorando vendas por loja, período e |
| Drill-down não abre o dashboard correto | Mapeamento de campo incorreto ou dashboard de destino não configurado | Revise as configurações de Drill to Detail e os campos mapeados | Filtros e drill-down: explorando vendas por loja, período e |
| Exportação gera arquivo vazio | Filtros muito restritivos ou erro na consulta | Aplique filtros mais amplos ou revise a consulta SQL | Filtros e drill-down: explorando vendas por loja, período e |
| Dispositivos na guest conseguem acessar a LAN | Regra de firewall ausente ou incorreta | Revise /etc/config/firewall e reinicie o serviço | Firewall, WPA2/3 e isolamento: protegendo sua loja |
| Clientes não conseguem conectar ao Wi-Fi Enterprise | Configuração RADIUS incorreta ou porta bloqueada | Verifique IP, segredo e portas do servidor RADIUS | Firewall, WPA2/3 e isolamento: protegendo sua loja |
| Clientes Wi-Fi conseguem se pingar | Isolamento não ativado ou hardware incompatível | Confirme option isolate '1' e suporte do hardware | Firewall, WPA2/3 e isolamento: protegendo sua loja |
| Dispositivos na guest conseguem acessar a LAN | Regra de firewall ausente ou incorreta | Revise /etc/config/firewall e reinicie o serviço | Firewall, WPA2/3 e isolamento: protegendo sua loja |
| Clientes não conseguem conectar ao Wi-Fi Enterprise | Configuração RADIUS incorreta ou porta bloqueada | Verifique IP, segredo e portas do servidor RADIUS | Firewall, WPA2/3 e isolamento: protegendo sua loja |
| Clientes Wi-Fi conseguem se pingar | Isolamento não ativado ou hardware incompatível | Confirme option isolate '1' e suporte do hardware | Firewall, WPA2/3 e isolamento: protegendo sua loja |
| Dados no BI atrasados em várias horas | Job de extração não está rodando ou réplica está parada | Verifique logs do ETL ou status da réplica; ajuste agendamento ou reinicie serviço | Fluxo de dados do PDV ao BI: do banco homologado à réplica P |
| Consultas no BI retornam erro de permissão | Usuário do Metabase sem permissão de leitura nas tabelas | Reveja os GRANTs no PostgreSQL e ajuste permissões | Fluxo de dados do PDV ao BI: do banco homologado à réplica P |
| Banco de produção lento em horários de extração | Jobs de extração rodando em horário de pico | Reagende extrações para horários de menor uso | Fluxo de dados do PDV ao BI: do banco homologado à réplica P |
| Erro de conexão no Metabase | Host, porta ou credenciais incorretos; firewall bloqueando acesso. | Revise dados de conexão e libere a porta 5432 (ou a porta do SGBD em uso). | Fluxo de dados: do ERP CISS ao Metabase via réplica PostgreS |
| Dados desatualizados no Metabase | Extração ou réplica não está sendo atualizada. | Verifique agendamento de importação ou status da réplica. | Fluxo de dados: do ERP CISS ao Metabase via réplica PostgreS |
| Permissão negada ao consultar tabelas | Usuário somente leitura sem acesso às tabelas. | Solicite ao DBA revisão das permissões do usuário. | Fluxo de dados: do ERP CISS ao Metabase via réplica PostgreS |
| Superset não enxerga as tabelas do BI | Permissões do usuário no PostgreSQL insuficientes ou conexão mal configurada. | Revise as permissões e a string de conexão. | Fluxo de dados: do ERP para o Superset sem atalhos |
| Erro de driver ao conectar | Driver Python não instalado no container do Superset. | Adicione o driver em docker/requirements-local.txt e reconstrua o container. | Fluxo de dados: do ERP para o Superset sem atalhos |
| Dados inconsistentes ou incompletos | Extração do ERP incompleta ou janela de carga errada. | Reveja a extração e ajuste a janela de dados. | Fluxo de dados: do ERP para o Superset sem atalhos |
| Erro 'No module named psycopg2' ao testar conexão | Driver Python não instalado no ambiente do Superset | Adicione psycopg2 ao requirements-local.txt e reinicie o container | Fonte de dados: cadastrando e testando conexões no Superset |
| Timeout ao conectar | Firewall bloqueando porta, host incorreto ou banco indisponível | Confirme host, porta, liberação de firewall e status da réplica | Fonte de dados: cadastrando e testando conexões no Superset |
| Usuário consegue alterar dados | Permissões do usuário não estão restritas a leitura | Solicite ao DBA ajuste das permissões para somente leitura | Fonte de dados: cadastrando e testando conexões no Superset |
| Usuário consegue editar dados pelo Metabase | Permissão de escrita no banco para o usuário do Metabase | Revogue todas as permissões de INSERT, UPDATE, DELETE e DDL do usuário no banco. | Gerenciamento de conexões e usuários no Metabase |
| Usuário vê dashboards de outros grupos | Permissões de coleção mal configuradas | Revise as permissões de cada grupo e coleções no Metabase. | Gerenciamento de conexões e usuários no Metabase |
| Log de auditoria não registra ações | Logs desativados ou problemas de permissão no servidor | Ative logs e confira permissões de escrita no diretório de logs do Metabase. | Gerenciamento de conexões e usuários no Metabase |
| Erro 'Too many open files' | Limite de arquivos abertos atingido no sistema | Aumente o ulimit -n ou reduza forks | Gerenciando centenas de dispositivos: limites práticos do An |
| Conexões SSH caindo aleatoriamente | Dispositivos sobrecarregados ou sem suporte a multiplexação | Reduza forks ou desabilite multiplexação para esses hosts | Gerenciando centenas de dispositivos: limites práticos do An |
| Execução muito lenta | Nó de controle saturado ou rede congestionada | Divida inventário em grupos menores e monitore recursos | Gerenciando centenas de dispositivos: limites práticos do An |
| Erro 'Decryption failed' ao rodar playbook | Senha do Vault incorreta ou arquivo corrompido | Verifique a senha e a integridade do arquivo Vault | Gerenciando segredos: Ansible Vault e boas práticas de senha |
| Variáveis sensíveis aparecem nos logs | Falta de no_log: true nas tasks | Adicione no_log: true nas tasks que manipulam segredos | Gerenciando segredos: Ansible Vault e boas práticas de senha |
| Playbook não encontra variável criptografada | Arquivo Vault não incluído no inventário ou nome incorreto | Confirme o caminho e o nome do arquivo Vault | Gerenciando segredos: Ansible Vault e boas práticas de senha |
| Erro 500 após deploy | Incompatibilidade no módulo atualizado ou migração incompleta | Execute rollback do banco e código, revise logs para identificar o erro | Gestão de mudanças: homologação, rollback e comunicação |
| Dados inconsistentes no estoque | Migração de dados falhou ou script mal testado | Restaure backup e refaça a homologação com dados reais | Gestão de mudanças: homologação, rollback e comunicação |
| Usuários não conseguem acessar o sistema | Serviço Odoo não reiniciado ou porta bloqueada | Reinicie o serviço e verifique firewall | Gestão de mudanças: homologação, rollback e comunicação |
| Integração com PDV parou de funcionar | Mudança afetou endpoints ou credenciais | Reverta configuração e valide integração em staging | Gestão de mudanças: homologação, rollback e comunicação |
| Usuário visualiza dados de outras lojas | Permissão excessiva no Metabase ou no SGBD | Revise grupos e restrinja acesso ao schema/tabela correto | Governança de dados: acesso, qualidade e ciclo de vida no BI |
| Dados do BI não batem com o ERP | Falha na extração ou regra de negócio diferente | Revise o ETL e valide regras aplicadas | Governança de dados: acesso, qualidade e ciclo de vida no BI |
| Logs de auditoria não aparecem | Configuração de log desativada no Metabase ou no banco | Ative logs conforme documentação oficial | Governança de dados: acesso, qualidade e ciclo de vida no BI |
| Dados antigos não são removidos | Tarefa agendada não está rodando | Verifique agendamento e permissões do script | Governança de dados: acesso, qualidade e ciclo de vida no BI |
| Dashboard apresenta dados inconsistentes após alteração de script | Falta de versionamento e revisão de mudanças | Implemente versionamento e revisão obrigatória de scripts | Governança de dados: versionamento, documentação e linhagem |
| Usuários não entendem o significado dos indicadores | Falta de documentação nos dashboards | Inclua descrição detalhada no campo de documentação do Superset | Governança de dados: versionamento, documentação e linhagem |
| Dificuldade em auditar origem dos dados | Linhagem dos dados não mapeada | Mapeie e registre cada etapa da origem ao consumo | Governança de dados: versionamento, documentação e linhagem |
| Testes automatizados falham após atualização | Mudança de dependências ou lógica não documentada | Rever documentação e atualizar testes conforme nova lógica | Governança do ambiente Odoo: documentação, versionamento e t |
| Erro ao rodar scripts de banco em homologação | Script fora de ordem ou não versionado | Padronize versionamento e ordem de execução dos scripts | Governança do ambiente Odoo: documentação, versionamento e t |
| Ambiente de produção diverge do homologado | Atualização feita manualmente sem seguir rotina | Sempre use scripts versionados e checklist de atualização | Governança do ambiente Odoo: documentação, versionamento e t |
| SSH parou de responder após hardening | Configuração inválida ou bloqueio do próprio IP | Acesse via console físico ou fallback e reverta a última alteração | Hardening automatizado: SSH, firewall e atualizações crítica |
| Firewall não aplica regras novas | Erro de formatação no arquivo ou falta de restart do serviço | Verifique sintaxe e reinicie o firewall com '/etc/init.d/firewall restart' | Hardening automatizado: SSH, firewall e atualizações crítica |
| Atualização de pacotes falha | Nomes de pacotes incorretos ou dependências quebradas | Liste pacotes com 'opkg list-installed' e consulte a documentação da versão | Hardening automatizado: SSH, firewall e atualizações crítica |
| Dados não aparecem no dashboard | Erro na coleta ou envio dos logs | Revise configurações do Filebeat e permissões de rede | IA, automação e analytics preditivo em redes de varejo |
| Alertas não são disparados | Regra de alerta mal configurada | Consulte a documentação do Prometheus e ajuste as regras | IA, automação e analytics preditivo em redes de varejo |
| Automação não executa o script | Node-RED sem permissão de execução | Ajuste permissões e teste o script manualmente | IA, automação e analytics preditivo em redes de varejo |
| Dados não aparecem no dashboard | Erro na coleta ou envio dos logs | Revise configurações do Filebeat e permissões de rede | IA, automação e analytics preditivo em redes de varejo |
| Alertas não são disparados | Regra de alerta mal configurada | Consulte a documentação do Prometheus e ajuste as regras | IA, automação e analytics preditivo em redes de varejo |
| Automação não executa o script | Node-RED sem permissão de execução | Ajuste permissões e teste o script manualmente | IA, automação e analytics preditivo em redes de varejo |
| Vendas de uma loja não aparecem no estoque central | Falha de conexão VPN ou erro no script de integração | Verifique logs de rede e revise o script Python conforme documentação oficial | Implantação em rede de lojas: desafios e soluções encontrada |
| Transferências automáticas não são disparadas | Regras de reabastecimento mal configuradas ou job agendado inativo | Revise as configurações das regras e agende novamente a ação | Implantação em rede de lojas: desafios e soluções encontrada |
| Lentidão no acesso ao Odoo | Latência de rede alta ou sobrecarga no servidor PostgreSQL | Monitore o tráfego, otimize queries e avalie upgrade de infraestrutura | Implantação em rede de lojas: desafios e soluções encontrada |
| Erro de encoding ao importar | Arquivo CSV não está em UTF-8. | Converta o arquivo com iconv antes de importar. | Importando extrações do CISSReport para o modelo bi_varejo |
| COPY falha por delimitador incorreto | CSV usa ponto e vírgula ou outro separador. | Converta delimitadores para vírgula com sed ou editor de texto. | Importando extrações do CISSReport para o modelo bi_varejo |
| Violação de chave estrangeira | Importou fatos antes das dimensões ou há IDs ausentes. | Reordene a carga e revise os arquivos de dimensão. | Importando extrações do CISSReport para o modelo bi_varejo |
| Playbook falha com erro de autenticação SSH | Credenciais incorretas ou chave SSH não autorizada no dispositivo | Revise variáveis de usuário/senha e autorize a chave pública no dispositivo | Infraestrutura como Código para redes: tendências e padrões |
| Mudança não aplicada, mas playbook executa sem erro | Dispositivo não suporta o módulo ou comando usado | Consulte a documentação do módulo Ansible e verifique compatibilidade | Infraestrutura como Código para redes: tendências e padrões |
| Configuração aplicada, mas rede ficou inacessível | Erro de lógica (ex: IP errado, máscara incompatível) | Revise o YAML, simule em laboratório e sempre valide antes de aplicar em produção | Infraestrutura como Código para redes: tendências e padrões |
| Odoo não inicia | Permissões erradas no odoo.conf ou ambiente virtual não ativado | Revise permissões e ative o ambiente virtual antes de rodar o serviço | Instalação do Odoo Community e PostgreSQL no Linux |
| Erro de conexão ao banco | Usuário ou senha do PostgreSQL incorretos no odoo.conf | Confirme usuário, senha e permissões no PostgreSQL | Instalação do Odoo Community e PostgreSQL no Linux |
| Porta 8069 não responde | Firewall bloqueando ou serviço não iniciado | Verifique firewall e status do serviço Odoo | Instalação do Odoo Community e PostgreSQL no Linux |
| Logs não são gravados | Permissões erradas no diretório de log | Ajuste permissões com chown para o usuário Odoo | Instalação do Odoo Community e PostgreSQL no Linux |
| O serviço zabbix-server não inicia | Configuração incorreta do banco de dados ou credenciais inválidas | Revise DBHost, DBName, DBUser e DBPassword em /etc/zabbix/zabbix_server.conf | Instalação do Zabbix Server, Proxy e Agent no Linux |
| Agent não responde ao comando zabbix_get | Firewall bloqueando porta 10050 ou Agent não iniciado | Libere a porta 10050 e reinicie o serviço zabbix-agent | Instalação do Zabbix Server, Proxy e Agent no Linux |
| Proxy não aparece como ativo no Server | Hostname do Proxy não cadastrado corretamente no Server | Verifique se o nome do Proxy em zabbix_proxy.conf é igual ao cadastrado na interface do Server | Instalação do Zabbix Server, Proxy e Agent no Linux |
| Ponto de rede sem conexão ou baixa velocidade | Cabo mal crimpado, excesso de comprimento ou interferência | Refaça a terminação e teste com certificador | Instalação física: cabeamento, racks e APs em campo |
| AP não liga via PoE | Switch ou injetor PoE incompatível ou cabo danificado | Verifique padrão PoE e troque o cabo | Instalação física: cabeamento, racks e APs em campo |
| Switch reiniciando ou travando | Sobrecarga elétrica ou falta de aterramento | Revisar aterramento e distribuição de energia | Instalação física: cabeamento, racks e APs em campo |
| Ponto de rede sem conexão ou baixa velocidade | Cabo mal crimpado, excesso de comprimento ou interferência | Refaça a terminação e teste com certificador | Instalação física: cabeamento, racks e APs em campo |
| AP não liga via PoE | Switch ou injetor PoE incompatível ou cabo danificado | Verifique padrão PoE e troque o cabo | Instalação física: cabeamento, racks e APs em campo |
| Switch reiniciando ou travando | Sobrecarga elétrica ou falta de aterramento | Revisar aterramento e distribuição de energia | Instalação física: cabeamento, racks e APs em campo |
| O Ansible retorna 'UNREACHABLE' para um host. | Problema de rede ou SSH não configurado corretamente. | Verifique conectividade com 'ping' e tente 'ssh root@host'. | Instalando Ansible e preparando o ambiente de automação |
| SSH pede senha mesmo após copiar a chave. | Chave pública não foi adicionada corretamente ao authorized_keys. | Revise o conteúdo do arquivo authorized_keys no equipamento. | Instalando Ansible e preparando o ambiente de automação |
| Erro 'Permission denied (publickey)'. | Permissões incorretas no diretório ~/.ssh ou na chave privada. | Ajuste permissões com 'chmod 700 ~/.ssh' e 'chmod 600 ~/.ssh/id_ed25519'. | Instalando Ansible e preparando o ambiente de automação |
| Dados de vendas não aparecem nos dashboards | Problema de permissão ou query incorreta | Revise permissões de acesso ao banco e valide a consulta SQL | Integração avançada: IA, analytics e omnichannel no Odoo |
| Previsões de IA não atualizam no Odoo | Falha no endpoint de importação ou formato de dados incompatível | Verifique logs do Odoo e valide o payload enviado | Integração avançada: IA, analytics e omnichannel no Odoo |
| Vendas de canais externos não sincronizam | Webhook mal configurado ou token de autenticação inválido | Reveja configuração do endpoint e tokens de API | Integração avançada: IA, analytics e omnichannel no Odoo |
| Dashboard lento ou travando | Consulta sem índices ou BI apontando para banco de produção | Ajuste índices, use views agregadas e aponte para réplica | Integração BI-ERP em produção: problemas reais e soluções |
| Dados sensíveis expostos | Falta de anonimização ou permissões mal configuradas | Implemente views de anonimização e revise roles no Superset | Integração BI-ERP em produção: problemas reais e soluções |
| Conflito de lock no ERP | Consulta BI rodando em tabela operacional durante horário crítico | Agende extração fora do pico e use réplica | Integração BI-ERP em produção: problemas reais e soluções |
| Arquivo CSV exportado com caracteres estranhos | Problema de encoding (UTF-8 vs ANSI) | Abra o arquivo em editor que suporte UTF-8 ou converta o encoding antes de importar. | Integração com CRM e marketing: exportando insights do BI |
| Consulta lenta ou travando o Superset | Consulta pesada rodando direto no banco de produção | Execute na réplica ou extraia uma amostra menor para testes. | Integração com CRM e marketing: exportando insights do BI |
| Erro de permissão ao exportar via API | Token inválido ou usuário sem permissão de exportação | Revise as permissões do usuário no Superset e gere novo token. | Integração com CRM e marketing: exportando insights do BI |
| Inventário vazio | Script dinâmico com erro ou sem permissão de execução | Verifique permissões e rode manualmente o script para depurar. | Integração com sistemas de inventário e CMDB via Ansible |
| Hosts ausentes ou duplicados | Dados inconsistentes no CMDB | Corrija o CMDB e revalide o inventário. | Integração com sistemas de inventário e CMDB via Ansible |
| Falha ao atualizar CMDB | Token expirado ou endpoint errado | Renove o token e valide a URL da API. | Integração com sistemas de inventário e CMDB via Ansible |
| Variáveis não sincronizadas | Script não retorna variáveis extras | Ajuste o script para incluir variáveis no JSON. | Integração com sistemas de inventário e CMDB via Ansible |
| Relatório não chega por e-mail | Configuração incorreta de SMTP ou bloqueio na rede | Revise o arquivo de configuração do msmtp/ssmtp e teste envio manual | Integração de analytics e relatórios automáticos |
| Relatório PDF vazio ou corrompido | Erro na conversão do CSV ou CSV mal formatado | Abra o CSV, corrija formatação e refaça a conversão | Integração de analytics e relatórios automáticos |
| Dados não aparecem no BI | Caminho do arquivo ou conexão com banco incorretos | Ajuste o caminho ou as permissões de acesso do BI | Integração de analytics e relatórios automáticos |
| Dados de Wi-Fi incompletos | Script rodando antes dos logs estarem completos | Ajuste o horário do cron para garantir que todos os dados estejam disponíveis | Integração de analytics e relatórios automáticos |
| Relatório não chega por e-mail | Configuração incorreta de SMTP ou bloqueio na rede | Revise o arquivo de configuração do msmtp/ssmtp e teste envio manual | Integração de analytics e relatórios automáticos |
| Relatório PDF vazio ou corrompido | Erro na conversão do CSV ou CSV mal formatado | Abra o CSV, corrija formatação e refaça a conversão | Integração de analytics e relatórios automáticos |
| Dados não aparecem no BI | Caminho do arquivo ou conexão com banco incorretos | Ajuste o caminho ou as permissões de acesso do BI | Integração de analytics e relatórios automáticos |
| Dados de Wi-Fi incompletos | Script rodando antes dos logs estarem completos | Ajuste o horário do cron para garantir que todos os dados estejam disponíveis | Integração de analytics e relatórios automáticos |
| Venda não aparece no Odoo após integração | Falha de autenticação ou endpoint incorreto | Verifique o token e a URL do endpoint no PDV | Integração prática: sincronizando vendas e estoque com PDV a |
| Estoque fica negativo após múltiplas vendas rápidas | Rotina de sincronização não é transacional ou há race condition | Implemente bloqueio transacional ou fila de processamento | Integração prática: sincronizando vendas e estoque com PDV a |
| Vendas duplicadas no Odoo | Falta de validação de sale_id único | Implemente checagem de duplicidade antes de criar novo pedido | Integração prática: sincronizando vendas e estoque com PDV a |
| PDV não acessa o gateway de pagamento | Firewall bloqueando IP ou porta necessária | Revise as regras de firewall e libere apenas os IPs e portas oficiais do adquirente | Integrando PDVs e sistemas de pagamento à rede segura |
| PDV recebe IP fora da faixa esperada | DHCP configurado em interface errada ou conflito de VLAN | Verifique a configuração de VLAN e DHCP no roteador | Integrando PDVs e sistemas de pagamento à rede segura |
| Dispositivo externo acessa PDV | Regras de firewall ausentes ou mal configuradas | Implemente bloqueio explícito entre VLANs | Integrando PDVs e sistemas de pagamento à rede segura |
| PDV não acessa o gateway de pagamento | Firewall bloqueando IP ou porta necessária | Revise as regras de firewall e libere apenas os IPs e portas oficiais do adquirente | Integrando PDVs e sistemas de pagamento à rede segura |
| PDV recebe IP fora da faixa esperada | DHCP configurado em interface errada ou conflito de VLAN | Verifique a configuração de VLAN e DHCP no roteador | Integrando PDVs e sistemas de pagamento à rede segura |
| Dispositivo externo acessa PDV | Regras de firewall ausentes ou mal configuradas | Implemente bloqueio explícito entre VLANs | Integrando PDVs e sistemas de pagamento à rede segura |
| Host não aparece no grupo esperado | Erro de indentação ou hierarquia no YAML | Revise a indentação e a estrutura do arquivo conforme a documentação YAML e Ansible. | Inventário Ansible para redes: hosts, grupos e variáveis por |
| Variável não é aplicada ao host | Variável definida no nível errado ou sobrescrita por outra | Verifique a hierarquia de precedência das variáveis e ajuste conforme necessário. | Inventário Ansible para redes: hosts, grupos e variáveis por |
| Erro de parsing ao validar inventário | Sintaxe inválida (caracteres especiais, espaços, aspas) | Corrija a sintaxe e valide novamente com 'ansible-inventory'. | Inventário Ansible para redes: hosts, grupos e variáveis por |
| Ativo não aparece no Zabbix após importação | Erro no arquivo CSV ou falta de template | Revise o formato do CSV e associe um template válido | Inventário: o que e como monitorar em uma loja |
| PDV aparece como 'Indisponível' | IP incorreto ou firewall bloqueando | Confirme o IP e libere portas necessárias no firewall | Inventário: o que e como monitorar em uma loja |
| Switch não retorna dados SNMP | SNMP desabilitado ou comunidade incorreta | Habilite SNMP no switch e ajuste a comunidade no Zabbix | Inventário: o que e como monitorar em uma loja |
| Superset não conecta ao PostgreSQL | Driver psycopg2 não instalado ou URI incorreta. | Confirme o pacote no requirements-local.txt e o formato do URI. | Isolamento é tudo: arquitetura segura para BI sobre Protheus |
| Dados desatualizados no BI | Agendamento de ETL falhou ou script com erro. | Revise logs do ETL e ajuste o agendamento. | Isolamento é tudo: arquitetura segura para BI sobre Protheus |
| Performance ruim no Superset | Faltam índices nas tabelas do PostgreSQL ou queries mal otimizadas. | Crie índices nos campos mais consultados e revise as queries. | Isolamento é tudo: arquitetura segura para BI sobre Protheus |
| PDV sem conexão | VLAN mal configurada ou sem DHCP | Revise configuração de interface e DHCP no OpenWrt | Levantamento de requisitos: do PDV ao Wi-Fi do cliente |
| Clientes não conseguem acessar o portal cativo | Serviço nodogsplash não iniciado ou firewall bloqueando | Reinicie nodogsplash e revise regras de firewall | Levantamento de requisitos: do PDV ao Wi-Fi do cliente |
| Câmeras travando | Banda insuficiente ou tráfego misturado com PDV | Separe VLAN e priorize QoS para vídeo | Levantamento de requisitos: do PDV ao Wi-Fi do cliente |
| Rede Wi-Fi lenta | Excesso de clientes ou interferência | Reduza número de clientes por AP e ajuste canais | Levantamento de requisitos: do PDV ao Wi-Fi do cliente |
| PDV sem conexão | VLAN mal configurada ou sem DHCP | Revise configuração de interface e DHCP no OpenWrt | Levantamento de requisitos: do PDV ao Wi-Fi do cliente |
| Clientes não conseguem acessar o portal cativo | Serviço nodogsplash não iniciado ou firewall bloqueando | Reinicie nodogsplash e revise regras de firewall | Levantamento de requisitos: do PDV ao Wi-Fi do cliente |
| Câmeras travando | Banda insuficiente ou tráfego misturado com PDV | Separe VLAN e priorize QoS para vídeo | Levantamento de requisitos: do PDV ao Wi-Fi do cliente |
| Rede Wi-Fi lenta | Excesso de clientes ou interferência | Reduza número de clientes por AP e ajuste canais | Levantamento de requisitos: do PDV ao Wi-Fi do cliente |
| Requisitos conflitantes entre áreas | Falta de alinhamento entre operações e TI | Realizar reuniões de validação conjunta e ajustar documentação | Levantamento de requisitos: estoque, vendas e integração PDV |
| Integração PDV-Odoo falha em horários de pico | Volume subestimado no levantamento | Revisar volumes e ajustar arquitetura de integração | Levantamento de requisitos: estoque, vendas e integração PDV |
| Estoque divergente entre Odoo e PDV | Regras de sincronização mal definidas | Rever requisitos e ajustar integração | Levantamento de requisitos: estoque, vendas e integração PDV |
| Erro de permissão ao consultar tabelas | Usuário BI sem privilégio de SELECT | Solicite ao DBA revisão das permissões | Levantando o dicionário: o que perguntar à CISS e ao DBA |
| Consultas lentas ou travando o ERP | Extração feita em horário de pico ou sem índice adequado | Reagende a carga e revise índices com o DBA | Levantando o dicionário: o que perguntar à CISS e ao DBA |
| Campos ou tabelas não encontrados | Dicionário incompleto ou nomes divergentes | Reconfirme com a CISS e atualize a documentação | Levantando o dicionário: o que perguntar à CISS e ao DBA |
| Consultas de BI deixam o PDV lento ou travado. | Query pesada rodando em produção sem filtro ou fora da janela segura. | Interrompa a consulta, revise filtros e agende extração para banco dedicado. | Limites de acesso: quando sua query pode travar o Protheus |
| Usuário de BI não consegue acessar tabelas do Protheus. | Permissões insuficientes ou usuário não está no grupo db_datareader. | Solicite ao DBA ajuste de permissões. | Limites de acesso: quando sua query pode travar o Protheus |
| Dados do BI estão desatualizados. | Extração ou replicação não está agendada corretamente. | Reveja o agendamento da rotina de ETL. | Limites de acesso: quando sua query pode travar o Protheus |
| Erro ao conectar ao Oracle | Driver JDBC ausente ou incompatível | Coloque o ojdbc8.jar (mínimo 19c) na pasta plugins e reinicie o Metabase | Limites do Metabase open source: o que dá para fazer e onde |
| Não aparece opção de SSO/SAML/LDAP | Funcionalidade exclusiva da edição enterprise | Consulte a documentação e avalie alternativas open source | Limites do Metabase open source: o que dá para fazer e onde |
| Alertas só enviam e-mail, não webhook | Limitação do open source | Automatize por scripts externos ou considere outra solução | Limites do Metabase open source: o que dá para fazer e onde |
| Log não é atualizado | Permissões erradas ou serviço não está rodando | Verifique permissões do arquivo e status do serviço com systemctl | Logs do Zabbix: onde procurar e como interpretar |
| Log cresce muito rápido | LogLevel alto em produção | Reduza LogLevel para 3 após o troubleshooting | Logs do Zabbix: onde procurar e como interpretar |
| Mensagens de erro vagas | LogLevel baixo | Aumente LogLevel temporariamente para obter mais detalhes | Logs do Zabbix: onde procurar e como interpretar |
| Logs não aparecem no servidor syslog externo | Firewall bloqueando porta 514/UDP ou configuração incorreta de IP/porta | Libere a porta no firewall e revise configuração em /etc/config/system | Logs, auditoria e resposta a incidentes na prática |
| Logs somem após reboot do OpenWrt | Logs gravados apenas em RAM | Configure envio para syslog externo conforme o passo 1 | Logs, auditoria e resposta a incidentes na prática |
| Eventos de clientes não aparecem no UniFi Controller | Versão do Controller desatualizada ou filtro de eventos aplicado | Atualize o Controller e limpe filtros na aba Events | Logs, auditoria e resposta a incidentes na prática |
| Logs não aparecem no servidor syslog externo | Firewall bloqueando porta 514/UDP ou configuração incorreta de IP/porta | Libere a porta no firewall e revise configuração em /etc/config/system | Logs, auditoria e resposta a incidentes na prática |
| Logs somem após reboot do OpenWrt | Logs gravados apenas em RAM | Configure envio para syslog externo conforme o passo 1 | Logs, auditoria e resposta a incidentes na prática |
| Eventos de clientes não aparecem no UniFi Controller | Versão do Controller desatualizada ou filtro de eventos aplicado | Atualize o Controller e limpe filtros na aba Events | Logs, auditoria e resposta a incidentes na prática |
| Tarefas sempre aparecem como 'changed' | Uso de comandos imperativos (shell, command) sem controle de idempotência. | Troque por módulos declarativos ou use 'creates'/'removes'. | Loops, condições e handlers: controlando fluxos complexos em |
| Handler não executa mesmo após mudança | Tarefa não está notificando o handler corretamente. | Adicione 'notify' na tarefa que altera o recurso. | Loops, condições e handlers: controlando fluxos complexos em |
| Tarefa com loop falha para alguns hosts | Variáveis ausentes ou listas inconsistentes no inventário. | Garanta que todos os itens do loop existem para cada host. | Loops, condições e handlers: controlando fluxos complexos em |
| Backup não gera arquivo | Permissões insuficientes ou caminho inexistente | Ajuste permissões do usuário e crie o diretório /backups | Manutenção preventiva: backup, atualização e limpeza de dado |
| Superset não sobe após atualização | Incompatibilidade de dependências ou erro no docker-compose.yml | Revise requirements-local.txt e logs do container | Manutenção preventiva: backup, atualização e limpeza de dado |
| Banco cresce mesmo após limpeza | VACUUM não executado ou limpeza incompleta | Execute VACUUM FULL e revise scripts de limpeza | Manutenção preventiva: backup, atualização e limpeza de dado |
| Arquivo CSV exportado está vazio | Consulta SQL sem resultados ou filtros de data incorretos | Revise a consulta e os parâmetros de data | Marketing orientado a dados: recorrência, RFM e cesta de com |
| Script de integração retorna erro de autenticação | Token ou credenciais da API do CRM inválidos | Atualize o token e revise permissões no CRM | Marketing orientado a dados: recorrência, RFM e cesta de com |
| Dados duplicados no CRM após importação | Script não verifica existência prévia do cliente | Implemente lógica de upsert ou deduplicação | Marketing orientado a dados: recorrência, RFM e cesta de com |
| Arquivo CSV não é gerado ou está vazio | Query sem resultados, view clientes_segmentados não criada ou erro de permissão no diretório de exportação | Revise a query, garanta que a view clientes_segmentados exista e verifique permissão de escrita no diretório | Marketing orientado a dados: recorrência, RFM e cesta de com |
| Exportação demora muito | Falta de índices nas tabelas ou volume excessivo de dados | Adicione índices nos campos de filtro e revise a janela temporal das queries | Marketing orientado a dados: recorrência, RFM e cesta de com |
| Dados importados no CRM aparecem truncados ou corrompidos | Problemas de encoding ou delimitador no CSV | Garanta exportação com CSV HEADER e encoding UTF-8; valide o arquivo antes de importar | Marketing orientado a dados: recorrência, RFM e cesta de com |
| Exportação agendada não chega ao CRM | E-mail ou webhook incorreto, ou falha na integração | Reveja o endereço configurado e teste manualmente o envio | Marketing orientado a dados: recorrência, RFM e cesta de com |
| Consulta demora demais ou falha | Query ineficiente ou volume de dados alto | Otimizar a consulta, criar índices ou reduzir o período analisado | Marketing orientado a dados: recorrência, RFM e cesta de com |
| Dados exportados incompletos | Campos não incluídos na query ou erro de formatação | Ajustar a seleção de campos e revisar o formato de exportação | Marketing orientado a dados: recorrência, RFM e cesta de com |
| Exportação do Superset falha ou retorna vazio | Query com erro, permissões insuficientes ou driver DB-API incorreto. | Revise a consulta, verifique permissões e dependências do driver. | Marketing orientado a dados: recorrência, RFM e cesta de com |
| Script de automação não executa no horário previsto | Erro de sintaxe no crontab ou path incorreto. | Cheque o log do cron e revise o caminho do script. | Marketing orientado a dados: recorrência, RFM e cesta de com |
| Dados importados no CRM estão desatualizados | Script não rodou ou exportação não foi atualizada. | Verifique logs de execução e timestamps dos arquivos. | Marketing orientado a dados: recorrência, RFM e cesta de com |
| Dashboard não atualiza com novos dados | Fonte de dados é uma extração estática ou há cache configurado. | Confirme a periodicidade da carga e ajuste o cache nas configurações do Metabase. | Metabase e BI no varejo: diferença entre relatório, dashboar |
| Relatório demora para carregar | Consulta pesada ou falta de índices na base analítica. | Otimize a consulta SQL e peça ao DBA para revisar índices. | Metabase e BI no varejo: diferença entre relatório, dashboar |
| Usuário não vê todos os filtros no dashboard | Permissões ou configuração de filtros globais incompleta. | Revise as permissões do usuário e ajuste os filtros no dashboard. | Metabase e BI no varejo: diferença entre relatório, dashboar |
| Campos ausentes ou com nomes diferentes | Customização ou versão diferente do ERP | Consulte o dicionário SX2 do seu ambiente para confirmar os nomes corretos. | Modelagem de dados para BI: do dicionário SX2 ao esquema bi_ |
| Erro de tipo de dado ao carregar | Incompatibilidade entre tipos do ERP e PostgreSQL | Ajuste os tipos no modelo bi_varejo conforme o SX2. | Modelagem de dados para BI: do dicionário SX2 ao esquema bi_ |
| Dados inconsistentes entre ERP e BI | Carga incompleta ou filtro errado no ETL | Revise o processo de extração e as condições de filtro. | Modelagem de dados para BI: do dicionário SX2 ao esquema bi_ |
| Erro de permissão ao criar esquema | Usuário do PostgreSQL sem privilégio de criação de schema | Conceda permissão CREATE SCHEMA ao usuário. | Modelagem de dados simulada para BI: esquema bi_varejo em Po |
| Dados inconsistentes após carga | Transformação inadequada ou campos incompatíveis | Revise o script de transformação e ajuste tipos de dados. | Modelagem de dados simulada para BI: esquema bi_varejo em Po |
| Carga lenta ou travada | Arquivo CSV muito grande ou falta de índices | Divida a carga em lotes menores e crie índices após a importação. | Modelagem de dados simulada para BI: esquema bi_varejo em Po |
| Erro de permissão ao criar schema ou tabelas | Usuário do PostgreSQL sem privilégios suficientes | Conceda CREATE e USAGE ao usuário no banco de dados | Modelo bi_varejo: esquema simulado para estudos e dashboards |
| Erro de chave estrangeira ao carregar dados | Ordem de carga invertida, faltam dimensões | Carregue primeiro as tabelas de dimensão, depois as de fato | Modelo bi_varejo: esquema simulado para estudos e dashboards |
| Dados não aparecem no Metabase | Conexão ou permissões incorretas no Metabase | Revise usuário, senha e permissões de leitura no PostgreSQL | Modelo bi_varejo: esquema simulado para estudos e dashboards |
| Produto não aparece na localização esperada | Localização não atribuída corretamente ou transferência não validada | Verifique o histórico de movimentação e ajuste a transferência. | Módulo de estoque: rotinas, regras e localização |
| Saldo de estoque negativo | Movimentação registrada sem saldo suficiente | Ajuste o inventário e revise permissões de saída. | Módulo de estoque: rotinas, regras e localização |
| Categorias não aparecem nos relatórios | Produtos cadastrados sem categoria | Atualize o cadastro dos produtos afetados. | Módulo de estoque: rotinas, regras e localização |
| Não é possível criar novo armazém | Permissão insuficiente ou configuração de localizações desativada | Ative múltiplas localizações e revise permissões do usuário. | Módulo de estoque: rotinas, regras e localização |
| Pedido de venda não reserva estoque | Produto não está como estocável | Altere o tipo do produto para 'Estocável' | Módulo de vendas: fluxos, cotação e integração com estoque |
| Fatura não reflete condição de pagamento | Condição não foi associada ao pedido | Adicione a condição de pagamento antes de confirmar a cotação | Módulo de vendas: fluxos, cotação e integração com estoque |
| Cotação é confirmada mesmo sem estoque | Configuração permite vendas negativas | Desative 'Permitir vendas de produtos fora de estoque' nas configurações de estoque | Módulo de vendas: fluxos, cotação e integração com estoque |
| Dashboards travando ou não carregam | Query excedendo timeout ou banco sobrecarregado | Ajuste o timeout, otimize a query ou aumente recursos do banco | Monitoramento de consultas e performance no Metabase |
| Dados desatualizados em dashboards | Cache de resultados configurado para tempo muito alto | Reduza o tempo de cache nas configurações do Metabase | Monitoramento de consultas e performance no Metabase |
| Logs do Metabase não mostram queries | Nível de log insuficiente ou log em diretório diferente | Ajuste o nível de log e confirme o caminho do arquivo | Monitoramento de consultas e performance no Metabase |
| Alertas não são enviados | Falta de script externo ou configuração de agendamento | Implemente scripts de monitoramento e agendamento de alertas | Monitoramento de consultas e performance no Metabase |
| Superset não conecta ao banco | Limite de conexões excedido | Reduza conexões ociosas ou aumente max_connections com cautela | Monitoramento do PostgreSQL: conexões, locks e uso de disco |
| Consultas ficam travadas | Locks não liberados por processos longos | Identifique e encerre sessões problemáticas | Monitoramento do PostgreSQL: conexões, locks e uso de disco |
| Banco para de funcionar repentinamente | Disco cheio | Libere espaço e revise políticas de retenção | Monitoramento do PostgreSQL: conexões, locks e uso de disco |
| Alertas de disco não disparam | Script ou ferramenta mal configurada | Revise configuração e permissões dos scripts | Monitoramento do PostgreSQL: conexões, locks e uso de disco |
| Trigger nunca dispara mesmo com dados fora do padrão | Expressão da trigger mal configurada ou intervalo de coleta inadequado | Revise a expressão e ajuste o intervalo do item | Monitoramento preditivo: tendências e anomalias com Zabbix |
| Dados previstos não aparecem nos itens | Script externo não está enviando dados corretamente | Teste o script manualmente e verifique logs do Zabbix | Monitoramento preditivo: tendências e anomalias com Zabbix |
| Alertas de anomalia com muitos falsos positivos | Limiar estatístico muito sensível ou série histórica curta | Ajuste o número de desvios padrão e aumente a janela histórica | Monitoramento preditivo: tendências e anomalias com Zabbix |
| Consultas do BI travam o banco em horário de pico | Execução direta no banco de produção sem uso de réplica | Configure uma réplica ou extração agendada para BI | Monitorando o banco: queries pesadas e locks perigosos |
| Locks prolongados impedem fechamento de vendas | Query do BI ou job do ERP bloqueando tabelas críticas | Identifique e mate apenas o processo do BI, nunca do ERP sem validação | Monitorando o banco: queries pesadas e locks perigosos |
| Logs não mostram queries lentas | Configuração de log inadequada | Ajuste log_min_duration_statement ou equivalente no seu banco | Monitorando o banco: queries pesadas e locks perigosos |
| Nenhum log de autenticação aparece | Portal cativo não está rodando ou log está em outro caminho | Verifique se o serviço está ativo com 'pgrep nodogsplash' e confira o caminho do log | Monitorando o portal cativo, autenticações e analytics |
| Muitas falhas de login | Senha errada, ataque de força bruta ou erro de configuração | Revise configuração do portal e troque senha se necessário | Monitorando o portal cativo, autenticações e analytics |
| Relatório diário mostra zero usuários | Script de contagem está filtrando data/hora errada ou log foi rotacionado | Ajuste o filtro de data/hora e confira política de rotação de logs | Monitorando o portal cativo, autenticações e analytics |
| Nenhum log de autenticação aparece | Portal cativo não está rodando ou log está em outro caminho | Verifique se o serviço está ativo com 'pgrep nodogsplash' e confira o caminho do log | Monitorando o portal cativo, autenticações e analytics |
| Muitas falhas de login | Senha errada, ataque de força bruta ou erro de configuração | Revise configuração do portal e troque senha se necessário | Monitorando o portal cativo, autenticações e analytics |
| Relatório diário mostra zero usuários | Script de contagem está filtrando data/hora errada ou log foi rotacionado | Ajuste o filtro de data/hora e confira política de rotação de logs | Monitorando o portal cativo, autenticações e analytics |
| Logs do Odoo não aparecem no arquivo esperado | Caminho do logfile incorreto ou permissão insuficiente | Verifique o parâmetro logfile no odoo.conf e ajuste permissões do diretório | Monitorando Odoo e PostgreSQL: logs, métricas e alertas |
| Métricas do PostgreSQL não aparecem no Prometheus | postgres_exporter não está rodando ou configurado corretamente | Reinicie o exporter e confira variáveis de ambiente de conexão | Monitorando Odoo e PostgreSQL: logs, métricas e alertas |
| Alertas não são enviados | Configuração de rota de alerta ausente ou errada | Revise o arquivo de alertas e teste envio manualmente | Monitorando Odoo e PostgreSQL: logs, métricas e alertas |
| Consultas do Metabase demoram minutos para retornar | Query mal otimizada ou falta de índice no banco BI | Analise o SQL, crie índices ou ajuste a consulta | Monitorando performance do Metabase e do banco BI |
| Metabase reinicia ou trava sob carga | Limite de memória do Java ou do container atingido | Aumente o parâmetro -Xmx ou recursos do host | Monitorando performance do Metabase e do banco BI |
| Banco BI fica lento para todos os usuários | Consultas pesadas em horário de pico ou falta de recursos | Agende extrações fora do pico e otimize queries | Monitorando performance do Metabase e do banco BI |
| Consulta para em 'idle in transaction' | Aplicação deixou transação aberta | Corrija a aplicação para finalizar transações rapidamente | Monitorando PostgreSQL: conexões, locks e uso de disco |
| Script de alerta não envia e-mail | Mail não instalado ou configurado | Instale e configure um agente de envio de e-mails no servidor | Monitorando PostgreSQL: conexões, locks e uso de disco |
| VACUUM FULL bloqueia tabela por muito tempo | Tabela grande ou uso em horário de pico | Agende para horários de baixa demanda e avalie particionamento | Monitorando PostgreSQL: conexões, locks e uso de disco |
| Queries continuam lentas após criar índice | O índice não cobre todas as colunas filtradas ou o plano de execução não está usando o índice | Reveja o SQL, crie índices compostos se necessário e analise o plano de execução novamente | Monitorando queries e performance no Superset |
| Logs do Superset não mostram queries | Nível de log insuficiente ou configuração incorreta | Ajuste LOG_LEVEL para INFO ou DEBUG no superset_config.py e reinicie o Superset | Monitorando queries e performance no Superset |
| pg_stat_statements não retorna dados | Extensão não ativada ou permissões insuficientes | Ative a extensão como superusuário e garanta permissão de leitura | Monitorando queries e performance no Superset |
| Consultas BI muito lentas mesmo após criar índices | Índices criados nos campos errados ou não utilizados pelo plano de execução | Revise o plano de execução da consulta e ajuste os índices conforme os filtros reais | Não é só espaço: índices, partições e performance em consult |
| ERP travando durante consultas BI | Consultas BI em produção sem particionamento ou horários inadequados | Direcione o BI para réplica/cópia e ajuste o agendamento das extrações | Não é só espaço: índices, partições e performance em consult |
| Locks frequentes em tabelas de venda | Consultas BI competindo com atualizações do ERP | Monitore sessões bloqueadas e ajuste índices, partições e horários de consulta | Não é só espaço: índices, partições e performance em consult |
| Dashboard lento ou travando | Consulta pesada no banco de produção | Ajuste para consultar réplica ou agende extração para ambiente analítico | Novas práticas em BI de varejo: self-service, open source e |
| Erro de conexão no Metabase ao conectar Oracle | Driver JDBC ausente ou incompatível | Baixe o ojdbc8.jar da Oracle e coloque na pasta plugins, reiniciando o Metabase | Novas práticas em BI de varejo: self-service, open source e |
| Dados desatualizados nos relatórios | Pipeline de ETL não executou ou falhou | Verifique logs do Airflow e reexecute o job com falha | Novas práticas em BI de varejo: self-service, open source e |
| Pedidos de compra não são gerados automaticamente | Configuração incorreta da regra de reabastecimento ou scheduler desativado | Revise os campos da regra e garanta que o agendador (cron) está ativo | Novidades do Odoo Community: recursos e tendências abertas |
| API JSON-RPC retorna erro de autenticação | Credenciais ou permissões incorretas do usuário | Ajuste permissões e verifique usuário/senha | Novidades do Odoo Community: recursos e tendências abertas |
| Módulo OCA não aparece no menu | Caminho de addons não configurado corretamente | Adicione o diretório ao parâmetro addons_path no odoo.conf e reinicie o serviço | Novidades do Odoo Community: recursos e tendências abertas |
| O BI está lento e o PDV trava em horários de pico | Consultas pesadas rodando direto no banco de produção | Direcione o BI para uma réplica ou extração agendada; revise filtros e limites. | Nunca faça isso: erros fatais em BI de ERP que custam caro |
| Usuário do BI consegue alterar dados do ERP | Permissões excessivas | Revogue permissões de escrita e ajuste para somente leitura. | Nunca faça isso: erros fatais em BI de ERP que custam caro |
| Dashboards trazem milhões de linhas sem filtro | Filtros obrigatórios não configurados | Configure filtros obrigatórios e limite o número de linhas retornadas. | Nunca faça isso: erros fatais em BI de ERP que custam caro |
| Itens não coletam dados | Agente Zabbix não configurado corretamente ou firewall bloqueando porta | Verifique zabbix_agentd.conf e liberação da porta 10050/10051 | O que o Zabbix faz (e o que não faz): limites e possibilidad |
| Alertas não chegam | Ação de notificação mal configurada ou SMTP/SMS fora do ar | Revise configurações de Media Type e teste envio manual | O que o Zabbix faz (e o que não faz): limites e possibilidad |
| Dados atrasados | Modo ativo com rede instável ou banco de dados lento | Ajuste intervalos de coleta e otimize o banco de dados | O que o Zabbix faz (e o que não faz): limites e possibilidad |
| Trigger dispara sem motivo | Condição mal definida ou métrica flutuante | Refine a expressão do trigger e use funções como avg() | O que o Zabbix faz (e o que não faz): limites e possibilidad |
| Venda não reduz estoque | Integração entre módulos stock e sale não está ativa | Reinstale ou atualize os módulos stock e sale | Odoo Community: módulos, fluxos e limites do código aberto |
| Módulo customizado não aparece | Manifest ou dependências incorretas | Revise o arquivo __manifest__.py e dependências | Odoo Community: módulos, fluxos e limites do código aberto |
| Erro ao instalar módulo | Permissões de arquivo ou dependências ausentes | Ajuste permissões e instale dependências requeridas | Odoo Community: módulos, fluxos e limites do código aberto |
| Operações lentas em horários de pico | Falta de particionamento ou parâmetros de memória subdimensionados | Reveja o particionamento das tabelas e aumente os valores de shared_buffers e work_mem | Odoo em larga escala: multi-tenant, particionamento e tuning |
| Erros de conexão entre Odoo e PostgreSQL | Limite de max_connections atingido ou firewall bloqueando porta | Aumente max_connections e revise regras de firewall | Odoo em larga escala: multi-tenant, particionamento e tuning |
| Dados inconsistentes entre filiais | Falta de automação na aplicação de customizações ou scripts | Automatize deploys e mantenha scripts sincronizados | Odoo em larga escala: multi-tenant, particionamento e tuning |
| Painel do Grafana não mostra dados do Zabbix | Plugin não instalado ou fonte de dados mal configurada | Reinstale o plugin e revise as credenciais/API URL | Open source além do Zabbix: combinando ferramentas para visã |
| Host criado via API não aparece no frontend do Zabbix | Parâmetros incorretos ou token inválido | Revise o JSON enviado e gere novo token de autenticação | Open source além do Zabbix: combinando ferramentas para visã |
| Agente Zabbix não inicia após playbook Ansible | Pacote não instalado ou serviço com erro | Verifique logs do Ansible e do sistema, reinstale o agente | Open source além do Zabbix: combinando ferramentas para visã |
| Erro de conexão ao banco | Driver DB-API ausente ou URI incorreto | Confirme o driver instalado e revise o URI conforme a documentação do Superset | Open source BI além do Superset: ferramentas e tendências pa |
| Dashboard lento ou travando | Consultas SQL mal otimizadas ou volume de dados excessivo | Revise índices, filtros e considere agregações no banco | Open source BI além do Superset: ferramentas e tendências pa |
| Usuário não visualiza todos os relatórios | Permissões de acesso mal configuradas | Ajuste os roles e permissões no Superset para o grupo correto | Open source BI além do Superset: ferramentas e tendências pa |
| Não acessa interface web após flash | IP do PC não está na mesma faixa ou firmware corrompido | Configure IP manualmente para 192.168.1.x ou refaça o flash via método de recuperação | OpenWrt e UniFi: instalação inicial e primeiros acessos |
| AP UniFi não aparece no controlador | Rede isolada ou controlador em outra sub-rede | Verifique VLAN, DHCP e use set-inform via SSH | OpenWrt e UniFi: instalação inicial e primeiros acessos |
| Wi-Fi aparece, mas não navega | Firewall ou interface WAN mal configurada | Revise regras de firewall e parâmetros WAN | OpenWrt e UniFi: instalação inicial e primeiros acessos |
| Cliente não recebe IP | DHCP desativado ou conflito de rede | Ative DHCP ou ajuste faixa de IP | OpenWrt e UniFi: instalação inicial e primeiros acessos |
| Não acessa interface web após flash | IP do PC não está na mesma faixa ou firmware corrompido | Configure IP manualmente para 192.168.1.x ou refaça o flash via método de recuperação | OpenWrt e UniFi: instalação inicial e primeiros acessos |
| AP UniFi não aparece no controlador | Rede isolada ou controlador em outra sub-rede | Verifique VLAN, DHCP e use set-inform via SSH | OpenWrt e UniFi: instalação inicial e primeiros acessos |
| Wi-Fi aparece, mas não navega | Firewall ou interface WAN mal configurada | Revise regras de firewall e parâmetros WAN | OpenWrt e UniFi: instalação inicial e primeiros acessos |
| Cliente não recebe IP | DHCP desativado ou conflito de rede | Ative DHCP ou ajuste faixa de IP | OpenWrt e UniFi: instalação inicial e primeiros acessos |
| Dashboards com métricas divergentes para o mesmo indicador. | Falta de padrão de nomenclatura ou filtros inconsistentes. | Revisar queries e alinhar nomes e filtros conforme o padrão. | Padronização de queries e dashboards: o que separa BI amador |
| Queries antigas quebram após atualização do ERP. | Campos ou tabelas mudaram sem revisão periódica. | Revisar queries impactadas e atualizar conforme o novo dicionário SX2. | Padronização de queries e dashboards: o que separa BI amador |
| Dificuldade em restaurar dashboards após erro. | Falta de controle de versões. | Adotar exportação e versionamento em Git para todos os artefatos. | Padronização de queries e dashboards: o que separa BI amador |
| Painel do Metabase não atualiza com vendas recentes | Lag na replicação ou falha na extração agendada | Verifique logs de replicação/extração e ajuste o agendamento | Painéis de vendas em tempo quase real: aprendizados de uma r |
| Consultas do Metabase estão lentas | Queries mal otimizadas ou falta de índices na réplica | Revise as queries e crie índices adequados | Painéis de vendas em tempo quase real: aprendizados de uma r |
| Vendas canceladas aparecem no painel | Filtro de status não aplicado corretamente na extração | Garanta que apenas registros com L1_SITUA = 'OK' sejam extraídos | Painéis de vendas em tempo quase real: aprendizados de uma r |
| Mapa não atualiza status dos hosts | Triggers não associadas corretamente aos elementos do mapa | Revise as triggers e vincule-as aos elementos certos | Painéis e mapas: visualização do status das lojas em tempo r |
| Widgets mostram dados desatualizados | Intervalo de atualização muito alto ou problemas de coleta | Reduza o intervalo e verifique o agente Zabbix | Painéis e mapas: visualização do status das lojas em tempo r |
| Dashboard lento ou travando | Excesso de widgets ou mapas muito grandes | Simplifique o dashboard e divida mapas em regiões menores | Painéis e mapas: visualização do status das lojas em tempo r |
| Execução lenta mesmo com forks altos | Control node saturado ou rede limitada | Reduza forks ou aumente recursos do servidor | Paralelismo avançado: maximizando throughput sem perder cont |
| Falhas intermitentes em hosts diferentes | Race condition ou limitação de recursos | Use serial menor e implemente locks | Paralelismo avançado: maximizando throughput sem perder cont |
| Processos do Ansible travam sem erro | Falta de memória ou excesso de forks | Monitore RAM e ajuste forks para baixo | Paralelismo avançado: maximizando throughput sem perder cont |
| Logs não mostram detalhes suficientes | Verbosity padrão muito baixa | Execute com -vvv ou redirecione logs para arquivo | Paralelismo avançado: maximizando throughput sem perder cont |
| Consultas continuam lentas após particionamento | Falta de índices adequados ou particionamento mal planejado | Revise os índices e o critério de particionamento; use EXPLAIN ANALYZE | Particionamento e otimização no PostgreSQL para grandes volu |
| Banco cresce sem parar | VACUUM não está rodando corretamente | Agende e monitore VACUUM; verifique logs | Particionamento e otimização no PostgreSQL para grandes volu |
| Erro ao criar partição | Intervalo de valores sobreposto ou falta de permissão | Ajuste os valores e revise permissões | Particionamento e otimização no PostgreSQL para grandes volu |
| Índices não aceleram consultas | Query não usa os campos indexados | Reescreva a consulta ou crie índices compostos | Particionamento e otimização no PostgreSQL para grandes volu |
| Playbook aplica mudanças em hosts errados | Grupos mal definidos ou inventários misturados | Revise a separação dos arquivos de inventário e os grupos usados nos playbooks | Particionando inventários e playbooks para grandes ambientes |
| Mudanças não são aplicadas em todos os hosts esperados | Uso incorreto de --limit ou grupos incompletos | Verifique o parâmetro --limit e complete os grupos nos arquivos de inventário | Particionando inventários e playbooks para grandes ambientes |
| Confusão de versões entre equipes | Repositórios únicos com múltiplos domínios | Implemente múltiplos repositórios e controle de acesso | Particionando inventários e playbooks para grandes ambientes |
| PDV não acessa a internet | Firewall bloqueando saída ou VLAN mal configurada | Revise regras de firewall e configuração de VLAN | PDV e PCI DSS: requisitos mínimos para não correr riscos |
| Logs não aparecem no servidor remoto | IP ou porta incorretos na configuração de log | Verifique IP, porta e protocolo (udp/tcp) do syslog | PDV e PCI DSS: requisitos mínimos para não correr riscos |
| PDV acessa hosts de outras VLANs | Falta de regra de bloqueio entre VLANs | Adicione regra de firewall rejeitando tráfego entre VLANs | PDV e PCI DSS: requisitos mínimos para não correr riscos |
| PDV não acessa a internet | Firewall bloqueando saída ou VLAN mal configurada | Revise regras de firewall e configuração de VLAN | PDV e PCI DSS: requisitos mínimos para não correr riscos |
| Logs não aparecem no servidor remoto | IP ou porta incorretos na configuração de log | Verifique IP, porta e protocolo (udp/tcp) do syslog | PDV e PCI DSS: requisitos mínimos para não correr riscos |
| PDV acessa hosts de outras VLANs | Falta de regra de bloqueio entre VLANs | Adicione regra de firewall rejeitando tráfego entre VLANs | PDV e PCI DSS: requisitos mínimos para não correr riscos |
| ERP lento durante extração | Consulta pesada ou volume excessivo | Reduza o volume, divida em lotes menores e ajuste o horário | Performance na extração: como não sobrecarregar o ERP |
| Extração falha por bloqueio de tabela | Lock em tabela concorrente com operação do ERP | Agende para fora do horário de uso e revise índices/consultas | Performance na extração: como não sobrecarregar o ERP |
| Dados inconsistentes na réplica | Extração durante backup ou janela de replicação incompleta | Ajuste a janela e sincronize após o backup | Performance na extração: como não sobrecarregar o ERP |
| Standby não replica dados do primário | Configuração incorreta de primary_conninfo ou firewall bloqueando porta 5432 | Revise primary_conninfo e libere porta no firewall | Planejando para crescer: alta disponibilidade e redundância |
| HAProxy não detecta servidor Odoo | Odoo não está rodando ou porta errada na configuração | Verifique status do Odoo e ajuste IP/porta no HAProxy | Planejando para crescer: alta disponibilidade e redundância |
| Backup não é criado | Permissões insuficientes ou caminho inexistente | Ajuste permissões e crie diretório de destino | Planejando para crescer: alta disponibilidade e redundância |
| Configuração divergente entre lojas | Comandos aplicados manualmente de formas diferentes | Padronize scripts ou use automação para garantir consistência | Por que automatizar redes de varejo: limites do manual e ris |
| Downtime prolongado após atualização | Falta de rollback ou backup automático | Implemente processos de backup e rollback automatizados | Por que automatizar redes de varejo: limites do manual e ris |
| Auditoria não encontra logs de mudanças | Alterações feitas sem registro central | Use ferramentas que gerem logs automáticos de configuração | Por que automatizar redes de varejo: limites do manual e ris |
| Consultas lentas ou travando o ERP | Consulta pesada em produção ou falta de índices | Reduza o volume de dados, crie índices ou use extração agendada | Por que BI com Metabase no varejo: limites e potencial do Pr |
| Erro de permissão ao conectar | Usuário do banco sem permissão de SELECT | Garanta que o usuário tem permissão apenas de leitura nas tabelas necessárias | Por que BI com Metabase no varejo: limites e potencial do Pr |
| Dados desatualizados no BI | Frequência de extração ou réplica inadequada | Ajuste o agendamento da extração para atender ao negócio | Por que BI com Metabase no varejo: limites e potencial do Pr |
| O item de latência não retorna valor | O host monitorado está offline ou o firewall bloqueia ICMP. | Verifique conectividade e regras de firewall. | Por que monitorar lojas: riscos e oportunidades no varejo co |
| Alertas não chegam por e-mail | Configuração de mídia ou SMTP incorreta no Zabbix. | Revise as configurações de notificação. | Por que monitorar lojas: riscos e oportunidades no varejo co |
| Dados históricos não aparecem nos gráficos | Problema no banco de dados ou retenção de dados muito curta. | Verifique o status do banco e ajuste a política de retenção. | Por que monitorar lojas: riscos e oportunidades no varejo co |
| Dashboard demora para carregar | Consulta pesada no banco de produção | Use réplica ou extração para banco dedicado ao BI | Por que não basta um relatório? BI, dashboards e o desafio d |
| Dados inconsistentes entre BI e ERP | Sincronização deficiente ou extração incompleta | Ajuste o processo de carga e valide logs de ETL | Por que não basta um relatório? BI, dashboards e o desafio d |
| Indicadores não batem com relatórios do ERP | Diferenças de filtros, períodos ou campos usados | Revise as queries e confirme com o dicionário SX2 do ambiente | Por que não basta um relatório? BI, dashboards e o desafio d |
| Consultas do Metabase deixam o ERP lento | Conexão está sendo feita no banco de produção, não na réplica | Redirecione o Metabase para a réplica ou extração autorizada | Por que não usar o banco de produção: riscos, bloqueios e in |
| Usuário do BI não acessa todas as tabelas necessárias | Permissões de leitura insuficientes na réplica | Solicite ao DBA a concessão de SELECT nas tabelas necessárias | Por que não usar o banco de produção: riscos, bloqueios e in |
| Dados do BI estão desatualizados | Janela de carga não está respeitada ou extração falhou | Reveja o agendamento da extração e monitore logs de carga | Por que não usar o banco de produção: riscos, bloqueios e in |
| Lentidão no ERP após consulta BI | Consulta executada no banco de produção em horário crítico | Redirecione todas as consultas para réplica ou extração; nunca use produção | Por que nunca consultar o banco de produção em horário de pi |
| Erro de permissão ao conectar | Usuário sem permissão de leitura na réplica | Ajuste as permissões do usuário no SGBD | Por que nunca consultar o banco de produção em horário de pi |
| Dados desatualizados no BI | Extração ou réplica não sincronizada | Revise a frequência da carga e ajuste a ventana de carga | Por que nunca consultar o banco de produção em horário de pi |
| PDV não comunica com a internet | VLAN ou firewall mal configurados | Revise a configuração de VLAN e regras de firewall para o segmento PDV | Por que rede de loja não é igual à da sua casa |
| Wi-Fi de clientes acessa sistemas internos | Falta de isolamento de VLAN ou regra de firewall ausente | Implemente segmentação e bloqueio explícito entre redes | Por que rede de loja não é igual à da sua casa |
| Failover não funciona | Configuração do mwan3 incompleta ou interface errada | Consulte logs do OpenWrt e revise interfaces WAN | Por que rede de loja não é igual à da sua casa |
| Câmeras sem acesso ao gravador | VLANs separadas sem rota permitida | Permita apenas o tráfego necessário entre câmeras e NVR | Por que rede de loja não é igual à da sua casa |
| Usuário não é redirecionado ao portal | Firewall ou DNS mal configurado | Revise regras de firewall e DNS, consulte a documentação | Portal cativo: configurando autenticação e consentimento LGP |
| Consentimento não é registrado nos logs | Formulário HTML sem campo obrigatório ou erro no script de registro | Corrija o HTML e teste o envio dos dados | Portal cativo: configurando autenticação e consentimento LGP |
| Logs não chegam ao servidor externo | Syslog remoto não configurado ou bloqueio de porta | Verifique configuração do syslog e regras de firewall | Portal cativo: configurando autenticação e consentimento LGP |
| Usuário não é redirecionado ao portal | Firewall ou DNS mal configurado | Revise regras de firewall e DNS, consulte a documentação | Portal cativo: configurando autenticação e consentimento LGP |
| Consentimento não é registrado nos logs | Formulário HTML sem campo obrigatório ou erro no script de registro | Corrija o HTML e teste o envio dos dados | Portal cativo: configurando autenticação e consentimento LGP |
| Logs não chegam ao servidor externo | Syslog remoto não configurado ou bloqueio de porta | Verifique configuração do syslog e regras de firewall | Portal cativo: configurando autenticação e consentimento LGP |
| Playbook falha com erro de permissão | Usuário remoto não tem privilégio para alterar configs | Garanta que become: true está setado e o usuário tem sudo/root. | Primeiro playbook: configurando hostname e acesso SSH em mas |
| Hostname não muda após execução | Comando uci não aplicado corretamente ou serviço não reiniciado | Verifique se todas as tarefas foram executadas sem erro e revise a ordem das tarefas. | Primeiro playbook: configurando hostname e acesso SSH em mas |
| Não consigo acessar via SSH após rodar o playbook | Chave pública não copiada corretamente ou permissão errada no arquivo | Confirme caminho, permissões e conteúdo do authorized_keys no destino. | Primeiro playbook: configurando hostname e acesso SSH em mas |
| Dados pessoais ainda aparecem em relatórios | Anonimização ou minimização incompleta nos scripts SQL | Revise queries e ajuste funções de mascaramento/remoção | Privacidade e LGPD: anonimização e minimização de dados no B |
| Logs de auditoria não são gerados | Configuração incorreta do logging no PostgreSQL | Verifique e corrija parâmetros em postgresql.conf | Privacidade e LGPD: anonimização e minimização de dados no B |
| Usuários acessam dados além do necessário | Permissões mal configuradas no Metabase | Ajuste roles e restrinja coleções e queries | Privacidade e LGPD: anonimização e minimização de dados no B |
| Documentação desatualizada | Falta de revisão periódica | Implemente checklist mensal de conformidade | Privacidade e LGPD: anonimização e minimização de dados no B |
| Usuário não consegue acessar a internet após aceitar os termos | Redirecionamento ou interface do gateway incorreta | Corrija o parâmetro GatewayInterface e teste o fluxo | Problemas típicos de portal cativo, analytics e LGPD |
| Dados de analytics não aparecem | Falha na integração com o coletor ou erro no endereço do servidor | Verifique configuração do coletor e logs de envio | Problemas típicos de portal cativo, analytics e LGPD |
| Consentimento não é registrado | Portal apenas exibe termos sem registro efetivo | Implemente registro do aceite em log seguro | Problemas típicos de portal cativo, analytics e LGPD |
| Logs de acesso acumulam indefinidamente | Ausência de política de expurgo automático | Configure cron para remover logs antigos | Problemas típicos de portal cativo, analytics e LGPD |
| Usuário reclama de privacidade | Coleta excessiva ou falta de transparência | Reveja texto do consentimento e minimize dados coletados | Problemas típicos de portal cativo, analytics e LGPD |
| Usuário não consegue acessar a internet após aceitar os termos | Redirecionamento ou interface do gateway incorreta | Corrija o parâmetro GatewayInterface e teste o fluxo | Problemas típicos de portal cativo, analytics e LGPD |
| Dados de analytics não aparecem | Falha na integração com o coletor ou erro no endereço do servidor | Verifique configuração do coletor e logs de envio | Problemas típicos de portal cativo, analytics e LGPD |
| Consentimento não é registrado | Portal apenas exibe termos sem registro efetivo | Implemente registro do aceite em log seguro | Problemas típicos de portal cativo, analytics e LGPD |
| Logs de acesso acumulam indefinidamente | Ausência de política de expurgo automático | Configure cron para remover logs antigos | Problemas típicos de portal cativo, analytics e LGPD |
| Usuário reclama de privacidade | Coleta excessiva ou falta de transparência | Reveja texto do consentimento e minimize dados coletados | Problemas típicos de portal cativo, analytics e LGPD |
| Campo sensível aparece completo no Metabase | View SQL não está mascarando corretamente ou o BI está acessando a tabela original | Ajuste a view para mascarar/anomizar e aponte o Metabase para a view, não para a tabela | Proteção de dados sensíveis: clientes e transações no BI |
| Logs do Metabase não mostram exportações | Nível de log insuficiente ou logs não configurados corretamente | Ajuste configuração de logging do Metabase e reinicie | Proteção de dados sensíveis: clientes e transações no BI |
| Consultas pesadas travam o banco de produção | BI está consultando diretamente o banco produtivo em horário de pico | Configure BI para usar réplica ou extração agendada | Proteção de dados sensíveis: clientes e transações no BI |
| Usuário vê dados de todas as filiais | Regra de registro ausente ou mal configurada | Revise o domínio da regra e associe ao grupo correto | Protegendo o Odoo: usuários, permissões e autenticação forte |
| Logs não aparecem no arquivo | Caminho do logfile incorreto ou permissão insuficiente | Corrija o caminho e garanta permissão de escrita para o usuário do Odoo | Protegendo o Odoo: usuários, permissões e autenticação forte |
| Usuário não consegue acessar nada | Permissões excessivamente restritivas | Ajuste as ACLs e regras de registro para o mínimo necessário | Protegendo o Odoo: usuários, permissões e autenticação forte |
| Hosts marcados como unreachable | Dispositivo offline ou sem acesso SSH. | Confirme conectividade e credenciais, tente novamente só nesse host. | Provisionamento em ondas: estratégias para evitar gargalos |
| Timeouts durante execução do batch | Batch grande demais para a capacidade do servidor ou da rede. | Reduza o valor de serial e reexecute. | Provisionamento em ondas: estratégias para evitar gargalos |
| Rollback não reverteu todos os dispositivos | Hosts falharam antes de aplicar a tarefa de rollback. | Execute o rollback manualmente nos hosts afetados. | Provisionamento em ondas: estratégias para evitar gargalos |
| Dashboard não mostra dados preditos | Tabela auxiliar não foi criada ou está vazia | Revise o script Python e a conexão com o banco. | Próximos passos: IA, predição e automação no BI do varejo |
| Alertas não são enviados | Configuração de SMTP ou webhook incorreta no Superset | Consulte a documentação e revise o superset_config.py. | Próximos passos: IA, predição e automação no BI do varejo |
| Consultas lentas ou travando o ERP | Execução de queries no banco de produção | Redirecione o BI para uma réplica ou extração agendada. | Próximos passos: IA, predição e automação no BI do varejo |
| Trigger não gera evento | Expressão da trigger incorreta ou item sem dados recentes | Revise a expressão e force coleta do item | Quando o alerta não chega: debug de triggers, ações e notifi |
| Ação não executa | Condições da ação não correspondem ao evento | Ajuste as condições para serem menos restritivas | Quando o alerta não chega: debug de triggers, ações e notifi |
| Media type falha no teste | Parâmetros de autenticação ou destino incorretos | Corrija usuário, senha, token ou endpoint | Quando o alerta não chega: debug de triggers, ações e notifi |
| Log mostra 'Successfully sent', mas nada chega | Entrega bloqueada fora do Zabbix (spam, firewall, API externa) | Verifique logs externos e filtros do destinatário | Quando o alerta não chega: debug de triggers, ações e notifi |
| Dashboard não carrega, só mostra spinner | Query muito pesada ou sem filtro de datas | Adicione filtros obrigatórios de período e limite de linhas | Quando o dashboard trava: debug de consultas e fontes de dad |
| Erro de permissão no log | Usuário do banco sem grants de leitura | Ajuste permissões no banco, garantindo acesso somente leitura | Quando o dashboard trava: debug de consultas e fontes de dad |
| Dados incompletos no gráfico | Filtro excessivo ou query truncada por limite baixo | Revise filtros e aumente o limite de linhas conforme necessário | Quando o dashboard trava: debug de consultas e fontes de dad |
| Quedas frequentes de Wi-Fi | APs sobrecarregados ou mal posicionados | Reduza usuários por AP ou adicione novos pontos de acesso | Quantos APs, switches e links? Dimensionamento na prática |
| PDV sem conexão em horário de pico | Switch saturado ou link insuficiente | Aumente a capacidade do switch ou do link | Quantos APs, switches e links? Dimensionamento na prática |
| Áreas sem sinal | Obstáculos físicos ou distância excessiva | Reposicione APs ou adicione repetidores | Quantos APs, switches e links? Dimensionamento na prática |
| Quedas frequentes de Wi-Fi | APs sobrecarregados ou mal posicionados | Reduza usuários por AP ou adicione novos pontos de acesso | Quantos APs, switches e links? Dimensionamento na prática |
| PDV sem conexão em horário de pico | Switch saturado ou link insuficiente | Aumente a capacidade do switch ou do link | Quantos APs, switches e links? Dimensionamento na prática |
| Áreas sem sinal | Obstáculos físicos ou distância excessiva | Reposicione APs ou adicione repetidores | Quantos APs, switches e links? Dimensionamento na prática |
| Superset travando ou retornando erro 504 | Workers ou threads insuficientes, ou falta de RAM/CPU. | Aumente SUPERSET_WORKERS, SUPERSET_WEBSERVER_THREADS e os limites de recursos no Docker. | Quantos dados, quantos usuários? Dimensionando Superset e ba |
| Consultas lentas mesmo com poucos usuários | Banco de dados sobrecarregado ou consultas sem índices. | Peça tuning ao DBA e use réplica para BI. | Quantos dados, quantos usuários? Dimensionando Superset e ba |
| Erro de conexão ao banco no Superset | Driver DB-API ausente ou URI incorreta. | Instale o driver correto e revise a string de conexão conforme a documentação. | Quantos dados, quantos usuários? Dimensionando Superset e ba |
| Consulta nunca termina ou trava outras operações | Falta de filtro ou ausência de índice | Adicione filtros por campos indexados e revise o plano de execução | Queries lentas ou travando: como identificar e otimizar |
| Dashboard do Metabase demora a carregar | Consulta retorna volume excessivo de dados | Use LIMIT ou restrinja o período consultado | Queries lentas ou travando: como identificar e otimizar |
| Bloqueios em tabelas de vendas durante o expediente | Consulta pesada em produção | Execute consultas apenas em réplica ou fora do horário de pico | Queries lentas ou travando: como identificar e otimizar |
| Erro de permissão ao restaurar banco | Usuário PostgreSQL sem permissão ou banco já existente | Verifique permissões e exclua banco existente antes do restore | Recuperando o ambiente: backup, restore e rollback seguro |
| Módulos sumiram após restore | Filestore ou addons não restaurados corretamente | Restaure diretórios de addons e filestore junto com o banco | Recuperando o ambiente: backup, restore e rollback seguro |
| Integrações externas não funcionam após rollback | Configurações de API ou tokens não restaurados | Valide e atualize credenciais nas configurações do Odoo | Recuperando o ambiente: backup, restore e rollback seguro |
| Backup não restaura em nova versão do Odoo | Incompatibilidade entre versões do banco ou Odoo | Consulte a documentação sobre migração e compatibilidade | Recuperando o ambiente: backup, restore e rollback seguro |
| Odoo lento em horários de pico | Workers insuficientes ou CPU saturada | Aumente o número de workers e CPUs conforme a fórmula recomendada | Recursos mínimos e gargalos: CPU, RAM, disco e rede |
| Consultas de estoque travando | shared_buffers do PostgreSQL baixo ou disco lento | Ajuste shared_buffers e migre para SSD | Recursos mínimos e gargalos: CPU, RAM, disco e rede |
| Erros de conexão ao banco de dados | max_connections insuficiente no PostgreSQL | Aumente max_connections em postgresql.conf | Recursos mínimos e gargalos: CPU, RAM, disco e rede |
| Sincronização entre lojas atrasada | Rede saturada ou latência alta | Verifique o uso da rede com iftop e aumente a largura de banda | Recursos mínimos e gargalos: CPU, RAM, disco e rede |
| Clientes não conseguem acessar o Wi-Fi | Canal congestionado ou potência inadequada | Refaça o site survey e ajuste canal/potência | Rede de filial em shopping: integração e analytics avançado |
| Logs não chegam ao servidor | IP ou porta incorretos na configuração do syslog | Confirme IP/porta e reinicie o serviço logd | Rede de filial em shopping: integração e analytics avançado |
| Portal cativo desconecta clientes rapidamente | Timeout baixo ou sobrecarga do AP | Ajuste o tempo de sessão e monitore a carga do AP | Rede de filial em shopping: integração e analytics avançado |
| Clientes não conseguem acessar o Wi-Fi | Canal congestionado ou potência inadequada | Refaça o site survey e ajuste canal/potência | Rede de filial em shopping: integração e analytics avançado |
| Logs não chegam ao servidor | IP ou porta incorretos na configuração do syslog | Confirme IP/porta e reinicie o serviço logd | Rede de filial em shopping: integração e analytics avançado |
| Portal cativo desconecta clientes rapidamente | Timeout baixo ou sobrecarga do AP | Ajuste o tempo de sessão e monitore a carga do AP | Rede de filial em shopping: integração e analytics avançado |
| Wi-Fi com sinal forte, mas sem navegação | Conflito de IP ou isolamento insuficiente das redes | Revise as configurações de VLAN e DHCP | Rede de loja de rua: desafios e soluções práticas |
| PDV ou câmera caindo frequentemente | Rede compartilhada com clientes ou interferência | Isolar redes e ajustar potência do rádio | Rede de loja de rua: desafios e soluções práticas |
| Clientes reclamam de lentidão em promoções | Excesso de conexões simultâneas | Reduzir limite de clientes ou adicionar mais access points | Rede de loja de rua: desafios e soluções práticas |
| Wi-Fi com sinal forte, mas sem navegação | Conflito de IP ou isolamento insuficiente das redes | Revise as configurações de VLAN e DHCP | Rede de loja de rua: desafios e soluções práticas |
| PDV ou câmera caindo frequentemente | Rede compartilhada com clientes ou interferência | Isolar redes e ajustar potência do rádio | Rede de loja de rua: desafios e soluções práticas |
| Clientes reclamam de lentidão em promoções | Excesso de conexões simultâneas | Reduzir limite de clientes ou adicionar mais access points | Rede de loja de rua: desafios e soluções práticas |
| Superset não conecta ao banco após failover | Variável de ambiente ou configuração não atualizada | Atualize o SUPERSET_SQLALCHEMY_DATABASE_URI e reinicie o container | Replicação e failover: alta disponibilidade para BI de missã |
| Standby não sincroniza com o primário | Permissões ou parâmetros de replicação incorretos | Revise pg_hba.conf, usuário e parâmetros no postgresql.conf | Replicação e failover: alta disponibilidade para BI de missã |
| Backup não restaura corretamente | Arquivo corrompido ou backup incompleto | Valide o backup após cada execução e teste a restauração periodicamente | Replicação e failover: alta disponibilidade para BI de missã |
| A réplica não aparece em pg_stat_replication | Configuração incorreta de pg_hba.conf ou senha inválida | Revise permissões e credenciais, teste conexão manualmente | Replicação e particionamento de dados para BI de alta escala |
| Consultas lentas mesmo com particionamento | Falta de filtro por campo particionado ou ausência de índices | Garanta que as queries filtram por data_venda e crie índices apropriados | Replicação e particionamento de dados para BI de alta escala |
| Metabase não conecta à réplica | Firewall bloqueando porta ou usuário sem permissão de leitura | Libere a porta 5432 e revise permissões do usuário no PostgreSQL | Replicação e particionamento de dados para BI de alta escala |
| Playbook executa mas serviço não reinicia | Nome do serviço incorreto ou permissão insuficiente | Confirme o nome real do serviço com 'systemctl list-units --type=service' e ajuste o playbook | Resolução automatizada de falhas comuns: exemplos práticos |
| Rollback não restaura configuração esperada | Backup desatualizado ou caminho errado | Verifique se o backup existe e está atualizado antes de rodar o playbook | Resolução automatizada de falhas comuns: exemplos práticos |
| Incidente não é registrado no log | Permissão insuficiente para escrever no arquivo de log | Ajuste permissões do arquivo ou rode o playbook como usuário com acesso | Resolução automatizada de falhas comuns: exemplos práticos |
| Erro 401 Unauthorized ao acessar endpoint | Token inválido ou permissões insuficientes | Gere novo token e revise permissões do usuário | REST API do Odoo: endpoints, autenticação e limites |
| Erro 500 Internal Server Error | Payload malformado ou campo obrigatório ausente | Valide o JSON enviado e consulte a documentação dos campos | REST API do Odoo: endpoints, autenticação e limites |
| Respostas lentas ou timeouts | Volume de requisições acima da capacidade do servidor | Implemente rate limiting e otimize consultas | REST API do Odoo: endpoints, autenticação e limites |
| Consulta lenta ou travando | Consulta pesada em produção ou falta de índices | Use réplica, extraia só os campos necessários e crie índices nas colunas de data. | Resultado de campanhas e promoções: comparar antes, durante |
| Dados divergentes entre BI e ERP | Erro de mapeamento de campos ou filtros inconsistentes | Revise os filtros e confirme nomes de campos no dicionário SX2. | Resultado de campanhas e promoções: comparar antes, durante |
| Metabase não conecta ao banco | Driver JDBC ausente ou configuração errada | Confirme o driver correto na pasta plugins e revise a configuração de conexão. | Resultado de campanhas e promoções: comparar antes, durante |
| Dados do dashboard atrasados | A replicação da base de BI não está atualizada. | Ajuste o agendamento da extração ou sincronização. | Resultado de campanhas e promoções: comparar antes, durante |
| Campos não encontrados na consulta | Nome do campo diferente ou customizado no ERP. | Consulte o SX2 do ambiente para o nome correto. | Resultado de campanhas e promoções: comparar antes, durante |
| Consultas lentas ou travando | Consulta pesada rodando direto na base de produção. | Use sempre uma réplica dedicada para BI. | Resultado de campanhas e promoções: comparar antes, durante |
| Os valores de vendas não mudam entre os períodos. | Datas da campanha estão erradas ou o filtro SQL está incorreto. | Revise as datas e a lógica do CASE na consulta. | Resultado de campanhas e promoções: comparar antes, durante |
| Margem aparece zerada. | Campo de custo não está sendo carregado ou está nulo. | Confirme a extração dos custos na base de BI. | Resultado de campanhas e promoções: comparar antes, durante |
| Erro de permissão ao rodar a query. | Usuário de leitura não tem acesso à tabela ou campo. | Solicite ao DBA revisão das permissões. | Resultado de campanhas e promoções: comparar antes, durante |
| Consulta lenta ou travando | Execução em banco de produção ou sem índices adequados | Use sempre uma réplica ou extração; peça ao DBA para revisar índices. | Resultado de campanhas e promoções: comparar antes, durante |
| Dados inconsistentes entre ERP e Superset | Extração desatualizada ou janela de consulta errada | Garanta que a extração esteja atualizada e revise as datas na consulta. | Resultado de campanhas e promoções: comparar antes, durante |
| Erro de conexão no Superset | Driver ausente ou URI incorreta | Confirme instalação do driver e revise a string de conexão conforme a documentação. | Resultado de campanhas e promoções: comparar antes, durante |
| Tabelas history continuam crescendo | Housekeeper desativado ou mal configurado | Revise parâmetros no zabbix_server.conf e reinicie o serviço | Retenção de dados e arquivamento: mantendo performance com h |
| Purge muito lento | Volume excessivo de dados acumulado | Execute purge manual em lotes menores e ajuste a política de retenção | Retenção de dados e arquivamento: mantendo performance com h |
| Gráficos antigos sem dados detalhados | Período de histórico detalhado expirou | Aumente o período de histórico ou exporte dados antes do purge | Retenção de dados e arquivamento: mantendo performance com h |
| Banco de dados lento | Tabelas de histórico muito grandes | Reduza o período de retenção e otimize índices | Retenção de dados e arquivamento: mantendo performance com h |
| Comando remoto não executa | EnableRemoteCommands não ativado ou UserParameter ausente | Verifique configuração do agente e reinicie o serviço | Scripts e comandos remotos: automatizando respostas a incide |
| Permissão negada ao executar script | Sudoers não configurado para o usuário zabbix | Ajuste o /etc/sudoers conforme exemplo | Scripts e comandos remotos: automatizando respostas a incide |
| Comando remoto executa, mas serviço não reinicia | Nome do serviço incorreto ou script sem permissão de execução | Cheque nome do serviço e permissões do script | Scripts e comandos remotos: automatizando respostas a incide |
| Logs não são gerados | Script não grava no diretório ou falta permissão de escrita | Ajuste permissões do diretório de log | Scripts e comandos remotos: automatizando respostas a incide |
| Usuário não consegue acessar o Superset após integração LDAP. | Configuração incorreta do AUTH_LDAP_SEARCH ou credenciais inválidas. | Revise os parâmetros LDAP no superset_config.py e teste com ldapsearch. | Segurança no Superset: autenticação, RBAC e logs de acesso |
| Logs não estão sendo gravados. | Permissões de escrita insuficientes na pasta de logs. | Ajuste as permissões do diretório /var/log/superset para o usuário do Superset. | Segurança no Superset: autenticação, RBAC e logs de acesso |
| Usuário visualizador consegue editar dashboards. | Papel atribuído incorretamente ou permissões mal configuradas. | Revise os papéis e permissões em Security > List Roles. | Segurança no Superset: autenticação, RBAC e logs de acesso |
| Consulta lenta mesmo após particionamento | Consulta não filtra pela coluna de particionamento | Adicione filtro na coluna particionada (ex: WHERE data_venda = ...) | Sharding e particionamento no PostgreSQL para grandes volume |
| Erro ao inserir dados | Intervalo de valor não coberto por nenhuma partição | Crie uma nova partição para o intervalo desejado | Sharding e particionamento no PostgreSQL para grandes volume |
| Backup ou restore muito lento | Operação feita na tabela inteira, não por partição | Realize backup/restauração por partição sempre que possível | Sharding e particionamento no PostgreSQL para grandes volume |
| Proxy aparece como 'Desconectado' no frontend | Falha de rede ou configuração incorreta do arquivo zabbix_proxy.conf | Verifique conectividade TCP e os parâmetros Server e Hostname. | Sharding, proxies e balanceamento: escalando o Zabbix em múl |
| Dados de uma loja não aparecem no servidor central | Proxy não está sincronizando ou banco de dados local está corrompido | Cheque os logs do proxy e reinicie o serviço após corrigir o banco. | Sharding, proxies e balanceamento: escalando o Zabbix em múl |
| Balanceador de carga não distribui conexões | Configuração incorreta do HAProxy ou servidores Zabbix inativos | Reveja haproxy.cfg e teste conexão direta com cada servidor. | Sharding, proxies e balanceamento: escalando o Zabbix em múl |
| Erro de chave estrangeira ao inserir venda ou item | ID de loja, cliente, produto ou campanha não existe na tabela dimensional | Insira primeiro os registros nas tabelas dimensionais. | Simulação de campanhas e promoções: modelo didático com bi_v |
| Consulta retorna valores zerados | Dados simulados insuficientes ou erro de filtro na query | Verifique se os dados foram inseridos e revise as condições da consulta. | Simulação de campanhas e promoções: modelo didático com bi_v |
| Metabase não reconhece as tabelas | Permissões insuficientes ou conexão mal configurada | Garanta que o usuário do Metabase tenha acesso ao esquema bi_varejo. | Simulação de campanhas e promoções: modelo didático com bi_v |
| Tarefas ficam presas na fila | Worker Celery não está rodando ou perdeu conexão com RabbitMQ | Reinicie o worker e verifique logs de conexão | Sincronização massiva: filas, cache e consistência eventual |
| Dados desatualizados mesmo após tempo de cache expirar | Função de atualização não está sendo chamada corretamente | Revise lógica de invalidação e atualização do cache | Sincronização massiva: filas, cache e consistência eventual |
| Conflitos de estoque não aparecem em log | Falta de implementação de registro de conflitos | Implemente auditoria nas funções de merge | Sincronização massiva: filas, cache e consistência eventual |
| Zabbix mostra 'Timeout while connecting to "device"' | Firewall bloqueando porta UDP 161 ou SNMP desativado no dispositivo | Verifique firewall e se SNMP está ativado | SNMP na prática: monitorando impressoras fiscais e switches |
| Item SNMP retorna 'No Such Object available on this agent at this OID' | OID incorreto ou não suportado pelo dispositivo | Confirme OID com snmpwalk ou documentação do fabricante | SNMP na prática: monitorando impressoras fiscais e switches |
| SNMP v3 falha com 'Authentication failure' | Usuário, senha ou protocolo de autenticação inválidos | Revise configuração de usuário SNMP v3 em ambos os lados | SNMP na prática: monitorando impressoras fiscais e switches |
| Erro ao conectar ao banco de dados | Driver ausente ou URI incorreta | Verifique se o driver está instalado e a string de conexão está correta | Superset 6.x: novidades e recursos avançados para BI de vare |
| Gráficos não aparecem após instalar plugin | Plugin não instalado corretamente ou requer reinício do Superset | Reinstale o plugin e reinicie o serviço | Superset 6.x: novidades e recursos avançados para BI de vare |
| Filtros globais não afetam todos os gráficos | Gráficos não estão vinculados ao mesmo filtro | Configure todos os gráficos para usar o filtro global desejado | Superset 6.x: novidades e recursos avançados para BI de vare |
| Plugin não aparece na interface | Registro incorreto ou falha na instalação do pacote | Revise o superset_config.py e reinstale o pacote | Superset 6.x: novidades, plugins e integrações avançadas |
| Erro ao conectar ao banco de dados | Driver DB-API ou dialeto SQLAlchemy ausente | Instale os pacotes corretos e reinicie o Superset | Superset 6.x: novidades, plugins e integrações avançadas |
| Métricas Prometheus não disponíveis | Configuração ENABLE_PROMETHEUS_METRICS ausente ou errada | Adicione a configuração e reinicie o serviço | Superset 6.x: novidades, plugins e integrações avançadas |
| Dashboards lentos mesmo após particionamento | Falta de índices ou queries mal otimizadas | Revise índices e planos de execução das queries | Superset para 1, 10, 100 lojas: escalando BI no varejo |
| Usuários desconectados aleatoriamente | Configuração incorreta de Redis ou sessões | Confirme que todos os contêineres usam o mesmo Redis | Superset para 1, 10, 100 lojas: escalando BI no varejo |
| Superset indisponível em horários de pico | Limite de conexões ou recursos insuficientes | Aumente instâncias Superset e recursos do servidor | Superset para 1, 10, 100 lojas: escalando BI no varejo |
| Logs não aparecem ou estão vazios. | Permissões insuficientes ou caminho de log incorreto. | Confirme o caminho do log e ajuste permissões do usuário. | Superset sob vigilância: monitorando performance e uso |
| Alertas não chegam por e-mail. | Mail não instalado ou SMTP bloqueado. | Instale um agente de e-mail e teste o envio manualmente. | Superset sob vigilância: monitorando performance e uso |
| Métricas do node_exporter não aparecem no Prometheus. | Firewall bloqueando porta 9100 ou configuração incorreta no prometheus.yml. | Libere a porta 9100 e revise o arquivo de configuração. | Superset sob vigilância: monitorando performance e uso |
| Valores de vendas duplicados ou inconsistentes | Relacionamento incorreto entre tabelas (ex: join errado entre SL1 e SL2) | Revise as chaves compostas e confirme no SX2. | Tabelas essenciais do Protheus PDV para BI: do SL1 ao SA1 |
| Campos não encontrados na query | Nome de campo diferente no ambiente | Consulte o SX2 para o nome correto. | Tabelas essenciais do Protheus PDV para BI: do SL1 ao SA1 |
| Vendas recentes não aparecem na análise | Filtro só em SD2/SF2, vendas ainda não processadas | Inclua SL1/SL2 com L1_SITUA = 'RX' para vendas pendentes. | Tabelas essenciais do Protheus PDV para BI: do SL1 ao SA1 |
| Itens do template não aparecem no host | Template não vinculado corretamente ou erro de permissão | Verifique se o template está realmente associado ao host e revise permissões de usuário | Templates e padronização: monitoramento eficiente em escala |
| Triggers do template não disparam | Condições de trigger incorretas ou itens sem coleta de dados | Revise a expressão da trigger e confirme se os itens estão coletando dados | Templates e padronização: monitoramento eficiente em escala |
| Erro ao importar template XML | Conflito de nomes ou dependências não atendidas | Ajuste nomes ou importe templates dependentes primeiro | Templates e padronização: monitoramento eficiente em escala |
| Dashboard do Metabase mostra dados desatualizados | ETL ou replicação com atraso, ou intervalo de atualização muito longo | Revise o agendamento do ETL e ajuste a frequência de atualização no Metabase | Tendências em BI para varejo: dados em tempo real, IA e inte |
| Relatórios com clientes duplicados | Falta de chave única ou deduplicação nos cadastros | Implemente regras de unificação e padronização de dados | Tendências em BI para varejo: dados em tempo real, IA e inte |
| Previsões de IA não aparecem nos dashboards | Tabela de previsões não está sendo atualizada ou não foi conectada ao Metabase | Verifique o processo de gravação dos resultados e reconfigure a fonte no Metabase | Tendências em BI para varejo: dados em tempo real, IA e inte |
| ansible-lint retorna erro de YAML | Indentação ou sintaxe incorreta no arquivo | Revise o YAML conforme a especificação em yaml.org/spec/1.2 | Testes automatizados de playbooks: evite surpresas em produç |
| molecule falha no teste de idempotência | Playbook não está idempotente; tasks alteram estado a cada execução | Ajuste tasks para serem idempotentes, usando módulos declarativos | Testes automatizados de playbooks: evite surpresas em produç |
| molecule não encontra dependências | Ambiente de teste mal configurado ou dependências ausentes | Verifique o arquivo molecule.yml e instale dependências necessárias | Testes automatizados de playbooks: evite surpresas em produç |
| Dados das filiais não aparecem no server central | Proxy não consegue se conectar ao server ou falha de autenticação TLS | Verifique logs do proxy e ajuste configurações de rede e TLS | Topologias de monitoramento: loja única, múltiplas lojas, ma |
| Alertas de 'unreachable' em todos os hosts de uma filial | Proxy caiu ou link WAN indisponível | Reinicie o proxy e valide a conectividade | Topologias de monitoramento: loja única, múltiplas lojas, ma |
| Coleta local funciona, mas não sincroniza após retorno do link | Proxy com buffer cheio ou erro de configuração de fila | Aumente buffers e revise configurações em zabbix_proxy.conf | Topologias de monitoramento: loja única, múltiplas lojas, ma |
| Dispositivos de uma VLAN acessam outra sem restrição | Configuração de VLAN ou firewall incorreta | Revise regras de firewall e atribuição de VLAN nas portas | Topologias de rede para lojas físicas e múltiplas filiais |
| Rede para após desconectar um uplink | STP desativado ou uplink redundante não funcionando | Ative STP e teste ambos os caminhos físicos | Topologias de rede para lojas físicas e múltiplas filiais |
| Filiais não se comunicam via VPN | Rotas ausentes ou conflito de sub-redes | Ajuste sub-redes e rotas nos servidores OpenVPN | Topologias de rede para lojas físicas e múltiplas filiais |
| Playbooks falham em algumas lojas | Conectividade instável ou NAT bloqueando acesso | Teste conectividade com 'ping' e ajuste firewalls ou use ansible-pull | Topologias de varejo: lojas isoladas, matriz-filial e redes |
| Execução lenta de playbooks | Latência alta ou perda de pacotes | Reduza o paralelismo (serial) e agende execuções fora do horário de pico | Topologias de varejo: lojas isoladas, matriz-filial e redes |
| Logs não chegam à matriz | Falha de upload ou conexão interrompida | Implemente reenvio automático e logging local | Topologias de varejo: lojas isoladas, matriz-filial e redes |
| Usuário de uma filial visualiza dados de outra | Record rules mal configuradas ou permissões excessivas | Revise e teste as regras de acesso no Odoo | Topologias reais: multiloja, replicação e isolamento de dado |
| Replicação do PostgreSQL não inicia | Configuração incorreta do pg_hba.conf ou usuário de replicação | Ajuste o pg_hba.conf e valide o usuário com permissão REPLICATION | Topologias reais: multiloja, replicação e isolamento de dado |
| Servidor Odoo lento em horários de pico | Sobrecarga por excesso de conexões simultâneas | Aumente recursos do servidor ou distribua a carga com múltiplas instâncias | Topologias reais: multiloja, replicação e isolamento de dado |
| Operador acessa recursos restritos | Política ou segmentação de rede mal configurada | Revise regras de firewall e permissões de SSID | Treinamento de equipe e políticas de uso aceitável |
| Convidado acessa impressoras ou PDV | Falta de isolamento entre redes | Aplique regras de firewall bloqueando tráfego entre guest e lan | Treinamento de equipe e políticas de uso aceitável |
| Equipe não sabe agir em incidentes | Treinamento insuficiente ou política desatualizada | Realize reciclagem e atualize procedimentos | Treinamento de equipe e políticas de uso aceitável |
| Operador acessa recursos restritos | Política ou segmentação de rede mal configurada | Revise regras de firewall e permissões de SSID | Treinamento de equipe e políticas de uso aceitável |
| Convidado acessa impressoras ou PDV | Falta de isolamento entre redes | Aplique regras de firewall bloqueando tráfego entre guest e lan | Treinamento de equipe e políticas de uso aceitável |
| Equipe não sabe agir em incidentes | Treinamento insuficiente ou política desatualizada | Realize reciclagem e atualize procedimentos | Treinamento de equipe e políticas de uso aceitável |
| Dashboard demora minutos para carregar | Filtros ausentes ou mal configurados; consulta retorna dados demais | Adicione filtros obrigatórios e revise queries | Tuning do Superset: filtros, permissões e performance |
| Usuário vê dados de outras lojas | Permissão de acesso ampla demais | Ajuste papéis e permissões de acesso | Tuning do Superset: filtros, permissões e performance |
| Erro de timeout em consultas | Consulta pesada ou limites muito baixos | Otimize a query ou ajuste o timeout com cautela | Tuning do Superset: filtros, permissões e performance |
| Usuário do Superset consegue editar ou apagar dados | Permissão excessiva no banco (INSERT, UPDATE, DELETE) | Revogue permissões e conceda apenas SELECT | Usuário só lê: políticas de acesso e restrição no BI de ERP |
| Usuário final não vê nenhum dado nos dashboards | Permissões insuficientes (falta de SELECT ou acesso ao schema) | Garanta GRANT SELECT nas tabelas e USAGE no schema | Usuário só lê: políticas de acesso e restrição no BI de ERP |
| Logs do Superset não mostram queries executadas | Nível de log inadequado ou configuração ausente | Ajuste LOG_LEVEL e revise superset_config.py | Usuário só lê: políticas de acesso e restrição no BI de ERP |
| Erro de conexão ao cadastrar banco no Superset | Usuário de banco inexistente ou senha incorreta | Confirme usuário, senha e permissões com o DBA | Usuário só lê: políticas de acesso e restrição no BI de ERP |
| O usuário de BI não consegue acessar nenhuma tabela. | Faltam privilégios de USAGE no esquema ou SELECT nas tabelas. | Conceda USAGE no esquema e SELECT nas tabelas conforme mostrado nos passos. | Usuário somente leitura: como garantir e auditar no PostgreS |
| Os logs não mostram conexões do usuário de BI. | O parâmetro log_connections está desativado. | Ative log_connections no postgresql.conf e reinicie o serviço. | Usuário somente leitura: como garantir e auditar no PostgreS |
| O usuário de BI consegue alterar dados. | Permissões de INSERT, UPDATE ou DELETE foram concedidas por engano. | Revogue todos os privilégios além de SELECT e revise as roles associadas. | Usuário somente leitura: como garantir e auditar no PostgreS |
| Playbook falha ao coletar configuração | Credenciais ou permissões SSH incorretas | Verifique usuário, senha e permissões no inventário | Validação automatizada de configuração e estado de rede |
| Relatório mostra divergências inexistentes | Modelo de estado desejado desatualizado | Atualize o YAML de referência | Validação automatizada de configuração e estado de rede |
| Correções não aplicadas | Condição 'when' incorreta ou sem permissão de escrita | Revise lógica condicional e permissões do usuário Ansible | Validação automatizada de configuração e estado de rede |
| Arquivo gerado com valores em branco | Variável não definida no inventário ou nome incorreto | Revise nomes de variáveis em host_vars, group_vars e no template. | Variáveis, templates e arquivos: parametrizando configuraçõe |
| Erro de execução: variável não definida | Variável obrigatória ausente | Inclua a variável no inventário ou defina valor padrão no playbook. | Variáveis, templates e arquivos: parametrizando configuraçõe |
| Configuração aplicada em host errado | Associação incorreta de host a grupo no inventário | Revise o arquivo de inventário e as associações de grupo. | Variáveis, templates e arquivos: parametrizando configuraçõe |
| Playbook executa versão errada após alteração | Commit não foi feito ou branch errada foi usada | Confirme branch ativa com 'git branch' e faça commit/pull corretamente | Versionamento e documentação de projetos Ansible para redes |
| Inventário não encontrado pelo Ansible | Arquivo está fora da pasta inventario/ ou nome incorreto | Padronize nomes e caminhos conforme estrutura sugerida | Versionamento e documentação de projetos Ansible para redes |
| Confusão sobre propósito de playbook | Falta de documentação ou comentários | Adicione README.md e comentários nos arquivos YAML | Versionamento e documentação de projetos Ansible para redes |
| Erro 'Data source is not working' | URL da API Zabbix incorreta ou usuário sem permissão | Verifique a URL e as permissões do usuário Zabbix. | Visualização avançada: integrando Zabbix ao Grafana |
| Dashboards não exibem dados | Itens do Zabbix não encontrados ou filtros incorretos | Revise os nomes dos hosts, grupos e itens usados nos painéis. | Visualização avançada: integrando Zabbix ao Grafana |
| Grafana lento ou travando | Consultas muito amplas ou histórico detalhado excessivo | Reduza o período das consultas e use dados de trends para períodos longos. | Visualização avançada: integrando Zabbix ao Grafana |
| Dispositivo não recebe IP ao conectar ao SSID | VLAN não configurada corretamente ou DHCP não ativo na interface | Revise a configuração da VLAN e do DHCP na interface correspondente | VLANs e SSIDs: separando PDV, clientes e câmeras |
| Clientes conseguem acessar o PDV | Regras de firewall ausentes ou incorretas | Implemente regras de bloqueio entre as VLANs | VLANs e SSIDs: separando PDV, clientes e câmeras |
| Câmeras sem acesso ao NVR | Regra de firewall bloqueando todo o tráfego | Permita acesso apenas do IP do NVR à VLAN das câmeras | VLANs e SSIDs: separando PDV, clientes e câmeras |
| Dispositivo não recebe IP ao conectar ao SSID | VLAN não configurada corretamente ou DHCP não ativo na interface | Revise a configuração da VLAN e do DHCP na interface correspondente | VLANs e SSIDs: separando PDV, clientes e câmeras |
| Clientes conseguem acessar o PDV | Regras de firewall ausentes ou incorretas | Implemente regras de bloqueio entre as VLANs | VLANs e SSIDs: separando PDV, clientes e câmeras |
| Câmeras sem acesso ao NVR | Regra de firewall bloqueando todo o tráfego | Permita acesso apenas do IP do NVR à VLAN das câmeras | VLANs e SSIDs: separando PDV, clientes e câmeras |
| Webhook não dispara | Gatilho da ação automatizada não está correto ou script com erro. | Revise o gatilho e valide o código Python. | Webhooks e scripts: integração além do básico |
| Erro 401 ou 403 na resposta do endpoint | Problema de autenticação ou permissão no endpoint externo. | Ajuste token ou credenciais no header da requisição. | Webhooks e scripts: integração além do básico |
| Logs mostram erro de conexão | Endpoint externo está offline ou URL incorreta. | Verifique conectividade e corrija a URL. | Webhooks e scripts: integração além do básico |
| Clientes não conectam após ativar WPA3 | Dispositivos antigos sem suporte a WPA3 | Habilite modo de compatibilidade WPA2/WPA3 ou atualize os dispositivos | Wi-Fi 6, Wi-Fi 7 e o futuro das redes de loja |
| Portal cativo lento ou travando | AP sobrecarregado ou canal congestionado | Reduza o número de clientes por AP e ajuste canais | Wi-Fi 6, Wi-Fi 7 e o futuro das redes de loja |
| Analytics com dados inconsistentes | Perda de pacotes por interferência | Replaneje a disposição dos APs e use bandas menos congestionadas | Wi-Fi 6, Wi-Fi 7 e o futuro das redes de loja |
| Clientes não conectam após ativar WPA3 | Dispositivos antigos sem suporte a WPA3 | Habilite modo de compatibilidade WPA2/WPA3 ou atualize os dispositivos | Wi-Fi 6, Wi-Fi 7 e o futuro das redes de loja |
| Portal cativo lento ou travando | AP sobrecarregado ou canal congestionado | Reduza o número de clientes por AP e ajuste canais | Wi-Fi 6, Wi-Fi 7 e o futuro das redes de loja |
| Analytics com dados inconsistentes | Perda de pacotes por interferência | Replaneje a disposição dos APs e use bandas menos congestionadas | Wi-Fi 6, Wi-Fi 7 e o futuro das redes de loja |
| SSID não aparece após aplicar playbook | Erro de sintaxe no template ou variável ausente | Revise o template e as variáveis; use 'logread' no AP para mensagens do hostapd | Wi-Fi em escala: SSID, segurança e otimização via playbooks |
| Dispositivos não conectam ao Wi-Fi | Senha incorreta ou modo de criptografia incompatível | Verifique as variáveis de senha e encryption; use WPA2-PSK para compatibilidade ampla | Wi-Fi em escala: SSID, segurança e otimização via playbooks |
| Interferência ou lentidão após atualização | Canais sobrepostos ou potência excessiva | Ajuste canais e potência no inventário; evite canais 1, 6 e 11 próximos fisicamente | Wi-Fi em escala: SSID, segurança e otimização via playbooks |
| Portal cativo não aparece ao conectar | Redirecionamento HTTP/HTTPS mal configurado ou firewall bloqueando. | Revise as regras de firewall e a configuração do Nodogsplash. | Wi-Fi, portal cativo e analytics: o que são e por que import |
| Usuários conseguem acessar a rede sem aceitar os termos | Portal cativo não está ativado na interface correta. | Confirme a interface definida em GatewayInterface no nodogsplash.conf. | Wi-Fi, portal cativo e analytics: o que são e por que import |
| Métricas de presença não aparecem ou estão zeradas | Coleta de dados passivos não ativada ou bloqueada por configuração de privacidade. | Revise scripts de coleta e permissões de leitura dos logs. | Wi-Fi, portal cativo e analytics: o que são e por que import |
| Erro 'SSL handshake failed' nos logs | Certificados incompatíveis ou caminhos errados | Revise os caminhos dos arquivos e se o certificado foi assinado pela mesma CA | Zabbix seguro: criptografia entre Server, Proxy e Agent |
| Agent não inicia após configuração | Permissões incorretas nos arquivos de chave | Ajuste para chmod 600 nos arquivos .key | Zabbix seguro: criptografia entre Server, Proxy e Agent |
| zabbix_get retorna timeout | Firewall bloqueando porta ou modo de conexão errado | Libere a porta 10050 e confira se TLS está habilitado no Agent | Zabbix seguro: criptografia entre Server, Proxy e Agent |
| Hosts aparecem como 'não suportados' | Configuração errada do Agent ou Proxy | Revise os parâmetros Server e Hostname nos arquivos de configuração | Zabbix Server, Proxy e Agent: quem faz o quê |
| Proxy não sincroniza com o Server | Firewall ou endereço IP incorreto | Verifique regras de firewall e IP do Server no zabbix_proxy.conf | Zabbix Server, Proxy e Agent: quem faz o quê |
| Dados atrasados após queda de link | Banco local do Proxy insuficiente | Aumente o espaço do banco local e revise a configuração DBName | Zabbix Server, Proxy e Agent: quem faz o quê |
