Pular para conteúdo

Troubleshooting

Comece pelo sintoma e siga a árvore. Cada folha aponta para a página com o diagnóstico detalhado. Problemas com o ./install.sh ou com o assistente /setup estão em Instalação.

flowchart TD
  S{Sintoma} --> A[Não consigo entrar]
  S --> B[Dispositivo em Aviso/Erro<br/>ou sem dados]
  S --> C[Gráficos vazios para todos]
  S --> D[Sem insights / insights demais]
  S --> E[Interface lenta]
  S --> F[IA não responde]
  A --> A1{HTTP?}
  A1 -->|401| A2[senha errada / LDAP bind / grupo não mapeado] --> AUT[Autenticação]
  A1 -->|423| A3[conta bloqueada] --> AUT
  A1 -->|página não abre| A4[web/api fora: /healthz, /api/health] --> LOG[Logs e diagnóstico]
  B --> B1{last_error}
  B1 -->|acesso negado 401/403| COL[Coleta]
  B1 -->|falha de conexão / timeout / certificado| COL
  B1 -->|coletor offline / não respondeu| COL
  C --> C1{Sistema › ingestão 10 min}
  C1 -->|0 pontos| ING[Ingestão e armazenamento]
  C1 -->|pontos > 0| C2[período/objeto errado ou primeiro ciclo] --> FAQ[FAQ]
  D --> ENG[Engine e insights]
  E --> PERF[Desempenho]
  F --> IA[IA]
  click AUT "autenticacao/" _self
  click COL "coleta/" _self
  click ING "ingestao-e-armazenamento/" _self
  click ENG "engine-e-insights/" _self
  click PERF "desempenho/" _self
  click IA "ia/" _self
  click LOG "logs-e-diagnostico/" _self
  click FAQ "faq/" _self

Tabela rápida

Sintoma Causa mais provável Ação Página
Login retorna “usuário ou senha inválidos” para usuário do AD bind da conta de serviço falhou ou filtro não encontra o usuário Diretórios › Testar com o usuário Autenticação
“usuário temporariamente bloqueado” (HTTP 423) 5 tentativas inválidas desbloquear em Usuários ou quantix reset-admin Autenticação
Dispositivo Erro com acesso negado (401) credencial errada ou sem permissão conferir a credencial e o papel no equipamento Coleta
Dispositivo Erro com falha de conexão … CERTIFICATE_VERIFY_FAILED “Validar certificado TLS” ligado sem CA no coletor instalar a CA no coletor ou desligar a validação Coleta
Teste de conexão: “o coletor não respondeu a tempo” coletor offline ver tela Coletores e logs do coletor Coleta
Sistema mostra ingestão 0 ingestor parado, NATS fora ou insert falhando docker compose logs ingestor Ingestão
Nenhum achado de mudança/previsão histórico insuficiente (3 dias / 5 dias) aguardar Engine
Muitos achados de latência em um array de backup limite global de flash aplicado exceção de threshold Engine
Dashboards lentos em 30–90 dias consulta em rollup sobre muitas séries limitar séries / escalar ClickHouse Desempenho