Troubleshooting — coleta¶
Onde ver o erro¶
- Administração › Dispositivos: status (Novo, Coletando, Aviso após 1–2 falhas seguidas,
Erro a partir da 3ª) e a última mensagem (
last_error), com prefixo[inventory]ou[performance]. O campo é limpo no próximo inventário bem-sucedido. - Testar conexão mostra a mensagem do plugin e de onde foi testado (nome do coletor ou “servidor da API”).
- Logs do coletor:
docker compose logs collector(oudocker logs quantix-collectorno site remoto). Mensagensinventário falhou: …/performance falhou: …com o campodevice. - Para ver por que endpoints opcionais foram ignorados, rode o coletor com
QV_LOG_LEVEL=DEBUG.
Mensagens comuns¶
| Mensagem | Significado | Ação |
|---|---|---|
AuthError: acesso negado (401) em <url>: verifique credencial e permissões |
usuário/senha/token inválidos | confira a credencial. Para Pure/FlashBlade o tipo deve ser token |
acesso negado (403) … |
autenticou, mas sem permissão para aquele endpoint | conceda o papel mínimo de Plataformas suportadas (ex.: PowerMax Monitor + registro de performance; ONTAP com aplicação http) |
HTTP 404 em … |
endpoint inexistente na versão do firmware | verifique a versão mínima (ONTAP 9.8+, FOS 8.2.1+, Purity REST 2.x). Endpoints opcionais já são ignorados |
HTTP 5xx em … |
erro no gerenciador do equipamento (o plugin já repete 2 vezes) | verifique a saúde da gerência. Gerências sobrecarregadas: aumente o intervalo |
falha de conexão com https://host:porta: … |
rede, DNS, porta errada, TLS | teste a partir do host do coletor: curl -kv https://host:porta/ |
… CERTIFICATE_VERIFY_FAILED … |
“Validar certificado TLS” ligado e a CA do equipamento não é confiável no coletor | instale a CA (SSL_CERT_FILE) ou desligue a validação para o dispositivo |
ReadTimeout / TimeoutError |
resposta mais lenta que collection.request_timeout_s (60 s) ou que o timeout do ciclo |
aumente collection.request_timeout_s. Para performance, o limite do ciclo é 90 % do intervalo |
SSH: usuário ou senha inválidos |
IBM Storage Virtualize | confira a senha ou use credencial ssh_key |
SSH: falha ao conectar em host:22: … |
porta fechada, SSH desabilitado | libere 22 a partir do coletor |
comando 'lsxxx' falhou (…): CMMVC… |
comando CLI rejeitado (permissão ou versão) | usuário no grupo Monitor; volume_iostats exige startstats e SFTP |
dispositivo sem endereço configurado |
cadastro sem IP/FQDN | edite o dispositivo |
plugin desconhecido: … |
plugin não carregado no coletor (versão antiga do coletor) | atualize a imagem do coletor |
o coletor não respondeu a tempo; verifique se está online |
tarefa de teste não foi atendida em 90 s | ver coletor offline |
dispositivo não está atribuído a este coletor (coletar agora) |
a atribuição mudou e o coletor ainda não recarregou | aguarde até 60 s ou reinicie o coletor |
Notas por fabricante¶
| Plataforma | Sintoma | Explicação |
|---|---|---|
| Dell Unity | sem IOPS/latência nos primeiros ciclos | a consulta de métricas em tempo real é criada no 1º ciclo e a base no 2º; os dados começam no 3º |
| Infinidat | sem performance no 1º ciclo | o collector de métricas recém-criado só tem dados no ciclo seguinte |
| PowerMax, 3PAR | intervalo não aceita < 300 s | a granularidade do fabricante é 5 min (min_perf_interval_s=300) |
| IBM DS8000 | nenhuma métrica de I/O | esperado: a REST pública só expõe capacidade |
| Hitachi VSP | só capacidade | configure export_dir com os CSVs do Export Tool (caminho no host do coletor; monte o diretório no container) |
| IBM Storage Virtualize | sem performance por volume | habilite volume_iostats (requer startstats -interval 5 e SFTP) |
| VMware | VM sem backed_by para o volume |
datastores NFS/vSAN/vVols não têm NAA; RDM não gera uses |
| Brocade | WWPN logado não casa com a porta | endereçamento estendido (FCID) pode não casar pelo byte de área |
| Cisco MDS | contador ausente | os nomes variam por release do NX-OS. Ausentes são ignorados |
Coletor offline¶
- Coletores mostra Pendente (nunca conectou) ou Offline (sem heartbeat > 120 s na listagem; a engine marca após 3 min).
- Veja os logs do coletor:
token de coletor inválido ou revogado→ gere um novo token (Gerar novo token) e atualizeQV_COLLECTOR_TOKEN;aguardando API: …→QV_API_URLerrado, DNS, firewall ou certificado. Teste comcurl -v $QV_API_URL/api/healtha partir do host do coletor;heartbeat falhou/falha ao enviar statusintermitentes → instabilidade de rede (o coletor guarda os últimos 500 status e reenvia).
- Transporte NATS: erros de conexão com
nats://…:4222indicam que o coletor não alcança o barramento. Para sites remotos, use HTTPS.
Testar a partir do coletor ou do servidor¶
Testar conexão usa o coletor atribuído quando ele está online. A API também aceita
from_server: true (POST /api/v1/devices/{id}/test) para testar a partir do container da API e
isolar se o problema é de rede do coletor. Equivalente manual: