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 |