388 sintomas catalogados
Cada sintoma com causa provável e correção, ligado à lição da trilha BI que explica o porquê. Descreva o sintoma para filtrar.
| Sintoma | Causa provável | Correção | Lição |
|---|---|---|---|
| E-mail não chega aos destinatários | SMTP mal configurado ou bloqueado | Revise as configurações de e-mail em Administração > Configurações > E-mail | Agendamento de perguntas e relatórios automáticos |
| Relatório chega vazio | Pergunta salva sem resultados ou erro na query | Execute a pergunta manualmente e revise a consulta | Agendamento de perguntas e relatórios automáticos |
| Falha de autenticação na API | Credenciais incorretas ou endpoint errado | Verifique usuário, senha e URL da API | Agendamento de perguntas e relatórios automáticos |
| Script não executa no horário | Erro na sintaxe do cron ou permissões do script | Teste o script manualmente e revise o cron | Agendamento de perguntas e relatórios automáticos |
| Query não executa no horário agendado | Expressão cron inválida ou worker inativo | Revise a expressão cron e verifique o status do worker | Agendamento de queries e alertas automáticos |
| Alertas por e-mail não são enviados | SMTP não configurado corretamente ou credenciais inválidas | Revise as variáveis SMTP e teste conexão com o servidor | Agendamento de queries e alertas automáticos |
| Recebe múltiplos alertas para o mesmo evento | Condição de alerta mal definida ou query retorna múltiplas linhas | Ajuste a condição do alerta para ser mais restritiva | Agendamento de queries e alertas automáticos |
| Relatórios não são enviados | Worker Celery não está rodando ou mal configurado | Reinicie o worker e verifique as variáveis CELERY_BROKER_URL e CELERY_RESULT_BACKEND | Agendamento de relatórios e alertas por e-mail no Superset |
| E-mails não chegam ao destinatário | Configuração SMTP incorreta ou porta bloqueada | Revise SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASSWORD e teste conexão com o servidor | Agendamento de relatórios e alertas por e-mail no Superset |
| Alertas não disparam mesmo com condição atendida | Regra de alerta mal definida ou consulta SQL errada | Revise a consulta e a condição de disparo; teste manualmente no SQL Lab | Agendamento de relatórios e alertas por e-mail no Superset |
| Tarefas de um time ficam presas em 'queued' | Pool do time sem slots disponíveis ou concorrência global atingida | Aumente slots do pool ou ajuste parallelism/max_active_runs_per_dag | Airflow em larga escala: multi-tenant, isolações e limites |
| Usuários veem DAGs de outros times | RBAC mal configurado ou permissões excessivas | Revise roles e permissões em Security > Roles | Airflow em larga escala: multi-tenant, isolações e limites |
| DAGs de um time sobrecarregam o cluster | Limites de concorrência insuficientes ou pools não aplicados | Reduza parallelism ou crie pools dedicados | Airflow em larga escala: multi-tenant, isolações e limites |
| Tarefas ficam presas em 'queued' | Backend de resultados mal configurado ou indisponível | Revise o parâmetro result_backend e a saúde do Redis ou RabbitMQ | airflow.cfg e variáveis de ambiente: o que importa para prod |
| Erro de 'Fernet key must not be empty' | Chave de criptografia não definida | Defina AIRFLOW__CORE__FERNET_KEY com uma chave válida | airflow.cfg e variáveis de ambiente: o que importa para prod |
| Webserver não inicia após alteração no airflow.cfg | Sintaxe incorreta ou parâmetro inválido | Revise o arquivo, corrija erros e consulte a documentação | airflow.cfg e variáveis de ambiente: o que importa para prod |
| Dashboards demoram a carregar mesmo após ajuste | Número de workers insuficiente ou consultas SQL lentas | Aumente workers ou otimize as queries no banco | Ajustando o Superset e dependências para performance |
| Tarefas agendadas acumulam na fila | Baixa concorrência do Celery ou Redis sobrecarregado | Aumente --concurrency do Celery e confira o uso de memória do Redis | Ajustando o Superset e dependências para performance |
| Redis começa a descartar chaves frequentemente | maxmemory muito baixo | Aumente o maxmemory ou reduza TTL das chaves de cache | Ajustando o Superset e dependências para performance |
| O Metabase fica inacessível após falha do banco primário. | Configuração incorreta de failover ou endereço fixo do banco. | Ajuste o Metabase para usar o VIP ou DNS do cluster e revise o Patroni. | Alta disponibilidade: redundância, failover e balanceamento |
| Balanceador de carga não distribui corretamente. | Configuração errada de backend ou healthcheck. | Revise o arquivo de configuração do HAProxy ou Nginx. | Alta disponibilidade: redundância, failover e balanceamento |
| Alertas de monitoramento não disparam em falhas. | Endpoints de saúde não monitorados ou alertas mal configurados. | Implemente checagens periódicas e ajuste regras de alerta. | Alta disponibilidade: redundância, failover e balanceamento |
| Consultas SQL não retornam dados | Tabela ou campo não existe na versão instalada | Consulte a documentação da sua versão do Metabase para nomes corretos. | Análise de uso: auditoria, rastreamento e relatórios |
| Relatórios internos não aparecem | Permissão insuficiente no Metabase | Acesse com usuário administrador. | Análise de uso: auditoria, rastreamento e relatórios |
| Consultas lentas no Metabase | Banco de dados subdimensionado ou queries mal otimizadas | Revise índices e simplifique perguntas complexas. | Análise de uso: auditoria, rastreamento e relatórios |
| DAG não aparece na interface | Arquivo fora da pasta 'dags' ou erro de sintaxe | Verifique o caminho e rode 'airflow dags list'. | Apache Airflow: o que é, para que serve e onde não usar |
| Tarefas travadas em 'queued' | Worker não está rodando ou executor mal configurado | Confira o serviço do scheduler e do executor. | Apache Airflow: o que é, para que serve e onde não usar |
| Logs não aparecem | Permissões de diretório ou configuração de logging | Revise 'airflow.cfg' e permissões da pasta de logs. | Apache Airflow: o que é, para que serve e onde não usar |
| Logs não aparecem no backend remoto | Configuração de conexão ou permissões incorretas | Verifique o conn_id e as permissões do bucket/S3 | Auditoria e rastreabilidade: SLA, retries e histórico de exe |
| SLA não dispara alerta | Callback não definido ou erro na função | Revise a definição do sla_miss_callback | Auditoria e rastreabilidade: SLA, retries e histórico de exe |
| Histórico de execuções incompleto | Problemas no banco de metadados | Cheque a integridade do banco e reinicie o scheduler | Auditoria e rastreabilidade: SLA, retries e histórico de exe |
| Usuário não consegue logar via LDAP | Configuração de host, porta ou DN base incorreta | Revise as configurações LDAP e teste conexão | Autenticação, autorização e políticas de acesso |
| Permissões não aplicadas corretamente | Usuário pertence a múltiplos grupos com permissões conflitantes | Revise a matriz de permissões e ajuste prioridades | Autenticação, autorização e políticas de acesso |
| Logs de acesso não aparecem | Arquivo de log não está sendo gravado ou variável MB_LOG_FILE não definida | Verifique permissões de escrita e configuração do log | Autenticação, autorização e políticas de acesso |
| Usuário não consegue logar | Parâmetros de conexão (host, bind, client_id) incorretos | Revise superset_config.py e consulte a documentação do provedor | Autenticação: LDAP, OAuth e Single Sign-On no Superset |
| Senha correta, mas acesso negado | Role padrão não permite acesso | Ajuste AUTH_USER_REGISTRATION_ROLE para um perfil com permissões adequadas | Autenticação: LDAP, OAuth e Single Sign-On no Superset |
| Erro 500 ao tentar autenticar | Dependências de Python faltando ou incompatíveis | Reinstale dependências com pip install 'apache-superset[ldap]' ou 'apache-superset[oauth]' | Autenticação: LDAP, OAuth e Single Sign-On no Superset |
| 401 Unauthorized | Token de API inválido ou ausente | Confirme o token, gere um novo se necessário | Automatizando exportação e ingestão de dados via API |
| 404 Not Found no endpoint | Endpoint incorreto ou query_id inexistente | Confira o endpoint e o ID da query | Automatizando exportação e ingestão de dados via API |
| Arquivo exportado vazio | Query sem resultados ou erro de execução | Execute a query manualmente e revise o SQL | Automatizando exportação e ingestão de dados via API |
| 429 Too Many Requests | Limite de requisições excedido | Implemente backoff exponencial nos scripts | Automatizando exportação e ingestão de dados via API |
| Macro {{ ds }} não é substituída no comando | O parâmetro não está marcado como template_field no operador | Confirme que o campo é suportado para templating no operador usado | Automatizando tarefas repetitivas: macros, templates e dynam |
| Tarefas dinâmicas não aparecem na DAG | Loop de criação de tarefas está fora do contexto da DAG ou erro de indentação | Garanta que a criação das tarefas ocorre dentro da definição da DAG | Automatizando tarefas repetitivas: macros, templates e dynam |
| Erro 'dag_run.conf' não encontrado | A DAG não foi disparada com parâmetros via API/UI | Dispare a DAG manualmente informando o JSON de parâmetros | Automatizando tarefas repetitivas: macros, templates e dynam |
| Dashboards não salvam ou desaparecem após logout | Banco de metadados mal configurado ou indisponível | Revise SQLALCHEMY_DATABASE_URI e conectividade com PostgreSQL/MySQL | Backend, frontend e metadados: desvendando a arquitetura do |
| Consultas lentas ou timeouts frequentes | Cache do Redis ausente ou mal configurado | Verifique se o Redis está rodando e revise CACHE_CONFIG | Backend, frontend e metadados: desvendando a arquitetura do |
| Erro 500 ao acessar a interface web | Falha no backend Flask ou dependências quebradas | Cheque logs do Flask e dependências Python (pip freeze) | Backend, frontend e metadados: desvendando a arquitetura do |
| Queries ficam eternamente em 'processing' | Workers não estão conectando ao Redis ou não conseguem acessar o banco de dados de origem. | Verifique logs do worker e conectividade TCP com Redis e PostgreSQL. | Backend, workers e frontend: como o Redash se organiza |
| Frontend carrega mas não mostra dashboards | API backend está fora ou há erro de configuração nas URLs. | Cheque variáveis de ambiente e se a API está escutando na porta correta. | Backend, workers e frontend: como o Redash se organiza |
| Workers caem com erro de autenticação | Usuário ou senha do PostgreSQL incorretos. | Ajuste REDASH_DATABASE_URL e reinicie os workers. | Backend, workers e frontend: como o Redash se organiza |
| Usuário não consegue acessar nenhum dashboard | Permissões de datasource ou schema ausentes. | Revise o role e adicione as permissões necessárias. | BI self-service: capacitando times de negócio sem abrir mão |
| Usuário vê dados de outras áreas | Falta de RLS ou permissões excessivas. | Ajuste as regras de RLS e revise o role. | BI self-service: capacitando times de negócio sem abrir mão |
| Erro ao salvar dashboard | Permissão 'can write on Dashboard' ausente. | Adicione essa permissão ao role do usuário. | BI self-service: capacitando times de negócio sem abrir mão |
| Perguntas não aparecem no dashboard | Permissões insuficientes ou perguntas salvas em coleções privadas | Verifique permissões e mova perguntas para coleções acessíveis | Como o Metabase pensa dados: perguntas, modelos e dashboards |
| Filtros globais não afetam todas as perguntas | Campos não padronizados ou perguntas SQL sem parametrização | Padronize nomes de campos e use parâmetros em SQL | Como o Metabase pensa dados: perguntas, modelos e dashboards |
| Relacionamentos não aparecem | Chaves estrangeiras não configuradas corretamente no banco | Ajuste as constraints no banco e re-sincronize o esquema no Metabase | Como o Metabase pensa dados: perguntas, modelos e dashboards |
| DAGs não aparecem no Webserver. | Scheduler parado ou erro de parsing no DAG. | Verifique logs do Scheduler e corrija erros no código dos DAGs. | Componentes do Airflow: Scheduler, Executor, Webserver e Met |
| Tarefas não executam mesmo após agendamento. | Executor mal configurado ou workers inativos. | Confirme o tipo de Executor e se os workers estão ativos. | Componentes do Airflow: Scheduler, Executor, Webserver e Met |
| Webserver acessível mas sem logs de execução. | Problema de conexão com o Metadata Database. | Cheque a string de conexão e permissões do banco. | Componentes do Airflow: Scheduler, Executor, Webserver e Met |
| Erro de autenticação ao conectar | Senha ou usuário incorretos | Verifique credenciais e existência do usuário no banco | Conectando fontes de dados: PostgreSQL e múltiplos bancos |
| Tabelas não aparecem no Metabase | Usuário sem privilégio SELECT nas tabelas | Conceda SELECT nas tabelas ou esquemas necessários | Conectando fontes de dados: PostgreSQL e múltiplos bancos |
| Timeout ao testar conexão | Firewall bloqueando porta do banco | Libere a porta (5432 para PostgreSQL) no firewall | Conectando fontes de dados: PostgreSQL e múltiplos bancos |
| Connection refused | Firewall bloqueando a porta ou host incorreto | Verifique firewall e endereço do host | Conectando o primeiro banco: PostgreSQL de verdade |
| Authentication failed | Usuário ou senha incorretos | Confirme usuário e senha no PostgreSQL | Conectando o primeiro banco: PostgreSQL de verdade |
| Permission denied for table | Usuário sem permissão de SELECT | Ajuste permissões com GRANT SELECT | Conectando o primeiro banco: PostgreSQL de verdade |
| Timeout ao conectar | Rede lenta ou rota bloqueada | Teste latência e libere rota entre Redash e PostgreSQL | Conectando o primeiro banco: PostgreSQL de verdade |
| Erro 'No module named psycopg2' | Driver Python não instalado | Execute 'pip install psycopg2-binary' no ambiente do Superset | Conectando PostgreSQL, MySQL e outros bancos suportados |
| Erro 'FATAL: password authentication failed' | Usuário ou senha incorretos | Revise as credenciais na string de conexão | Conectando PostgreSQL, MySQL e outros bancos suportados |
| Timeout ao conectar | Firewall bloqueando porta ou host incorreto | Verifique host, porta e regras de firewall | Conectando PostgreSQL, MySQL e outros bancos suportados |
| Erro 'permission denied for table' | Permissões insuficientes no banco | Ajuste permissões do usuário no banco de dados | Conectando PostgreSQL, MySQL e outros bancos suportados |
| E-mails não chegam | SMTP mal configurado ou bloqueado | Revise variáveis SMTP e teste conexão com o servidor (telnet ou openssl s_client) | Configurações essenciais: e-mail, branding e permissões |
| Logo não aparece | URL inválida ou arquivo não acessível publicamente | Corrija a URL e garanta acesso HTTP ao arquivo | Configurações essenciais: e-mail, branding e permissões |
| Permissões não aplicadas a novos usuários | Variável REDASH_DEFAULT_PERMISSION não definida corretamente | Consulte a documentação e ajuste o valor | Configurações essenciais: e-mail, branding e permissões |
| Erro ao reiniciar Redash | Sintaxe incorreta no arquivo .env | Valide o arquivo e remova espaços extras ou aspas desnecessárias | Configurações essenciais: e-mail, branding e permissões |
| E-mails não chegam | SMTP mal configurado ou bloqueio de porta | Revise as credenciais e teste conexão com o servidor SMTP. | Configurações essenciais: idioma, branding e e-mails |
| Interface em inglês | Idioma não salvo ou variável de ambiente não aplicada | Reaplique a configuração e reinicie o serviço. | Configurações essenciais: idioma, branding e e-mails |
| Logotipo não aparece | Formato ou tamanho de arquivo incompatível | Use PNG ou SVG com fundo transparente e tamanho recomendado. | Configurações essenciais: idioma, branding e e-mails |
| Erro: 'SECRET_KEY not set' ao iniciar | Variável SECRET_KEY não definida no ambiente | Defina uma chave forte e reinicie o Superset | Configurando variáveis de ambiente essenciais para produção |
| Superset não conecta ao banco | SQLALCHEMY_DATABASE_URI incorreta ou banco inacessível | Revise usuário, senha, host e permissões | Configurando variáveis de ambiente essenciais para produção |
| Falha ao usar cache ou Celery | REDIS_URL ausente ou Redis não acessível | Confirme URL e se o Redis está rodando | Configurando variáveis de ambiente essenciais para produção |
| Erro 401 Unauthorized | Token ou credenciais inválidas/expiradas | Atualize o token em conn-extra ou revise usuário/senha na conexão | Consumindo APIs REST em pipelines Airflow: hooks, operadores |
| Erro 404 Not Found | Endpoint incorreto ou API mudou | Verifique o endpoint e consulte a documentação da API | Consumindo APIs REST em pipelines Airflow: hooks, operadores |
| Timeout na requisição | API lenta ou indisponível | Ajuste timeout no Operator ou implemente retry | Consumindo APIs REST em pipelines Airflow: hooks, operadores |
| Falha ao parsear JSON | Resposta não está em formato JSON válido | Valide o conteúdo da resposta e trate exceções | Consumindo APIs REST em pipelines Airflow: hooks, operadores |
| Usuário não consegue logar após integração LDAP | Configuração de DN base ou filtro de usuário incorretos | Revise as configurações LDAP no webserver_config.py e teste conexão com ldapsearch | Controle de acesso: RBAC, autenticação e autorização no Airf |
| Permissões não aplicadas corretamente | Usuário associado ao perfil errado ou role sem permissões suficientes | Verifique associação de roles e revise permissões na interface Security | Controle de acesso: RBAC, autenticação e autorização no Airf |
| Logs de auditoria não aparecem | Caminho de logging incorreto ou permissões de escrita insuficientes | Ajuste FAB_LOGGING_LOCATION e permissões do diretório de logs | Controle de acesso: RBAC, autenticação e autorização no Airf |
| Consultas lentas ou travando | Falta de CPU ou memória | Aumente os recursos alocados e revise queries pesadas | CPU, memória e storage: como dimensionar o ambiente |
| Erro de conexão com Redis ou PostgreSQL | Containers sem recursos suficientes ou storage cheio | Aumente limites de recursos e libere espaço em disco | CPU, memória e storage: como dimensionar o ambiente |
| Redash reiniciando sozinho | Falta de memória (OOM) | Aumente a RAM alocada no container | CPU, memória e storage: como dimensionar o ambiente |
| Plugin não aparece na interface | Registro incorreto ou falta de rebuild do frontend/backend | Verifique o registro no arquivo correto e recompile/reinicie os serviços | Customização avançada: plugins, extensões e scripts |
| Erro de importação ao iniciar o Redash | Dependências Python não instaladas ou erro de sintaxe | Revise o código do plugin e instale dependências ausentes | Customização avançada: plugins, extensões e scripts |
| Visualização customizada não renderiza | Erro no componente React ou falta de registro | Cheque o console do navegador e o registro no index.js | Customização avançada: plugins, extensões e scripts |
| Script de automação retorna 401 | API Key inválida ou endpoint incorreto | Confirme a API Key e o endpoint na documentação | Customização avançada: plugins, extensões e scripts |
| DAG não aparece na interface do Airflow | Erro de sintaxe ou problema no deploy do arquivo | Verifique logs do scheduler e valide o código Python | DAGs no mundo real: versionamento, documentação e reuso |
| Variável retorna erro de não encontrada | Variável não cadastrada no ambiente correto | Use 'airflow variables list' para conferir e cadastrar | DAGs no mundo real: versionamento, documentação e reuso |
| Deploy sobrescreve DAGs de outro ambiente | Branches ou pipelines de CI/CD mal configurados | Garanta isolamento de branches e paths de deploy | DAGs no mundo real: versionamento, documentação e reuso |
| Filtros não aparecem no dashboard | Query não está parametrizada corretamente | Revise os parâmetros, use {{parametro}} no SQL | Dashboards colaborativos para equipes multidisciplinares |
| Usuário não consegue acessar dashboard | Permissão de grupo não atribuída | Adicione o usuário ao grupo correto e revise permissões | Dashboards colaborativos para equipes multidisciplinares |
| Dashboard lento ou travando | Queries pesadas ou sem filtros | Adicione parâmetros obrigatórios e otimize as queries | Dashboards colaborativos para equipes multidisciplinares |
| Chart não exibe dados | Dataset configurado com colunas ou métricas inexistentes na tabela | Revise o dataset e ajuste os campos conforme a estrutura real da tabela | Dashboards, datasets e charts: os blocos fundamentais do Sup |
| Erro de conexão ao criar dataset | Fonte de dados mal configurada ou credenciais incorretas | Verifique a string de conexão e permissões do usuário no banco | Dashboards, datasets e charts: os blocos fundamentais do Sup |
| Dashboard lento para carregar | Charts usando queries pesadas ou sem filtros | Otimize as queries dos charts e utilize filtros para reduzir o volume de dados | Dashboards, datasets e charts: os blocos fundamentais do Sup |
| Eventos de lineage não aparecem no backend | Configuração incorreta do provider OpenLineage ou backend inacessível | Revise o bloco [openlineage] no airflow.cfg e teste a conectividade com o backend | DataOps além do Airflow: orchestration as code, data mesh e |
| Ambiente do Airflow apresenta inconsistências após update | Containers antigos não foram removidos corretamente | Sempre execute 'docker-compose down' antes de 'up -d' | DataOps além do Airflow: orchestration as code, data mesh e |
| DAGs diferentes em ambientes de dev e prod | Deploy manual ou falta de versionamento | Automatize deploys e use sempre o mesmo repositório Git | DataOps além do Airflow: orchestration as code, data mesh e |
| Usuário vê todos os dados, ignorando RLS | Regra de RLS não está associada corretamente ao dataset ou ao role | Revise as associações de RLS e roles no menu Security > Row Level Security | Datasets, views e permissões de acesso a dados |
| Dataset não aparece na lista | Permissões de acesso ao banco ou ao dataset ausentes | Verifique permissões do usuário e se o dataset foi publicado corretamente | Datasets, views e permissões de acesso a dados |
| Erro ao criar dataset a partir de view | View não existe ou usuário Superset não tem permissão no banco | Confirme existência da view e permissões no banco de dados | Datasets, views e permissões de acesso a dados |
| Metabase não conecta ao banco | Configuração de host, porta ou credenciais incorretas | Verifique variáveis MB_DB_HOST, MB_DB_PORT, MB_DB_USER e MB_DB_PASS | De planilhas ao BI: por que Metabase muda o jogo |
| Dashboards não atualizam | Problemas de permissão no banco ou cache do Metabase | Revise permissões SQL e limpe cache nas configurações do Metabase | De planilhas ao BI: por que Metabase muda o jogo |
| Erro 500 ao acessar o Metabase | Incompatibilidade de versão entre Metabase e banco de dados | Consulte a documentação para versões suportadas | De planilhas ao BI: por que Metabase muda o jogo |
| Usuário não consegue acessar uma fonte de dados necessária | Time do usuário não está autorizado na fonte de dados | Em Settings > Data Sources, adicione o grupo do usuário à lista de acesso | Definindo políticas de acesso e colaboração |
| Usuário consegue editar queries sem permissão | Usuário está com papel de editor ou admin por engano | Revise o papel do usuário em Settings > Users e ajuste para viewer | Definindo políticas de acesso e colaboração |
| Times não aparecem para seleção em fontes de dados | Grupo não foi criado corretamente ou falta atualização | Crie o grupo em Settings > Groups e recarregue a página | Definindo políticas de acesso e colaboração |
| Superset perde sessões após restart | Superset não está usando Redis para sessões | Configure o backend de cache para Redis | Dependências externas: por que Superset precisa de PostgreSQ |
| Dashboards e usuários somem após reiniciar | Banco de dados não persistente ou usando SQLite | Configure e use PostgreSQL como banco principal | Dependências externas: por que Superset precisa de PostgreSQ |
| Tarefas assíncronas não executam | Celery não está conectado ao Redis | Verifique as variáveis CELERY_BROKER_URL e CELERY_RESULT_BACKEND | Dependências externas: por que Superset precisa de PostgreSQ |
| Erro de conexão ao subir containers | Ordem de inicialização errada ou variáveis de ambiente incorretas | Use depends_on no docker-compose.yml e revise as variáveis | Dependências externas: por que Superset precisa de PostgreSQ |
| DAG não aparece na interface do Airflow | Arquivo não copiado para o diretório correto ou erro de sintaxe | Verifique logs do Airflow e valide o caminho do deploy. | Deploy contínuo de DAGs: integração com Git e pipelines CI/C |
| Erro de permissão ao copiar arquivos | Usuário SSH não tem permissão no diretório de DAGs | Ajuste permissões no servidor Airflow. | Deploy contínuo de DAGs: integração com Git e pipelines CI/C |
| Rollback não funciona | Deploy manual sobrescreveu arquivos ou pipeline não foi reexecutado | Garanta que todo deploy passe pelo pipeline e nunca edite arquivos direto no servidor. | Deploy contínuo de DAGs: integração com Git e pipelines CI/C |
| Dashboards lentos ou travando | Pool de conexões insuficiente ou queries sem índice | Aumente o pool e crie índices nas colunas filtradas | Desafios de escala: múltiplos usuários e grandes volumes de |
| Erros de conexão ao banco | Limite de conexões do PostgreSQL atingido | Ajuste max_connections no PostgreSQL e revise o pool do Metabase | Desafios de escala: múltiplos usuários e grandes volumes de |
| Resultados desatualizados em dashboards | Cache TTL muito alto ou views materializadas não atualizadas | Reduza o TTL ou agende refresh das views | Desafios de escala: múltiplos usuários e grandes volumes de |
| Consumo alto de memória | JVM subdimensionada ou queries muito pesadas | Aumente -Xmx e otimize as queries | Desafios de escala: múltiplos usuários e grandes volumes de |
| Dashboard lento ou travando | Queries pesadas ou falta de índices | Otimizar queries e criar índices no banco | Desafios e soluções: aprendizados de ambientes críticos |
| Usuário acessa dados indevidos | Permissões mal configuradas no banco ou Metabase | Revisar views e permissões de acesso | Desafios e soluções: aprendizados de ambientes críticos |
| Erro de conexão ao subir container | MB_DB_HOST incorreto ou banco inacessível | Usar nome de serviço/IP correto e testar conectividade | Desafios e soluções: aprendizados de ambientes críticos |
| Dashboards quebrados após upgrade | Mudança de campo ou função no Metabase | Ler release notes, ajustar queries e restaurar backup se necessário | Desafios e soluções: aprendizados de ambientes críticos |
| Relacionamentos não aparecem no Metabase | Faltam chaves estrangeiras no banco | Adicione FOREIGN KEYs nas tabelas relacionadas | Design do modelo de dados: tabelas, relacionamentos e nomenc |
| Consultas lentas | Falta de índices em colunas filtradas | Crie índices nas colunas mais usadas em WHERE e JOIN | Design do modelo de dados: tabelas, relacionamentos e nomenc |
| Colunas com nomes confusos no Metabase | Nomenclatura inconsistente ou ausência de comentários | Padronize nomes e adicione comentários SQL | Design do modelo de dados: tabelas, relacionamentos e nomenc |
| Queries nunca terminam | Timeout muito alto ou queries ineficientes | Reduza REDASH_QUERY_RUNNER_MAX_RUNTIME e otimize as queries | Detectando gargalos: queries lentas e workers sobrecarregado |
| Workers travam em 100% de CPU | Queries pesadas demais ou poucos workers | Aumente WORKERS_COUNT e revise as queries | Detectando gargalos: queries lentas e workers sobrecarregado |
| Erros de timeout frequentes | Timeout baixo demais para o volume de dados | Ajuste REDASH_QUERY_RUNNER_MAX_RUNTIME para um valor adequado | Detectando gargalos: queries lentas e workers sobrecarregado |
| Sistema lento mesmo com poucos usuários | Falta de índices nas tabelas consultadas | Adicione índices nas colunas usadas em WHERE/JOIN | Detectando gargalos: queries lentas e workers sobrecarregado |
| Log da tarefa está vazio ou incompleto | Worker falhou ou backend de logs mal configurado | Verifique status do worker e configuração de logging no airflow.cfg | Diagnóstico rápido: logs, estados de tarefa e dependências q |
| Tarefa fica presa em 'queued' | Executor sem recursos ou fila congestionada | Cheque disponibilidade de workers e filas, ajuste paralelismo se necessário | Diagnóstico rápido: logs, estados de tarefa e dependências q |
| Tarefa em 'upstream_failed' sem erro aparente | Dependência anterior falhou ou foi pulada | Analise o estado e log das tarefas upstream | Diagnóstico rápido: logs, estados de tarefa e dependências q |
| Tarefas ficam presas em 'queued' por muito tempo | Paralelismo global ou por DAG insuficiente, ou pool de conexões saturado | Aumente 'parallelism', 'dag_concurrency' ou o pool de conexões | Dimensionando recursos: workers, conexões e banco de metadad |
| Erro 'too many connections' no banco de metadados | Pool de conexões do Airflow ou limite do banco subdimensionado | Ajuste 'sql_alchemy_pool_size' e 'max_connections' no banco | Dimensionando recursos: workers, conexões e banco de metadad |
| Scheduler lento ou travando | Threads insuficientes ou banco de metadados sobrecarregado | Aumente 'max_threads' (se suportado) e otimize o banco | Dimensionando recursos: workers, conexões e banco de metadad |
| Interface web não carrega em http://localhost:5000 | Porta 5000 já está em uso ou container server não iniciou. | Libere a porta ou ajuste o mapeamento no docker-compose.yml. | Dockerizando o Redash: containers, redes e volumes |
| Dados somem após reiniciar containers | Volumes não foram mapeados corretamente. | Verifique se os volumes estão definidos e os diretórios existem no host. | Dockerizando o Redash: containers, redes e volumes |
| Consultas ficam em fila e não processam | Poucos workers ou Redis indisponível. | Aumente o número de workers e verifique se o serviço Redis está rodando. | Dockerizando o Redash: containers, redes e volumes |
| Erro de autenticação no PostgreSQL | Senha do banco diferente da configurada no REDASH_DATABASE_URL. | Sincronize as variáveis de ambiente e reinicie os containers. | Dockerizando o Redash: containers, redes e volumes |
| Dashboard sumiu após importação | Arquivo YAML incompatível ou schema alterado | Consulte a documentação oficial sobre import/export e ajuste o YAML conforme o schema atual | Documentação viva: mantendo datasets, dashboards e permissõe |
| Usuário não consegue acessar dashboard | Permissão ausente ou role incorreta | Revise roles e permissões atribuídas ao usuário na interface de segurança | Documentação viva: mantendo datasets, dashboards e permissõe |
| Backup do banco falha | Permissões insuficientes ou banco inacessível | Verifique usuário, senha e conectividade com o banco PostgreSQL | Documentação viva: mantendo datasets, dashboards e permissõe |
| Query sem descrição aparece confusa para outros usuários | Falta de preenchimento do campo de descrição | Edite a query e adicione uma descrição detalhada | Documentando queries e dashboards: para não virar caos |
| Tags não retornam resultados consistentes | Uso de tags diferentes para o mesmo conceito | Padronize e corrija as tags das queries | Documentando queries e dashboards: para não virar caos |
| Dashboards aparecem em times errados | Associação incorreta ao criar ou mover dashboards | Reatribua o dashboard ao time correto nas configurações | Documentando queries e dashboards: para não virar caos |
| O iframe mostra tela em branco ou erro 403 | Token JWT inválido ou chave secreta incorreta | Verifique se o token foi gerado com a chave correta e não expirou | Embedding: dashboards e perguntas em aplicações externas |
| Dashboard aparece sem filtros aplicados | Payload do token não inclui parâmetros esperados | Inclua os filtros necessários no campo 'params' do JWT | Embedding: dashboards e perguntas em aplicações externas |
| Erro de CORS ou bloqueio de iframe | Política de segurança do navegador ou do servidor | Ajuste cabeçalhos X-Frame-Options e Content-Security-Policy no servidor | Embedding: dashboards e perguntas em aplicações externas |
| Mensagem 'Connection refused' no log | Serviço de destino offline ou firewall bloqueando porta | Verifique se o serviço está rodando e libere a porta no firewall | Erros de conexão e autenticação: diagnóstico rápido |
| Mensagem 'Authentication failed' | Usuário ou senha incorretos | Revise credenciais e teste login direto no serviço | Erros de conexão e autenticação: diagnóstico rápido |
| Mensagem 'permission denied' | Usuário sem permissão de leitura | Ajuste permissões no banco de dados | Erros de conexão e autenticação: diagnóstico rápido |
| Erro 'Connection refused' ao iniciar | Banco de dados ou Redis parado | Inicie o serviço externo e verifique firewall | Erros de conexão, timeouts e falhas de login: onde investiga |
| Timeout ao tentar login | Rede lenta ou serviço sobrecarregado | Cheque uso de CPU/RAM e latência de rede | Erros de conexão, timeouts e falhas de login: onde investiga |
| Login falha mesmo com senha correta | Configuração de autenticação externa errada | Revise superset_config.py e credenciais | Erros de conexão, timeouts e falhas de login: onde investiga |
| Sessão expira rapidamente | Redis fora do ar ou secret key alterada | Garanta Redis ativo e secret key estável | Erros de conexão, timeouts e falhas de login: onde investiga |
| Mensagem 'Couldn't connect to the database' | Credenciais erradas, host/porta incorretos ou banco fora do ar | Verifique usuário, senha, host, porta e status do banco | Erros frequentes: conexões, permissões e queries lentas |
| Erro 'permission denied for relation' | Usuário do banco sem permissão de leitura na tabela | Ajuste as permissões com GRANT SELECT | Erros frequentes: conexões, permissões e queries lentas |
| Dashboard travando ou query lenta | Consulta sem índice ou join pesado | Otimize a query e crie índices | Erros frequentes: conexões, permissões e queries lentas |
| Tasks ficam em estado 'queued' indefinidamente. | Permissões insuficientes ou falta de recursos no cluster. | Revise o ServiceAccount e quotas de recursos no namespace. | Escalando com Kubernetes: Executor, pod templates e auto sca |
| Pods de tasks falham ao iniciar. | Imagem não encontrada ou erro no pod template. | Verifique o campo 'image' e o YAML do template. | Escalando com Kubernetes: Executor, pod templates e auto sca |
| Cluster não escala mesmo com muitos pods pendentes. | Cluster Autoscaler não está configurado corretamente. | Confira logs do autoscaler e limites de nodes no cluster. | Escalando com Kubernetes: Executor, pod templates e auto sca |
| Queries ficam em fila indefinidamente | Poucos workers ou workers travados | Aumente a contagem de workers ou reinicie os containers travados | Escalando workers e conexões de banco |
| Erro de 'too many connections' no banco | Workers abrindo conexões demais | Reduza SQLALCHEMY_POOL_SIZE ou aumente o limite no banco, se possível | Escalando workers e conexões de banco |
| Workers caem ao iniciar | Configuração incorreta de filas ou variáveis de ambiente | Revise o QUEUES e variáveis obrigatórias no docker-compose | Escalando workers e conexões de banco |
| Consultas lentas mesmo com muitos workers | Banco de dados saturado ou queries mal otimizadas | Otimize queries e monitore o uso de CPU/memória do banco | Escalando workers e conexões de banco |
| Superset não inicia em container | Variável SUPERSET_SECRET_KEY ausente ou inválida | Defina uma chave secreta forte via variável de ambiente | Escolhendo a infraestrutura: bare metal, nuvem ou containers |
| Erro de conexão com banco de metadados | Configuração incorreta de host, porta ou credenciais | Revise variáveis de ambiente e conectividade de rede | Escolhendo a infraestrutura: bare metal, nuvem ou containers |
| Porta 8088 inacessível externamente | Firewall bloqueando ou mapeamento de porta ausente | Ajuste regras de firewall e verifique o 'ports' no Docker Compose | Escolhendo a infraestrutura: bare metal, nuvem ou containers |
| Tarefas não rodam em paralelo no LocalExecutor | Banco de metadados incompatível (SQLite) | Migre para PostgreSQL ou MySQL | Escolhendo executores: Sequential, Local, Celery e Kubernete |
| Tarefas ficam presas no estado 'queued' no CeleryExecutor | Workers não estão ativos ou broker indisponível | Verifique status dos workers e do broker | Escolhendo executores: Sequential, Local, Celery e Kubernete |
| Pods não são criados no KubernetesExecutor | Configuração de acesso ao cluster incorreta | Revise kube_config e permissões | Escolhendo executores: Sequential, Local, Celery e Kubernete |
| Dashboards lentos em horários de pico | Consultas simultâneas demais ou dashboards muito grandes | Reduza o número de widgets ou otimize queries | Estimando carga: usuários, consultas e volumetria de dados |
| Erros de conexão ao banco de dados | Limite de conexões simultâneas excedido | Ajuste o pool de conexões do Metabase ou aumente o limite no banco | Estimando carga: usuários, consultas e volumetria de dados |
| Metabase travando sob carga | Recursos de hardware insuficientes ou JVM mal configurada | Aumente memória/CPU ou ajuste parâmetros da JVM | Estimando carga: usuários, consultas e volumetria de dados |
| DAG não aparece no Webserver | Erro de sintaxe ou dependência no código Python | Revise o código da DAG e consulte os logs de parsing | Fluxo de dados e execução de DAGs: do agendamento à monitora |
| Tarefa fica presa em 'queued' | Executor sem recursos ou Workers indisponíveis | Verifique configuração do Executor e disponibilidade dos Workers | Fluxo de dados e execução de DAGs: do agendamento à monitora |
| Logs não são exibidos no Webserver | Permissões de arquivo ou configuração incorreta de logging | Ajuste permissões e revise logging_config_class | Fluxo de dados e execução de DAGs: do agendamento à monitora |
| Tarefa marcada como 'upstream_failed' | Dependência anterior falhou | Investigue e corrija a tarefa anterior antes de reexecutar | Fluxo de dados e execução de DAGs: do agendamento à monitora |
| Airflow não encontra a conexão no Vault | Path ou chave incorreta no Vault | Verifique o path e o nome do segredo no Vault; siga o padrão esperado pelo Airflow. | Gerenciamento de conexões e secrets: integrando com Vault e |
| Erro de autenticação com o Vault | Token inválido ou expirado | Gere um novo token no Vault e atualize o airflow.cfg. | Gerenciamento de conexões e secrets: integrando com Vault e |
| Senha aparece em logs do Airflow | Logs em modo debug ou má configuração de logging | Reduza o nível de log e revise handlers personalizados. | Gerenciamento de conexões e secrets: integrando com Vault e |
| Usuário não consegue acessar nenhum dashboard | Role sem permissões de leitura em dashboards ou datasets. | Atribua permissões 'can read' nos dashboards e datasets desejados para a role do usuário. | Gerenciando usuários e permissões iniciais |
| Usuário consegue editar dashboards que não deveria | Permissão 'can write' concedida indevidamente à role. | Remova permissões de escrita da role e mantenha apenas 'can read'. | Gerenciando usuários e permissões iniciais |
| Novo usuário não aparece na lista | Erro na criação via CLI ou falta de commit no banco de dados. | Refaça o comando de criação e verifique logs do Superset. | Gerenciando usuários e permissões iniciais |
| Usuário não recebe e-mail de convite | SMTP mal configurado ou bloqueio de spam | Verifique SMTP em Settings > General e consulte logs do servidor. | Gerenciando usuários e times: convites e políticas |
| Usuário não aparece em grupo após convite | Grupo não selecionado no momento do convite | Edite o usuário em Settings > Users e adicione ao grupo correto. | Gerenciando usuários e times: convites e políticas |
| Revogação não bloqueia acesso imediatamente | Sessão ativa não expirada | Peça logout forçado ou aguarde expiração da sessão. | Gerenciando usuários e times: convites e políticas |
| Usuário acessa dashboard sem permissão | Permissão concedida ao grupo errado ou coleção com acesso público | Revise permissões em Administração > Permissões e ajuste grupos | Governança de dados: ciclo de vida, acesso e compliance |
| Pergunta arquivada ainda aparece em dashboards | Dashboards usam perguntas arquivadas como fonte de dados | Atualize o dashboard para remover perguntas arquivadas ou reative-as | Governança de dados: ciclo de vida, acesso e compliance |
| Dados sensíveis expostos em dashboards públicos | Falta de classificação de dados sensíveis ou permissões mal configuradas | Classifique dashboards e restrinja acesso imediatamente | Governança de dados: ciclo de vida, acesso e compliance |
| Logs de tasks não aparecem no storage remoto | Configuração incorreta do backend de logs ou credenciais inválidas | Revise o bloco [logging] do airflow.cfg e teste conexão com o storage | Governança de dados: rastreabilidade, compliance e auditoria |
| Usuários não autenticados conseguem acessar a Web UI | Backend de autenticação não está ativo ou mal configurado | Verifique a configuração de auth_backend e reinicie o serviço | Governança de dados: rastreabilidade, compliance e auditoria |
| Dados pessoais aparecem em logs | Tasks não implementam anonimização ou mascaramento | Reescreva tasks para anonimizar ou remover campos sensíveis antes de logar | Governança de dados: rastreabilidade, compliance e auditoria |
| Histórico de versões não aparece para uma query. | Query nunca foi salva mais de uma vez ou problema de permissão. | Salve a query novamente ou verifique permissões do usuário. | Governança de dados: versionamento, revisões e auditoria |
| Consultas de auditoria não retornam resultados. | Tabela de eventos vazia ou retenção de logs insuficiente. | Aumente a retenção de logs e revise políticas de limpeza automática. | Governança de dados: versionamento, revisões e auditoria |
| Alterações em queries não são atribuídas ao usuário correto. | Usuários compartilhando credenciais. | Implemente login individual e proíba compartilhamento de contas. | Governança de dados: versionamento, revisões e auditoria |
| Dashboards lentos ou travando | Falta de memória ou CPU insuficiente | Aumente a RAM ou núcleos do servidor | Infraestrutura: memória, CPU, armazenamento e rede |
| Erros de conexão com banco de dados | Rede lenta ou instável | Verifique latência, throughput e estabilidade da conexão | Infraestrutura: memória, CPU, armazenamento e rede |
| Container do Metabase reiniciando | Limite de memória atingido no Docker | Aumente o limite de memória do container | Infraestrutura: memória, CPU, armazenamento e rede |
| Erro de permissão ao gravar logs | Diretórios locais sem permissão de escrita para o usuário do container | Ajuste as permissões dos diretórios com 'chmod 777 logs dags plugins' (apenas em ambiente de desenvolvimento) | Instalação do Airflow com Docker: do zero ao ambiente funcio |
| Webserver não inicia ou retorna erro 500 | FERNET_KEY ou SECRET_KEY ausentes ou inválidos | Gere novas chaves com openssl e atualize o docker-compose.yaml | Instalação do Airflow com Docker: do zero ao ambiente funcio |
| Banco de dados não persiste após reinicialização | Volume do Postgres não configurado corretamente | Verifique a seção 'volumes' do docker-compose.yaml e o mapeamento para postgres-db-volume | Instalação do Airflow com Docker: do zero ao ambiente funcio |
| Erro 'Database connection refused' | Host, porta ou credenciais incorretas | Revise as variáveis de ambiente e permissões no PostgreSQL | Instalação do Metabase: Docker, JAR e PostgreSQL de aplicaçã |
| Metabase reinicia em loop | Permissões insuficientes no banco ou usuário errado | Garanta que o usuário tem ALL PRIVILEGES no banco | Instalação do Metabase: Docker, JAR e PostgreSQL de aplicaçã |
| Timeout ao conectar ao PostgreSQL | Firewall ou configuração de rede | Libere a porta 5432 e revise o pg_hba.conf | Instalação do Metabase: Docker, JAR e PostgreSQL de aplicaçã |
| Acesso negado ao iniciar via JAR | Java desatualizado | Use Java 11 ou superior | Instalação do Metabase: Docker, JAR e PostgreSQL de aplicaçã |
| Página não carrega na porta 5000 | Porta bloqueada no firewall ou serviço não inicializado | Verifique firewall e se todos os containers estão 'Up' com 'docker-compose ps' | Instalação do Redash com Docker Compose: passo a passo real |
| Erro de conexão com PostgreSQL | Variável REDASH_DATABASE_URL incorreta ou banco não inicializado | Revise a string de conexão e logs do container postgres | Instalação do Redash com Docker Compose: passo a passo real |
| Não consigo criar o admin | Banco já inicializado ou erro de permissão | Recrie os volumes ou consulte a documentação para resetar o usuário | Instalação do Redash com Docker Compose: passo a passo real |
| Erro de conexão com o banco de dados | Variáveis de ambiente POSTGRES_HOST, POSTGRES_USER ou POSTGRES_PASSWORD incorretas. | Verifique o docker-compose.yml e reinicie os containers. | Instalando Apache Superset com Docker Compose: o caminho mai |
| Superset não sobe ou reinicia em loop | Banco de dados ou Redis não inicializados, ou falta de volume persistente. | Cheque logs com docker-compose logs e ajuste volumes e dependências. | Instalando Apache Superset com Docker Compose: o caminho mai |
| Porta 8088 já está em uso | Outro serviço já ocupa a porta. | Pare o serviço conflitante ou altere a porta no docker-compose.yml. | Instalando Apache Superset com Docker Compose: o caminho mai |
| Task falha ao ler arquivo legado | Codificação ou delimitador incorreto | Confirme encoding e delimitador no código Python | Integração com sistemas legados: desafios e soluções com Air |
| Dados duplicados após reprocessamento | Checkpoint não implementado corretamente | Revise lógica de checkpoint e idempotência | Integração com sistemas legados: desafios e soluções com Air |
| Falha de conexão com banco antigo | Driver ou biblioteca incompatível | Teste conexão manualmente e ajuste dependências | Integração com sistemas legados: desafios e soluções com Air |
| Pipeline trava em task de fallback | Branch condicional não cobre todos os casos | Implemente rotas explícitas para todos os cenários | Integração com sistemas legados: desafios e soluções com Air |
| Dados do Redash não atualizam após ETL | Trigger da API não foi executado ou falhou | Revise logs do Airflow, valide endpoint e API Key do Redash | Integração Redash + pipelines ETL open source |
| Query do Redash retorna erro de conexão | Credenciais ou rede do banco de dados incorretas | Teste conexão do Redash ao banco, revise firewall e permissões | Integração Redash + pipelines ETL open source |
| Pipeline ETL executa mas dados não aparecem no dashboard | Query do Redash consulta tabela errada ou dados com delay | Valide SQL da query e timestamps de carga | Integração Redash + pipelines ETL open source |
| 401 Unauthorized | API Key inválida ou ausente | Verifique se a API Key está correta e presente no header Authorization | Integração via REST API do Redash: automação e consumo exter |
| 403 Forbidden | Permissão insuficiente do usuário | Confirme se o usuário tem acesso à query | Integração via REST API do Redash: automação e consumo exter |
| JSON vazio ou incompleto | Query sem resultados recentes ou erro na execução | Execute a query manualmente na interface e verifique se há resultados | Integração via REST API do Redash: automação e consumo exter |
| Erro de conexão | URL incorreta ou Redash offline | Confirme o endereço e se o Redash está acessível | Integração via REST API do Redash: automação e consumo exter |
| O Prometheus não coleta dados do Superset | Endpoint /health inacessível ou bloqueado por firewall | Verifique conectividade de rede e permissões de acesso. | Integrando Superset com Prometheus e Grafana para monitorame |
| Dashboards do Grafana não exibem dados | Fonte de dados Prometheus não configurada corretamente | Revise a configuração da data source no Grafana. | Integrando Superset com Prometheus e Grafana para monitorame |
| Alertas não disparam mesmo com falha | Erro na expressão de alerta ou falta de reload nas regras | Corrija a regra e recarregue as configurações do Prometheus. | Integrando Superset com Prometheus e Grafana para monitorame |
| Query aparece em todos os ambientes | Volumes de dados compartilhados entre ambientes. | Separe volumes e bancos em cada docker-compose.yml. | Isolando ambientes: desenvolvimento, teste e produção |
| Erro de conexão ao subir ambiente | Variáveis de ambiente incorretas ou faltando. | Revise arquivos .env e nomes de containers. | Isolando ambientes: desenvolvimento, teste e produção |
| Dados de produção visíveis no desenvolvimento | Banco de dados compartilhado por engano. | Ajuste REDASH_DATABASE_URL para bancos distintos. | Isolando ambientes: desenvolvimento, teste e produção |
| Logs não aparecem no arquivo | Variável MB_LOG_FILE não definida corretamente ou permissões de escrita insuficientes | Verifique o valor da variável e as permissões do diretório de logs | Logs, métricas e alertas: monitorando o Metabase |
| Arquivo de log cresce sem parar | Logrotate não configurado ou falhando | Revise a configuração do logrotate e execute manualmente para testar | Logs, métricas e alertas: monitorando o Metabase |
| Healthcheck do Docker marca o serviço como unhealthy | Metabase não está respondendo na porta 3000 ou endpoint de health está inacessível | Verifique se o Metabase está rodando e se há bloqueios de firewall | Logs, métricas e alertas: monitorando o Metabase |
| Não há logs de queries no PostgreSQL | Parâmetro log_statement não ativado corretamente | Revise o postgresql.conf e reinicie o serviço após alteração | Logs, métricas e alertas: monitorando o Metabase |
| Não aparecem logs do Redash no stdout | Containers podem estar parados ou logs redirecionados para arquivo. | Verifique se os containers estão rodando com docker ps e revise a configuração de logging do docker-compose. | Logs, métricas e alertas: o que monitorar de verdade |
| Métricas de containers não aparecem no cAdvisor | Volumes não montados corretamente ou cAdvisor não tem permissão. | Revise os volumes e permissões do comando de execução do cAdvisor. | Logs, métricas e alertas: o que monitorar de verdade |
| Alertas não disparam mesmo com erro no Redash | Regras de alerta mal configuradas ou Prometheus não está coletando métricas corretamente. | Revise as regras de alerta e o scrape_configs do Prometheus. | Logs, métricas e alertas: o que monitorar de verdade |
| Logs não aparecem no arquivo | Permissões incorretas no diretório ou erro de configuração do handler | Ajuste permissões e revise o superset_config.py | Logs, métricas e health checks: monitorando o Superset |
| Health check do banco falha | Banco de dados fora do ar ou credenciais incorretas | Verifique o serviço do banco e as credenciais usadas | Logs, métricas e health checks: monitorando o Superset |
| Uso de CPU/memória muito alto | Consultas SQL pesadas ou vazamento de memória | Analise queries recentes e reinicie o serviço se necessário | Logs, métricas e health checks: monitorando o Superset |
| Erro de conexão ao adicionar a fonte | Firewall bloqueando porta ou IP incorreto | Revise regras de rede e IP/porta do banco | Mapeando fontes de dados: PostgreSQL, MySQL e além |
| Query trava e nunca retorna | Query sem LIMIT ou banco sem timeout configurado | Adicione LIMIT e configure statement_timeout | Mapeando fontes de dados: PostgreSQL, MySQL e além |
| Permissão negada ao executar query | Usuário do Redash sem GRANT adequado | Reveja permissões do usuário no banco | Mapeando fontes de dados: PostgreSQL, MySQL e além |
| Dashboard demora para carregar | Consultas SQL mal otimizadas ou falta de índices no banco | Revise as queries e otimize os índices das tabelas mais acessadas | Metabase em operação: exemplos de dashboards e fluxos de BI |
| Dados desatualizados nos dashboards | Agendamento de atualização mal configurado | Ajuste o cronograma de atualização em Administração > Agendamento | Metabase em operação: exemplos de dashboards e fluxos de BI |
| Usuário não visualiza determinado dashboard | Permissões insuficientes no grupo de acesso | Revise as permissões em Administração > Grupos | Metabase em operação: exemplos de dashboards e fluxos de BI |
| Atualização quebrou integrações | Breaking change não identificada no changelog | Sempre leia o changelog oficial antes de atualizar | Metabase no futuro: tendências, comunidade e roadmap |
| Feature prometida não aparece na nova versão | Feature ainda em desenvolvimento ou não incluída na release | Verifique o roadmap e milestone no GitHub | Metabase no futuro: tendências, comunidade e roadmap |
| Pull request rejeitado sem explicação clara | Padrões de contribuição não seguidos | Leia e siga o CONTRIBUTING.md no repositório | Metabase no futuro: tendências, comunidade e roadmap |
| Tarefa executa parcialmente e falha | Falta de atomicidade na implementação | Implemente rollback ou transações completas | Modelagem de pipelines: dependências, modularidade e atomici |
| Dados duplicados após reexecução | Tarefa não idempotente | Inclua checagens de execução prévia | Modelagem de pipelines: dependências, modularidade e atomici |
| Pipeline trava em dependências circulares | Dependências mal definidas no DAG | Revise o fluxo de dependências e elimine ciclos | Modelagem de pipelines: dependências, modularidade e atomici |
| Logs não aparecem na interface web | Permissões incorretas no diretório de logs ou configuração errada do base_log_folder. | Ajuste permissões e revise o caminho em airflow.cfg. | Monitorando DAGs e tarefas: logs, métricas e notificações |
| Não recebe e-mails de alerta | Configuração SMTP incorreta ou bloqueio de firewall. | Teste SMTP manualmente e ajuste configurações. | Monitorando DAGs e tarefas: logs, métricas e notificações |
| Métricas não aparecem no Prometheus | statsd-exporter não está rodando ou configuração errada de host/porta. | Verifique containers, portas e targets no Prometheus. | Monitorando DAGs e tarefas: logs, métricas e notificações |
| Tarefa falha com erro de conexão | Credenciais ou host incorretos na conexão do Airflow. | Revise as configurações da conexão e teste acesso manual ao banco. | Movendo dados entre PostgreSQL e outras fontes: transfer ope |
| XCom não retorna valor | do_xcom_push não habilitado ou query não retorna resultado. | Garanta que do_xcom_push=True e a query retorna dados. | Movendo dados entre PostgreSQL e outras fontes: transfer ope |
| Arquivo CSV não gerado | Permissão de escrita no diretório ou erro no script. | Verifique permissões e revise o script Python. | Movendo dados entre PostgreSQL e outras fontes: transfer ope |
| Consultas ficam presas ou demoram muito para rodar | Poucos workers ou fila Redis acumulada | Aumente o número de workers e monitore a fila | Multiplicando workers e otimizando uso de recursos |
| Banco de dados do Redash fica lento ou trava | Excesso de conexões abertas pelos workers | Reduza o número de workers ou aumente max_connections no banco | Multiplicando workers e otimizando uso de recursos |
| Workers caem ou não sobem | Falta de recursos (CPU/memória) no host | Ajuste recursos do host ou reduza o número de containers | Multiplicando workers e otimizando uso de recursos |
| Fila Celery não existe ou nome diferente | QUEUES customizada na configuração | Verifique o valor da variável QUEUES e ajuste o comando de monitoramento | Multiplicando workers e otimizando uso de recursos |
| Erro 'Access denied' ao conectar MySQL | Usuário/senha incorretos ou falta de permissão | Verifique credenciais e privilégios do usuário no MySQL | MySQL, APIs REST e outros: ampliando horizontes de dados |
| Erro 401 ao consultar API | Token inválido ou header ausente | Revise o header de autenticação e obtenha novo token se necessário | MySQL, APIs REST e outros: ampliando horizontes de dados |
| API retorna 'Invalid JSON' | Resposta não é um array de objetos JSON | Ajuste endpoint ou use 'root_key_path' para apontar para o array correto | MySQL, APIs REST e outros: ampliando horizontes de dados |
| Timeout ao conectar MySQL | Firewall bloqueando ou host/porta errados | Confirme IP, porta e regras de firewall | MySQL, APIs REST e outros: ampliando horizontes de dados |
| Erro: 'TypeError: __init__() got an unexpected keyword argument 'schedule_interval'' | Uso de parâmetro depreciado no decorator @dag. | Troque 'schedule_interval' por 'schedule' conforme documentação. | Novidades do Airflow: recursos recentes e roadmap oficial |
| Sensor consome slot mesmo após troca para deferrable | Uso do operador tradicional ou import incorreto. | Garanta que está usando 'DeferrableHttpSensor' e não 'HttpSensor'. | Novidades do Airflow: recursos recentes e roadmap oficial |
| DAG não aparece na interface após atualização | Erro de sintaxe ou importação no arquivo DAG. | Cheque logs do scheduler e valide o código Python. | Novidades do Airflow: recursos recentes e roadmap oficial |
| Novos recursos não aparecem após atualização | Cache do navegador ou do backend | Limpe o cache e reinicie os serviços | Novidades do Superset: recursos recentes e roadmap oficial |
| Erros ao rodar testes automatizados | Dependências desatualizadas | Atualize os pacotes conforme requirements.txt | Novidades do Superset: recursos recentes e roadmap oficial |
| Permissões não aplicam corretamente | Migração incompleta do banco de dados | Rode o comando de migração: superset db upgrade | Novidades do Superset: recursos recentes e roadmap oficial |
| Dashboard criado via API não aparece na interface | Possível cache ou erro de permissão | Recarregue a página e revise permissões do usuário | Novidades e recursos avançados: customização, plugins e API |
| Plugin de driver não é reconhecido após reiniciar | Arquivo JAR incompatível ou na pasta errada | Baixe o driver correto e coloque em /plugins, depois reinicie | Novidades e recursos avançados: customização, plugins e API |
| Erro 401 ao usar API | Token de sessão inválido ou expirado | Obtenha novo token e repita a requisição | Novidades e recursos avançados: customização, plugins e API |
| Não entendi a diferença entre Superset e Tableau | Falta de clareza sobre licenciamento e arquitetura | Releia a seção de comparação e consulte a documentação oficial | O que é BI e por que Superset? Entendendo o propósito da fer |
| Não sei se posso usar Superset comercialmente | Dúvida sobre licença Apache 2.0 | Leia o texto da licença em https://www.apache.org/licenses/LICENSE-2.0 | O que é BI e por que Superset? Entendendo o propósito da fer |
| Não sei se Superset conecta ao meu banco de dados | Dúvida sobre integrações suportadas | Consulte a lista de bancos suportados em https://superset.apache.org/docs/databases/ | O que é BI e por que Superset? Entendendo o propósito da fer |
| Tenho receio de falta de suporte | Preocupação comum com open source | Avalie a comunidade e considere suporte interno ou de terceiros | O que é BI e por que Superset? Entendendo o propósito da fer |
| Usuário não consegue salvar perguntas em uma coleção | Permissão de Adicionar não concedida na coleção | Revise as permissões do grupo na coleção em Administração > Permissões | Organização de espaços: coleções, permissões e governança |
| Usuário vê dados de uma fonte que não deveria | Permissão de acesso à fonte de dados concedida por engano | Retire a permissão do grupo na fonte de dados | Organização de espaços: coleções, permissões e governança |
| Usuário consegue excluir perguntas importantes | Permissão de Excluir concedida em excesso | Restrinja a permissão de Excluir apenas a grupos responsáveis | Organização de espaços: coleções, permissões e governança |
| DAG não aparece na interface web | Nome do arquivo ou da DAG fora do padrão ou erro de sintaxe | Renomeie o arquivo e corrija o código conforme o padrão | Padronização de DAGs: nomenclatura, modularização e testes |
| Testes unitários falham | Dependências não importadas corretamente ou tasks mal definidas | Verifique imports e defina tasks conforme o padrão | Padronização de DAGs: nomenclatura, modularização e testes |
| Código duplicado em múltiplas DAGs | Falta de modularização | Extraia funções comuns para módulos reutilizáveis | Padronização de DAGs: nomenclatura, modularização e testes |
| Dashboard sem descrição | Falta de padronização ou esquecimento | Exija revisão antes de publicar e revise periodicamente. | Padronização e documentação: nomeação, descrições e versiona |
| Assets sobrescritos sem histórico | Não exportou e versionou manualmente | Implemente rotina semanal de exportação e commit. | Padronização e documentação: nomeação, descrições e versiona |
| Nomes de perguntas confusos ou duplicados | Padrão de nomeação inexistente | Crie e divulgue guia de nomenclatura. | Padronização e documentação: nomeação, descrições e versiona |
| Dashboards lentos mesmo com pouco dado | Query sem índice ou SELECT * | Crie índices e especifique colunas na consulta | Performance sustentável: estratégias para evitar gargalos fu |
| Erro de timeout em consultas | Limite de tempo baixo ou query pesada | Ajuste SQLLAB_TIMEOUT ou otimize a query | Performance sustentável: estratégias para evitar gargalos fu |
| Dados desatualizados em dashboards | Cache com timeout alto demais | Reduza CACHE_DEFAULT_TIMEOUT ou limpe o cache | Performance sustentável: estratégias para evitar gargalos fu |
| Banco sobrecarregado | Consultas sem paginação ou limites | Implemente ROW_LIMIT e paginação | Performance sustentável: estratégias para evitar gargalos fu |
| Usuário visualiza queries privadas de outro time | Permissões do time configuradas incorretamente | Revise as permissões do time no menu Groups | Permissões avançadas: times, queries privadas e auditoria |
| Logs de auditoria não aparecem na tabela 'events' | Banco de dados do Redash não está registrando eventos | Verifique a integridade e permissões do banco | Permissões avançadas: times, queries privadas e auditoria |
| Query privada aparece como pública | Configuração de privacidade da query foi alterada | Edite a query e ajuste a privacidade | Permissões avançadas: times, queries privadas e auditoria |
| Metabase perde configurações após reiniciar | Uso do banco H2 em arquivo temporário ou não persistente | Configure um banco PostgreSQL ou MySQL e aponte corretamente nas variáveis de ambiente | Persistência e armazenamento: onde ficam dados, logs e arqui |
| Logs não aparecem em arquivo | logback.xml não configurado para saída em arquivo | Ajuste o appender para FILE e defina o caminho correto | Persistência e armazenamento: onde ficam dados, logs e arqui |
| Backup do banco falha | Permissões insuficientes ou conexão incorreta com o SGBD | Verifique usuário, senha e privilégios no banco | Persistência e armazenamento: onde ficam dados, logs e arqui |
| Logo não aparece ou está distorcido | Caminho incorreto ou tamanho inadequado do arquivo | Verifique o caminho em APP_ICON e ajuste as dimensões da imagem. | Personalizando o Superset: temas, branding e idioma |
| Cores não mudam após ajuste | Cache do navegador ou erro de sintaxe em THEME_OVERRIDES | Limpe o cache e revise o dicionário de cores. | Personalizando o Superset: temas, branding e idioma |
| Idioma permanece em inglês | Faltam arquivos de tradução ou configuração incorreta | Confirme BABEL_DEFAULT_LOCALE e a presença do pt_BR em translations. | Personalizando o Superset: temas, branding e idioma |
| Menus não mudam | Erro em MENU_ROUTES ou permissões conflitantes | Revise o formato do array e as permissões do usuário. | Personalizando o Superset: temas, branding e idioma |
| Tarefa de ingestão falha com timeout | Fonte de dados instável ou parâmetros de timeout baixos | Ajuste o parâmetro de timeout no operador e verifique a saúde da fonte | Pipeline BI em rede de fibra dedicada: ingestão, transformaç |
| Erro de permissão ao carregar no PostgreSQL | Usuário do banco sem permissão de escrita | Ajuste as permissões do usuário no PostgreSQL | Pipeline BI em rede de fibra dedicada: ingestão, transformaç |
| Transformação em Python falha por falta de memória | Volume de dados excede capacidade do worker | Otimize o script para processar em lotes ou aumente recursos do worker | Pipeline BI em rede de fibra dedicada: ingestão, transformaç |
| Requisito de BI não pode ser atendido | Fonte de dados inexistente ou incompleta | Reveja o levantamento e busque fontes alternativas ou ajuste o requisito | Planejamento do BI: requisitos, fontes de dados e stakeholde |
| Dados inconsistentes nos relatórios | Fonte de dados desatualizada ou sem governança | Implemente processos de atualização e validação de dados | Planejamento do BI: requisitos, fontes de dados e stakeholde |
| Acesso indevido a dados sensíveis | Perfis de acesso mal configurados | Revise a matriz de stakeholders e ajuste permissões no Metabase | Planejamento do BI: requisitos, fontes de dados e stakeholde |
| Erro de conexão ao banco de aplicação | Credenciais ou host incorretos | Revise variáveis MB_DB_* e permissões do usuário no PostgreSQL | Por dentro do Metabase: componentes, fluxo de dados e depend |
| Dashboards não carregam dados | Firewall ou porta bloqueada entre Metabase e fonte | Libere a porta 5432 no servidor de banco | Por dentro do Metabase: componentes, fluxo de dados e depend |
| Agendamento de email falha | SMTP não configurado | Configure SMTP nas variáveis de ambiente ou interface | Por dentro do Metabase: componentes, fluxo de dados e depend |
| Pipeline de dados falha sem aviso | Falta de monitoramento automatizado | Implemente alertas e logging centralizado no orquestrador | Por que DataOps muda o jogo do BI: limites do ETL tradiciona |
| Dados inconsistentes em relatórios | Ausência de validação automatizada | Inclua testes de qualidade em cada etapa do pipeline | Por que DataOps muda o jogo do BI: limites do ETL tradiciona |
| Dificuldade em rastrear falhas | Execução manual e ausência de logs | Automatize execuções e centralize logs | Por que DataOps muda o jogo do BI: limites do ETL tradiciona |
| Interface web do Redash não carrega após deploy Docker | Porta 5000 já em uso ou container não inicializou | Verifique containers ativos com 'docker ps' e ajuste a porta se necessário. | Por que Redash? O papel do open source no BI moderno |
| Permissões de queries não funcionam como esperado | Configuração de grupos ou permissões incompleta | Revise as permissões em Settings > Groups. | Por que Redash? O papel do open source no BI moderno |
| Erro ao conectar a fonte de dados | Credenciais incorretas ou firewall bloqueando acesso | Confirme usuário, senha e liberação de IP no banco de dados. | Por que Redash? O papel do open source no BI moderno |
| Navegador exibe aviso de certificado inválido | Certificado SSL expirado ou autoassinado | Renove o certificado com Let's Encrypt e reinicie o Nginx | Práticas essenciais: HTTPS, variáveis e segredos |
| Redash não sobe após alteração de variáveis | Permissões incorretas ou sintaxe inválida no .env | Corrija permissões e revise o conteúdo do .env | Práticas essenciais: HTTPS, variáveis e segredos |
| Senha de banco exposta em logs | Variável de ambiente mal configurada ou log em modo debug | Ajuste variáveis e desative logs verbosos em produção | Práticas essenciais: HTTPS, variáveis e segredos |
| Superset não conecta ao banco de metadados | String de conexão errada ou usuário sem permissão | Revise a string e permissões do usuário no banco | Preparando o banco de metadados e o Redis para produção |
| Dashboards demoram a carregar ou perdem cache | Redis sem memória ou política de descarte inadequada | Ajuste maxmemory e maxmemory-policy no Redis | Preparando o banco de metadados e o Redis para produção |
| Erro de autenticação no Redis | Senha incorreta ou variável de ambiente mal configurada | Revisar senha no redis.conf e nas variáveis do Superset | Preparando o banco de metadados e o Redis para produção |
| Tarefa 'carrega' falha com erro de conexão | Conexão PostgreSQL não cadastrada ou parâmetros errados | Revise o cadastro da conexão no Airflow UI e teste acesso ao banco | Primeira DAG: extraindo e carregando dados no PostgreSQL |
| Tarefa 'verifica' retorna 0 linhas | Insert não executou ou tabela vazia | Cheque o SQL do operador e o log do 'carrega' | Primeira DAG: extraindo e carregando dados no PostgreSQL |
| DAG não aparece no Airflow UI | Arquivo da DAG não está no diretório correto ou erro de sintaxe | Confirme o caminho e rode 'airflow dags list' para ver se carrega | Primeira DAG: extraindo e carregando dados no PostgreSQL |
| Erro de conexão HTTPS | Certificado TLS inválido ou mal configurado | Revise caminhos dos certificados e permissões no NGINX | Protegendo dados sensíveis: criptografia e backups |
| Backup não restaura corretamente | Backup corrompido ou incompleto | Teste restauração regularmente e monitore logs do pg_dump | Protegendo dados sensíveis: criptografia e backups |
| Variáveis sensíveis expostas em logs | Configuração de log excessivamente detalhada ou erro de script | Reduza verbosidade dos logs e revise scripts de inicialização | Protegendo dados sensíveis: criptografia e backups |
| A interface web não abre em HTTPS | Certificado SSL inválido ou caminho incorreto no airflow.cfg | Verifique o certificado e os caminhos configurados | Protegendo pipelines: criptografia, logs e isolamento de exe |
| Valores sensíveis aparecem em texto claro no banco | Fernet Key ausente ou incorreta | Gere e configure uma Fernet Key válida | Protegendo pipelines: criptografia, logs e isolamento de exe |
| Tarefas continuam rodando no host, não em containers | Executor não configurado corretamente | Revise o parâmetro executor no airflow.cfg e reinicie os serviços | Protegendo pipelines: criptografia, logs e isolamento de exe |
| Metabase não inicia | Banco de dados não disponível ou variável de ambiente incorreta | Verifique logs com 'docker-compose logs' e revise MB_DB_HOST e MB_DB_PASS | Provisionamento automatizado: Docker Compose e infraestrutur |
| Erro de permissão em volumes | Permissões de pasta local incompatíveis | Ajuste permissões com 'chown -R 1000:1000 ./metabase-data ./pgdata' | Provisionamento automatizado: Docker Compose e infraestrutur |
| Atualização não aplica nova versão | Imagem antiga em cache | Rode 'docker-compose pull' antes do 'up -d' | Provisionamento automatizado: Docker Compose e infraestrutur |
| Senhas expostas no Git | Arquivo .env versionado por engano | Adicione .env ao .gitignore imediatamente | Provisionamento automatizado: Docker Compose e infraestrutur |
| Dashboard carrega, mas charts ficam em loading infinito | Query SQL muito pesada ou sem índice adequado | Otimizar a query e criar índices nas colunas filtradas | Quando o dashboard não carrega: debug de queries e performan |
| Erro de timeout ao abrir dashboard | Limite de tempo excedido devido a queries lentas ou banco sobrecarregado | Ajustar queries e aumentar timeout apenas se necessário | Quando o dashboard não carrega: debug de queries e performan |
| Dados desatualizados após atualização no banco | Cache do Superset com timeout muito alto | Reduzir CACHE_DEFAULT_TIMEOUT ou limpar cache manualmente | Quando o dashboard não carrega: debug de queries e performan |
| Dashboards lentos mesmo com poucos usuários | Queries pesadas ou falta de índices no banco de origem | Otimizar queries e criar índices adequados | Quantos usuários e dashboards? Dimensionando Superset para s |
| Erros de conexão ao Redis | Redis sem RAM suficiente ou mal configurado | Aumentar memória ou revisar configuração do Redis | Quantos usuários e dashboards? Dimensionando Superset para s |
| Usuários reclamam de quedas durante picos | Workers insuficientes ou falta de recursos na VM | Aumentar número de workers e recursos de CPU/RAM | Quantos usuários e dashboards? Dimensionando Superset para s |
| Dashboard mostra erro de parâmetro | Query parametrizada sem valor padrão ou filtro global não configurado | Defina valores padrão ou configure filtros globais corretamente | Queries, dashboards e usuários: a tríade do Redash |
| Usuário não vê o dashboard | Permissão de acesso não atribuída ao grupo do usuário | Adicione o usuário ao grupo com permissão de visualização | Queries, dashboards e usuários: a tríade do Redash |
| Alteração em query não aparece no dashboard | Dashboard usa cache antigo | Recarregue ou force atualização do dashboard | Queries, dashboards e usuários: a tríade do Redash |
| Metabase não inicia após restauração | Backup corrompido ou incompatível | Teste o backup em ambiente isolado e use outro ponto de restauração | Recuperação rápida: travamentos, restauração e rollback |
| Dashboards sumiram após rollback | Rollback de configuração sem restaurar banco de aplicação | Restaure também o banco de aplicação do mesmo ponto | Recuperação rápida: travamentos, restauração e rollback |
| Erro de conexão com banco após restart | Configuração de banco alterada ou credenciais inválidas | Reverta configuração e valide credenciais | Recuperação rápida: travamentos, restauração e rollback |
| Erro 'database already exists' na restauração | Banco não foi removido antes da restauração | Use DROP DATABASE antes de restaurar | Recuperando queries e dashboards corrompidos |
| Dashboards restaurados não aparecem | Cache do navegador ou do Redash | Limpe o cache e reinicie os serviços | Recuperando queries e dashboards corrompidos |
| Erro 500 ao acessar query restaurada | Dados corrompidos persistem | Verifique integridade dos dados e considere restaurar backup mais antigo | Recuperando queries e dashboards corrompidos |
| Slug em conflito após importação via API | Slug já existe no banco | Edite o slug antes de importar ou remova o objeto conflitante | Recuperando queries e dashboards corrompidos |
| Tarefas presas em 'queued' por horas | parallelism ou concurrency muito baixos | Aumente os valores em airflow.cfg e reinicie scheduler/workers | Resolvendo problemas de performance: deadlocks, filas e garg |
| DAG nunca sai do estado 'scheduled' | Deadlock por dependência circular ou max_active_runs_per_dag baixo | Reveja dependências e aumente max_active_runs_per_dag | Resolvendo problemas de performance: deadlocks, filas e garg |
| Fila Celery cresce sem parar | Poucos workers ou tarefas lentas | Aumente workers ou otimize tarefas | Resolvendo problemas de performance: deadlocks, filas e garg |
| Pull request ignorado | Descrição insuficiente ou fora do escopo do roadmap | Revise a descrição e alinhe com issues abertas | Roadmap, comunidade e para onde o Redash está indo |
| Feature não aceita | Desalinhamento com prioridades do projeto | Participe das discussões para entender o contexto | Roadmap, comunidade e para onde o Redash está indo |
| Dificuldade em rodar testes | Ambiente local desatualizado | Atualize dependências conforme README oficial | Roadmap, comunidade e para onde o Redash está indo |
| Usuário vê todos os dados, ignorando o filtro | Filtro não está associado ao papel correto ou expressão SQL malformada | Revise a associação de papéis e a sintaxe do filtro | Segurança por linha: row-level security na prática |
| Erro de variável não encontrada | Campo do usuário não existe ou não foi populado no contexto | Verifique se o atributo está presente no modelo de usuário | Segurança por linha: row-level security na prática |
| Dashboard não carrega dados | Filtro RLS bloqueou todas as linhas por erro de lógica | Teste a cláusula SQL diretamente no SQL Lab com valores reais | Segurança por linha: row-level security na prática |
| Dashboards importados não aparecem | IDs exportados não correspondem a objetos existentes ou erro no caminho do arquivo | Confirme os IDs e o caminho do arquivo ZIP exportado | Separando ambientes: desenvolvimento, homologação e produção |
| Conexões de banco não funcionam após migração | Variáveis de ambiente ou credenciais incorretas | Revise as configurações de conexão e variáveis de ambiente | Separando ambientes: desenvolvimento, homologação e produção |
| Deploy com imagem Docker falha | Uso de tag 'latest' ou incompatibilidade de versão | Ajuste para uma tag de versão específica e compatível | Separando ambientes: desenvolvimento, homologação e produção |
| Plugin não aparece na lista de visualizações | Registro incorreto no superset_config.py ou erro de build | Recompile o plugin, revise importações e reinicie o Superset | Superset além do básico: plugins, extensões e customizações |
| Erro de autenticação ao tentar login corporativo | Configuração incorreta de LDAP/OAuth | Revise parâmetros de conexão e consulte logs detalhados | Superset além do básico: plugins, extensões e customizações |
| Cache Redis não é utilizado | CACHE_CONFIG mal configurado ou Redis offline | Verifique URL do Redis e status do serviço | Superset além do básico: plugins, extensões e customizações |
| 401 Unauthorized ao chamar endpoint | Token expirado ou inválido | Obtenha novo access_token e tente novamente | Superset API: integração programática para automação |
| 403 Forbidden ao criar recurso | Permissão insuficiente do usuário | Ajuste as permissões do usuário de automação | Superset API: integração programática para automação |
| 422 Unprocessable Entity ao criar dashboard | Campo obrigatório ausente ou nome de campo incorreto | Verifique o payload e os nomes dos campos na documentação oficial | Superset API: integração programática para automação |
| Falha ao conectar via HTTPS | Certificado SSL inválido ou ausente | Configure corretamente o HTTPS no Superset | Superset API: integração programática para automação |
| Usuário é desconectado ao navegar | Sessão não está persistida no Redis | Revise o superset_config.py e a conexão com Redis | Superset em cluster: múltiplos workers e balanceamento de ca |
| Uma instância Superset não recebe tráfego | Proxy reverso mal configurado | Verifique upstream e health checks do Nginx | Superset em cluster: múltiplos workers e balanceamento de ca |
| Superset lento ou travando | Poucos workers ou falta de recursos | Aumente o número de workers e monitore uso de CPU/memória | Superset em cluster: múltiplos workers e balanceamento de ca |
| Fonte de dados não aparece ou falha ao conectar | Driver ausente ou string de conexão incorreta | Reinstale o driver e revise a string de conexão | Superset em uma rede de fibra dedicada: desafios e soluções |
| Usuários não conseguem autenticar | Configuração LDAP errada ou usuário fora do escopo de busca | Revise <code>AUTH_LDAP_SEARCH</code> e credenciais | Superset em uma rede de fibra dedicada: desafios e soluções |
| Dashboards lentos mesmo com rede rápida | Consultas pesadas ou banco de dados subdimensionado | Otimize queries e revise recursos do banco | Superset em uma rede de fibra dedicada: desafios e soluções |
| Métricas de monitoramento não aparecem | Gunicorn não configurado para expor métricas | Adicione flag <code>--statsd-host</code> e reinicie | Superset em uma rede de fibra dedicada: desafios e soluções |
| Webhook não dispara | Condição de alerta não foi atingida ou URL inválida | Revise a condição e teste a URL manualmente | Webhooks, integrações e API REST do Metabase |
| API retorna 401 Unauthorized | Token de sessão inválido ou expirado | Reautentique e obtenha novo token | Webhooks, integrações e API REST do Metabase |
| Payload não chega ao endpoint receptor | Firewall ou bloqueio de rede | Libere portas e revise regras de firewall | Webhooks, integrações e API REST do Metabase |
