Pular para conteúdo

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 (ou docker logs quantix-collector no site remoto). Mensagens inventário falhou: … / performance falhou: … com o campo device.
  • 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

  1. Coletores mostra Pendente (nunca conectou) ou Offline (sem heartbeat > 120 s na listagem; a engine marca após 3 min).
  2. Veja os logs do coletor:
    • token de coletor inválido ou revogado → gere um novo token (Gerar novo token) e atualize QV_COLLECTOR_TOKEN;
    • aguardando API: … → QV_API_URL errado, DNS, firewall ou certificado. Teste com curl -v $QV_API_URL/api/health a partir do host do coletor;
    • heartbeat falhou / falha ao enviar status intermitentes → instabilidade de rede (o coletor guarda os últimos 500 status e reenvia).
  3. Transporte NATS: erros de conexão com nats://…:4222 indicam 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:

docker compose exec collector curl -skv https://10.0.0.10:443/api/api_version
docker compose exec api       curl -skv https://10.0.0.10:443/api/api_version