468 sintomas catalogados
Cada sintoma com causa provável e correção, ligado à lição da trilha Observabilidade que explica o porquê. Descreva o sintoma para filtrar.
| Sintoma | Causa provável | Correção | Lição |
|---|---|---|---|
| Não aparecem traces no backend | Sampling configurado muito agressivo ou erro de sintaxe na configuração | Reduza o sampling_percentage e valide a configuração YAML | Ajustando sampling e agregação de métricas |
| Métricas não agregadas corretamente | aggregation_type incompatível com o tipo de métrica | Revise o tipo de métrica e ajuste aggregation_type | Ajustando sampling e agregação de métricas |
| Latência aumentou após ajuste | Uso excessivo de tail_sampling ou agregação pesada | Simplifique as regras ou aumente recursos do Collector | Ajustando sampling e agregação de métricas |
| Alerta não dispara mesmo com condição atingida | Query mal definida ou intervalo de tempo incorreto | Revise a query e ajuste o parâmetro de tempo | Alertas automáticos: detectando e reagindo a incidentes em t |
| E-mail não enviado | Configuração SMTP incorreta ou bloqueio de firewall | Verifique as credenciais e conectividade com o servidor SMTP | Alertas automáticos: detectando e reagindo a incidentes em t |
| Webhook não recebe chamada | URL incorreta ou endpoint inacessível | Teste o endpoint manualmente e corrija a URL | Alertas automáticos: detectando e reagindo a incidentes em t |
| Alertas não aparecem na interface do Alertmanager | Prometheus não está enviando alertas ou endpoint está incorreto | Verifique a configuração do bloco alerting no prometheus.yml e logs do Prometheus | Alertas inteligentes: Prometheus Alertmanager na prática |
| E-mails de alerta não chegam | Configuração SMTP incorreta ou bloqueio na porta 587 | Revise credenciais SMTP e teste conexão com telnet | Alertas inteligentes: Prometheus Alertmanager na prática |
| Alertas duplicados ou em excesso | Agrupamento mal configurado ou repeat_interval muito baixo | Ajuste group_by e repeat_interval no alertmanager.yml | Alertas inteligentes: Prometheus Alertmanager na prática |
| Alertas não aparecem na interface do Alertmanager | Prometheus não está enviando alertas ou endpoint está incorreto | Verifique a configuração do bloco alerting no prometheus.yml e logs do Prometheus | Alertas inteligentes: Prometheus Alertmanager na prática |
| E-mails de alerta não chegam | Configuração SMTP incorreta ou bloqueio na porta 587 | Revise credenciais SMTP e teste conexão com telnet | Alertas inteligentes: Prometheus Alertmanager na prática |
| Alertas duplicados ou em excesso | Agrupamento mal configurado ou repeat_interval muito baixo | Ajuste group_by e repeat_interval no alertmanager.yml | Alertas inteligentes: Prometheus Alertmanager na prática |
| Latência da aplicação aumentou após instrumentação | Batch ou buffer mal dimensionado, exportação síncrona ou sampling baixo | Ajuste batch para valores maiores, aumente o timeout ou use sampling mais agressivo | Análise de performance: quando a instrumentação atrapalha |
| Consumo de memória do Collector cresce continuamente | Buffers grandes demais ou exportação lenta | Reduza send_batch_max_size ou otimize o backend de exportação | Análise de performance: quando a instrumentação atrapalha |
| Perda de traces ou métricas sob alta carga | Buffers estourando ou exportação bloqueada | Aumente send_batch_size ou otimize o backend; use sampling | Análise de performance: quando a instrumentação atrapalha |
| Erro 400 Bad Request ao inserir documento | JSON malformado ou campo inesperado | Valide o JSON e revise o mapeamento do índice | APIs REST do Elasticsearch: ingestão e consulta sem intermed |
| Erro 401 Unauthorized | Falta de autenticação ou credenciais inválidas | Inclua cabeçalhos de autenticação válidos | APIs REST do Elasticsearch: ingestão e consulta sem intermed |
| Bulk retorna erros parciais | Formato NDJSON incorreto ou dados inconsistentes | Revise cada linha do payload e valide o NDJSON | APIs REST do Elasticsearch: ingestão e consulta sem intermed |
| Logs não estão sendo gravados | Permissões de diretório ou configuração incorreta | Ajuste permissões e revise o caminho de log no arquivo de configuração | Auditoria e logs do Elastic Stack: onde procurar e como inte |
| Mensagens de erro aparecem repetidamente | Problema não resolvido no serviço | Leia a mensagem completa, corrija a causa raiz e reinicie o serviço | Auditoria e logs do Elastic Stack: onde procurar e como inte |
| Arquivo audit.log não existe | Auditoria não ativada no Elasticsearch | Ative xpack.security.audit.enabled no elasticsearch.yml e reinicie | Auditoria e logs do Elastic Stack: onde procurar e como inte |
| Usuário recebe erro 401 ao tentar acessar logs | Credenciais incorretas ou autenticação não configurada corretamente | Revise usuário/senha ou token; confira configuração de autenticação no Loki e no proxy | Autenticação, autorização e isolamento de dados |
| Logs aparecem para o tenant errado | tenant_id não especificado ou incorreto no Fluent Bit | Ajuste o parâmetro tenant_id na configuração do Fluent Bit | Autenticação, autorização e isolamento de dados |
| Acesso negado mesmo com credenciais corretas | Restrição excessiva no proxy ou roles não mapeadas corretamente | Revise regras do proxy e headers de roles | Autenticação, autorização e isolamento de dados |
| Auditoria não registra acessos | Log de acesso desabilitado no proxy | Habilite access_log e defina formato adequado | Autenticação, autorização e isolamento de dados |
| Métricas internas não aparecem no Prometheus | Target não configurado ou endpoint incorreto | Revise o job_name e o endereço do target no prometheus.yml | Auto-monitoramento: métricas internas do Prometheus, Grafana |
| Alertas não disparam mesmo com uso alto de disco | Expressão de alerta incorreta ou métrica não disponível | Ajuste a expressão e confirme as métricas no endpoint /metrics | Auto-monitoramento: métricas internas do Prometheus, Grafana |
| Grafana não expõe métricas em /metrics | Versão antiga ou configuração desabilitada | Consulte a documentação do Grafana e habilite a exportação de métricas | Auto-monitoramento: métricas internas do Prometheus, Grafana |
| Loki não aparece como target UP | Loki não está rodando ou porta incorreta | Verifique o status do serviço e a porta configurada | Auto-monitoramento: métricas internas do Prometheus, Grafana |
| Métricas internas não aparecem no Prometheus | Target não configurado ou endpoint incorreto | Revise o job_name e o endereço do target no prometheus.yml | Auto-monitoramento: métricas internas do Prometheus, Grafana |
| Alertas não disparam mesmo com uso alto de disco | Expressão de alerta incorreta ou métrica não disponível | Ajuste a expressão e confirme as métricas no endpoint /metrics | Auto-monitoramento: métricas internas do Prometheus, Grafana |
| Grafana não expõe métricas em /metrics | Versão antiga ou configuração desabilitada | Consulte a documentação do Grafana e habilite a exportação de métricas | Auto-monitoramento: métricas internas do Prometheus, Grafana |
| Loki não aparece como target UP | Loki não está rodando ou porta incorreta | Verifique o status do serviço e a porta configurada | Auto-monitoramento: métricas internas do Prometheus, Grafana |
| Dashboard não aparece no Grafana | Erro no caminho do diretório ou sintaxe do JSON | Verifique o caminho em dashboards.yaml e valide o JSON | Automatizando dashboards e alertas: provisionamento via arqu |
| Alerta não dispara no Prometheus | Expressão incorreta ou erro de sintaxe no YAML | Revise a expressão e valide o YAML com ferramentas como yamllint | Automatizando dashboards e alertas: provisionamento via arqu |
| Pipeline CI/CD falha ao copiar arquivos | Permissões insuficientes ou caminho incorreto | Ajuste permissões e revise os caminhos nos scripts | Automatizando dashboards e alertas: provisionamento via arqu |
| Alterações não aplicadas após commit | Serviço não reiniciado/recarregado | Garanta que o pipeline execute o restart/reload dos serviços | Automatizando dashboards e alertas: provisionamento via arqu |
| Dashboard não aparece no Grafana | Erro no caminho do diretório ou sintaxe do JSON | Verifique o caminho em dashboards.yaml e valide o JSON | Automatizando dashboards e alertas: provisionamento via arqu |
| Alerta não dispara no Prometheus | Expressão incorreta ou erro de sintaxe no YAML | Revise a expressão e valide o YAML com ferramentas como yamllint | Automatizando dashboards e alertas: provisionamento via arqu |
| Pipeline CI/CD falha ao copiar arquivos | Permissões insuficientes ou caminho incorreto | Ajuste permissões e revise os caminhos nos scripts | Automatizando dashboards e alertas: provisionamento via arqu |
| Alterações não aplicadas após commit | Serviço não reiniciado/recarregado | Garanta que o pipeline execute o restart/reload dos serviços | Automatizando dashboards e alertas: provisionamento via arqu |
| Pods de Loki não iniciam após upgrade | Configuração inválida ou incompatível com a nova versão | Revise logs do pod com 'kubectl logs' e valide o arquivo de configuração; faça rollback se necessário | Automatizando deploys: Ansible, Helm e CI/CD |
| Playbook Ansible falha em hosts específicos | Permissões insuficientes ou dependências ausentes | Garanta que o usuário Ansible tenha sudo e que dependências estejam listadas no playbook | Automatizando deploys: Ansible, Helm e CI/CD |
| Rollback Helm não restaura estado anterior | Alterações manuais fora do Helm ou recursos não gerenciados pelo chart | Evite alterações manuais; sempre use Helm para gerenciar recursos | Automatizando deploys: Ansible, Helm e CI/CD |
| Índices não são deletados após o tempo configurado | Política ILM não aplicada corretamente ou alias de escrita ausente | Revise o template e a configuração do alias; consulte a documentação | Automatizando ingestão e rotação de índices com ILM e script |
| Script shell não deleta índices esperados | Formato de data incompatível ou permissão insuficiente | Ajuste parsing de datas e verifique permissões do usuário | Automatizando ingestão e rotação de índices com ILM e script |
| Rollover não ocorre | Índice inicial não tem alias de escrita definido | Crie o índice inicial com o alias correto usando is_write_index | Automatizando ingestão e rotação de índices com ILM e script |
| O endpoint /metrics não responde | Porta errada ou bloqueada, configuração ausente | Verifique service.telemetry.metrics.address e firewall | Coletando métricas do Collector: healthcheck e auto-observab |
| Healthcheck retorna erro | Collector não inicializou corretamente ou porta em uso | Revise logs do Collector e ajuste a porta do healthcheck | Coletando métricas do Collector: healthcheck e auto-observab |
| Métricas não aparecem no Prometheus | Scrape mal configurado ou endpoint inacessível | Confirme targets e conectividade de rede | Coletando métricas do Collector: healthcheck e auto-observab |
| Dados não chegam ao backend | Configuração incorreta dos endpoints ou workers offline | Revise os endpoints e o status dos Collectors | Collector em cluster: balanceamento e alta disponibilidade |
| Dados duplicados no backend | Failover agressivo enviando dados para múltiplos Collectors | Ajuste o mecanismo de failover e monitore duplicidade | Collector em cluster: balanceamento e alta disponibilidade |
| Coletor consome muita CPU | Subdimensionamento ou excesso de dados em um único nó | Adicione mais instâncias e balanceie melhor | Collector em cluster: balanceamento e alta disponibilidade |
| Dados não aparecem no backend | Exporter mal configurado ou pipeline incompleto | Revise endpoints e pipelines na configuração | Collector em detalhes: receivers, processors e exporters |
| Collector consome muita RAM | Falta de processor memory_limiter | Adicione e configure o processor memory_limiter | Collector em detalhes: receivers, processors e exporters |
| Muitos spans descartados | Filter ou sampling agressivo demais | Revise regras de filter e sampling | Collector em detalhes: receivers, processors e exporters |
| Heap frequentemente acima de 80% | Excesso de shards ou pouca RAM | Reduza o número de shards ou aumente a RAM (sem ultrapassar 32 GB de heap) | Como estimar armazenamento, CPU e memória sem chute |
| Busca lenta ou timeouts | CPU insuficiente ou shards demais | Adicione nós ou reduza shards por nó | Como estimar armazenamento, CPU e memória sem chute |
| Disco enchendo rápido | Retenção ou replicação excessiva | Reduza retenção ou número de réplicas | Como estimar armazenamento, CPU e memória sem chute |
| Status do cluster permanece yellow | Faltam nós para alocar réplicas ou configuração de réplicas incompatível | Adicione mais data nodes ou reduza o número de réplicas | Como o Elasticsearch armazena, indexa e busca: de shard a cl |
| Busca lenta após aumento de shards | Shards pequenos demais ou excesso de shards por nó | Reavalie o particionamento e use shrink API para consolidar shards | Como o Elasticsearch armazena, indexa e busca: de shard a cl |
| Cluster não elege novo nó mestre após falha | Número ímpar de nós mestres não configurado ou quorum insuficiente | Garanta pelo menos três nós mestres elegíveis e verifique discovery.seed_hosts | Como o Elasticsearch armazena, indexa e busca: de shard a cl |
| Métricas não aparecem no Prometheus | Target offline ou endpoint incorreto | Verifique o endereço e a porta dos exporters no prometheus.yml | Componentes críticos: Prometheus, Grafana, Loki e OpenTeleme |
| Grafana não conecta ao Prometheus | URL do datasource incorreta ou Prometheus fora do ar | Confirme a URL e se o serviço Prometheus está rodando | Componentes críticos: Prometheus, Grafana, Loki e OpenTeleme |
| Logs não chegam ao Loki | Configuração errada do promtail ou endpoint Loki incorreto | Revise o arquivo de configuração do promtail e do Loki | Componentes críticos: Prometheus, Grafana, Loki e OpenTeleme |
| Métricas não aparecem no Prometheus | Target offline ou endpoint incorreto | Verifique o endereço e a porta dos exporters no prometheus.yml | Componentes críticos: Prometheus, Grafana, Loki e OpenTeleme |
| Grafana não conecta ao Prometheus | URL do datasource incorreta ou Prometheus fora do ar | Confirme a URL e se o serviço Prometheus está rodando | Componentes críticos: Prometheus, Grafana, Loki e OpenTeleme |
| Logs não chegam ao Loki | Configuração errada do promtail ou endpoint Loki incorreto | Revise o arquivo de configuração do promtail e do Loki | Componentes críticos: Prometheus, Grafana, Loki e OpenTeleme |
| Buscas muito lentas | Labels com alta cardinalidade ou storage subdimensionado | Reveja as labels e aumente recursos do storage | Componentes críticos: storage, indexação e alta disponibilid |
| Perda de logs após falha de nó | Replication_factor insuficiente | Aumente o replication_factor e valide a configuração do ring | Componentes críticos: storage, indexação e alta disponibilid |
| Erro de conexão com object storage | Credenciais ou endpoint incorretos | Revise as configurações de storage_config | Componentes críticos: storage, indexação e alta disponibilid |
| Busca retorna logs de outros clientes | Header X-Scope-OrgID ausente ou incorreto | Ajuste o header nas requisições de consulta | Configuração detalhada do Loki: labels, tenants e limites |
| Erro de limite excedido na ingestão | Limite de ingestion_rate_limit muito baixo | Aumente o valor conforme a capacidade do cluster | Configuração detalhada do Loki: labels, tenants e limites |
| Buscas lentas ou timeouts | Labels de alta cardinalidade ou consultas amplas demais | Revise os labels e restrinja o período das buscas | Configuração detalhada do Loki: labels, tenants e limites |
| Nada aparece nos logs do Collector | Endpoint, protocolo ou porta incorretos | Revise o endpoint no SDK, o protocolo (gRPC), e se a porta 4317 está liberada | Configurando o Collector para ingestão OTLP via gRPC |
| Erro de certificado TLS | Caminho ou permissões incorretos nos arquivos de certificado/chave | Verifique caminhos e permissões dos arquivos em tls_settings | Configurando o Collector para ingestão OTLP via gRPC |
| Timeout ao conectar | Firewall bloqueando porta 4317 | Libere a porta no firewall do sistema operacional | Configurando o Collector para ingestão OTLP via gRPC |
| Campos geoip ou useragent vazios | Campo de origem não extraído corretamente pelo grok | Ajuste o padrão grok para garantir extração dos campos necessários | Configurando pipelines de ingestão: parsing, filtros e enriq |
| Eventos não aparecem no Elasticsearch | Erro de output ou pipeline travado | Verifique logs do Logstash e a configuração do output | Configurando pipelines de ingestão: parsing, filtros e enriq |
| Dead letter queue não funciona | Logstash abaixo da versão 7.12 ou configuração ausente | Atualize Logstash e habilite DLQ no logstash.yml | Configurando pipelines de ingestão: parsing, filtros e enriq |
| Parsing falha para alguns logs | Formato do log mudou ou é inconsistente | Refine o padrão grok e use tag_on_failure para identificar problemas | Configurando pipelines de ingestão: parsing, filtros e enriq |
| Query demora vários minutos | Consulta ampla ou storage lento | Restringir labels, otimizar storage | Consultas lentas e falhas no Loki: causas e soluções |
| Erro 'query failed' no log | Timeout ou falha no backend | Ajustar timeout ou revisar backend | Consultas lentas e falhas no Loki: causas e soluções |
| Uso de CPU do Loki alto | Muitas queries paralelas ou indexação ruim | Limitar queries ou melhorar indexação | Consultas lentas e falhas no Loki: causas e soluções |
| Falha ao conectar nodes após ativar TLS | Certificados inválidos ou caminhos errados no elasticsearch.yml | Verifique os caminhos dos certificados e se todos os nodes usam a mesma CA | Controlando acesso: usuários, roles e TLS no Elastic Stack |
| Usuário não consegue autenticar | Senha incorreta ou role não atribuída | Redefina a senha e confira as roles do usuário | Controlando acesso: usuários, roles e TLS no Elastic Stack |
| Permissões excessivas para usuários comuns | Uso da role superuser por padrão | Atribua roles específicas e remova superuser de usuários não administrativos | Controlando acesso: usuários, roles e TLS no Elastic Stack |
| Falha de conexão TLS | Certificado inválido ou não confiável | Verifique se o CA do cliente corresponde ao do servidor e se o hostname bate com o CN do certificado. | Criptografia e autenticação no OTLP/gRPC |
| Handshake TLS rejeitado | Chave privada ou certificado ausente/corrompido | Recrie os arquivos e ajuste permissões. | Criptografia e autenticação no OTLP/gRPC |
| Cliente não consegue autenticar no mTLS | Certificado do cliente não assinado pela CA correta | Reemita o certificado do cliente com a CA configurada no Collector. | Criptografia e autenticação no OTLP/gRPC |
| Painel não exibe dados | Query LogQL incorreta ou fonte de dados Loki mal configurada | Revise a query e teste a conexão com Loki | Dashboards e alertas: ação rápida em incidentes |
| Alertas não disparam | Limiar muito alto ou regra de alerta mal definida | Reduza o threshold e revise a expressão da regra | Dashboards e alertas: ação rápida em incidentes |
| Notificação não chega | Configuração errada do canal de notificação | Teste o canal em 'Contact points' e revise as permissões | Dashboards e alertas: ação rápida em incidentes |
| KPIs não aparecem no Grafana | Collector não está expondo métricas ou Prometheus não está coletando. | Verifique a configuração do receiver prometheus e o scrape_config. | Dashboards e alertas: o que realmente importa monitorar |
| Alertas não disparam mesmo com falha simulada | Condição do alerta está errada ou tempo de avaliação muito curto. | Revise as regras de alerta e aumente o tempo de FOR. | Dashboards e alertas: o que realmente importa monitorar |
| Fila de exportação sempre alta | Backend está lento ou Collector subdimensionado. | Aumente recursos do Collector ou otimize o backend. | Dashboards e alertas: o que realmente importa monitorar |
| Erro 'Data source is not working' ao testar Prometheus | URL incorreta ou Prometheus inacessível | Verifique o endpoint e se o serviço Prometheus está rodando | Dashboards e datasources no Grafana: do zero ao insight |
| Variáveis não aparecem no topo do dashboard | Variável mal configurada ou consulta vazia | Revise a query da variável e o datasource selecionado | Dashboards e datasources no Grafana: do zero ao insight |
| Dashboard não exibe dados | Consulta PromQL inválida ou datasource errado | Teste a consulta diretamente no Prometheus e ajuste o painel | Dashboards e datasources no Grafana: do zero ao insight |
| Erro 'Data source is not working' ao testar Prometheus | URL incorreta ou Prometheus inacessível | Verifique o endpoint e se o serviço Prometheus está rodando | Dashboards e datasources no Grafana: do zero ao insight |
| Variáveis não aparecem no topo do dashboard | Variável mal configurada ou consulta vazia | Revise a query da variável e o datasource selecionado | Dashboards e datasources no Grafana: do zero ao insight |
| Dashboard não exibe dados | Consulta PromQL inválida ou datasource errado | Teste a consulta diretamente no Prometheus e ajuste o painel | Dashboards e datasources no Grafana: do zero ao insight |
| Dashboard vazio ou sem dados | Index pattern não cobre os índices corretos ou range de datas não contém dados. | Revise o padrão do index pattern e ajuste o filtro de datas. | Dashboards no Kibana: do zero ao insight |
| Usuário não consegue acessar o dashboard | Permissões insuficientes no role atribuído. | Ajuste o role para incluir acesso ao index pattern do dashboard. | Dashboards no Kibana: do zero ao insight |
| Visualização mostra erro de campo inexistente | Campo não existe em todos os índices ou foi digitado incorretamente. | Verifique os campos disponíveis no index pattern e corrija o nome. | Dashboards no Kibana: do zero ao insight |
| Logs não aparecem no Grafana | Problema de configuração no output do Fluent Bit ou Promtail | Revise URLs e portas dos outputs, cheque logs de erro dos agentes | Dataflow de logs: do agente ao dashboard |
| Latência alta entre geração e visualização | Bufferização excessiva ou problemas de rede | Ajuste parâmetros de flush e buffer nos agentes, verifique conectividade | Dataflow de logs: do agente ao dashboard |
| Logs sumindo após alguns dias | Retenção mal configurada no Loki | Ajuste retention_period e políticas de storage no Loki | Dataflow de logs: do agente ao dashboard |
| Gaps regulares em métricas | Exporter instável ou timeout de scraping | Reinicie o exporter, ajuste intervalos e timeouts | Debugando gaps de métricas, scraping e queries lentas |
| Dashboards demoram a carregar | Queries PromQL pesadas ou alta cardinalidade | Otimize queries e reduza labels desnecessários | Debugando gaps de métricas, scraping e queries lentas |
| Target aparece DOWN no /targets | Problema de rede ou exporter parado | Verifique conectividade e status do serviço | Debugando gaps de métricas, scraping e queries lentas |
| Erros de scrape nos logs | Timeouts ou endpoint indisponível | Aumente timeout ou corrija o endpoint | Debugando gaps de métricas, scraping e queries lentas |
| Gaps regulares em métricas | Exporter instável ou timeout de scraping | Reinicie o exporter, ajuste intervalos e timeouts | Debugando gaps de métricas, scraping e queries lentas |
| Dashboards demoram a carregar | Queries PromQL pesadas ou alta cardinalidade | Otimize queries e reduza labels desnecessários | Debugando gaps de métricas, scraping e queries lentas |
| Target aparece DOWN no /targets | Problema de rede ou exporter parado | Verifique conectividade e status do serviço | Debugando gaps de métricas, scraping e queries lentas |
| Erros de scrape nos logs | Timeouts ou endpoint indisponível | Aumente timeout ou corrija o endpoint | Debugando gaps de métricas, scraping e queries lentas |
| Logs antigos não são excluídos após o período de retenção. | Configuração incorreta do retention_period ou retenção desabilitada. | Revise o bloco table_manager e habilite retention_deletes_enabled. | Definindo requisitos: volume, retenção e compliance |
| Armazenamento esgota antes do previsto. | Subestimação do volume ou fator de indexação. | Recalcule estimativas e ajuste retenção ou storage backend. | Definindo requisitos: volume, retenção e compliance |
| Logs sensíveis aparecem em buscas públicas. | Falta de filtragem ou labels inadequados. | Implemente filtros no Fluent Bit e revise labels no Loki. | Definindo requisitos: volume, retenção e compliance |
| Traces não aparecem no backend | Agente não configurado corretamente ou endpoint do Collector errado | Revise variáveis de ambiente e configuração do agente | Delimitando o escopo: o que e onde instrumentar primeiro |
| Só parte do fluxo aparece | Faltou instrumentação em algum serviço intermediário | Mapeie dependências e adicione spans onde faltar | Delimitando o escopo: o que e onde instrumentar primeiro |
| Muitos spans irrelevantes | Instrumentação automática sem filtro | Ajuste sampling e refine pontos de instrumentação | Delimitando o escopo: o que e onde instrumentar primeiro |
| Collector não inicia no Docker | Arquivo de configuração não encontrado ou com sintaxe inválida | Revise o caminho do volume e valide o YAML | Deploy automatizado do Collector com Docker e Kubernetes |
| Pods do Collector em CrashLoopBackOff | ConfigMap com erro ou incompatibilidade de versão da imagem | Cheque logs do pod e valide o arquivo de configuração | Deploy automatizado do Collector com Docker e Kubernetes |
| Atualização do Collector falha no Kubernetes | Nova imagem com breaking changes ou config incompatível | Faça rollback com 'kubectl rollout undo' e revise as mudanças | Deploy automatizado do Collector com Docker e Kubernetes |
| Loki não inicia | Permissões no diretório de dados ou erro de sintaxe no YAML | Verifique permissões e valide o YAML com 'yamllint'. | Deploy de Loki e OpenTelemetry Collector |
| Collector não aparece no Prometheus | Porta errada ou Collector não iniciado | Confirme a porta 8888 e se o processo está rodando. | Deploy de Loki e OpenTelemetry Collector |
| Logs não aparecem no Grafana | Fonte de dados Loki mal configurada | Reveja a URL e as permissões do Loki. | Deploy de Loki e OpenTelemetry Collector |
| Loki não inicia | Permissões no diretório de dados ou erro de sintaxe no YAML | Verifique permissões e valide o YAML com 'yamllint'. | Deploy de Loki e OpenTelemetry Collector |
| Collector não aparece no Prometheus | Porta errada ou Collector não iniciado | Confirme a porta 8888 e se o processo está rodando. | Deploy de Loki e OpenTelemetry Collector |
| Logs não aparecem no Grafana | Fonte de dados Loki mal configurada | Reveja a URL e as permissões do Loki. | Deploy de Loki e OpenTelemetry Collector |
| Logs não aparecem no Loki | Erro de configuração de host, porta ou labels | Revise os parâmetros no bloco OUTPUT e teste conectividade com o Loki | Deploy do Fluent Bit: opções, plugins e integração com Loki |
| Fluent Bit não inicia | Erro de sintaxe no arquivo de configuração | Cheque logs em /var/log/td-agent-bit.log e valide a sintaxe | Deploy do Fluent Bit: opções, plugins e integração com Loki |
| Logs duplicados ou ausentes | Configuração incorreta de Tag/Match | Garanta que Tag no INPUT e Match no OUTPUT estão alinhados | Deploy do Fluent Bit: opções, plugins e integração com Loki |
| Logs não aparecem no Loki | Agente não consegue conectar ao endpoint ou labels obrigatórios ausentes | Revise configuração de output e conectividade de rede | Desenhando pipelines: escolha de agentes, labels e rotas |
| Explosão de cardinalidade | Labels com valores únicos demais (IDs, timestamps) | Reduza ou remova labels dinâmicos | Desenhando pipelines: escolha de agentes, labels e rotas |
| Logs chegam truncados ou ilegíveis | Parser incorreto ou formato de log inesperado | Ajuste o parser ou revise o formato de entrada | Desenhando pipelines: escolha de agentes, labels e rotas |
| Nenhum trace aparece no backend | Endpoint OTLP incorreto no SDK | Corrigir a variável OTEL_EXPORTER_OTLP_ENDPOINT | Detectando gaps: por que métricas, logs ou traces não aparec |
| Erro de conexão no SDK | Porta 4317 fechada ou Collector não escutando | Abrir porta e revisar binding do Collector | Detectando gaps: por que métricas, logs ou traces não aparec |
| Dados aparecem só às vezes | Sampling muito baixo | Aumentar ou desabilitar sampling temporariamente | Detectando gaps: por que métricas, logs ou traces não aparec |
| Collector recebe mas não exporta | Exporter ausente ou mal configurado | Adicionar/exporter correto no Collector | Detectando gaps: por que métricas, logs ou traces não aparec |
| Sem logs detalhados | Nível de log padrão no Collector | Ativar log de debug | Detectando gaps: por que métricas, logs ou traces não aparec |
| Eventos não aparecem no Elasticsearch | Falha de conexão entre Beats e Logstash ou Logstash e Elasticsearch | Verifique configurações de output e autenticação; teste conectividade de rede | Diagnóstico de ingestão: por que dados não chegam ou chegam |
| Eventos chegam com campos vazios ou errados | Erro de parsing (grok, dissect) ou pipeline mal configurado | Revise filtros do Logstash e teste parsing com exemplos reais | Diagnóstico de ingestão: por que dados não chegam ou chegam |
| Muitos eventos com tag _grokparsefailure | Expressão grok incompatível com o formato do log | Ajuste a expressão grok e valide com logs reais | Diagnóstico de ingestão: por que dados não chegam ou chegam |
| Perda de logs sob carga alta | Buffers pequenos ou CPU insuficiente | Aumente Buffer_Chunk_Size e BatchSize, ou aloque mais CPU | Dimensionando agentes e ingestão: CPU, memória e throughput |
| Latência alta na entrega de logs | BatchWait alto demais ou saturação de rede/backend | Reduza BatchWait ou distribua a carga entre mais agentes | Dimensionando agentes e ingestão: CPU, memória e throughput |
| Crash do agente | Memória insuficiente para o volume de logs | Aumente Buffer_Max_Size ou RAM disponível | Dimensionando agentes e ingestão: CPU, memória e throughput |
| Muitos erros 429 do Loki | Ingestão acima da capacidade do Loki | Reduza o número de agentes ou aumente a capacidade do Loki | Dimensionando agentes e ingestão: CPU, memória e throughput |
| Prometheus está lento ou travando | Excesso de séries ou retenção muito longa | Reduza a retenção ou a frequência de scraping | Dimensionando Prometheus: storage, retenção e scraping |
| Disco enchendo rapidamente | Estimativa de volume subdimensionada | Ajuste a retenção ou aumente o storage | Dimensionando Prometheus: storage, retenção e scraping |
| Dados não aparecem no destino remote_write | Fila de envio cheia ou endpoint remoto instável | Monitore o backlog e revise a configuração do remote_write | Dimensionando Prometheus: storage, retenção e scraping |
| Prometheus está lento ou travando | Excesso de séries ou retenção muito longa | Reduza a retenção ou a frequência de scraping | Dimensionando Prometheus: storage, retenção e scraping |
| Disco enchendo rapidamente | Estimativa de volume subdimensionada | Ajuste a retenção ou aumente o storage | Dimensionando Prometheus: storage, retenção e scraping |
| Dados não aparecem no destino remote_write | Fila de envio cheia ou endpoint remoto instável | Monitore o backlog e revise a configuração do remote_write | Dimensionando Prometheus: storage, retenção e scraping |
| Collector inicia mas não exporta dados | Endpoint do exporter incorreto ou porta bloqueada | Verifique o endpoint e libere a porta no firewall | Editando pipelines no Collector: receivers, processors e exp |
| Erro 'pipeline not connected' | Receiver ou exporter não referenciado no pipeline | Inclua o receiver/exporter corretamente no bloco service | Editando pipelines no Collector: receivers, processors e exp |
| Alto uso de memória | Ausência ou má configuração do memory_limiter | Ajuste os parâmetros do memory_limiter | Editando pipelines no Collector: receivers, processors e exp |
| Pipeline de ingestão não marca o campo 'anomalia'. | Erro no script Painless ou pipeline não atribuído ao índice. | Revise o script e associe o pipeline ao índice na indexação. | Elastic Stack além do básico: machine learning e integrações |
| Alertas de e-mail não são enviados. | Configuração SMTP incorreta ou porta bloqueada. | Verifique as credenciais e conectividade SMTP. | Elastic Stack além do básico: machine learning e integrações |
| Plugin não aparece após instalação. | Elasticsearch não foi parado antes da instalação. | Pare o serviço, reinstale o plugin e reinicie. | Elastic Stack além do básico: machine learning e integrações |
| Logs não aparecem no Kibana | Erro de configuração no Filebeat ou Logstash | Revise os caminhos dos arquivos e portas de destino; verifique logs do Filebeat e Logstash. | Elastic Stack: por que ELK mudou o jogo da análise de dados |
| Dados chegam sem campos estruturados | Filtro grok mal configurado no Logstash | Ajuste o padrão do grok para casar com o formato real dos logs. | Elastic Stack: por que ELK mudou o jogo da análise de dados |
| Alto uso de CPU no Elasticsearch | Volume de dados acima da capacidade do cluster | Aumente recursos ou implemente retenção e rotação de índices. | Elastic Stack: por que ELK mudou o jogo da análise de dados |
| Logs não são ingeridos após adicionar novos ingesters | Configuração do ring inconsistente ou store diferente entre os nós | Garanta que todos os ingesters usam o mesmo store (ex: memberlist) e estão na mesma rede | Escalando Loki: sharding, replicação e balanceamento |
| Consultas lentas mesmo com vários queriers | Storage lento ou falta de sharding adequado | Aumente o número de ingesters e otimize o backend de storage | Escalando Loki: sharding, replicação e balanceamento |
| Perda de logs após queda de ingester | Replication_factor baixo ou min_ready_replicas mal configurado | Aumente replication_factor e ajuste min_ready_replicas conforme a documentação | Escalando Loki: sharding, replicação e balanceamento |
| Beats não envia dados | Configuração de output incorreta ou firewall bloqueando porta | Revise filebeat.yml e libere as portas 5044 (Logstash) ou 9200 (Elasticsearch) | Escolhendo componentes: do Beat ao cluster distribuído |
| Logstash com alta latência | Pipeline sobrecarregado ou falta de CPU | Ajuste número de workers e monitore uso de recursos | Escolhendo componentes: do Beat ao cluster distribuído |
| Eventos duplicados no Elasticsearch | Pipelines não idempotentes ou reenvio de Beats | Garanta que pipelines Logstash sejam idempotentes e monitore retries | Escolhendo componentes: do Beat ao cluster distribuído |
| Prometheus lento ou travando | Cardinalidade alta devido a labels dinâmicos | Remova ou agregue labels, revise exporters | Escolhendo o que medir: métricas, labels e cardinalidade |
| Queries retornam timeout | Séries em excesso dificultando busca | Reduza labels ou agregue métricas | Escolhendo o que medir: métricas, labels e cardinalidade |
| Uso de memória muito alto | Métricas com labels de alta cardinalidade | Limite labels a valores estáticos | Escolhendo o que medir: métricas, labels e cardinalidade |
| Prometheus lento ou travando | Cardinalidade alta devido a labels dinâmicos | Remova ou agregue labels, revise exporters | Escolhendo o que medir: métricas, labels e cardinalidade |
| Queries retornam timeout | Séries em excesso dificultando busca | Reduza labels ou agregue métricas | Escolhendo o que medir: métricas, labels e cardinalidade |
| Uso de memória muito alto | Métricas com labels de alta cardinalidade | Limite labels a valores estáticos | Escolhendo o que medir: métricas, labels e cardinalidade |
| O Collector consome muita CPU ou memória | Volume excessivo de dados ou batch size inadequado | Reduza sampling ou aumente o batch size | Estimando volume de dados: métricas, logs e traces em produç |
| Perda de traces ou métricas | Buffers cheios ou exportação lenta | Aumente buffers ou otimize exportadores | Estimando volume de dados: métricas, logs e traces em produç |
| Arquivo de exportação cresce rápido demais | Sampling insuficiente ou instrumentação excessiva | Ajuste sampling e revise pontos instrumentados | Estimando volume de dados: métricas, logs e traces em produç |
| Busca lenta em todos os índices | Índices grandes ou queries ineficientes | Rotacione índices e otimize queries com filtros | Evitando armadilhas: erros clássicos que custam caro no Elas |
| Cluster instável após adicionar dados | Oversharding ou undersharding | Rebalanceie o número de shards e reindexe se necessário | Evitando armadilhas: erros clássicos que custam caro no Elas |
| Acesso não autorizado ao cluster | TLS e autenticação desativados | Ative xpack.security e configure certificados | Evitando armadilhas: erros clássicos que custam caro no Elas |
| Prometheus está lento ou consumindo muita memória | Explosão de séries devido a labels dinâmicos | Remova labels de alta cardinalidade e reinicie a coleta | Evite armadilhas: métricas inúteis, labels explosivos e dash |
| Dashboards do Grafana são confusos e difíceis de usar | Excesso de painéis e falta de agrupamento lógico | Reorganize e documente os painéis, removendo redundâncias | Evite armadilhas: métricas inúteis, labels explosivos e dash |
| Alertas disparam sem sentido | Métricas ou thresholds desatualizados | Revise e ajuste alertas e métricas periodicamente | Evite armadilhas: métricas inúteis, labels explosivos e dash |
| Prometheus está lento ou consumindo muita memória | Explosão de séries devido a labels dinâmicos | Remova labels de alta cardinalidade e reinicie a coleta | Evite armadilhas: métricas inúteis, labels explosivos e dash |
| Dashboards do Grafana são confusos e difíceis de usar | Excesso de painéis e falta de agrupamento lógico | Reorganize e documente os painéis, removendo redundâncias | Evite armadilhas: métricas inúteis, labels explosivos e dash |
| Alertas disparam sem sentido | Métricas ou thresholds desatualizados | Revise e ajuste alertas e métricas periodicamente | Evite armadilhas: métricas inúteis, labels explosivos e dash |
| Spans não aparecem no Jaeger após update | Mudança em endpoint ou protocolo OTLP | Revise configuração do receiver OTLP no Collector | Evolução segura: atualizando SDKs e Collector sem downtime |
| Métricas param de ser exportadas | Incompatibilidade de versão do exporter | Consulte a documentação e ajuste a versão do exporter | Evolução segura: atualizando SDKs e Collector sem downtime |
| Erro de autenticação após upgrade | Mudança em flags de segurança | Verifique parâmetros de autenticação e atualize conforme release notes | Evolução segura: atualizando SDKs e Collector sem downtime |
| Traces não aparecem no Jaeger UI | Collector não está exportando corretamente ou endpoint incorreto | Verifique logs do Collector e ajuste o endpoint OTLP para o Jaeger. | Exportando dados para Jaeger via OTLP |
| Atributos dos spans não aparecem | Campos customizados não suportados pelo Jaeger | Priorize atributos padronizados e revise o mapeamento. | Exportando dados para Jaeger via OTLP |
| Erros de conexão Collector-Jaeger | Porta ou protocolo OTLP incorretos | Confirme se Jaeger suporta OTLP e revise as portas (4317 para gRPC). | Exportando dados para Jaeger via OTLP |
| Logs não chegam ao destino externo | Configuração incorreta do output ou bloqueio de rede | Revise o bloco [OUTPUT] e teste conectividade com o destino | Exportando e correlacionando logs: integrações externas |
| Perda de eventos em picos de volume | Buffer insuficiente no Fluent Bit | Ajuste parâmetros de buffer e monitore métricas | Exportando e correlacionando logs: integrações externas |
| Campos de correlação ausentes | Parser mal configurado ou logs sem padrão | Padronize logs na origem e ajuste o parser do Fluent Bit | Exportando e correlacionando logs: integrações externas |
| O Prometheus mostra o target como DOWN | Exporter não está rodando ou firewall bloqueando a porta | Verifique se o processo está ativo e se a porta está liberada | Exporters: monitorando sistemas operacionais, bancos e aplic |
| Métricas do postgres_exporter estão vazias | Problema de permissão ou usuário incorreto no PostgreSQL | Revise as permissões do usuário e a string de conexão | Exporters: monitorando sistemas operacionais, bancos e aplic |
| blackbox_exporter retorna erro 400 | Parâmetros incorretos na requisição /probe | Consulte a documentação do blackbox_exporter para os parâmetros corretos | Exporters: monitorando sistemas operacionais, bancos e aplic |
| O Prometheus mostra o target como DOWN | Exporter não está rodando ou firewall bloqueando a porta | Verifique se o processo está ativo e se a porta está liberada | Exporters: monitorando sistemas operacionais, bancos e aplic |
| Métricas do postgres_exporter estão vazias | Problema de permissão ou usuário incorreto no PostgreSQL | Revise as permissões do usuário e a string de conexão | Exporters: monitorando sistemas operacionais, bancos e aplic |
| blackbox_exporter retorna erro 400 | Parâmetros incorretos na requisição /probe | Consulte a documentação do blackbox_exporter para os parâmetros corretos | Exporters: monitorando sistemas operacionais, bancos e aplic |
| Perda de logs durante picos de volume | Buffer de memória insuficiente ou destino Loki indisponível | Aumente Mem_Buf_Limit e monitore a saúde do backend | Fluent Bit em larga escala: clusters e balanceamento |
| Instâncias Fluent Bit com uso excessivo de memória | Mem_Buf_Limit muito alto para a RAM disponível | Reduza Mem_Buf_Limit ou distribua a carga em mais instâncias | Fluent Bit em larga escala: clusters e balanceamento |
| Logs não chegam ao Loki | Configuração incorreta de host/porta do balanceador ou falha no backend | Verifique conectividade e configuração do balanceador | Fluent Bit em larga escala: clusters e balanceamento |
| Traces não aparecem no backend | Endpoint do exporter incorreto ou Collector não iniciado | Verifique URLs e portas, reinicie o Collector e revise a configuração | Fluxo de dados: do código ao backend de observabilidade |
| Alto uso de CPU no Collector | Volume excessivo de spans ou configuração de processors ineficiente | Ajuste o batch size dos processors e otimize filtros | Fluxo de dados: do código ao backend de observabilidade |
| Dados duplicados no backend | Exportação simultânea direta e via Collector | Garanta que apenas um caminho de exportação está ativo | Fluxo de dados: do código ao backend de observabilidade |
| Exporter não aparece como 'UP' no Prometheus | Firewall bloqueando porta ou exporter não iniciado | Verifique firewall e status do serviço node_exporter | Fluxos de dados: do exporter ao dashboard |
| Logs não aparecem no Loki | Erro de configuração no promtail ou endpoint do Loki incorreto | Revise o config.yaml do promtail e o endereço do Loki | Fluxos de dados: do exporter ao dashboard |
| Dashboard do Grafana sem dados | Datasource mal configurado ou queries erradas | Reconfigure o datasource e revise as queries no painel | Fluxos de dados: do exporter ao dashboard |
| Exporter não aparece como 'UP' no Prometheus | Firewall bloqueando porta ou exporter não iniciado | Verifique firewall e status do serviço node_exporter | Fluxos de dados: do exporter ao dashboard |
| Logs não aparecem no Loki | Erro de configuração no promtail ou endpoint do Loki incorreto | Revise o config.yaml do promtail e o endereço do Loki | Fluxos de dados: do exporter ao dashboard |
| Dashboard do Grafana sem dados | Datasource mal configurado ou queries erradas | Reconfigure o datasource e revise as queries no painel | Fluxos de dados: do exporter ao dashboard |
| Dados de telemetria desaparecendo em picos | Fila do exporter pequena demais ou sem backpressure ativado | Aumente queue_size e habilite sending_queue | Gerenciando backpressure e filas em pipelines de alta demand |
| Collector consumindo toda a memória e travando | Fila grande demais para a RAM disponível | Reduza queue_size ou aumente a RAM | Gerenciando backpressure e filas em pipelines de alta demand |
| Atrasos grandes na exportação dos dados | Fila cheia ou downstream lento | Aumente num_consumers ou otimize o destino | Gerenciando backpressure e filas em pipelines de alta demand |
| Falha ao instalar pacote pip | pip não instalado ou repositório desatualizado | Garanta que python3-pip está presente e atualize os repositórios | Gerenciando instrumentação em larga escala com Ansible |
| Erro de permissão ao escrever configuração | Usuário sem privilégio root | Execute o playbook com become: yes | Gerenciando instrumentação em larga escala com Ansible |
| Variável de segredo não encontrada | Vault não desbloqueado ou variável mal referenciada | Desbloqueie o Vault e revise nomes das variáveis | Gerenciando instrumentação em larga escala com Ansible |
| Configuração não aplicada em todos os hosts | Inventário incompleto ou erro de conectividade SSH | Revise o inventário e teste acesso SSH | Gerenciando instrumentação em larga escala com Ansible |
| Logs antigos não estão sendo excluídos | Parâmetros de retenção mal configurados ou serviço Loki desatualizado | Revise a configuração do table_manager e consulte a documentação | Governança de logs: retenção, privacidade e auditoria |
| Campos sensíveis continuam aparecendo nos logs | Filtro do Fluent Bit mal configurado ou não aplicado | Verifique a seção FILTER e os nomes dos campos | Governança de logs: retenção, privacidade e auditoria |
| Acessos não aparecem nos logs de auditoria | Log_level insuficiente ou logs de acesso desabilitados | Ajuste o log_level do Loki para info ou superior | Governança de logs: retenção, privacidade e auditoria |
| Usuário consegue editar dashboards mesmo sem permissão. | Permissões mal configuradas em Grafana. | Revise as permissões em Configuration > Users e Configuration > Teams. | Governança de observabilidade: controle, auditoria e evoluçã |
| Prometheus acessível sem autenticação. | Proxy reverso não está ativo ou mal configurado. | Verifique configuração do NGINX e arquivo .htpasswd. | Governança de observabilidade: controle, auditoria e evoluçã |
| Logs de auditoria do Grafana não aparecem. | Logging desativado ou nível de log inadequado. | Ajuste [log] no grafana.ini para mode = file e level = info. | Governança de observabilidade: controle, auditoria e evoluçã |
| Alterações em prometheus.yml não têm histórico. | Arquivo não está versionado em Git. | Adicione o arquivo ao repositório e exija pull request para mudanças. | Governança de observabilidade: controle, auditoria e evoluçã |
| Usuário consegue editar dashboards mesmo sem permissão. | Permissões mal configuradas em Grafana. | Revise as permissões em Configuration > Users e Configuration > Teams. | Governança de observabilidade: controle, auditoria e evoluçã |
| Prometheus acessível sem autenticação. | Proxy reverso não está ativo ou mal configurado. | Verifique configuração do NGINX e arquivo .htpasswd. | Governança de observabilidade: controle, auditoria e evoluçã |
| Logs de auditoria do Grafana não aparecem. | Logging desativado ou nível de log inadequado. | Ajuste [log] no grafana.ini para mode = file e level = info. | Governança de observabilidade: controle, auditoria e evoluçã |
| Alterações em prometheus.yml não têm histórico. | Arquivo não está versionado em Git. | Adicione o arquivo ao repositório e exija pull request para mudanças. | Governança de observabilidade: controle, auditoria e evoluçã |
| Painel não mostra logs | Fonte de dados Loki mal configurada ou Loki fora do ar | Revisar URL e status do Loki | Grafana e Loki: painéis, queries e alertas |
| Alertas não disparam | Query do alerta incorreta ou threshold mal calibrado | Testar query no Explore e ajustar parâmetros | Grafana e Loki: painéis, queries e alertas |
| Dashboard lento ou travando | Queries sem labels ou uso excessivo de regex | Reescrever queries priorizando labels | Grafana e Loki: painéis, queries e alertas |
| Novo nó não aparece no cluster | Configuração de network.host ou discovery.seed_hosts incorreta | Verifique elasticsearch.yml e conectividade de rede | Horizontal ou vertical? Estratégias reais para escalar clust |
| Uso de heap JVM acima de 32 GB causa instabilidade | Heap configurado acima do recomendado | Reduza o heap para até 32 GB | Horizontal ou vertical? Estratégias reais para escalar clust |
| Rebalanceamento de shards muito lento | Limite de cluster_concurrent_rebalance muito baixo | Aumente o valor conforme a capacidade do hardware | Horizontal ou vertical? Estratégias reais para escalar clust |
| Latência alta após escalar horizontalmente | Rede entre nós saturada ou shards mal distribuídos | Verifique largura de banda e rebalanceie shards manualmente | Horizontal ou vertical? Estratégias reais para escalar clust |
| Serviço não inicia após deploy | Arquivo de configuração inválido | Verifique o template e rode 'prometheus --config.file=/etc/prometheus/prometheus.yml' para validar. | Infrastructure as Code: provisionando Prometheus e Grafana c |
| Playbook falha em permissões | Usuário sem sudo | Garanta que o usuário do Ansible tenha acesso sudo sem senha. | Infrastructure as Code: provisionando Prometheus e Grafana c |
| Mudanças não aplicadas | Cache do Ansible ou variáveis não atualizadas | Limpe o cache e revise as variáveis passadas no playbook. | Infrastructure as Code: provisionando Prometheus e Grafana c |
| Serviço não inicia após deploy | Arquivo de configuração inválido | Verifique o template e rode 'prometheus --config.file=/etc/prometheus/prometheus.yml' para validar. | Infrastructure as Code: provisionando Prometheus e Grafana c |
| Playbook falha em permissões | Usuário sem sudo | Garanta que o usuário do Ansible tenha acesso sudo sem senha. | Infrastructure as Code: provisionando Prometheus e Grafana c |
| Mudanças não aplicadas | Cache do Ansible ou variáveis não atualizadas | Limpe o cache e revise as variáveis passadas no playbook. | Infrastructure as Code: provisionando Prometheus e Grafana c |
| Nó não aparece no cluster | Problema de rede, firewall ou seed_hosts incorreto | Verifique conectividade, revise discovery.seed_hosts e logs em /var/log/elasticsearch/ | Inicializando um cluster: do single node ao multi-node |
| Status do cluster permanece yellow em multi-node | Shards de réplica não alocados | Cheque se todos os nós estão online e com roles corretos | Inicializando um cluster: do single node ao multi-node |
| Erro de split-brain ou múltiplos clusters formados | cluster.initial_master_nodes mal configurado ou omitido na criação | Recrie o cluster com cluster.initial_master_nodes correto | Inicializando um cluster: do single node ao multi-node |
| curl retorna connection refused em localhost:9200 | Elasticsearch não iniciou ou está escutando em outro endereço | Verifique logs em /var/log/elasticsearch/ e status do serviço. | Instalando Elasticsearch, Logstash, Kibana e Beats na prátic |
| Kibana não abre na porta 5601 | Serviço não iniciado ou porta bloqueada | Cheque 'sudo systemctl status kibana' e firewall local. | Instalando Elasticsearch, Logstash, Kibana e Beats na prátic |
| filebeat test output falha | Configuração incorreta do output ou permissão insuficiente | Revise o arquivo filebeat.yml e execute com sudo. | Instalando Elasticsearch, Logstash, Kibana e Beats na prátic |
| Logstash não processa entrada | Pipeline mal configurado ou serviço não iniciado | Teste pipeline mínimo e cheque logs em /var/log/logstash/. | Instalando Elasticsearch, Logstash, Kibana e Beats na prátic |
| Loki não responde na porta 3100 | Configuração incorreta do arquivo YAML ou porta bloqueada pelo firewall | Revise o arquivo de configuração e libere a porta no firewall | Instalando Loki e Promtail: binários, containers e Helm |
| Promtail não envia logs | URL do Loki incorreta ou permissões de leitura nos arquivos de log | Ajuste a URL em clients e verifique permissões dos arquivos de log | Instalando Loki e Promtail: binários, containers e Helm |
| Erro de permissão ao rodar container | Volumes montados com permissões restritas ou container rodando como root sem necessidade | Ajuste permissões dos volumes e use a flag --user | Instalando Loki e Promtail: binários, containers e Helm |
| Pods não sobem no Kubernetes | Recursos insuficientes ou erro de configuração no values.yaml | Revise requests/limits e a sintaxe do values.yaml | Instalando Loki e Promtail: binários, containers e Helm |
| Prometheus não inicia | Permissões incorretas nos diretórios ou erro de sintaxe no prometheus.yml | Verifique logs em /var/log/syslog ou journalctl -u prometheus; corrija permissões e sintaxe | Instalando Prometheus e Grafana: do binário ao serviço |
| Grafana não acessível na porta 3000 | Serviço não iniciou ou firewall bloqueando a porta | Cheque status com systemctl e libere a porta no firewall | Instalando Prometheus e Grafana: do binário ao serviço |
| Erro de hash ao verificar binário | Download corrompido ou arquivo adulterado | Baixe novamente do site oficial e repita a verificação | Instalando Prometheus e Grafana: do binário ao serviço |
| Prometheus não inicia | Permissões incorretas nos diretórios ou erro de sintaxe no prometheus.yml | Verifique logs em /var/log/syslog ou journalctl -u prometheus; corrija permissões e sintaxe | Instalando Prometheus e Grafana: do binário ao serviço |
| Grafana não acessível na porta 3000 | Serviço não iniciou ou firewall bloqueando a porta | Cheque status com systemctl e libere a porta no firewall | Instalando Prometheus e Grafana: do binário ao serviço |
| Erro de hash ao verificar binário | Download corrompido ou arquivo adulterado | Baixe novamente do site oficial e repita a verificação | Instalando Prometheus e Grafana: do binário ao serviço |
| Traces aparecem incompletos ou com spans faltando | Propagação de contexto falha ou instrumentação inconsistente | Revise headers e padronize atributos em todos os serviços | Instrumentação em microserviços: desafios e soluções |
| Collector consome muita CPU | Volume excessivo de spans ou configuração ineficiente | Ajuste o sampling e revise processadores no pipeline | Instrumentação em microserviços: desafios e soluções |
| Spans não chegam ao Jaeger | Erro de configuração no exporter ou problemas de rede | Verifique endpoints e conectividade entre collector e Jaeger | Instrumentação em microserviços: desafios e soluções |
| Traces não aparecem no Jaeger | Exporter configurado para endpoint errado ou Jaeger não está rodando | Verifique se Jaeger está ativo e se o exporter aponta para o endpoint correto (UDP ou HTTP) | Instrumentação manual e automática: exemplos práticos |
| Auto-instrumentação não coleta spans | Pacote opentelemetry-instrumentation não instalado ou framework não suportado | Confirme a instalação do pacote e consulte a lista de frameworks suportados | Instrumentação manual e automática: exemplos práticos |
| Erro de importação em Go (context.Background) | Faltou importar o pacote 'context' | Adicione 'import "context"' no início do arquivo Go | Instrumentação manual e automática: exemplos práticos |
| Spans aparecem sem atributos de negócio | Faltou instrumentação manual nos pontos críticos | Adicione spans manuais onde for necessário contexto de negócio | Instrumentação manual e automática: exemplos práticos |
| Endpoint /metrics retorna erro 404 | Exporter prometheus não está habilitado ou endpoint incorreto. | Revise a configuração do exporter e reinicie o Collector. | Integração com sistemas de métricas: Prometheus e outros |
| Prometheus não coleta métricas do Collector | Endpoint ou porta incorretos no prometheus.yml. | Corrija o endereço e reinicie o Prometheus. | Integração com sistemas de métricas: Prometheus e outros |
| Métricas aparecem duplicadas | Scraping de múltiplos endpoints expondo as mesmas métricas. | Centralize a exposição pelo Collector e ajuste scrape_configs. | Integração com sistemas de métricas: Prometheus e outros |
| Nenhum dado chega ao Elasticsearch | Erro de configuração no output ou bloqueio de firewall | Revise o bloco output e teste conectividade com curl. | Integrando Filebeat e Metricbeat com aplicações e sistemas o |
| Logs duplicados | Inputs sobrepostos ou paths mal definidos | Ajuste os paths e revise se múltiplos módulos/input coletam o mesmo arquivo. | Integrando Filebeat e Metricbeat com aplicações e sistemas o |
| Falha de autenticação TLS | Certificado ou CA inválido | Recrie certificados e valide caminhos no arquivo de configuração. | Integrando Filebeat e Metricbeat com aplicações e sistemas o |
| Logs não aparecem no Kibana | Filebeat ou Logstash não estão enviando dados corretamente | Verifique logs do Filebeat (/var/log/filebeat/filebeat), do Logstash e conectividade com Elasticsearch | Logs de rede e segurança: Elastic Stack como SIEM open sourc |
| Campos de geolocalização não aparecem | Plugin geoip não configurado ou base de dados ausente | Confirme a configuração do filtro geoip e a presença do arquivo GeoLite2 | Logs de rede e segurança: Elastic Stack como SIEM open sourc |
| Alertas não disparam | Regras de alerta mal configuradas ou permissões insuficientes | Revise as condições dos alertas e permissões de usuário no Kibana | Logs de rede e segurança: Elastic Stack como SIEM open sourc |
| Ainda aparecem dados pessoais em métricas | Instrumentação ou exporters não filtraram corretamente | Revise processadores e relabel_configs; teste com dados de exemplo | Logs e métricas sensíveis: anonimização e controle de exposi |
| Labels sensíveis continuam visíveis em dashboards | Permissões do Grafana estão amplas ou labels não foram filtradas | Ajuste permissões e revise filtros de labels | Logs e métricas sensíveis: anonimização e controle de exposi |
| Auditoria de acessos não está funcionando | Configuração de auditoria não foi aplicada corretamente | Verifique o arquivo grafana.ini e reinicie o serviço | Logs e métricas sensíveis: anonimização e controle de exposi |
| Ainda aparecem dados pessoais em métricas | Instrumentação ou exporters não filtraram corretamente | Revise processadores e relabel_configs; teste com dados de exemplo | Logs e métricas sensíveis: anonimização e controle de exposi |
| Labels sensíveis continuam visíveis em dashboards | Permissões do Grafana estão amplas ou labels não foram filtradas | Ajuste permissões e revise filtros de labels | Logs e métricas sensíveis: anonimização e controle de exposi |
| Auditoria de acessos não está funcionando | Configuração de auditoria não foi aplicada corretamente | Verifique o arquivo grafana.ini e reinicie o serviço | Logs e métricas sensíveis: anonimização e controle de exposi |
| Campos sensíveis continuam aparecendo nos logs | Filtro de anonimização mal configurado ou não aplicado | Revise a configuração dos filtros modify/lua no Fluent Bit | Logs em ambientes regulamentados: aprendizados de produção |
| Logs antigos não são deletados | retention_period mal configurado ou deleção física não ativada no backend | Ajuste retention_period e valide a configuração do backend de storage | Logs em ambientes regulamentados: aprendizados de produção |
| Logs de auditoria ausentes | Coleta de logs administrativos não implementada | Implemente coleta dos logs de acesso e operações no Loki | Logs em ambientes regulamentados: aprendizados de produção |
| Logs não aparecem estruturados no Grafana | Promtail não está extraindo campos JSON corretamente | Revise pipeline_stages e expressions no promtail.yaml | Logs estruturados e traces: modelagem para busca eficiente |
| Não há trace_id nos logs | Serviço não está propagando trace_id | Implemente middleware de tracing com OpenTelemetry | Logs estruturados e traces: modelagem para busca eficiente |
| Queries por campo retornam vazio | Campos inconsistentes ou nomes diferentes entre serviços | Padronize nomes e tipos de campos em todos os serviços | Logs estruturados e traces: modelagem para busca eficiente |
| Logs não aparecem estruturados no Grafana | Promtail não está extraindo campos JSON corretamente | Revise pipeline_stages e expressions no promtail.yaml | Logs estruturados e traces: modelagem para busca eficiente |
| Não há trace_id nos logs | Serviço não está propagando trace_id | Implemente middleware de tracing com OpenTelemetry | Logs estruturados e traces: modelagem para busca eficiente |
| Queries por campo retornam vazio | Campos inconsistentes ou nomes diferentes entre serviços | Padronize nomes e tipos de campos em todos os serviços | Logs estruturados e traces: modelagem para busca eficiente |
| Logs não aparecem no Loki | Input ou output mal configurados | Revisar caminhos e endpoints | Logs que não chegam: debug no Fluent Bit e Promtail |
| Logs atrasados ou perdidos | Buffers cheios ou filas saturadas | Ajustar Buffer_Chunk_Size e batchsize | Logs que não chegam: debug no Fluent Bit e Promtail |
| Erros de conexão com Loki | Loki fora do ar ou endpoint errado | Testar conectividade e corrigir host/porta | Logs que não chegam: debug no Fluent Bit e Promtail |
| Logs não aparecem no Loki | Promtail parado ou configuração incorreta | Reinicie o promtail e revise o arquivo de configuração. | Logs sumidos e traces incompletos: causas e soluções |
| Consulta retorna poucos logs ou timeout | Limites baixos de consulta no Loki | Ajuste 'max_query_length' e 'max_samples_per_query' no YAML e reinicie o Loki. | Logs sumidos e traces incompletos: causas e soluções |
| Traces incompletos no Grafana Tempo | Endpoint OTLP errado ou Collector não recebe spans | Corrija o endpoint e verifique a instrumentação da aplicação. | Logs sumidos e traces incompletos: causas e soluções |
| Logs aparecem com atraso | Buffer ou fila cheia no promtail | Aumente o buffer ou reduza a taxa de logs na origem. | Logs sumidos e traces incompletos: causas e soluções |
| Logs não aparecem no Loki | Promtail parado ou configuração incorreta | Reinicie o promtail e revise o arquivo de configuração. | Logs sumidos e traces incompletos: causas e soluções |
| Consulta retorna poucos logs ou timeout | Limites baixos de consulta no Loki | Ajuste 'max_query_length' e 'max_samples_per_query' no YAML e reinicie o Loki. | Logs sumidos e traces incompletos: causas e soluções |
| Traces incompletos no Grafana Tempo | Endpoint OTLP errado ou Collector não recebe spans | Corrija o endpoint e verifique a instrumentação da aplicação. | Logs sumidos e traces incompletos: causas e soluções |
| Logs aparecem com atraso | Buffer ou fila cheia no promtail | Aumente o buffer ou reduza a taxa de logs na origem. | Logs sumidos e traces incompletos: causas e soluções |
| Logs não aparecem no Kibana | Filebeat não está rodando ou caminho do arquivo está incorreto | Verifique status do Filebeat com 'systemctl status filebeat' e revise filebeat.yml | Logs, métricas e eventos: o que realmente importa na observa |
| Métricas ausentes ou desatualizadas | Metricbeat não consegue acessar endpoints ou módulos estão desabilitados | Cheque logs do Metricbeat e revise configuração dos módulos | Logs, métricas e eventos: o que realmente importa na observa |
| Eventos chegam sem campos estruturados | Formato JSON incorreto ou pipeline de ingestão falho | Valide o JSON e pipelines no Logstash ou ingest node | Logs, métricas e eventos: o que realmente importa na observa |
| Logs não aparecem na busca | Falta de indexação ou labels incorretos | Verifique a configuração de labels no Fluent Bit e Loki | Logs, métricas e traces: diferenças e sinergias em observabi |
| Métricas não refletem incidentes recentes | Intervalo de scraping alto ou agregação excessiva | Ajuste o intervalo de coleta e granularidade das métricas | Logs, métricas e traces: diferenças e sinergias em observabi |
| Traces não mostram todos os serviços | Instrumentação incompleta | Garanta que todos os serviços estejam instrumentados para tracing | Logs, métricas e traces: diferenças e sinergias em observabi |
| Perda de logs após reinício do ingester | Backend de storage não configurado corretamente | Revise configuração do storage e permissões | Loki distribuído e Grafana em HA: arquitetura resiliente |
| Dashboards sumindo após reinício do Grafana | Banco de dados externo não persistente ou mal configurado | Ajuste grafana.ini para banco externo e teste persistência | Loki distribuído e Grafana em HA: arquitetura resiliente |
| Balanceador reporta instância como unhealthy | Endpoint de saúde não responde ou porta errada | Verifique logs e endpoints de health das instâncias | Loki distribuído e Grafana em HA: arquitetura resiliente |
| Perda de logs após reinício do ingester | Backend de storage não configurado corretamente | Revise configuração do storage e permissões | Loki distribuído e Grafana em HA: arquitetura resiliente |
| Dashboards sumindo após reinício do Grafana | Banco de dados externo não persistente ou mal configurado | Ajuste grafana.ini para banco externo e teste persistência | Loki distribuído e Grafana em HA: arquitetura resiliente |
| Balanceador reporta instância como unhealthy | Endpoint de saúde não responde ou porta errada | Verifique logs e endpoints de health das instâncias | Loki distribuído e Grafana em HA: arquitetura resiliente |
| Consultas lentas ou travando | Labels de alta cardinalidade ou falta de filtros | Reduza a cardinalidade dos labels e sempre filtre por labels nas consultas | Loki e logs em escala: retenção, indexação e custos |
| Disco enchendo rapidamente | Retenção longa ou volume de logs acima do previsto | Reduza o período de retenção e revise o volume de logs ingeridos | Loki e logs em escala: retenção, indexação e custos |
| Logs de um tenant aparecendo para outro | Configuração de multi-tenancy incorreta | Revise headers e autenticação dos agentes de envio | Loki e logs em escala: retenção, indexação e custos |
| Consultas lentas ou travando | Labels de alta cardinalidade ou falta de filtros | Reduza a cardinalidade dos labels e sempre filtre por labels nas consultas | Loki e logs em escala: retenção, indexação e custos |
| Disco enchendo rapidamente | Retenção longa ou volume de logs acima do previsto | Reduza o período de retenção e revise o volume de logs ingeridos | Loki e logs em escala: retenção, indexação e custos |
| Logs de um tenant aparecendo para outro | Configuração de multi-tenancy incorreta | Revise headers e autenticação dos agentes de envio | Loki e logs em escala: retenção, indexação e custos |
| Logs não aparecem após upgrade | Configuração incompatível ou erro de sintaxe | Reverta para backup anterior e valide a configuração com yamllint ou --dry-run | Manutenção preventiva: upgrades, testes e rollback seguro |
| Serviço não inicia | Binário incompatível ou dependências ausentes | Verifique versão do binário e dependências; use a versão anterior se necessário | Manutenção preventiva: upgrades, testes e rollback seguro |
| Perda de logs durante upgrade | Falta de buffer ou retenção configurada | Ajuste buffers e revise políticas de retenção antes do upgrade | Manutenção preventiva: upgrades, testes e rollback seguro |
| Erro de autenticação no Loki | Mudança em parâmetros de autenticação | Atualize configurações de autenticação conforme documentação | Manutenção preventiva: upgrades, testes e rollback seguro |
| Cluster lotando rapidamente | Volume de dados subestimado ou retenção excessiva | Recalcule o volume, ajuste políticas de retenção e reindexe se necessário | Mapeando requisitos: o que perguntar antes de desenhar o sta |
| Dados sensíveis aparecendo em dashboards | Falta de mascaramento ou anonimização nos pipelines | Revise filtros de Logstash e políticas de ingestão | Mapeando requisitos: o que perguntar antes de desenhar o sta |
| Fontes de dados não aparecem no Kibana | Pipeline de ingestão mal configurado ou formatos incompatíveis | Verifique configurações de Beat, Logstash e mapping do Elasticsearch | Mapeando requisitos: o que perguntar antes de desenhar o sta |
| Métricas do Fluent Bit não aparecem no Prometheus | Endpoint HTTP não habilitado ou firewall bloqueando porta | Revise a configuração do Fluent Bit e libere a porta 2020 | Métricas do Loki e Fluent Bit: o que importa de verdade |
| Chunks na memória do Loki crescendo sem parar | Storage lento ou ingestão acima da capacidade | Aumente a capacidade do storage ou ajuste a taxa de ingestão | Métricas do Loki e Fluent Bit: o que importa de verdade |
| Retentativas de output do Fluent Bit muito altas | Destino (ex: Loki) indisponível ou sobrecarregado | Verifique a saúde do Loki e ajuste o buffer do Fluent Bit | Métricas do Loki e Fluent Bit: o que importa de verdade |
| Não encontro logs de um evento específico | Logs podem não estar estruturados ou não têm campos de correlação. | Adote logs estruturados e inclua IDs de correlação. | Métricas, logs e traces: o tripé da observabilidade moderna |
| Traces não aparecem para todas as requisições | Amostragem de traces está configurada para coletar só uma fração. | Ajuste a taxa de amostragem conforme a necessidade, mas evite coletar tudo em produção. | Métricas, logs e traces: o tripé da observabilidade moderna |
| Painel de métricas mostra dados inconsistentes | Problemas de scrape ou configuração incorreta do Prometheus. | Revise targets e intervalos de scrape na configuração do Prometheus. | Métricas, logs e traces: o tripé da observabilidade moderna |
| Métricas do Elasticsearch não aparecem no Kibana | Configuração incorreta do módulo elasticsearch ou autenticação inválida | Revise o arquivo /etc/metricbeat/modules.d/elasticsearch.yml e teste a conexão manualmente | Metricbeat e o monitoramento da saúde do cluster |
| Alertas não disparam mesmo com condição atingida | Campo ou índice errado na regra do Kibana | Confirme o nome do campo nas métricas e ajuste a consulta da regra | Metricbeat e o monitoramento da saúde do cluster |
| Espaço em disco não aparece entre as métricas | Módulo system não habilitado ou configurado | Ative e configure o módulo system do Metricbeat | Metricbeat e o monitoramento da saúde do cluster |
| Falha ao reiniciar o Metricbeat | Erro de sintaxe na configuração | Cheque logs em /var/log/metricbeat/metricbeat.log e corrija o YAML | Metricbeat e o monitoramento da saúde do cluster |
| Spans aparecem sem relação hierárquica | Contexto de trace não propagado corretamente entre serviços | Garanta que headers de trace são transmitidos e lidos pelos serviços | Modelando spans, atributos e eventos para rastreamento útil |
| Atributos ausentes ou inconsistentes | Atributos não definidos ou nomes divergentes | Revise a implementação e padronize nomes conforme semantic conventions | Modelando spans, atributos e eventos para rastreamento útil |
| Eventos não aparecem nos rastros | Eventos não adicionados ou não exportados | Confirme uso correto de add_event e configuração do exporter | Modelando spans, atributos e eventos para rastreamento útil |
| Traces não aparecem no Kibana | Agente APM não consegue enviar dados para o APM Server | Verifique se o APM Server está rodando e a URL está correta | Monitoramento de aplicações: métricas, logs e APM sem vendor |
| Logs não chegam ao Elasticsearch | Filebeat não consegue acessar o arquivo ou o Elasticsearch | Cheque permissões dos arquivos e conectividade | Monitoramento de aplicações: métricas, logs e APM sem vendor |
| Métricas ausentes no dashboard | Metricbeat não está ativo ou módulo não habilitado | Reveja a configuração do metricbeat.modules e reinicie o serviço | Monitoramento de aplicações: métricas, logs e APM sem vendor |
| Métricas de latência não aparecem no Grafana | blackbox_exporter não está rodando ou porta bloqueada | Verifique se o serviço está ativo e libere a porta 9115 no firewall | Monitorando redes e aplicações em uma rede de fibra dedicada |
| Alertas não são enviados | Alertmanager não configurado ou regras ausentes | Revise a configuração do Alertmanager e das regras de alerta | Monitorando redes e aplicações em uma rede de fibra dedicada |
| Logs de aplicação não aparecem | OpenTelemetry Collector não está lendo o arquivo ou exporter mal configurado | Verifique paths e endpoints no YAML do Collector | Monitorando redes e aplicações em uma rede de fibra dedicada |
| Métricas de latência não aparecem no Grafana | blackbox_exporter não está rodando ou porta bloqueada | Verifique se o serviço está ativo e libere a porta 9115 no firewall | Monitorando redes e aplicações em uma rede de fibra dedicada |
| Alertas não são enviados | Alertmanager não configurado ou regras ausentes | Revise a configuração do Alertmanager e das regras de alerta | Monitorando redes e aplicações em uma rede de fibra dedicada |
| Logs de aplicação não aparecem | OpenTelemetry Collector não está lendo o arquivo ou exporter mal configurado | Verifique paths e endpoints no YAML do Collector | Monitorando redes e aplicações em uma rede de fibra dedicada |
| Usuário vê dados de outro tenant | Role com padrão de índice muito amplo ou permissões globais. | Ajuste a role para restringir o padrão de índice ao tenant correto. | Multi-tenancy e isolamento: uma stack, vários times sem bagu |
| Dashboard não aparece no Space do tenant | Permissão de Space não atribuída ou dashboard salvo no Space errado. | Verifique o Space e as permissões da role no Kibana. | Multi-tenancy e isolamento: uma stack, vários times sem bagu |
| Erro ao criar índice dinâmico | Campo tenant ausente no evento ou erro de sintaxe no Logstash. | Garanta que o campo tenant está presente e revise a configuração do Logstash. | Multi-tenancy e isolamento: uma stack, vários times sem bagu |
| Índices antigos não são deletados | Política ILM não aplicada ou mal configurada | Revise a aplicação da política e ajuste os parâmetros de idade/rotação. | Naming, versionamento e limpeza: o que separa o stack de pro |
| Pipelines com nomes confusos | Ausência de padrão de nomenclatura | Padronize nomes e documente o padrão. | Naming, versionamento e limpeza: o que separa o stack de pro |
| Rollback impossível após erro | Configuração não versionada | Implemente versionamento imediato em Git. | Naming, versionamento e limpeza: o que separa o stack de pro |
| Falha ao indexar logs no Loki | Configuração incorreta do boltdb-shipper ou permissões de diretório | Revise paths e permissões no storage_config | Novas features do Loki e Fluent Bit: o que muda o jogo |
| Parsers dinâmicos não aplicam mudanças | API HTTP não habilitada ou sintaxe incorreta | Habilite a API e valide o payload enviado | Novas features do Loki e Fluent Bit: o que muda o jogo |
| Erro de conexão TLS no Fluent Bit | Certificados inválidos ou CA não reconhecida | Revise arquivos de certificado e cadeia de confiança | Novas features do Loki e Fluent Bit: o que muda o jogo |
| Dados não aparecem no Kibana | Problema de ingestão no Logstash ou Beats | Verifique logs de Logstash e Filebeat; cheque conexões e permissões | Novidades e tendências: Elastic Stack open source em 2024 |
| Alertas não são disparados | Condição de alerta mal configurada ou e-mail bloqueado | Revise regras YAML e logs do Kibana; teste envio manual de e-mail | Novidades e tendências: Elastic Stack open source em 2024 |
| Snapshots não restauram rápido | Storage subdimensionado ou configuração incorreta | Ajuste storage e revise parâmetros de searchable snapshots | Novidades e tendências: Elastic Stack open source em 2024 |
| Pipeline do Logstash lento | Falta de paralelismo ou gargalo em filtro | Aumente workers e revise filtros pesados | Novidades e tendências: Elastic Stack open source em 2024 |
| Logs não aparecem no backend | Pipeline de logs não configurado corretamente no Collector. | Revise a seção 'pipelines' e garanta que 'logs' está incluído. | Novidades recentes e roadmap do OpenTelemetry |
| Exemplars não são exportados | Exportador Prometheus desatualizado ou flag ausente. | Atualize o exportador e adicione 'enable_open_metrics: true'. | Novidades recentes e roadmap do OpenTelemetry |
| Auto-instrumentação não coleta traces | Variáveis de ambiente incorretas ou pacote não instalado. | Verifique as variáveis OTEL_TRACES_EXPORTER e OTEL_EXPORTER_OTLP_ENDPOINT e reinstale o pacote. | Novidades recentes e roadmap do OpenTelemetry |
| Logs não mostram trace_id | Logger não está configurado para capturar o contexto do trace | Adapte o middleware de logging para extrair e incluir o trace_id | Observabilidade em microsserviços: métricas, logs e traces c |
| Traces aparecem incompletos no Tempo | Nem todos os serviços propagam o trace_id corretamente | Revise a configuração de propagação do trace_id em todos os serviços | Observabilidade em microsserviços: métricas, logs e traces c |
| Métricas não têm label de trace_id | Instrumentação das métricas não está associando o trace_id | Inclua o trace_id como label nas métricas customizadas | Observabilidade em microsserviços: métricas, logs e traces c |
| Logs não mostram trace_id | Logger não está configurado para capturar o contexto do trace | Adapte o middleware de logging para extrair e incluir o trace_id | Observabilidade em microsserviços: métricas, logs e traces c |
| Traces aparecem incompletos no Tempo | Nem todos os serviços propagam o trace_id corretamente | Revise a configuração de propagação do trace_id em todos os serviços | Observabilidade em microsserviços: métricas, logs e traces c |
| Métricas não têm label de trace_id | Instrumentação das métricas não está associando o trace_id | Inclua o trace_id como label nas métricas customizadas | Observabilidade em microsserviços: métricas, logs e traces c |
| Atributos semânticos não aparecem nos traces | Instrumentação ausente ou nomes incorretos | Revise o código e compare com as semantic conventions oficiais | Observabilidade semântica: além de métricas, logs e traces |
| Contexto de trace não é propagado entre serviços | Headers de contexto não estão sendo enviados ou lidos | Verifique configuração de propagação e compatibilidade entre linguagens | Observabilidade semântica: além de métricas, logs e traces |
| Dados customizados não aparecem no backend | Atributos não documentados ou incompatíveis com o coletor | Documente e padronize os atributos customizados; ajuste o pipeline do coletor se necessário | Observabilidade semântica: além de métricas, logs e traces |
| Métricas não aparecem no Prometheus | Collector não está expondo endpoint corretamente | Revise a configuração do exporter prometheus e certifique-se de que a porta está liberada | OpenTelemetry e o futuro da observabilidade: além de métrica |
| Traces não chegam ao Jaeger | Endpoint ou protocolo incorreto no exporter jaeger | Verifique o endereço e o protocolo configurados no Collector | OpenTelemetry e o futuro da observabilidade: além de métrica |
| Logs não aparecem no backend | Suporte a logs não estável na linguagem usada | Consulte a documentação oficial para status do suporte | OpenTelemetry e o futuro da observabilidade: além de métrica |
| Métricas não aparecem no Prometheus | Collector não está expondo endpoint corretamente | Revise a configuração do exporter prometheus e certifique-se de que a porta está liberada | OpenTelemetry e o futuro da observabilidade: além de métrica |
| Traces não chegam ao Jaeger | Endpoint ou protocolo incorreto no exporter jaeger | Verifique o endereço e o protocolo configurados no Collector | OpenTelemetry e o futuro da observabilidade: além de métrica |
| Logs não aparecem no backend | Suporte a logs não estável na linguagem usada | Consulte a documentação oficial para status do suporte | OpenTelemetry e o futuro da observabilidade: além de métrica |
| Spans não aparecem no backend | Problema de configuração no Collector ou erro na instrumentação manual | Revise o arquivo de configuração do Collector e verifique se os spans estão sendo enviados corretamente pelo SDK. | OpenTelemetry em sistemas legados: migrando sem traumas |
| Dados inconsistentes ou traces quebrados | Mistura de protocolos sem correta configuração de contexto | Garanta que o Collector está recebendo todos os protocolos necessários e que o contexto de trace está sendo propagado corretamente. | OpenTelemetry em sistemas legados: migrando sem traumas |
| Aumento de latência após instrumentação | Instrumentação excessiva ou coleta síncrona | Reduza o número de spans ou ajuste a configuração do SDK para coleta assíncrona, se disponível. | OpenTelemetry em sistemas legados: migrando sem traumas |
| Métricas não aparecem no endpoint /metrics | PrometheusMetricReader não configurado corretamente ou porta incorreta | Revise a configuração do metric_reader e garanta que o start_http_server está rodando na porta correta | OpenTelemetry SDKs: instrumentando código para métricas e tr |
| Traces não chegam ao Jaeger | Exporter configurado com host ou porta errados | Verifique os parâmetros agent_host_name e agent_port do JaegerExporter | OpenTelemetry SDKs: instrumentando código para métricas e tr |
| Instrumentação automática não coleta dados de um framework | Framework não suportado ou versão incompatível | Consulte a lista de frameworks suportados na documentação oficial e atualize se necessário | OpenTelemetry SDKs: instrumentando código para métricas e tr |
| Métricas não aparecem no endpoint /metrics | PrometheusMetricReader não configurado corretamente ou porta incorreta | Revise a configuração do metric_reader e garanta que o start_http_server está rodando na porta correta | OpenTelemetry SDKs: instrumentando código para métricas e tr |
| Traces não chegam ao Jaeger | Exporter configurado com host ou porta errados | Verifique os parâmetros agent_host_name e agent_port do JaegerExporter | OpenTelemetry SDKs: instrumentando código para métricas e tr |
| Instrumentação automática não coleta dados de um framework | Framework não suportado ou versão incompatível | Consulte a lista de frameworks suportados na documentação oficial e atualize se necessário | OpenTelemetry SDKs: instrumentando código para métricas e tr |
| Traces não aparecem no Jaeger | Collector mal configurado ou endpoint incorreto | Revise a configuração YAML do Collector e valide o endpoint do Jaeger | OpenTelemetry: o padrão aberto para instrumentação unificada |
| Métricas não chegam ao backend | SDK sem exportador de métricas habilitado | Habilite e configure o exportador de métricas no SDK | OpenTelemetry: o padrão aberto para instrumentação unificada |
| Alto uso de CPU no Collector | Pipeline de processamento mal dimensionado | Ajuste o número de workers ou utilize filtros para reduzir volume | OpenTelemetry: o padrão aberto para instrumentação unificada |
| Dados duplicados | Instrumentação manual e automática simultâneas | Escolha apenas um método de instrumentação por serviço | OpenTelemetry: o padrão aberto para instrumentação unificada |
| Spans com nomes diferentes para a mesma operação | Falta de padronização entre equipes | Centralize e divulgue o padrão de nomenclatura | Padronização de nomenclatura e atributos: evitando caos nos |
| Atributos ausentes ou inconsistentes | Instrumentação manual sem seguir a especificação | Reforce o uso dos atributos oficiais | Padronização de nomenclatura e atributos: evitando caos nos |
| Dashboards quebrados após atualização | Mudança em nomes de métricas ou atributos sem comunicação | Implemente processo de revisão e comunicação de mudanças | Padronização de nomenclatura e atributos: evitando caos nos |
| Dados não aparecem no Kibana | Pipeline interrompido ou erro de configuração em Beats, Logstash ou Elasticsearch | Revise logs de cada componente e valide configurações de output e index pattern | Pipeline de ingestão: do Beat ao Kibana sem perder dados |
| Logs duplicados | Beats reiniciando sem registrar offset ou Logstash reprocessando filas persistentes | Garanta persistência de estado nos Beats e monitore filas do Logstash | Pipeline de ingestão: do Beat ao Kibana sem perder dados |
| Atraso na visualização | Backpressure ou lentidão no Logstash | Monitore uso de CPU/memória e ajuste batch size e workers | Pipeline de ingestão: do Beat ao Kibana sem perder dados |
| Logs não aparecem no Loki | Configuração errada de output no Fluent Bit ou labels inconsistentes | Revise a configuração e os nomes dos labels; consulte os logs do Fluent Bit para mensagens de erro | Por que Loki e Fluent Bit: modelo, licenças e arquitetura op |
| Consumo de CPU alto no Fluent Bit | Filtros mal otimizados ou volume excessivo de logs | Ajuste filtros e paths de input para reduzir carga | Por que Loki e Fluent Bit: modelo, licenças e arquitetura op |
| Consulta lenta no Loki | Labels mal definidos ou consulta ampla demais | Refine labels e restrinja o período da consulta | Por que Loki e Fluent Bit: modelo, licenças e arquitetura op |
| Não encontra logs relacionados ao trace | Falta de propagação de trace ID nos logs | Configure o logger para incluir trace ID nos registros. | Por que métricas, logs e traces são inseparáveis em sistemas |
| Métricas não refletem problemas vistos nos logs | Coleta de métricas insuficiente ou granularidade inadequada | Ajuste a instrumentação para capturar métricas relevantes. | Por que métricas, logs e traces são inseparáveis em sistemas |
| Traces incompletos entre serviços | Falta de propagação de contexto entre serviços | Verifique a configuração de propagação de contexto do OpenTelemetry. | Por que métricas, logs e traces são inseparáveis em sistemas |
| Métricas não aparecem no Grafana | Prometheus não está coletando do endpoint correto | Revise o job_name e targets no prometheus.yml | Por que Prometheus, Grafana, Loki e OpenTelemetry mudaram o |
| Logs não aparecem no Loki | Promtail não está lendo o arquivo de log | Verifique o caminho em __path__ na configuração do promtail | Por que Prometheus, Grafana, Loki e OpenTelemetry mudaram o |
| Dashboards vazios | Fonte de dados não conectada no Grafana | Configure corretamente as conexões no painel de fontes de dados do Grafana | Por que Prometheus, Grafana, Loki e OpenTelemetry mudaram o |
| Métricas não aparecem no Grafana | Prometheus não está coletando do endpoint correto | Revise o job_name e targets no prometheus.yml | Por que Prometheus, Grafana, Loki e OpenTelemetry mudaram o |
| Logs não aparecem no Loki | Promtail não está lendo o arquivo de log | Verifique o caminho em __path__ na configuração do promtail | Por que Prometheus, Grafana, Loki e OpenTelemetry mudaram o |
| Dashboards vazios | Fonte de dados não conectada no Grafana | Configure corretamente as conexões no painel de fontes de dados do Grafana | Por que Prometheus, Grafana, Loki e OpenTelemetry mudaram o |
| Atributos sensíveis continuam aparecendo nos spans exportados. | Processor não foi incluído no pipeline ou chave do atributo está incorreta. | Revise a configuração dos processors e pipelines, e confirme os nomes exatos dos atributos. | Privacidade e compliance: filtrando e mascarando dados sensí |
| O Collector não inicia após alteração no YAML. | Erro de sintaxe na configuração. | Valide o YAML com ferramentas como yamllint e revise a documentação oficial. | Privacidade e compliance: filtrando e mascarando dados sensí |
| Mascaramento não funciona como esperado. | Valor do atributo não é sobrescrito porque o processor não suporta regex. | Use apenas valores fixos para update; para lógica avançada, implemente um processor customizado. | Privacidade e compliance: filtrando e mascarando dados sensí |
| Métricas não aparecem no Grafana | Datasource mal configurado ou Prometheus sem exposição pública | Revise a configuração do datasource e o endpoint do Prometheus | Prometheus e Grafana: recursos avançados e integração com o |
| Alertas não disparam | Alertmanager não configurado ou regras inválidas | Verifique logs do Prometheus e Alertmanager, corrija regras | Prometheus e Grafana: recursos avançados e integração com o |
| Erro ao instalar plugin no Grafana | Permissões insuficientes ou plugin incompatível | Execute como root e confirme compatibilidade na documentação | Prometheus e Grafana: recursos avançados e integração com o |
| Métricas não aparecem no Grafana | Datasource mal configurado ou Prometheus sem exposição pública | Revise a configuração do datasource e o endpoint do Prometheus | Prometheus e Grafana: recursos avançados e integração com o |
| Alertas não disparam | Alertmanager não configurado ou regras inválidas | Verifique logs do Prometheus e Alertmanager, corrija regras | Prometheus e Grafana: recursos avançados e integração com o |
| Erro ao instalar plugin no Grafana | Permissões insuficientes ou plugin incompatível | Execute como root e confirme compatibilidade na documentação | Prometheus e Grafana: recursos avançados e integração com o |
| Métricas ausentes no Prometheus central | Expressão match[] incorreta ou endpoint federate inacessível | Revise a configuração do job federate e teste o endpoint via curl | Prometheus em escala: federation, sharding e remote_write |
| Duplicidade de métricas | Targets sendo coletados por mais de um shard | Garanta que cada target está em apenas um Prometheus | Prometheus em escala: federation, sharding e remote_write |
| Falha no remote_write | Backend externo fora do ar ou endpoint incorreto | Verifique logs do Prometheus e conectividade de rede | Prometheus em escala: federation, sharding e remote_write |
| Métricas ausentes no Prometheus central | Expressão match[] incorreta ou endpoint federate inacessível | Revise a configuração do job federate e teste o endpoint via curl | Prometheus em escala: federation, sharding e remote_write |
| Duplicidade de métricas | Targets sendo coletados por mais de um shard | Garanta que cada target está em apenas um Prometheus | Prometheus em escala: federation, sharding e remote_write |
| Falha no remote_write | Backend externo fora do ar ou endpoint incorreto | Verifique logs do Prometheus e conectividade de rede | Prometheus em escala: federation, sharding e remote_write |
| Job não aparece na aba Targets | Erro de sintaxe no prometheus.yml ou indentação incorreta | Verifique o arquivo com um validador YAML e corrija a indentação. | Prometheus.yml: scrape configs, relabeling e regras de grava |
| Métricas não aparecem nos dashboards | Recording rule mal definida ou não carregada | Cheque o arquivo de regras e a aba 'Rules' no Prometheus. | Prometheus.yml: scrape configs, relabeling e regras de grava |
| Labels inconsistentes entre targets | Falta de relabeling ou labels conflitantes | Ajuste as relabel_configs para padronizar os labels. | Prometheus.yml: scrape configs, relabeling e regras de grava |
| Erro de handshake TLS ao iniciar o nó | Certificados inválidos ou incompatíveis entre os nós | Regere os certificados e valide o CA usado em todos os nós | Protegendo dados sensíveis: criptografia em trânsito e em re |
| Elasticsearch não inicia após ativar criptografia em disco | Volume criptografado não montado no boot | Monte o volume antes de iniciar o serviço Elasticsearch | Protegendo dados sensíveis: criptografia em trânsito e em re |
| Logs de auditoria não aparecem | Configuração de auditoria ausente ou diretório de logs sem permissão | Revise elasticsearch.yml e permissões em /var/log/elasticsearch/ | Protegendo dados sensíveis: criptografia em trânsito e em re |
| Logs ausentes durante o incidente | Falha na ingestão do Fluent Bit ou retenção insuficiente no Loki | Verifique a configuração de output do Fluent Bit e a política de retenção do Loki. | Recuperação de incidentes: do log ao root cause |
| Busca lenta no Loki | Falta de indexação adequada ou excesso de dados não estruturados | Otimize labels e use logs estruturados no pipeline do Fluent Bit. | Recuperação de incidentes: do log ao root cause |
| Impossível correlacionar logs e traces | Ausência de trace_id nos eventos | Configure o Fluent Bit para enriquecer logs com trace_id das requisições. | Recuperação de incidentes: do log ao root cause |
| Cluster permanece em estado red | Shards primários indisponíveis ou índices corrompidos | Restaurar índices a partir de snapshot e verificar integridade dos nós | Recuperando clusters: split brain, nós caindo e índices corr |
| Múltiplos masters nos logs | Quorum de master mal configurado | Ajustar minimum_master_nodes e reiniciar nós | Recuperando clusters: split brain, nós caindo e índices corr |
| Shards UNASSIGNED após queda de nó | Falta de réplicas ou espaço insuficiente | Adicionar nós ou liberar espaço; restaurar de snapshot se necessário | Recuperando clusters: split brain, nós caindo e índices corr |
| O script não executa após o alerta | Permissões insuficientes ou endpoint incorreto | Revise permissões do usuário e o endereço do webhook | Respostas automáticas a incidentes: scripts e integrações |
| Ação é disparada em falso positivo | Consulta Loki muito genérica | Refine a expressão do alerta para ser mais específica | Respostas automáticas a incidentes: scripts e integrações |
| Loop de reinícios automáticos | Critério de disparo não considera tempo mínimo entre execuções | Implemente rate limit ou lock no script | Respostas automáticas a incidentes: scripts e integrações |
| Coletor não recebe tráfego | Balanceador de carga mal configurado ou Collector offline | Revise a configuração do balanceador e verifique o status do Collector | Sharding e replicação: Collector para milhares de serviços |
| Dados duplicados nos exporters | Replicação configurada sem deduplicação | Evite múltiplos exporters para o mesmo destino sem controle | Sharding e replicação: Collector para milhares de serviços |
| Perda de dados após falha de um Collector | Filas locais não persistidas | Reduza o tempo de retenção local ou aumente a replicação | Sharding e replicação: Collector para milhares de serviços |
| O storage enche rapidamente | Retenção longa ou alta cardinalidade de labels | Reduza a retenção ou revise os labels usados | Storage e retenção: sizing para Loki em produção |
| Queries lentas em períodos longos | Backend remoto com alta latência ou volume excessivo de dados | Reduza a janela de consulta ou otimize a infraestrutura do backend | Storage e retenção: sizing para Loki em produção |
| Perda de logs antigos | Retenção configurada abaixo do necessário | Aumente o retention_period e monitore o uso de storage | Storage e retenção: sizing para Loki em produção |
| Logs não aparecem no Loki após atualização | Quebra de compatibilidade ou erro de configuração | Revise changelog, valide sintaxe e teste com configuração mínima | Tendências em observabilidade: open source, IA e beyond |
| Buffer local do Fluent Bit lota rapidamente | Chunk_Size ou Max_Chunks subdimensionados | Aumente valores conforme a documentação e monitore uso de disco | Tendências em observabilidade: open source, IA e beyond |
| Falha na integração com ferramentas externas | Formato de log incompatível ou endpoint incorreto | Ajuste formato de saída e valide endpoint com curl ou netcat | Tendências em observabilidade: open source, IA e beyond |
| Latência muito alta nos testes | CPU saturada ou disco lento | Aumente recursos ou otimize shards/mapeamentos | Testes de carga: simulando produção antes do desastre |
| Erro de conexão no Rally | Elasticsearch não acessível no host/porta informados | Verifique firewall, endereço e status do cluster | Testes de carga: simulando produção antes do desastre |
| Throughput baixo mesmo após ajustes | Gargalo em rede ou configuração de JVM inadequada | Ajuste heap da JVM e verifique largura de banda | Testes de carga: simulando produção antes do desastre |
| Erro 'certificate verify failed' no Fluent Bit | Certificado da CA não corresponde ao do servidor ou hostname divergente. | Verifique se o parâmetro tls.ca_file aponta para o certificado correto e se o CN do certificado bate com o hostname configurado. | TLS na prática: criptografia ponta a ponta em Loki e Fluent |
| Loki não inicia após configuração de TLS | Permissões incorretas na chave privada ou caminho inválido. | Ajuste permissões para 600 e confira os caminhos em config.yaml. | TLS na prática: criptografia ponta a ponta em Loki e Fluent |
| Conexão é estabelecida, mas logs não chegam ao Loki | Porta ou protocolo incorretos no Fluent Bit. | Confirme que o Fluent Bit está usando porta 443 e tls=On. | TLS na prática: criptografia ponta a ponta em Loki e Fluent |
| Erro de certificado inválido ao acessar via HTTPS | Certificado autoassinado ou hostname incorreto | Regere o certificado com o CN correto ou use uma CA confiável | TLS, autenticação e autorização: protegendo Prometheus e Gra |
| Prometheus acessível sem autenticação | Proxy reverso não está ativo ou mal configurado | Revise a configuração do Nginx/Apache e reinicie o serviço | TLS, autenticação e autorização: protegendo Prometheus e Gra |
| Usuários do Grafana conseguem editar dashboards sem permissão | Permissões de usuário mal atribuídas | Revise funções atribuídas e ajuste para Viewer ou Editor conforme necessário | TLS, autenticação e autorização: protegendo Prometheus e Gra |
| Erro de certificado inválido ao acessar via HTTPS | Certificado autoassinado ou hostname incorreto | Regere o certificado com o CN correto ou use uma CA confiável | TLS, autenticação e autorização: protegendo Prometheus e Gra |
| Prometheus acessível sem autenticação | Proxy reverso não está ativo ou mal configurado | Revise a configuração do Nginx/Apache e reinicie o serviço | TLS, autenticação e autorização: protegendo Prometheus e Gra |
| Usuários do Grafana conseguem editar dashboards sem permissão | Permissões de usuário mal atribuídas | Revise funções atribuídas e ajuste para Viewer ou Editor conforme necessário | TLS, autenticação e autorização: protegendo Prometheus e Gra |
| Logs não aparecem no Loki | Filtro descartando tudo ou parser mal configurado | Revise os filtros e teste o parser com exemplos reais | Tuning do Fluent Bit: filtros, parsers e buffers |
| Buffer enche rapidamente | Volume de logs acima do esperado ou destino indisponível | Aumente Buffer_Max_Size ou investigue a disponibilidade do Loki | Tuning do Fluent Bit: filtros, parsers e buffers |
| Logs chegam incompletos | Parser não extrai todos os campos | Ajuste a expressão regular ou formato do parser | Tuning do Fluent Bit: filtros, parsers e buffers |
