Dispositivos¶
Um dispositivo é um equipamento ou gerenciador monitorado: array, switch FC, vCenter, Prism
Central etc. Cada um usa um plugin (interface do fabricante), uma credencial e um coletor.
Permissão: devices.manage.

Cadastrar pelo assistente¶
Administração › Dispositivos › Adicionar dispositivo, em três etapas:
-
Plataforma: escolha o fabricante/produto (filtro por texto). Cada cartão mostra a interface e os requisitos de acesso mínimo.

-
Conexão:
Campo Observações Nome único por tenant. Aparece em toda a plataforma Tenant escopo do dispositivo (multi-tenant) Endereços (IP/FQDN) o plugin usa o primeiro endereço. Os demais ficam registrados como alternativos (failover entre gerenciadores não é automático na v1.0.0) Porta vazio = porta padrão do plugin Credencial perfis do tipo aceito pelo plugin. Dá para criar uma nova ali mesmo Opções do plugin ex.: symmetrix_id,export_dir,vf_id,volume_iostats(tabela abaixo)Coletor vazio = atribuição automática (coletor online com menos dispositivos) quando collection.auto_assignestá ativoIntervalo de performance / inventário vazio = padrões globais (300 s; 60 s para switches; inventário 3600 s). Nunca abaixo do mínimo do plugin Tags separadas por vírgula. Usadas em aplicações e filtros Validar certificado TLS desligado por padrão. Ative com CA instalada no coletor Coleta ativa desligado = dispositivo cadastrado, sem coleta -
Teste e salvar: Testar conexão executa
test_connection()pelo coletor atribuído (se estiver online) ou pelo servidor da API. O resultado mostra de onde foi testado, a mensagem e o modelo/serial/firmware encontrados. Salve com Salvar dispositivo ou Salvar mesmo assim.
Ao salvar, o coletor recebe uma tarefa reload e começa o inventário em segundos. A
performance começa ~5 s depois e se alinha à próxima fronteira do intervalo.
Ações na lista¶
Editar, Testar conexão, Coletar agora (inventário + performance imediatos no coletor) e Excluir (remove inventário, relações e saúde; as métricas históricas expiram pela retenção). O status do dispositivo vai de Novo → Coletando (ok) → Aviso (1–2 falhas seguidas) → Erro (3+), com a última mensagem de erro (ver Troubleshooting › Coleta).
Importação em lote (CSV)¶
Importar CSV aceita até 5.000 linhas, valida cada linha no navegador e mostra o erro por linha antes de enviar.

Colunas: name, plugin, address, port, credential, collector, tags. Vários endereços ou tags são
separados por ; (ou |). Credencial e coletor são informados pelo nome cadastrado (ou ID).
Use Baixar modelo CSV:
name,plugin,address,port,credential,collector,tags
PURE-DC1-01,pure_flasharray,10.0.0.10;10.0.0.11,,svc-quantix,coletor-local,producao;dc1
SAN-A-CORE,brocade_fos,10.0.1.5,,svc-san,,
As opções do plugin recebem os valores padrão. Ajuste depois pela edição, se necessário. Nomes já existentes são rejeitados ("já existe").
Pré-requisitos por fabricante¶
A tabela completa (interface, porta padrão, intervalo mínimo e permissão mínima) é gerada do
código em Plataformas suportadas. Notas operacionais e
limitações conhecidas de cada plugin (de backend/quantix/collector/plugins/README.md):
Plugin (key) |
Opções | Notas e limitações |
|---|---|---|
Dell PowerMax/VMAX (dell_powermax) |
symmetrix_id (vazio = 1º array local), volume_perf |
Unisphere REST 8443. Array registrado para performance (Diagnostic). Granularidade de 5 min. 1 chamada por volume no inventário (concorrência 8). SRDF não modelado |
Dell Unity (dell_unity) |
— | 1º ciclo cria a consulta de métricas, o 2º grava a base e as métricas de I/O começam no 3º ciclo. NAS e replicação não modelados |
Dell PowerStore (dell_powerstore) |
max_volumes_perf (2000) |
appliance modelado como pool. Performance por volume = 1 chamada/volume |
Pure FlashArray (pure_flasharray) |
— | credencial do tipo token (API token readonly). Pool lógico shared. Pods/ActiveCluster não modelados |
NetApp ONTAP (netapp_ontap) |
— | ONTAP 9.8+. Usuário com aplicação http e papel readonly. igroup = host, FlexVol = file system. Sem cache hit; NVMe/SnapMirror não modelados |
Huawei OceanStor (huawei_oceanstor) |
scope (0 local, 1 LDAP) |
DeviceManager 8088. IDs de indicador variam entre V3/V5/V6 (os ausentes são ignorados) |
IBM Storage Virtualize (ibm_spectrum_virtualize) |
volume_iostats |
SSH 22 (senha ou chave). Sem volume_iostats não há performance por volume (exige startstats e SFTP). Amostra de 5 s |
IBM DS8000 (ibm_ds8000) |
— | REST da HMC 8452. Somente inventário e capacidade: sem performance de I/O (a REST pública não expõe contadores). Volumes CKD ignorados |
Hitachi VSP (hitachi_vsp) |
storage_device_id, export_dir |
REST só tem inventário/capacidade. Performance via Export Tool: CSV/ZIP agendados em export_dir, um caminho no host do coletor. Sem export_dir = só capacidade. Formato do CSV varia por microcódigo |
HPE 3PAR/Primera/Alletra (hpe_3par) |
— | WSAPI 8080 (Alletra: 443). System Reporter (licença em 3PAR). Hires = 5 min |
Infinidat InfiniBox (infinidat_infinibox) |
max_volumes_perf (500) |
collector de métricas recém-criado só tem dados no ciclo seguinte |
Pure FlashBlade (pure_flashblade) |
— | token. Sem separação por protocolo; sem performance por bucket |
Dell PowerScale (dell_powerscale) |
— | OneFS 8080. Privilégios ISI_PRIV_* somente leitura. Quotas sem limite só têm cap_used |
Brocade FOS (brocade_fos) |
vf_id |
FOS 8.2.1+, REST habilitado. 1 dispositivo = 1 switch lógico. O casamento de WWPN logado com porta usa o byte de área do FCID: endereçamento estendido pode não casar |
Cisco MDS (cisco_mds) |
— | feature nxapi, papel network-operator. Fabric = VSAN. Nomes de contadores variam por release |
VMware vSphere (vmware_vsphere) |
collect_tags |
papel Read-only propagado da raiz. Contadores realtime (20 s, ~1 h de histórico). NFS/vSAN/vVols sem NAA (sem correlação com volume). RDM não gera uses |
Nutanix Prism (nutanix_prism) |
— | 9440, papel Viewer. Prism Central sem proxy v2.0 terá só inventário v3 |
Simulador (simulator) |
perfil, tamanhos | laboratório e demonstração, com anomalias injetadas |
Validação dos plugins
Todos os plugins de fabricante foram testados somente com respostas de API gravadas. Rode cada um contra um equipamento de laboratório antes de usar em produção e confira, na página do objeto, se as métricas batem com a ferramenta do fabricante.