373 sintomas catalogados
Cada sintoma com causa provável e correção, ligado à lição da trilha Dados que explica o porquê. Descreva o sintoma para filtrar.
| Sintoma | Causa provável | Correção | Lição |
|---|---|---|---|
| Task falha ao acessar HDFS | Conexão HDFS mal configurada ou permissão insuficiente | Revise a configuração da conexão e as permissões do usuário no HDFS | Airflow orquestrando pipelines: do ETL ao machine learning |
| HiveOperator retorna erro de autenticação | Credenciais ou host do Hive incorretos | Verifique os parâmetros da conexão Hive no Airflow | Airflow orquestrando pipelines: do ETL ao machine learning |
| DAG não aparece na interface web | Arquivo Python do DAG com erro de sintaxe ou mal posicionado | Corrija o código e coloque o arquivo na pasta 'dags' do Airflow | Airflow orquestrando pipelines: do ETL ao machine learning |
| Produtor bloqueando ao enviar mensagens | buffer.memory insuficiente | Aumente buffer.memory ou reduza batch.size | Ajustando produtores e consumidores para alta performance |
| Latência alta em consumidores | fetch.min.bytes alto demais para o volume de mensagens | Reduza fetch.min.bytes | Ajustando produtores e consumidores para alta performance |
| Produtor lança OutOfMemoryError | batch.size ou buffer.memory muito altos | Reduza ambos e monitore o uso de memória | Ajustando produtores e consumidores para alta performance |
| Consumidor processando poucas mensagens por vez | max.poll.records baixo | Aumente max.poll.records gradualmente | Ajustando produtores e consumidores para alta performance |
| Usuários não aparecem na interface do Ranger | Configuração incorreta do LDAP/AD | Revise as propriedades LDAP e teste a conexão com ldapsearch | Apache Ranger: controle fino de acesso em escala |
| Políticas não têm efeito no HDFS/Hive | Plugin do Ranger não instalado ou mal configurado | Reinstale o plugin e verifique o arquivo de configuração | Apache Ranger: controle fino de acesso em escala |
| Logs de auditoria não são gerados | Backend de auditoria não configurado corretamente | Revise as configurações de auditoria no Ranger Admin | Apache Ranger: controle fino de acesso em escala |
| Logs de auditoria do HDFS não aparecem após operações. | Parâmetro de auditoria não ativado ou permissão de escrita insuficiente no diretório de logs. | Revise o hdfs-site.xml e permissões do diretório. Reinicie o NameNode. | Auditoria e rastreabilidade: quem fez o quê, quando e onde |
| Logs do Hive não mostram operações de usuários. | Parâmetro de logging do HiveServer2 desativado. | Ative hive.server2.logging.operation.enabled e reinicie o HiveServer2. | Auditoria e rastreabilidade: quem fez o quê, quando e onde |
| Eventos não aparecem na interface de auditoria do Ranger. | Auditoria não habilitada no serviço ou falha de integração. | Revise configurações no Ranger Admin UI e logs do Ranger Admin. | Auditoria e rastreabilidade: quem fez o quê, quando e onde |
| SIEM não recebe logs do HDFS. | Configuração do Filebeat/Logstash incorreta ou caminho do log errado. | Ajuste o caminho e reinicie o agente de coleta. | Auditoria e rastreabilidade: quem fez o quê, quando e onde |
| Usuário não consegue acessar nenhum índice | Papel não atribuído ou privilégio insuficiente | Verifique os papéis atribuídos e permissões no papel | Autenticação e autorização: usuários, papéis e permissões |
| Usuário acessa índices não permitidos | Papel com permissão ampla demais | Restrinja os padrões de índice e privilégios no papel | Autenticação e autorização: usuários, papéis e permissões |
| Erro de autenticação ao integrar com LDAP | Configuração de realm LDAP incorreta | Revise URL, DN e credenciais no elasticsearch.yml | Autenticação e autorização: usuários, papéis e permissões |
| Erro 'GSSException: No valid credentials provided' | Kerberos não configurado corretamente ou ticket expirado. | Renove o ticket com 'kinit' e revise keytabs. | Autenticação, criptografia e masking: camadas essenciais de |
| Arquivos em zona criptografada não podem ser lidos | Chave de criptografia não disponível ou permissões incorretas. | Verifique políticas de chave e permissões do usuário. | Autenticação, criptografia e masking: camadas essenciais de |
| Dados sensíveis aparecem completos nas consultas Hive | Função de masking não aplicada ou consulta sem filtro. | Reveja o SQL e aplique masking corretamente. | Autenticação, criptografia e masking: camadas essenciais de |
| Erro: 'FATAL: no pg_hba.conf entry for host...' | Regra no pg_hba.conf ausente ou incorreta para o IP de origem. | Adicione ou corrija a regra correspondente no pg_hba.conf e recarregue a configuração. | Autenticação, SSL e pg_hba.conf: blindando conexões e acesso |
| Erro: 'SSL error: certificate verify failed' | Certificado autoassinado não confiável ou CA ausente no cliente. | Instale o certificado da CA no cliente ou use um certificado assinado por uma CA confiável. | Autenticação, SSL e pg_hba.conf: blindando conexões e acesso |
| Conexão sem SSL aceita mesmo com hostssl | Cliente não está usando SSL ou regra host (sem ssl) está acima no pg_hba.conf. | Remova regras host sem SSL ou coloque hostssl acima. | Autenticação, SSL e pg_hba.conf: blindando conexões e acesso |
| Cluster não sobe após upgrade | Configuração incompatível ou versão do Java incorreta | Verifique logs em /var/log/elasticsearch e ajuste elasticsearch.yml conforme a documentação | Automatizando deploys e upgrades: Ansible e scripts shell na |
| Nó não aparece no cluster | Firewall ou configuração de network.host errada | Ajuste network.host e portas no elasticsearch.yml, reinicie o nó | Automatizando deploys e upgrades: Ansible e scripts shell na |
| Playbook falha em um host | Permissão insuficiente ou SSH não configurado | Garanta acesso sudo e conectividade SSH entre máquina de controle e hosts | Automatizando deploys e upgrades: Ansible e scripts shell na |
| Serviço Hadoop não inicia após upgrade | Configuração incompatível ou arquivo corrompido | Restaure o backup da configuração e reinicie o serviço. | Automatizando deploys e upgrades: menos erro, mais controle |
| Hive não conecta ao metastore | Variáveis de ambiente ou JDBC incorretos | Revise hive-site.xml e as variáveis de ambiente JAVA_HOME e HIVE_HOME. | Automatizando deploys e upgrades: menos erro, mais controle |
| Erro de permissão ao executar playbook | Usuário sem sudo ou SSH configurado | Configure sudoers e chaves SSH corretamente. | Automatizando deploys e upgrades: menos erro, mais controle |
| Backup não é criado pelo cron | Permissões ou variáveis de ambiente ausentes no cron | Inclua caminhos completos nos scripts e exporte variáveis necessárias | Backup e restore automáticos: pg_dump, pg_basebackup e cron |
| Restore falha com erro de versão | Incompatibilidade entre versões do PostgreSQL | Use pg_dump e pg_restore da mesma versão do servidor de destino | Backup e restore automáticos: pg_dump, pg_basebackup e cron |
| Backup físico falha com erro de permissão | Usuário não tem permissão de replicação | Ajuste o pg_hba.conf e conceda permissão REPLICATION ao usuário | Backup e restore automáticos: pg_dump, pg_basebackup e cron |
| Snapshot não pode ser criado | Diretório não está habilitado para snapshots. | Execute 'hdfs dfsadmin -allowSnapshot <diretório>'. | Backup, snapshots e recuperação: não confie só na replicação |
| Backup com distcp falha | Permissões insuficientes ou destino inacessível. | Verifique permissões e conectividade entre os clusters. | Backup, snapshots e recuperação: não confie só na replicação |
| Restore do NameNode não monta o namespace | Arquivos fsimage ou edits corrompidos. | Restaure de um backup anterior válido e valide com 'hdfs fsck /'. | Backup, snapshots e recuperação: não confie só na replicação |
| Busca lenta | Número excessivo de shards ou falta de RAM | Reduza shards ou aumente recursos físicos | Busca full-text em milhões de documentos: lições de clusters |
| Documentos não encontrados em buscas multilíngues | Analisador incorreto ou campo errado na query | Revise o mapeamento e os campos usados na busca | Busca full-text em milhões de documentos: lições de clusters |
| Cluster travando após semanas | Índices crescendo sem controle | Implemente ILM e deleção automática | Busca full-text em milhões de documentos: lições de clusters |
| Heap frequentemente acima de 80% | Heap pequeno demais ou workload excessivo | Aumentar heap até 32GB ou reduzir volume de dados/processamento | Busca lenta, heap full, GC: atacando problemas de performanc |
| GC com pausas acima de 2s | Heap grande demais ou coletor de lixo inadequado | Reduzir heap, garantir uso de G1GC, revisar queries | Busca lenta, heap full, GC: atacando problemas de performanc |
| Busca lenta em campos textuais | Uso de wildcard/regexp em campos analisados | Trocar para campos keyword ou refatorar queries | Busca lenta, heap full, GC: atacando problemas de performanc |
| Busca retorna resultados irrelevantes. | Modelo NLP inadequado ou embeddings não normalizados. | Troque o modelo ou normalize os embeddings antes de indexar. | Buscas semânticas, vetores e NLP: o que já é possível com El |
| Latência alta nas buscas. | Volume de dados grande e ausência de indexação ANN. | Limite o número de documentos ou use ferramentas especializadas para busca vetorial. | Buscas semânticas, vetores e NLP: o que já é possível com El |
| Erro ao indexar embedding. | Dimensão do vetor incompatível com o mapeamento. | Verifique se o número de elementos do vetor bate com o campo 'dims' do mapeamento. | Buscas semânticas, vetores e NLP: o que já é possível com El |
| O NameNode trava ou reinicia frequentemente | Falta de RAM para metadados | Aumente a memória heap do NameNode e revise o número de blocos | Calculando storage, memória e CPU: dimensionamento que evita |
| O DataNode apresenta lentidão em uploads | Disco subdimensionado ou CPU insuficiente | Adicione discos rápidos (SSD) ou aumente núcleos de CPU | Calculando storage, memória e CPU: dimensionamento que evita |
| O cluster atinge 100% de storage rapidamente | Fator de replicação alto ou crescimento não planejado | Revise o fator de replicação e amplie storage | Calculando storage, memória e CPU: dimensionamento que evita |
| Latência alta na publicação | Batch.size ou linger.ms muito altos, disco lento ou partições insuficientes | Reduza batch.size/linger.ms, use SSD, aumente número de partições | Calculando throughput, latência e armazenamento |
| Uso de disco crescendo rápido demais | Retenção alta ou compactação mal configurada | Reduza retention.ms ou ative compactação se aplicável | Calculando throughput, latência e armazenamento |
| Consumidores ficam atrás do produtor | Poucas partições ou consumidores lentos | Aumente partições ou otimize consumidores | Calculando throughput, latência e armazenamento |
| Tópicos ficam indisponíveis após falha de broker | Fator de replicação insuficiente ou min.insync.replicas maior que o número de brokers ativos | Aumente o número de brokers ou ajuste min.insync.replicas | Cluster Kafka: brokers, Zookeeper e replicação |
| Kafka não inicia ou perde conexão com Zookeeper | Configuração incorreta de zookeeper.connect ou quorum insuficiente | Revise a configuração e garanta que a maioria dos nós Zookeeper está ativa | Cluster Kafka: brokers, Zookeeper e replicação |
| Mensagens não são replicadas | Brokers followers offline ou lentos | Monitore o status dos brokers e ajuste recursos do sistema | Cluster Kafka: brokers, Zookeeper e replicação |
| Cluster com status yellow | Nem todas as réplicas estão alocadas | Verifique se há nós suficientes e recursos livres | Cluster, nó, shard e réplica: como o Elasticsearch distribui |
| Shards unassigned | Faltam nós ou configuração incorreta | Adicione nós ou ajuste configurações de shards | Cluster, nó, shard e réplica: como o Elasticsearch distribui |
| Busca lenta após falha de nó | Réplica promovida, mas cluster sobrecarregado | Aumente o número de nós ou otimize queries | Cluster, nó, shard e réplica: como o Elasticsearch distribui |
| Erro de node.name duplicado | Dois nós com mesmo nome | Garanta node.name único em cada nó | Cluster, nó, shard e réplica: como o Elasticsearch distribui |
| Mensagens não aparecem no cluster de destino | Erro de configuração no MirrorMaker ou falha de rede | Revise mm2.properties e conectividade entre datacenters | Clusters Kafka em múltiplos datacenters e replicação geográf |
| Replication lag alto | Largura de banda insuficiente ou batch.size pequeno | Aumente batch.size e tasks.max, verifique link de rede | Clusters Kafka em múltiplos datacenters e replicação geográf |
| Offsets de consumidores não sincronizam | Configuração de offset sync ausente | Habilite offset sync no MirrorMaker e ajuste consumidores | Clusters Kafka em múltiplos datacenters e replicação geográf |
| Consumidor não recebe mensagens | Partição não atribuída ou consumidor fora do grupo | Verifique se o número de consumidores não excede o de partições e se o grupo está correto. | Conceitos-chave: tópicos, partições, brokers e consumidores |
| Broker não aparece na lista de ativos | Broker offline ou problema de rede | Cheque logs do broker e conectividade de rede. | Conceitos-chave: tópicos, partições, brokers e consumidores |
| Produtor falha ao enviar mensagem | Broker indisponível ou tópico inexistente | Confirme se o broker está online e o tópico existe. | Conceitos-chave: tópicos, partições, brokers e consumidores |
| Usuário autenticado não consegue produzir ou consumir | ACL ausente ou permissões insuficientes | Crie ou ajuste a ACL para o usuário e operação desejada | Controle de acesso: permissões e ACLs no Kafka |
| Permissões excessivas concedidas acidentalmente | Uso de curingas (*) em tópicos ou operações | Remova ACLs globais e crie regras específicas | Controle de acesso: permissões e ACLs no Kafka |
| Logs de auditoria não aparecem | Configuração de authorizer.logger ausente ou incorreta | Ajuste o server.properties para ativar o log de autorização | Controle de acesso: permissões e ACLs no Kafka |
| Arquivo inacessível no HDFS | Bloco corrompido ou ausente | Rode fsck, tente re-replicar ou restaure de backup | Corrupt blocks, falhas de ingestão e outros pesadelos: soluç |
| Ingestão não processa novas partições | Erro em script ou dados mal formatados | Revise logs, corrija dados e reprocessa apenas o intervalo afetado | Corrupt blocks, falhas de ingestão e outros pesadelos: soluç |
| Alertas de corrupção recorrentes | Disco defeituoso ou nó instável | Verifique hardware, remova ou substitua DataNode | Corrupt blocks, falhas de ingestão e outros pesadelos: soluç |
| GC frequente e pausas longas | Heap pequeno demais ou queries pesadas | Aumente heap até 50% da RAM física e otimize queries | CPU, RAM, disco e rede: o que realmente limita a performance |
| Ingestão lenta mesmo com CPU ociosa | Disco lento (HDD ou SSD saturado) | Migre para SSD NVMe e ajuste número de shards | CPU, RAM, disco e rede: o que realmente limita a performance |
| Busca lenta em cluster distribuído | Latência de rede alta entre nós | Aloque nós em mesma sub-rede e use rede de 10 Gbps | CPU, RAM, disco e rede: o que realmente limita a performance |
| Role não consegue acessar tabela | Permissão de USAGE no schema ausente | Conceda USAGE no schema com GRANT USAGE ON SCHEMA nome_schema TO role; | Criando bancos, roles e permissões: estrutura mínima para de |
| Role de leitura não vê novas tabelas | Permissão padrão não configurada | Use ALTER DEFAULT PRIVILEGES para garantir herança de permissões. | Criando bancos, roles e permissões: estrutura mínima para de |
| Aplicação conecta mas não consegue inserir dados | Permissão INSERT ausente na tabela | Conceda INSERT explicitamente na tabela ou schema. | Criando bancos, roles e permissões: estrutura mínima para de |
| Erro de handshake TLS entre nós | Certificados incompatíveis ou CA ausente | Verifique se todos os nós usam a mesma CA e se os caminhos dos certificados estão corretos | Criptografia em trânsito e em repouso: protegendo dados sens |
| Elasticsearch não inicia após configurar TLS | Permissões incorretas nos arquivos de chave | Ajuste permissões para 600 e usuário elasticsearch | Criptografia em trânsito e em repouso: protegendo dados sens |
| Volume criptografado não monta no boot | Falta de configuração no /etc/crypttab ou /etc/fstab | Inclua a entrada correta nesses arquivos e teste o boot | Criptografia em trânsito e em repouso: protegendo dados sens |
| Dados não aparecem na tabela Hive | Partições não adicionadas ou diretório incorreto no HDFS | Execute 'MSCK REPAIR TABLE cdr;' no Hive e verifique caminhos de ingestão | Data Lake em telecom: ingestão massiva e analytics em tempo |
| Atraso excessivo na ingestão | Gargalo no canal do Flume ou sobrecarga no HDFS | Aumente a capacidade do canal ou otimize a configuração do HDFS | Data Lake em telecom: ingestão massiva e analytics em tempo |
| Jobs do Airflow falham intermitentemente | Dependências externas instáveis ou scripts mal configurados | Revise logs do Airflow e teste comandos manualmente | Data Lake em telecom: ingestão massiva e analytics em tempo |
| Dados não aparecem na tabela Hive | Erro na definição do caminho ou formato | Revise LOCATION e formato da tabela | Data Lake multi-setor: lições de integração e governança |
| Usuário de outro setor acessa dados restritos | Política Ranger mal configurada | Revise políticas e grupos no Ranger | Data Lake multi-setor: lições de integração e governança |
| Ingestão automática falha | Erro no DAG do Airflow ou credenciais expiradas | Cheque logs do Airflow e renove credenciais | Data Lake multi-setor: lições de integração e governança |
| Criptografia não ativa | Permissões insuficientes ou key não criada | Verifique permissões e existência da chave HDFS | Data Lake multi-setor: lições de integração e governança |
| Arquivo não aparece no HDFS após upload | Permissões insuficientes ou caminho incorreto | Confirme permissões e o caminho com 'hdfs dfs -ls' e ajuste com 'hdfs dfs -chmod' | Data Lake não é Data Warehouse: diferenças que mudam o proje |
| Erro ao carregar dados no Hive | Formato do arquivo incompatível com o esquema da tabela | Valide o delimitador e o tipo de dado no arquivo fonte | Data Lake não é Data Warehouse: diferenças que mudam o proje |
| Usuário sem acesso ao dado sensível | Política de acesso mal configurada no Ranger ou Hive | Revise as regras de permissão e aplique novamente | Data Lake não é Data Warehouse: diferenças que mudam o proje |
| Erro ao criar tabela Iceberg no Hive | Versão do Hive incompatível ou dependências do Iceberg ausentes | Verifique se o Hive está na versão suportada e se o JAR do Iceberg está no classpath | Data Lakehouse, Iceberg e o futuro do Hadoop: o que acompanh |
| Operações ACID falham ou retornam erro de metadados | Catálogo Hive não configurado corretamente para Iceberg | Revise as configurações do catálogo e reinicie os serviços | Data Lakehouse, Iceberg e o futuro do Hadoop: o que acompanh |
| Spark não reconhece tabelas Iceberg | Dependências do Iceberg não adicionadas ao Spark | Inclua o pacote do Iceberg ao iniciar o Spark com --packages | Data Lakehouse, Iceberg e o futuro do Hadoop: o que acompanh |
| Consumidores ociosos em um grupo | Número de partições menor que o de consumidores | Aumente o número de partições do tópico | Definindo tópicos e partições para performance e resiliência |
| Latência alta ao produzir mensagens | Excesso de partições ou réplicas, ou min.insync.replicas alto | Ajuste o número de partições ou min.insync.replicas | Definindo tópicos e partições para performance e resiliência |
| Tópico indisponível após falha de broker | Fator de replicação insuficiente | Recrie o tópico com replication-factor >= 3 | Definindo tópicos e partições para performance e resiliência |
| Busca lenta em índices recentes | Shards grandes demais ou muitos shards pequenos | Ajuste a granularidade dos índices e o número de shards | Design de índices: estratégias para grandes volumes e múltip |
| Cluster com muitos índices pequenos | Granularidade exagerada (ex: índices diários para baixo volume) | Aumente o intervalo dos índices (semanal ou mensal) | Design de índices: estratégias para grandes volumes e múltip |
| Erro ao deletar índices antigos | Política ILM não aplicada ou permissões insuficientes | Revise a política ILM e as permissões do usuário | Design de índices: estratégias para grandes volumes e múltip |
| Query continua lenta após criar índice | O índice não está sendo usado (talvez por função no WHERE ou tipo incompatível) | Crie índice funcional ou ajuste o tipo de dado | Diagnóstico de lentidão: EXPLAIN, índices e vacuum fora do l |
| VACUUM não reduz tamanho da tabela | Bloat muito alto, talvez precise de VACUUM FULL | Rode VACUUM FULL fora do horário de pico | Diagnóstico de lentidão: EXPLAIN, índices e vacuum fora do l |
| Autovacuum não roda com frequência suficiente | Parâmetros autovacuum padrão insuficientes para o volume de dados | Ajuste autovacuum_vacuum_scale_factor e autovacuum_analyze_scale_factor | Diagnóstico de lentidão: EXPLAIN, índices e vacuum fora do l |
| Partição com ISR reduzido | Broker offline ou lento | Restaurar broker e checar rede/disco | Diagnóstico de problemas comuns: brokers, tópicos e consumid |
| Consumidor com lag alto e estável | Consumidor travado ou commit ausente | Reiniciar consumidor e revisar commits | Diagnóstico de problemas comuns: brokers, tópicos e consumid |
| Erro de disco nos logs | Disco cheio ou corrompido | Liberar espaço ou substituir disco | Diagnóstico de problemas comuns: brokers, tópicos e consumid |
| Documentação desatualizada após deploy de pipeline | Falta de automação ou processo de revisão falho | Automatize geração de documentação e exija revisão obrigatória em pull requests | Documentação viva: como não perder o controle do seu Data La |
| Confusão sobre qual schema está em produção | Schemas não versionados junto com código | Extraia schemas automaticamente e salve no repositório | Documentação viva: como não perder o controle do seu Data La |
| Branch principal com documentação inconsistente | Commits diretos na main sem revisão | Bloqueie push direto na main e use pull requests | Documentação viva: como não perder o controle do seu Data La |
| Consulta lenta em campo JSONB | Falta de índice GIN ou uso de funções não indexáveis | Crie índice GIN e reescreva a consulta para usar operadores suportados | Documentos, JSONB e arrays: quando (e como) usar estruturas |
| Dados inconsistentes em JSONB | Falta de validação na aplicação ou constraints | Implemente CHECK constraints ou validação em triggers | Documentos, JSONB e arrays: quando (e como) usar estruturas |
| Array com mais elementos do que o esperado | Ausência de constraint de tamanho | Adicione constraint com array_length() | Documentos, JSONB e arrays: quando (e como) usar estruturas |
| Índice GIN ocupa muito espaço | Alta cardinalidade ou documentos muito variados | Avalie necessidade do índice e considere extrair campos críticos para colunas separadas | Documentos, JSONB e arrays: quando (e como) usar estruturas |
| FATAL: password authentication failed | Usuário ou senha incorretos, ou método de autenticação incompatível. | Verifique credenciais e o parâmetro auth_type no PgBouncer. | Drivers, strings de conexão e pooling: conectando aplicações |
| could not connect to server: Connection refused | Serviço não está rodando ou firewall bloqueando porta. | Confirme se PostgreSQL e PgBouncer estão ativos e portas liberadas. | Drivers, strings de conexão e pooling: conectando aplicações |
| too many connections | Limite de conexões simultâneas excedido. | Ajuste max_connections no PostgreSQL e max_client_conn no PgBouncer. | Drivers, strings de conexão e pooling: conectando aplicações |
| Cluster entra em estado 'red' após falha de zona | Faltam réplicas ou shards não estão distribuídos corretamente | Ajuste o awareness de zona e aumente o número de réplicas | Elastic Stack em ambientes de alta disponibilidade e multi-c |
| Split-brain detectado | Quorum de master configurado incorretamente ou latência alta entre zonas | Revise minimum_master_nodes e monitore latência de rede | Elastic Stack em ambientes de alta disponibilidade e multi-c |
| Snapshot falha ao restaurar em outro datacenter | Permissões de acesso ao repositório ou incompatibilidade de versão | Verifique permissões e compatibilidade entre clusters | Elastic Stack em ambientes de alta disponibilidade e multi-c |
| Cluster não forma quorum | discovery.seed_hosts ou cluster.initial_master_nodes incorretos | Verifique IPs e nomes dos nós no elasticsearch.yml | elasticsearch.yml sem mistério: as opções que realmente impo |
| Nó não aceita conexões externas | network.host configurado para localhost ou firewall bloqueando | Ajuste network.host e libere portas 9200/9300 no firewall | elasticsearch.yml sem mistério: as opções que realmente impo |
| Performance ruim em indexação | indices.memory.index_buffer_size subdimensionado | Aumente o buffer para 15-20% da heap | elasticsearch.yml sem mistério: as opções que realmente impo |
| Shards primários UNASSIGNED após queda de nó | Nó não voltou ou dados corrompidos | Recupere o nó ou force alocação com accept_data_loss | Erros de shard, split brain e cluster red: causas e soluções |
| Cluster em estado red após atualização | Incompatibilidade de versões ou configuração de quorum errada | Verifique versões e ajuste quorum | Erros de shard, split brain e cluster red: causas e soluções |
| Split brain detectado em logs | minimum_master_nodes insuficiente ou falha de rede | Ajuste quorum e verifique conectividade entre nós | Erros de shard, split brain e cluster red: causas e soluções |
| GC com pausas longas | Heap grande demais ou queries pesadas | Reduza heap ou otimize queries | Escalabilidade vertical e tuning fino: extraindo o máximo do |
| Rejeição de requisições de busca | Fila do thread pool cheia | Aumente queue_size ou otimize queries | Escalabilidade vertical e tuning fino: extraindo o máximo do |
| Swap sendo usado | Memory lock desativado ou heap muito grande | Ative bootstrap.memory_lock e ajuste o heap | Escalabilidade vertical e tuning fino: extraindo o máximo do |
| Latência alta sob carga | Excesso de threads ou CPU saturada | Reduza thread_pool.size ou aumente CPUs | Escalabilidade vertical e tuning fino: extraindo o máximo do |
| Novo nó não aparece no cluster | Configuração de cluster.name ou discovery.seed_hosts incorreta | Revise elasticsearch.yml e reinicie o serviço | Escalando horizontalmente: adicionando nós sem perder perfor |
| Shards ficam em INITIALIZING ou RELOCATING por muito tempo | Rede lenta ou disco sobrecarregado | Verifique uso de rede e disco; limite rebalanceamentos simultâneos | Escalando horizontalmente: adicionando nós sem perder perfor |
| Cluster entra em estado yellow ou red após adicionar nó | Falha na realocação de shards ou falta de réplicas | Aumente número de réplicas ou libere espaço em disco | Escalando horizontalmente: adicionando nós sem perder perfor |
| Consumidores ociosos | Menos partições que consumidores | Aumente o número de partições | Escalando tópicos, partições e consumidores |
| Lag alto nos consumidores | Partições demais para poucos consumidores ou consumidores lentos | Aumente o número de consumidores ou otimize o processamento | Escalando tópicos, partições e consumidores |
| Rebalanceamento frequente | Instabilidade de consumidores ou timeout baixo | Ajuste o session.timeout.ms e monitore a saúde dos consumidores | Escalando tópicos, partições e consumidores |
| Usuário recebe erro de permissão ao consultar tabela Hive | Política Ranger restritiva ou ausência de permissão para SELECT | Revise políticas no Ranger e adicione permissão SELECT para o usuário/grupo | Escolhendo componentes: quando usar Hive, Ranger e Airflow n |
| DAG do Airflow não dispara tarefa Hive | Operador Hive não configurado corretamente ou conexão inválida | Verifique conexão Hive no Airflow e dependências do operador | Escolhendo componentes: quando usar Hive, Ranger e Airflow n |
| Consultas Hive estão lentas | Particionamento inadequado ou metastore sobrecarregado | Reveja particionamento das tabelas e dimensione o metastore | Escolhendo componentes: quando usar Hive, Ranger e Airflow n |
| Erro 'extension does not exist' ao criar extensão | Pacote do sistema não instalado ou versão errada. | Confirme a versão do PostgreSQL e reinstale o pacote correto. | Extensões avançadas: PostGIS, pg_partman e Citus (open-sourc |
| Funções da extensão não aparecem | Extensão não ativada no banco desejado. | Execute 'CREATE EXTENSION nome_da_extensao;' no banco correto. | Extensões avançadas: PostGIS, pg_partman e Citus (open-sourc |
| Erro de permissão ao instalar extensão | Usuário sem privilégios suficientes. | Use um usuário superuser para instalar extensões. | Extensões avançadas: PostGIS, pg_partman e Citus (open-sourc |
| Conector não inicia | Configuração inválida ou falta de dependências | Revise o arquivo JSON e verifique logs do Kafka Connect | Extensões e integrações avançadas: Kafka Connect, Streams e |
| Dados não aparecem no tópico | Permissões insuficientes ou erro de mapeamento de campos | Cheque credenciais e correspondência de nomes de campos | Extensões e integrações avançadas: Kafka Connect, Streams e |
| Streams não processa eventos | Serialização incompatível ou falha de configuração | Confirme os Serdes utilizados e ajuste a configuração da aplicação | Extensões e integrações avançadas: Kafka Connect, Streams e |
| Lentidão no processamento | Recursos insuficientes ou configuração de paralelismo baixa | Ajuste número de workers ou threads e monitore métricas | Extensões e integrações avançadas: Kafka Connect, Streams e |
| Prometheus não coleta métricas do Kafka | Porta errada ou exporter não iniciado | Verifique se o JMX Exporter está rodando na porta correta e se o Prometheus está configurado para ela. | Ferramentas open source para monitoramento de Kafka |
| Burrow não mostra lag dos consumidores | Configuração incorreta do cluster Kafka no Burrow | Revise o arquivo de configuração do Burrow e reinicie o serviço. | Ferramentas open source para monitoramento de Kafka |
| Logs do Kafka não aparecem no diretório esperado | Caminho de log configurado errado no log4j.properties | Ajuste o caminho do arquivo de log no log4j.properties e reinicie o Kafka. | Ferramentas open source para monitoramento de Kafka |
| Exporter não sobe ou não expõe métricas | Problema de conexão com o banco ou variáveis de ambiente incorretas | Revise a string DATA_SOURCE_NAME e permissões do usuário no PostgreSQL | Ferramentas open-source de monitoramento: do pganalyze ao pr |
| Prometheus não coleta métricas do exporter | Endpoint ou porta incorreta no prometheus.yml | Ajuste o targets para o endereço correto do exporter | Ferramentas open-source de monitoramento: do pganalyze ao pr |
| Dashboards do Grafana aparecem vazios | Fonte de dados mal configurada ou queries erradas | Reveja a configuração da fonte de dados e as queries dos painéis | Ferramentas open-source de monitoramento: do pganalyze ao pr |
| Mensagens não aparecem para consumidores novos | Offset inicial não definido ou retenção expirou | Use --from-beginning e ajuste retention.ms | Fluxos de dados: do produtor ao consumidor |
| Consumidor lê mensagens duplicadas | Commit de offset feito antes do processamento | Altere para commit manual após processamento | Fluxos de dados: do produtor ao consumidor |
| Tópico cresce indefinidamente | Política de retenção inadequada | Defina retention.ms ou retention.bytes apropriados | Fluxos de dados: do produtor ao consumidor |
| Mensagens perdidas após falha | Offset commit automático ativado | Configure commit manual e idempotência no produtor | Fluxos de dados: do produtor ao consumidor |
| Índices não giram (rollover) automaticamente | Alias de rollover ausente ou mal configurado | Crie o alias corretamente e marque como is_write_index | Gerenciamento de índices: criação, rotação e exclusão automa |
| Índices antigos não são excluídos | Política de delete não aplicada ou min_age muito alto | Revise a política ILM e ajuste min_age conforme necessário | Gerenciamento de índices: criação, rotação e exclusão automa |
| Erro de espaço em disco | Retenção excessiva ou falta de política de exclusão | Reduza o tempo de retenção ou aumente a capacidade do cluster | Gerenciamento de índices: criação, rotação e exclusão automa |
| Erro ao registrar novo schema | Schema incompatível com a política definida | Revise o schema e ajuste para garantir compatibilidade (ex: adicione campos opcionais ou valores default) | Governança de dados e versionamento de schemas |
| Consumidor falha ao ler mensagens | Versão do schema não compatível com consumidor | Atualize o consumidor para suportar a nova versão do schema ou ajuste o schema para manter compatibilidade | Governança de dados e versionamento de schemas |
| Mensagens rejeitadas pelo produtor | Schema não registrado ou URL do Schema Registry incorreta | Confirme a configuração do produtor e o registro do schema no Schema Registry | Governança de dados e versionamento de schemas |
| Validações de qualidade não são executadas | DAGs do Airflow desativadas ou agendamento incorreto | Verifique o status dos DAGs e o schedule_interval | Governança de dados: qualidade, linhagem e compliance na prá |
| Acessos não autorizados a dados sensíveis | Políticas do Ranger mal configuradas | Revise regras de acesso e teste com usuários de perfis diferentes | Governança de dados: qualidade, linhagem e compliance na prá |
| Linhagem de dados incompleta | Falta de documentação ou versionamento dos scripts | Inclua logs e versionamento nos pipelines e revise descrições dos DAGs | Governança de dados: qualidade, linhagem e compliance na prá |
| NameNode não responde | Processo parado ou corrupção de metadados | Reinicie o serviço e verifique logs em /var/log/hadoop-hdfs/ | HDFS, NameNode e DataNode: como o armazenamento distribuído |
| DataNode ausente no report | Falha de rede, disco cheio ou serviço parado | Cheque conectividade, espaço em disco e reinicie o DataNode | HDFS, NameNode e DataNode: como o armazenamento distribuído |
| Arquivo não replica corretamente | DataNodes insuficientes ou configuração de replicação acima da capacidade | Adicione DataNodes ou reduza o fator de replicação | HDFS, NameNode e DataNode: como o armazenamento distribuído |
| Busca retorna poucos ou nenhum resultado. | Analisador do campo não compatível com o texto ou stopwords removendo termos importantes. | Revise a configuração do analisador e ajuste filtros de stopwords. | Índice invertido, relevância e análise: o motor real do Elas |
| Resultados irrelevantes aparecem no topo. | Parâmetros do BM25 inadequados ou análise mal configurada. | Ajuste k1 e b do BM25 e revise o pipeline de análise. | Índice invertido, relevância e análise: o motor real do Elas |
| Busca lenta mesmo com poucos documentos. | Falta de mapeamento adequado ou índice corrompido. | Verifique o mapping e reindexe os dados se necessário. | Índice invertido, relevância e análise: o motor real do Elas |
| Consultas lentas em índices grandes | Shards muito grandes ou poucos shards | Rebalanceie o número de shards e reindexe se necessário | Índices, shards e mapeamentos: padrões que evitam dor de cab |
| Erro ao alterar tipo de campo | Mudança de tipo não suportada em mapeamento existente | Crie novo índice com mapeamento correto e reindexe | Índices, shards e mapeamentos: padrões que evitam dor de cab |
| Consumo excessivo de memória | Muitos shards pequenos | Consolide índices e reduza o número de shards | Índices, shards e mapeamentos: padrões que evitam dor de cab |
| Disco crescendo rapidamente | Bloat acumulado ou índices desnecessários | Reveja índices, rode vacuum e reindexe. | Índices, vacuum e autovacuum: o que consome espaço e como pr |
| Queries lentas após muitos updates | Índices inchados ou bloat alto | Reindexe e ajuste autovacuum. | Índices, vacuum e autovacuum: o que consome espaço e como pr |
| Autovacuum rodando sem parar | Tabelas com muita escrita ou parâmetros mal ajustados | Ajuste thresholds e scale factors. | Índices, vacuum e autovacuum: o que consome espaço e como pr |
| psql: could not connect to server: No such file or directory | O serviço PostgreSQL não está rodando ou o cluster não foi inicializado. | Verifique o status do serviço com 'systemctl status postgresql-16' e inicialize se necessário. | Instalação do PostgreSQL no Linux: do repositório à primeira |
| Permission denied ao inicializar cluster | Comando executado sem permissões de root ou usuário postgres. | Use 'sudo' ou troque para o usuário correto. | Instalação do PostgreSQL no Linux: do repositório à primeira |
| Erro de chave GPG ao atualizar pacotes | Chave de assinatura não importada corretamente. | Reimporte a chave conforme o passo 2. | Instalação do PostgreSQL no Linux: do repositório à primeira |
| O serviço não inicia ou para imediatamente. | Permissões incorretas nos diretórios de dados/logs ou porta já em uso. | Ajuste permissões e verifique se a porta 9200 está livre. | Instalação real: do download à configuração inicial em ambie |
| curl retorna conexão recusada. | Elasticsearch não está rodando ou escutando em outro endereço. | Verifique network.host em elasticsearch.yml e se o processo está ativo. | Instalação real: do download à configuração inicial em ambie |
| Status do cluster é 'red'. | Erro crítico de inicialização ou diretório de dados corrompido. | Consulte os logs em path.logs e revise configurações. | Instalação real: do download à configuração inicial em ambie |
| Kafka não inicia, erro de conexão com Zookeeper | Zookeeper não está rodando ou porta incorreta. | Verifique se o Zookeeper está ativo na porta 2181 e revise o parâmetro zookeeper.connect. | Instalando Apache Kafka e Zookeeper do zero |
| Erro 'JAVA_HOME is not set' | Variável de ambiente JAVA_HOME não configurada. | Defina JAVA_HOME apontando para o diretório do Java instalado. | Instalando Apache Kafka e Zookeeper do zero |
| Tópico não aparece na listagem | Kafka não está conectado ao Zookeeper ou erro de permissão. | Revise os logs do Kafka e Zookeeper e tente criar o tópico novamente. | Instalando Apache Kafka e Zookeeper do zero |
| Porta 9092 já está em uso | Outro processo está usando a porta padrão do Kafka. | Altere a porta em server.properties ou finalize o processo conflitante. | Instalando Apache Kafka e Zookeeper do zero |
| Erro de permissão ao criar tabelas no Hive | Permissões incorretas no diretório warehouse do HDFS | Execute 'hdfs dfs -chmod -R 1777 /user/hive/warehouse' | Instalando HDFS e Hive na prática: do zero ao primeiro dado |
| HiveServer2 não inicia | Banco do metastore mal configurado ou porta em uso | Revise o hive-site.xml e verifique se a porta 10000 está livre | Instalando HDFS e Hive na prática: do zero ao primeiro dado |
| NameNode não sobe após formatação | Diretório dfs.namenode.name.dir sem permissão ou espaço | Ajuste permissões e espaço em disco; refaça a formatação | Instalando HDFS e Hive na prática: do zero ao primeiro dado |
| Erro de autenticação ao conectar | Configuração incorreta de Kerberos ou credenciais inválidas | Verifique o principal, o arquivo krb5.conf e as permissões do usuário. | Integração com BI e analytics: conectando Hive ao mundo exte |
| Consultas lentas ou travando | Cluster sobrecarregado ou consultas ineficientes | Otimize as queries, limite o número de conexões e monitore o uso do cluster. | Integração com BI e analytics: conectando Hive ao mundo exte |
| Ferramenta de BI não lista tabelas | Permissões insuficientes no Hive ou erro na string de conexão | Revise as políticas no Ranger e a configuração do driver. | Integração com BI e analytics: conectando Hive ao mundo exte |
| Eventos não aparecem no tópico Kafka | Conector mal configurado ou sem permissão de leitura no banco | Revise a configuração do conector e permissões do usuário no banco | Integração de Kafka com bancos de dados e aplicações legadas |
| Duplicidade de eventos | Modo de captura inadequado (ex: polling sem controle de offset) | Ajuste o modo de operação do conector para CDC ou incremente controle de offset | Integração de Kafka com bancos de dados e aplicações legadas |
| Latência alta na ingestão de dados | Polling muito espaçado ou gargalo no sistema legado | Reduza o intervalo de polling ou otimize o processo de leitura | Integração de Kafka com bancos de dados e aplicações legadas |
| Task fica em 'queued' indefinidamente | Scheduler ou Worker parados | Reinicie serviços do Airflow: 'airflow scheduler' e 'airflow worker' | Job scheduling e automação de cargas: Airflow além do básico |
| Falha ao acessar HDFS | Permissões ou variáveis de ambiente incorretas | Verifique usuário e variáveis HADOOP_CONF_DIR | Job scheduling e automação de cargas: Airflow além do básico |
| Notificações não chegam | SMTP não configurado ou bloqueio de firewall | Configure SMTP no airflow.cfg e teste envio manual | Job scheduling e automação de cargas: Airflow além do básico |
| Conector em estado FAILED | Erro de autenticação ou configuração inválida | Revise as credenciais e os parâmetros do arquivo JSON | Kafka Connect: integrando bancos de dados relacionais e NoSQ |
| Dados não aparecem no tópico Kafka | Tabela/coleção vazia ou filtro de consulta restritivo | Valide a consulta SQL ou os parâmetros de filtro | Kafka Connect: integrando bancos de dados relacionais e NoSQ |
| Offsets não avançam | Coluna de incremento não está sendo atualizada | Verifique se há novos dados e se a coluna de incremento é única e crescente | Kafka Connect: integrando bancos de dados relacionais e NoSQ |
| Kafka não aceita conexões após queda de broker | Perda de quorum no Zookeeper ou replication.factor insuficiente | Restabeleça quorum e aumente replication.factor | Kafka em ambientes de alta disponibilidade e missão crítica |
| UnderReplicatedPartitions não zera | Brokers lentos ou falha de rede | Verifique disco, rede e logs dos brokers | Kafka em ambientes de alta disponibilidade e missão crítica |
| MirrorMaker 2 não sincroniza tópicos | Configuração de conexão ou permissão incorreta | Revise propriedades e conectividade entre clusters | Kafka em ambientes de alta disponibilidade e missão crítica |
| Não é possível criar tópicos | Quorum de controllers não está estabelecido | Verifique logs dos brokers e se todos os nodes do quorum estão online | Kafka sem Zookeeper: KRaft e a nova arquitetura |
| Broker não inicia | Configuração de process.roles ou controller.quorum.voters incorreta | Revise o arquivo server.properties e os IDs de node | Kafka sem Zookeeper: KRaft e a nova arquitetura |
| Operações administrativas falham após queda de nodes | Quorum de controllers foi perdido | Restaure a disponibilidade dos nodes do quorum | Kafka sem Zookeeper: KRaft e a nova arquitetura |
| Processamento está lento ou travado | Lag alto nas partições ou gargalo de estado local | Aumente o número de instâncias ou otimize operações de estado | Kafka Streams: processamento de eventos em tempo real |
| Dados de saída ausentes | Erro na lógica de filtro ou mapeamento | Revise o código e as condições dos operadores | Kafka Streams: processamento de eventos em tempo real |
| Falha ao inicializar Kafka Streams | Configuração incorreta de bootstrap.servers ou application.id duplicado | Corrija as configurações e reinicie a aplicação | Kafka Streams: processamento de eventos em tempo real |
| Kibana não conecta ao Elasticsearch | Endpoint ou porta incorretos no kibana.yml | Revise elasticsearch.hosts no kibana.yml e reinicie o serviço | Kibana e Logstash: instalando e conectando ao Elasticsearch |
| Logstash não envia dados | Erro de configuração no pipeline ou permissão de leitura no arquivo | Cheque o log do Logstash e permissões dos arquivos de entrada | Kibana e Logstash: instalando e conectando ao Elasticsearch |
| Índices não aparecem no Kibana | Kibana não está indexando padrões ou o Elasticsearch está vazio | Configure o padrão de índice em Kibana e valide ingestão de dados | Kibana e Logstash: instalando e conectando ao Elasticsearch |
| Painel de Monitoring vazio ou incompleto | Coleta de métricas desativada ou permissões insuficientes | Verifique se xpack.monitoring.collection.enabled está true e revise permissões de usuário | Kibana Monitoring: visualizando saúde e métricas do cluster |
| Alertas não disparam mesmo com thresholds excedidos | Configuração de alertas incorreta ou canal de notificação não configurado | Revise as condições dos alertas e teste o canal de saída | Kibana Monitoring: visualizando saúde e métricas do cluster |
| Métricas de nodes aparecem com delay | Latência de rede ou sobrecarga no cluster | Avalie uso de recursos e conectividade entre Elasticsearch e Kibana | Kibana Monitoring: visualizando saúde e métricas do cluster |
| Consultas lentas mesmo com particionamento | Arquivos pequenos demais ou partições desbalanceadas. | Reparticione os dados e compacte arquivos pequenos. | Layout de dados e particionamento: o que decide performance |
| Erro ao consultar partições novas no Hive | Partições não adicionadas ao metastore. | Execute 'MSCK REPAIR TABLE <tabela>' para atualizar as partições. | Layout de dados e particionamento: o que decide performance |
| Espaço em disco alto mesmo após compressão | Formato de arquivo inadequado ou compressão não habilitada. | Converta arquivos para Parquet ou ORC e habilite compressão. | Layout de dados e particionamento: o que decide performance |
| Latência de busca aumentou subitamente | Heap JVM próximo do limite ou threadpool search saturado | Aumente heap (se possível) ou otimize queries e mapeamentos | Logs e métricas no detalhe: o que olhar quando algo sai do n |
| Shards não alocam em novos nós | Pouco espaço em disco ou incompatibilidade de versão | Libere espaço ou verifique versões dos nós | Logs e métricas no detalhe: o que olhar quando algo sai do n |
| Logs mostram rejected_execution_exception | Threadpool write/search saturado | Reduza carga, aumente recursos ou distribua índices | Logs e métricas no detalhe: o que olhar quando algo sai do n |
| Dados não aparecem no Elasticsearch | Erro de configuração no output ou conexão com o cluster | Revise hosts e índices no bloco output; teste conexão com 'curl' no Elasticsearch | Logstash pipelines: ingestão de dados estruturados e não est |
| Campos não extraídos corretamente | Regex do grok ou parse JSON incorreto | Ajuste o padrão grok ou valide o JSON de entrada | Logstash pipelines: ingestão de dados estruturados e não est |
| Pipeline lento ou travando | Filtros pesados ou falta de recursos | Otimize filtros, reduza regex complexos e monitore uso de CPU/memória | Logstash pipelines: ingestão de dados estruturados e não est |
| Busca por termo exato não retorna resultado | Campo está como text (analisado), não keyword | Altere o mapeamento para keyword ou use multi-fields | Mapeamento e tipagem: como modelar dados para performance e |
| Agregações lentas ou com erro | Campo não tem doc_values habilitado ou está como text | Use keyword e garanta doc_values ativado (padrão em keyword) | Mapeamento e tipagem: como modelar dados para performance e |
| Erro ao ordenar por campo | Campo analisado (text) não suporta ordenação eficiente | Adicione um subcampo keyword para ordenação | Mapeamento e tipagem: como modelar dados para performance e |
| Cluster não elege master | Menos de três nós master elegíveis ou problemas de rede entre eles | Garanta pelo menos três nós master elegíveis e conectividade entre eles | Master, data e ingest: papéis dos nós e como eles impactam a |
| Busca ou indexação lenta | Nós data sobrecarregados ou atuando também como ingest | Separe os papéis e adicione mais nós data ou ingest conforme a carga | Master, data e ingest: papéis dos nós e como eles impactam a |
| Pipelines de ingest travando | Nós ingest insuficientes para o volume de pré-processamento | Adicione nós ingest dedicados | Master, data e ingest: papéis dos nós e como eles impactam a |
| Mensagens produzidas não aparecem no consumidor | Produtor com acks=0 ou falha de rede durante envio | Ajuste para acks=all e verifique conectividade | Mensagens não entregues: rastreando e corrigindo falhas |
| Lag do consumidor cresce continuamente | Consumidor lento ou travado, offset não sendo commitado | Aumente paralelismo ou revise lógica de commit | Mensagens não entregues: rastreando e corrigindo falhas |
| Mensagens duplicadas no consumidor | Produtor sem idempotência ou consumidor reprocessando após falha | Ative enable.idempotence e commit controlado | Mensagens não entregues: rastreando e corrigindo falhas |
| Erro: 'MetaException: Could not connect to meta store' | Serviço Metastore parado ou configuração incorreta. | Reinicie o Metastore e revise hive-site.xml. | Metadados, Catálogo e Hive: onde a mágica da consulta aconte |
| Tabela não aparece após criação | Banco do Metastore inconsistente ou cache desatualizado. | Verifique logs do Hive e reinicie o serviço. | Metadados, Catálogo e Hive: onde a mágica da consulta aconte |
| DROP TABLE não remove arquivos no HDFS | Tabela é externa. | Remova manualmente os arquivos se necessário. | Metadados, Catálogo e Hive: onde a mágica da consulta aconte |
| Lag de consumidor não aparece | Métrica não configurada no exporter ou consumidor não está reportando offsets. | Ajuste o kafka-jmx.yml e verifique se o consumidor está ativo. | Métricas essenciais: lag, throughput e uso de recursos |
| Uso de CPU sempre zero | Coleta JMX incompleta ou exporter mal configurado. | Revise a configuração do exporter e reinicie o broker. | Métricas essenciais: lag, throughput e uso de recursos |
| Disco cheio sem alerta prévio | Métrica kafka.log:type=Log,name=Size não coletada ou alerta mal configurado. | Inclua a métrica no exporter e ajuste o alerta no Prometheus. | Métricas essenciais: lag, throughput e uso de recursos |
| Caracteres estranhos ou corrompidos após a migração | Charset de origem diferente do destino | Garanta que ambos os bancos usem UTF-8 e reexporte os dados | Migração de MySQL para PostgreSQL: lições de um projeto real |
| Erro de constraint UNIQUE ao importar | Dados duplicados permitidos no MySQL, mas bloqueados no PostgreSQL | Remova duplicatas antes de migrar | Migração de MySQL para PostgreSQL: lições de um projeto real |
| Trigger ou função não funciona após migração | Sintaxe procedural diferente entre bancos | Reescreva triggers em PL/pgSQL | Migração de MySQL para PostgreSQL: lições de um projeto real |
| Mensagem rejeitada pelo produtor | Mensagem não está em conformidade com o schema registrado | Revise o schema e os dados enviados | Modelando mensagens e contratos de dados |
| Consumidor não consegue deserializar mensagem | Versão do schema incompatível ou ausência do schema esperado | Verifique compatibilidade e atualização do consumidor | Modelando mensagens e contratos de dados |
| Falha ao registrar novo schema | Quebra de política de compatibilidade | Ajuste o schema para respeitar a política configurada | Modelando mensagens e contratos de dados |
| Logs não aparecem no Elasticsearch | Configuração incorreta do Logstash ou firewall bloqueando porta 514 | Verifique logs do Logstash em /var/log/logstash/logstash-plain.log e regras de firewall | Monitoramento de infraestrutura: logs, métricas e alertas em |
| Dashboards do Kibana não mostram dados atualizados | Delay na indexação ou filtro de tempo incorreto | Ajuste o filtro de tempo e monitore a fila do Logstash | Monitoramento de infraestrutura: logs, métricas e alertas em |
| Alertas não disparam | Condição do alerta mal definida ou serviço Watcher desativado | Revise a query do alerta e verifique status do Watcher com GET _watcher/stats | Monitoramento de infraestrutura: logs, métricas e alertas em |
| Endpoint de métricas não responde | O javaagent não foi injetado corretamente ou a porta está bloqueada. | Revise o hadoop-env.sh, reinicie o NameNode e verifique firewall. | Monitorando HDFS e Hive: métricas que você não pode ignorar |
| Métricas aparecem zeradas | YAML do jmx_exporter está incorreto ou a query JMX não corresponde ao objeto. | Revise o arquivo de configuração do jmx_exporter e consulte a documentação. | Monitorando HDFS e Hive: métricas que você não pode ignorar |
| Prometheus não coleta métricas | Endpoint não cadastrado ou erro de scrape. | Verifique a configuração do Prometheus e o status do endpoint HTTP. | Monitorando HDFS e Hive: métricas que você não pode ignorar |
| Usuário consegue acessar dados de outro time | Permissões HDFS ou política Ranger mal configurada | Revise permissões e políticas, corrija e teste novamente | Multi-tenancy e isolamento: Data Lake para vários times sem |
| Job de um time consome todo o cluster | Fila YARN sem limites de recursos | Ajuste o capacity-scheduler.xml para limitar recursos por fila | Multi-tenancy e isolamento: Data Lake para vários times sem |
| Quota de espaço atinge o limite inesperadamente | Quota mal dimensionada ou crescimento não monitorado | Aumente a quota após análise de uso real | Multi-tenancy e isolamento: Data Lake para vários times sem |
| Logs do Ranger não mostram acessos | Auditoria desabilitada ou mal configurada | Ative e configure corretamente a auditoria no Ranger | Multi-tenancy e isolamento: Data Lake para vários times sem |
| NameNode não inicia após reinício | Disco cheio ou corrupção nos arquivos de metadados | Libere espaço e restaure metadados de backup | NameNode down, jobs travados: diagnóstico rápido sem pânico |
| Jobs no YARN ficam em ACCEPTED indefinidamente | ResourceManager não consegue acessar o NameNode | Restaure o NameNode e reinicie o ResourceManager | NameNode down, jobs travados: diagnóstico rápido sem pânico |
| DataNodes reportam erro de conexão | NameNode fora do ar ou firewall bloqueando porta 8020 | Inicie o NameNode e revise regras de firewall | NameNode down, jobs travados: diagnóstico rápido sem pânico |
| Erro de objeto já existente ao aplicar script | Script foi rodado fora de ordem ou já aplicado | Confirme o histórico de migrações e ajuste a sequência. | Naming, versionamento e migrações: banco limpo, time feliz |
| Rollback falha por dependências | Script de rollback não considera constraints ou dados relacionados | Revise o script de rollback para remover dependências antes. | Naming, versionamento e migrações: banco limpo, time feliz |
| Ambientes divergentes | Scripts aplicados manualmente ou fora do controle de versão | Padronize o uso de scripts versionados e revalide o estado do schema. | Naming, versionamento e migrações: banco limpo, time feliz |
| Erro de violação de chave estrangeira | Tentativa de inserir valor que não existe na tabela referenciada | Verifique se o valor existe na tabela pai antes de inserir | Normalização na prática: tabelas, tipos e constraints para e |
| Erro de valor duplicado em coluna UNIQUE | Tentativa de inserir valor já existente | Corrija o dado ou remova duplicidade | Normalização na prática: tabelas, tipos e constraints para e |
| CHECK constraint falha | Valor não atende à condição definida | Ajuste o valor para cumprir a regra do CHECK | Normalização na prática: tabelas, tipos e constraints para e |
| Commits estão lentos | Disco lento ou checkpoints muito frequentes | Otimize o hardware de disco ou ajuste checkpoint_timeout | O ciclo de vida de uma transação: do comando ao commit |
| WAL ocupa muito espaço | Checkpoints pouco frequentes ou replica atrasada | Reduza max_wal_size ou investigue atraso na replica | O ciclo de vida de uma transação: do comando ao commit |
| Perda de dados após queda | synchronous_commit desativado | Ative synchronous_commit para garantir durabilidade | O ciclo de vida de uma transação: do comando ao commit |
| Spark não enxerga as tabelas do Hive | Configuração incorreta do Hive Metastore no Spark | Revise o parâmetro spark.hadoop.hive.metastore.uris e reinicie o Spark | Open source além do Hadoop: interoperabilidade e ecossistema |
| Usuário sem acesso à tabela no Hive | Política restritiva no Ranger | Ajuste as permissões no Ranger para o usuário ou grupo correto | Open source além do Hadoop: interoperabilidade e ecossistema |
| Job do Airflow falha ao acessar dados | Variáveis de ambiente ou paths incorretos no DAG | Revise o código do DAG e as credenciais usadas | Open source além do Hadoop: interoperabilidade e ecossistema |
| Produtores não conseguem enviar mensagens | Permissões insuficientes ou quotas atingidas | Revise ACLs e quotas do usuário afetado | Operação segura e eficiente de clusters Kafka |
| Cluster lento ou com lag elevado | Disco cheio ou gargalo de rede | Libere espaço e verifique conectividade entre brokers | Operação segura e eficiente de clusters Kafka |
| Broker some do cluster | Falha de hardware, disco ou ZooKeeper indisponível | Cheque logs do broker e status do ZooKeeper | Operação segura e eficiente de clusters Kafka |
| NameNode reinicia ou trava | Heap size insuficiente | Aumente Xmx/Xms em hadoop-env.sh | Parâmetros críticos do HDFS e Hive: ajuste para produção |
| Usuário não consegue gravar dados | Quota atingida | Revise quotas com hdfs dfsadmin -clrSpaceQuota | Parâmetros críticos do HDFS e Hive: ajuste para produção |
| Queries Hive falham por permissão | Permissões mal configuradas | Revise GRANT/REVOKE e hive.server2.enable.doAs | Parâmetros críticos do HDFS e Hive: ajuste para produção |
| Logs ausentes ou incompletos | Diretório de logs incorreto ou permissão insuficiente | Ajuste paths e permissões dos diretórios de log | Parâmetros críticos do HDFS e Hive: ajuste para produção |
| Mensagens somem antes do esperado | Retenção muito baixa ou disco cheio | Aumente log.retention.hours ou log.retention.bytes; monitore o espaço em disco | Parâmetros essenciais: retenção, compactação e limites |
| Broker para de aceitar novas mensagens | Disco lotado por retenção excessiva | Reduza log.retention.hours ou limpe partições antigas | Parâmetros essenciais: retenção, compactação e limites |
| Consumidor falha ao buscar mensagens grandes | Limite de message.max.bytes abaixo do necessário | Ajuste message.max.bytes e max.request.size no produtor | Parâmetros essenciais: retenção, compactação e limites |
| Consultas lentas mesmo após particionamento | Critério de particionamento inadequado ou falta de índices nas partições | Revise o método de particionamento e crie índices apropriados em cada partição | Particionamento e sharding: dividindo para conquistar |
| Dados inseridos na tabela-mãe não aparecem nas partições | Partições não cobrem todo o range de valores possíveis | Crie partições adicionais para cobrir todos os intervalos necessários | Particionamento e sharding: dividindo para conquistar |
| Erro ao criar partição: valores sobrepostos | Intervalos de partições se sobrepõem | Ajuste os limites de cada partição para garantir ranges exclusivos | Particionamento e sharding: dividindo para conquistar |
| pg_stat_activity não mostra queries antigas | log_min_duration_statement está alto ou queries são rápidas | Reduza log_min_duration_statement e monitore em horários de pico | pg_stat_activity, pg_stat_replication e logs: onde achar pro |
| Lag de replicação alto | Rede lenta ou replica sobrecarregada | Verifique banda e recursos do standby | pg_stat_activity, pg_stat_replication e logs: onde achar pro |
| Logs sem informações de locks | log_lock_waits está desativado | Ative log_lock_waits no postgresql.conf | pg_stat_activity, pg_stat_replication e logs: onde achar pro |
| Erro de autenticação ao conectar pelo pgAdmin | Configuração incorreta no pg_hba.conf ou senha errada | Revise o pg_hba.conf e reinicie o PostgreSQL após ajustes | pgAdmin e psql: administração visual e por linha de comando |
| psql não encontrado no terminal | PostgreSQL não instalado ou PATH não configurado | Instale o pacote postgresql-client e adicione ao PATH | pgAdmin e psql: administração visual e por linha de comando |
| Exportação com \copy falha com permissão negada | Usuário do sistema sem permissão de escrita no diretório | Escolha um diretório onde seu usuário tem permissão | pgAdmin e psql: administração visual e por linha de comando |
| Latência alta nas escritas | Disco lento ou saturado | Migrar para SSD ou distribuir logs em mais discos | Planejamento de recursos: CPU, memória, disco e rede |
| Timeouts de replicação | Rede lenta ou instável entre brokers | Verificar cabeamento, switches e priorizar tráfego Kafka | Planejamento de recursos: CPU, memória, disco e rede |
| GC pausas longas | Heap JVM acima de 8 GB | Reduzir heap e aumentar brokers | Planejamento de recursos: CPU, memória, disco e rede |
| Banco começa a usar swap | shared_buffers ou work_mem configurados acima do limite da RAM | Reduza os parâmetros e reinicie o PostgreSQL | Planejando espaço e memória: sizing realista para bancos em |
| Consultas lentas em tabelas grandes | Falta de índices ou work_mem baixo | Crie índices adequados e ajuste work_mem | Planejando espaço e memória: sizing realista para bancos em |
| Disco lotando rápido | Crescimento subestimado ou falta de particionamento | Implemente particionamento e revise as estimativas | Planejando espaço e memória: sizing realista para bancos em |
| Backup não aparece no repositório | Permissões insuficientes ou caminho incorreto | Ajuste permissões e revise a configuração do repositório | Política de backup, disaster recovery e testes de restauraçã |
| Restauração falha com erro de versão | Versão do PostgreSQL do backup diferente da do destino | Utilize versões compatíveis ou migre dados via pg_dump/pg_restore | Política de backup, disaster recovery e testes de restauraçã |
| Backup corrompido | Problemas de disco ou interrupção durante o backup | Verifique integridade do disco e repita o backup | Política de backup, disaster recovery e testes de restauraçã |
| Busca SQL muito lenta | Falta de índice adequado ou uso de LIKE com coringas no início | Considere migrar a busca textual para Elasticsearch. | Por que bancos relacionais falham na busca: limites do SQL f |
| Resultados irrelevantes no SQL | LIKE não entende contexto ou variações linguísticas | Use mecanismos de análise textual como no Elasticsearch. | Por que bancos relacionais falham na busca: limites do SQL f |
| Elasticsearch não retorna resultados esperados | Campo não foi analisado corretamente na indexação | Reindexe o campo com o analyzer adequado. | Por que bancos relacionais falham na busca: limites do SQL f |
| O cluster Hadoop não inicia ou apresenta erros de conexão. | Configuração incorreta do NameNode/DataNode ou portas de rede bloqueadas. | Revise os arquivos core-site.xml e hdfs-site.xml; verifique firewall e portas. | Por que Hadoop virou padrão de Data Lake open source |
| Consultas Hive lentas ou travando. | Recursos insuficientes ou má configuração do YARN. | Ajuste as configurações de memória e CPU no yarn-site.xml. | Por que Hadoop virou padrão de Data Lake open source |
| Falhas de acesso a dados por usuários. | Políticas incorretas no Ranger ou permissões mal configuradas no HDFS. | Revise as políticas no Ranger e permissões de diretórios no HDFS. | Por que Hadoop virou padrão de Data Lake open source |
| Mensagens não são entregues a múltiplos consumidores | Modelo tradicional de fila, não pub/sub | Migre para arquitetura baseada em tópicos do Kafka | Por que Kafka? Evolução do processamento de dados e o papel |
| Dificuldade em reprocessar eventos antigos | Mensageria não retém mensagens após consumo | Configure retenção adequada no Kafka | Por que Kafka? Evolução do processamento de dados e o papel |
| Latência alta no processamento de dados | Processamento em lote ou fila sobrecarregada | Implemente streaming com Kafka para reduzir latência | Por que Kafka? Evolução do processamento de dados e o papel |
| Consultas SQL não funcionam igual em todos os bancos | Diferenças no suporte ao padrão SQL | Adapte o SQL para o banco escolhido ou escolha um que siga mais o padrão, como PostgreSQL. | Por que PostgreSQL? Diferenças práticas frente a MySQL, Orac |
| Erro ao criar tipos de dados customizados | Banco não suporta extensibilidade | Use PostgreSQL ou verifique as limitações do banco atual. | Por que PostgreSQL? Diferenças práticas frente a MySQL, Orac |
| Custos inesperados com licença | Uso de banco proprietário | Reavalie a escolha e considere bancos de código aberto como PostgreSQL. | Por que PostgreSQL? Diferenças práticas frente a MySQL, Orac |
| Queries demorando minutos para retornar | Falta de memória (work_mem baixo) ou locks | Aumentar work_mem e revisar locks com pg_locks | PostgreSQL em alta demanda: tuning e incidentes em uma rede |
| Banco travando durante picos de acesso | Excesso de conexões simultâneas | Limitar conexões com pgbouncer e ajustar max_connections | PostgreSQL em alta demanda: tuning e incidentes em uma rede |
| Uso intenso de swap | shared_buffers alto demais ou falta de RAM | Reduzir shared_buffers ou aumentar RAM | PostgreSQL em alta demanda: tuning e incidentes em uma rede |
| Mensagens 'could not write to file' | Disco cheio ou problemas de permissão | Liberar espaço em disco e revisar permissões | PostgreSQL em alta demanda: tuning e incidentes em uma rede |
| O PostgreSQL não inicia após editar os arquivos. | Erro de sintaxe em postgresql.conf ou pg_hba.conf. | Revise os arquivos, corrija linhas inválidas e tente iniciar novamente. | postgresql.conf e pg_hba.conf: os dois arquivos que decidem |
| Usuário não consegue conectar mesmo com senha correta. | Regra do pg_hba.conf não cobre o IP ou usa método de autenticação errado. | Ajuste a linha correspondente no pg_hba.conf e faça reload. | postgresql.conf e pg_hba.conf: os dois arquivos que decidem |
| Alteração de parâmetro não tem efeito. | Parâmetro exige restart, mas só foi feito reload. | Consulte a documentação e faça restart se necessário. | postgresql.conf e pg_hba.conf: os dois arquivos que decidem |
| Tabela Hive retorna zero linhas | Diretório LOCATION incorreto ou arquivo ausente no HDFS | Verifique o caminho e use hdfs dfs -ls para conferir a presença do arquivo | Primeira carga: ingestão de dados brutos e validação no Hive |
| Campos aparecem como NULL | Delimitador errado ou tipos incompatíveis na definição da tabela | Ajuste FIELDS TERMINATED BY e os tipos das colunas | Primeira carga: ingestão de dados brutos e validação no Hive |
| Erro de permissão ao consultar tabela | Usuário Hive sem permissão de leitura no diretório HDFS | Ajuste permissões com hdfs dfs -chmod ou revise políticas de acesso | Primeira carga: ingestão de dados brutos e validação no Hive |
| Banco cresce rapidamente e fica lento. | Processo autovacuum não está rodando ou está mal configurado. | Verifique logs e parâmetros autovacuum no postgresql.conf. | Processos, shared buffers e WAL: o que roda por trás do seu |
| Picos de I/O durante horários de pico. | Shared buffers pequeno demais ou background writer ineficiente. | Aumente shared_buffers e ajuste parâmetros do background writer. | Processos, shared buffers e WAL: o que roda por trás do seu |
| Erro de falta de espaço em disco no pg_wal. | WAL não está sendo rotacionado ou arquivado corretamente. | Revise max_wal_size e archive_command. | Processos, shared buffers e WAL: o que roda por trás do seu |
| Consumer não recebe mensagens | Tópico errado ou broker fora do ar | Confirme o nome do tópico e se o Kafka está rodando | Produzindo e consumindo mensagens na prática |
| Producer trava ao enviar mensagem | Broker inacessível ou porta incorreta | Verifique o endereço e porta do bootstrap-server | Produzindo e consumindo mensagens na prática |
| Mensagens não aparecem ao consumir | Consumer sem --from-beginning ou partição vazia | Adicione --from-beginning ou produza novas mensagens | Produzindo e consumindo mensagens na prática |
| Broker não aparece na lista de brokers ativos | Configuração de broker.id ou listeners incorreta | Revise o template server.properties e variáveis do Ansible | Provisionamento automatizado de clusters Kafka |
| Erro de permissão ao rodar playbook | Usuário sem sudo ou permissão de escrita | Ajuste o become: yes e permissões dos diretórios | Provisionamento automatizado de clusters Kafka |
| Tópicos não são criados | Script executado antes do Kafka estar totalmente iniciado | Adicione checagem de serviço ativo antes de criar tópicos | Provisionamento automatizado de clusters Kafka |
| Shards não se alocam | Número de nós insuficiente para réplicas configuradas | Reduza o número de réplicas ou adicione mais nós | Quantos nós, quantos shards: dimensionando para ingestão e b |
| Busca lenta | Shards grandes demais ou poucos shards | Divida em mais shards ou otimize queries | Quantos nós, quantos shards: dimensionando para ingestão e b |
| Ingestão travando | Refresh interval muito baixo ou shards pequenos demais | Aumente o refresh interval e ajuste o número de shards | Quantos nós, quantos shards: dimensionando para ingestão e b |
| Erro 'invalid page in block' ao acessar tabela | Corrupção física no arquivo de dados | Tente reindexar ou restaurar backup | Recuperação de falhas: corrupção, crash e restaurando a conf |
| FATAL: could not write to log file: No space left on device | Disco cheio | Libere espaço antes de reiniciar o PostgreSQL | Recuperação de falhas: corrupção, crash e restaurando a conf |
| Panic: WAL contains references to invalid pages | WAL corrompido ou disco com falha | Restaure backup e WAL íntegros | Recuperação de falhas: corrupção, crash e restaurando a conf |
| Query não usa paralelismo | Parâmetros de paralelismo estão baixos ou consulta não é elegível | Aumente max_parallel_workers_per_gather e revise a query | Recursos recentes: paralelismo, JIT e melhorias do PostgreSQ |
| JIT não aparece no plano de execução | JIT desativado ou custo da query abaixo do limite | Ative jit e ajuste jit_above_cost | Recursos recentes: paralelismo, JIT e melhorias do PostgreSQ |
| Índice GIN não é utilizado | Consulta não está usando operadores suportados pelo índice | Reescreva a query usando operadores compatíveis com GIN | Recursos recentes: paralelismo, JIT e melhorias do PostgreSQ |
| Todos os blocos replicados no mesmo rack | Script de topologia ausente ou mal configurado | Revise o script e a configuração net.topology.script.file.name | Rede e topologia: latência, throughput e o erro clássico do |
| Throughput baixo entre racks | Uplink saturado ou switch subdimensionado | Aumente a capacidade do uplink ou redistribua os DataNodes | Rede e topologia: latência, throughput e o erro clássico do |
| Latência alta entre racks | Rede física mal dimensionada ou congestionada | Investigue cabos, switches e rotas; prefira links diretos | Rede e topologia: latência, throughput e o erro clássico do |
| Standby não conecta ao primário | Configuração incorreta no pg_hba.conf ou senha errada | Revise pg_hba.conf e teste conexão com psql | Replicação nativa: streaming replication, slots e failover m |
| Standby fica muito atrasado | Rede lenta ou max_wal_senders insuficiente | Aumente max_wal_senders e verifique largura de banda | Replicação nativa: streaming replication, slots e failover m |
| Disco do primário enche rapidamente | Replication slot órfão (standby morto) | Remova slots inativos: SELECT pg_drop_replication_slot('nome_do_slot'); | Replicação nativa: streaming replication, slots e failover m |
| Erro 404 ao tentar indexar | Endpoint incorreto ou índice não existe | Verifique se está usando /{index}/_doc/ e se o índice existe | REST API na prática: indexação e busca sem intermediários |
| Erro 400 ao indexar documento | JSON malformado | Valide o JSON antes de enviar | REST API na prática: indexação e busca sem intermediários |
| Busca retorna zero resultados | Campo ou valor não existem nos documentos | Confirme o mapeamento e revise a query | REST API na prática: indexação e busca sem intermediários |
| Usuário vê todas as linhas, mesmo com RLS | RLS não habilitado ou política mal definida | Confirme ENABLE ROW LEVEL SECURITY e revise as políticas | Roles, privilégios e row-level security: controle granular d |
| Permissão negada ao acessar tabela | Role não recebeu GRANT necessário | Use GRANT para liberar o privilégio correto | Roles, privilégios e row-level security: controle granular d |
| Comandos não aparecem nos logs | log_statement configurado incorretamente | Ajuste para 'mod', 'ddl' ou 'all' conforme necessidade | Roles, privilégios e row-level security: controle granular d |
| Snapshot falha com erro de permissão | O usuário Elasticsearch não tem acesso ao diretório do repositório. | Ajuste permissões do diretório para o usuário do serviço. | Rotinas automáticas: snapshots, restauração e limpeza de índ |
| Restauração não funciona | Índice está aberto ou já existe. | Feche ou remova o índice antes de restaurar. | Rotinas automáticas: snapshots, restauração e limpeza de índ |
| Índices antigos não são deletados | Policy ILM não está associada ou há erro de configuração. | Revise a associação da policy e consulte _ilm/explain. | Rotinas automáticas: snapshots, restauração e limpeza de índ |
| Backup falha com arquivos em uso | O serviço Kafka ou ZooKeeper estava rodando durante o backup. | Pare o serviço antes de copiar os arquivos críticos. | Rotinas automatizadas de manutenção e backup |
| Logs não são limpos como esperado | Configuração de retenção incorreta ou sobrescrita por outro parâmetro. | Verifique se retention.ms está definido corretamente e tem prioridade sobre outros parâmetros. | Rotinas automatizadas de manutenção e backup |
| Não recebe alertas das rotinas agendadas | Variável MAILTO não configurada ou serviço de e-mail indisponível. | Configure MAILTO corretamente e teste o envio de e-mails do servidor. | Rotinas automatizadas de manutenção e backup |
| VACUUM não reduz tamanho do arquivo de tabela. | VACUUM padrão só marca espaço como reutilizável, não libera para o SO. | Use VACUUM FULL em horários de baixa demanda. | Rotinas de manutenção: VACUUM, reindex e scripts para não pe |
| Scripts de manutenção não rodam pelo cron. | Permissões, variáveis de ambiente ou caminhos incorretos. | Verifique permissões, use caminhos absolutos e registre logs para depurar. | Rotinas de manutenção: VACUUM, reindex e scripts para não pe |
| Autovacuum não roda em tabelas grandes. | Parâmetros de autovacuum insuficientes ou desativado. | Ajuste autovacuum_* no postgresql.conf e reinicie o serviço. | Rotinas de manutenção: VACUUM, reindex e scripts para não pe |
| Novo DataNode não aparece no NameNode | Problemas de rede, firewall ou configuração incorreta | Verifique conectividade, portas abertas e arquivos core-site.xml/hdfs-site.xml | Scale-out e balanceamento: adicionando nós sem perder o cont |
| O balancer não redistribui blocos | Threshold muito baixo ou cluster muito ocupado | Ajuste o threshold ou execute o balancer em horários de menor uso | Scale-out e balanceamento: adicionando nós sem perder o cont |
| NameNode com uso de memória muito alto | Excesso de arquivos pequenos ou falta de RAM | Aumente a RAM do NameNode ou compacte arquivos pequenos | Scale-out e balanceamento: adicionando nós sem perder o cont |
| Handshake SSL falha com erro de certificado | Truststore do cliente não contém o certificado do broker ou certificado expirado | Importe o certificado correto no truststore do cliente e verifique validade | SSL/TLS e SASL: protegendo dados em trânsito e autenticação |
| Erro de autenticação SASL | Usuário ou senha incorretos na configuração do cliente | Revise o arquivo JAAS e as propriedades do cliente | SSL/TLS e SASL: protegendo dados em trânsito e autenticação |
| Broker não inicia após configuração de SSL/SASL | Permissões incorretas nos arquivos .jks ou .conf | Ajuste permissões para leitura apenas pelo usuário do Kafka | SSL/TLS e SASL: protegendo dados em trânsito e autenticação |
| Rollback não restaura todos os dados | Snapshot desatualizado ou incompleto | Garanta que snapshots sejam recentes e completos antes de qualquer alteração | Testes, versionamento e rollback: como evitar surpresas em p |
| Testes automatizados falham após deploy | Alteração não compatível com dados ou queries existentes | Reverta a mudança e revise os testes e os dados de entrada | Testes, versionamento e rollback: como evitar surpresas em p |
| Configuração dinâmica não volta ao valor anterior | Script de rollback incompleto ou erro de digitação | Valide comandos e mantenha scripts de rollback testados e versionados | Testes, versionamento e rollback: como evitar surpresas em p |
| Transações travadas | Deadlock entre processos | Identifique e encerre uma das transações usando pg_terminate_backend. | Transações, ACID e MVCC: como o PostgreSQL garante integrida |
| Uso de disco crescendo rápido | Autovacuum mal configurado | Revise parâmetros de autovacuum e execute VACUUM manualmente se necessário. | Transações, ACID e MVCC: como o PostgreSQL garante integrida |
| Erro de serialization failure | Concorrência alta com nível de isolamento SERIALIZABLE | Considere reduzir o isolamento ou reescrever a lógica para minimizar conflitos. | Transações, ACID e MVCC: como o PostgreSQL garante integrida |
| Servidor começa a usar swap após aumento de work_mem | work_mem alto demais para o número de conexões simultâneas | Reduza work_mem ou limite max_connections | Tuning inicial: work_mem, maintenance_work_mem, max_connecti |
| VACUUM e CREATE INDEX continuam lentos | maintenance_work_mem ainda insuficiente | Aumente maintenance_work_mem gradualmente | Tuning inicial: work_mem, maintenance_work_mem, max_connecti |
| Picos de I/O em horários regulares | checkpoint_timeout muito baixo | Aumente checkpoint_timeout e monitore o tempo de recovery | Tuning inicial: work_mem, maintenance_work_mem, max_connecti |
| Conexões recusadas | max_connections atingido | Reduza o número de clientes ou implemente pool de conexões | Tuning inicial: work_mem, maintenance_work_mem, max_connecti |
