Pular para conteúdo

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.

Dispositivos

Cadastrar pelo assistente

Administração › Dispositivos › Adicionar dispositivo, em três etapas:

  1. Plataforma: escolha o fabricante/produto (filtro por texto). Cada cartão mostra a interface e os requisitos de acesso mínimo.

    Assistente — plataforma

  2. 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_assign está ativo
    Intervalo 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
  3. 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.

Importação CSV

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.