Changelog¶
7.5.0 — novembro de 2026¶
Microsoft Copilot (Azure OpenAI)¶
- Novo provedor de IA Microsoft Copilot (Azure OpenAI) para o assistente e os resumos executivos.
Diferente do OpenAI padrão, autentica com o cabeçalho
api-key, usaapi-versione oModeloinformado é o nome do deployment do Azure (caminho/openai/deployments/<deployment>/chat/completions). - Configuração em Configurações › Inteligência artificial: Provedor = Microsoft Copilot (Azure OpenAI),
URL do recurso (
https://<recurso>.openai.azure.com), chave, deployment eapi-version. - Os provedores Anthropic Claude e Compatível OpenAI (vLLM, Ollama, gateway on-premise) seguem disponíveis.
7.0.0 — novembro de 2026¶
NetApp StorageGRID (novo plugin)¶
- Novo plugin de coleta NetApp StorageGRID (storage de objeto S3/Swift) via Grid Management API: grid, sites, nós (Admin/Storage/Gateway/Archive), tenants (contas S3/Swift) e buckets.
- Métricas: capacidade utilizável e usada (grid e por site), CPU por nó, operações e transferência S3 do grid e, por tenant/bucket, bytes usados, quantidade de objetos e ocupação da quota.
- Os insights passam a cobrir storage de objeto: ocupação do grid/site/bucket e quota de tenant (saúde, achados e previsão de esgotamento) — o tenant entra na análise de capacidade.
Plugins pela interface¶
- Envio de plugins pela plataforma: o superadministrador envia um módulo de plugin (
.py) em Administração › Plataforma › Plugins de coleta; ele é validado, instalado e passa a aparecer no catálogo — sem reconstruir imagem. Os coletores (local e remotos) sincronizam o novo plugin em segundos, por HTTP, sem acesso ao volume de dados. - Na tela de adicionar dispositivo: botão Incluir plugin e filtro Somente plugins enviados na escolha da plataforma.
- Remoção de plugins enviados pela interface; os embutidos não podem ser sobrescritos nem removidos.
- Enviar um plugin executa código no servidor: a ação é restrita a superadministradores e registrada em auditoria.
Atualização pela interface¶
- Pacote Quantix_update_7.0 pronto para ser enviado e aplicado em Administração › Plataforma › Atualizar versão (backup automático e rollback automático se a nova versão não ficar saudável).
6.2.0 — novembro de 2026¶
Diagnóstico da plataforma¶
- Nova tela Administração › Diagnóstico: verifica se todos os serviços, pacotes e recursos estão em execução e se a plataforma está configurada corretamente, distinguindo o que está em execução (running) do que está pendente (pending), com atalho para resolver cada pendência.
- Cobre serviços (API, web, PostgreSQL, ClickHouse, NATS, ingestor, engine, automação, coletores), schema e coleta de dados, configuração (primeira execução, certificado, diretório, e-mail, IA), recursos (dispositivos, inventário, backup, licença) e o agente do host.
- Os serviços internos passam a registrar um sinal de vida (
service_status), usado para diferenciar serviço ativo de serviço parado ou ainda não implantado.
Instalação de agentes pela interface¶
- Coletor remoto: assistente em Administração › Coletores para instalar um coletor em um host Linux remoto informando host, usuário e credencial SSH na própria tela; a plataforma faz o deploy via runbook Ansible (com aprovação, quando configurada) e mostra o progresso ao vivo. Sem rodar comando no host remoto.
- Agente do host: em Administração › Plataforma, o superadministrador baixa um instalador pré-configurado e executa um único comando no servidor; a tela acompanha e indica “conectado” automaticamente. Reinstalação/atualização também pela interface.
6.1.1 — outubro de 2026¶
Sistemas operacionais¶
- Oracle Linux 8 e 9 passam a ser oficialmente suportados pelo instalador (já funcionavam pela família RedHat; agora estão listados e verificados).
- SUSE Linux Enterprise Server 15 (SP5/SP6) e openSUSE Leap 15 suportados: a role de Docker
ganhou o caminho
zypper(instala Docker e o plugin Compose pelo módulo Containers do SUSE), e o preflight passa a aceitar a família SUSE 15. Em SLES, o módulo Containers precisa estar registrado; o Docker Compose precisa ser 2.24 ou superior (verificado após a instalação). - Ajustes de kernel para o ClickHouse (sysctl, limites, THP) continuam genéricos e valem para as três famílias.
6.1.0 — outubro de 2026¶
Drill-down de métricas (detalhamento das fontes)¶
- Em qualquer gráfico de métrica de performance de um recurso (array, cluster, datastore, controladora, pool…) o botão Detalhar abre o detalhamento: quais recursos compõem aquele valor, ordenados pela contribuição, com gráfico e barra de participação. Cada item pode ser aprofundado, encadeando os níveis (ex.: cluster → datastore → VMs), com trilha de navegação (breadcrumb) para voltar.
- A composição segue dois caminhos: contenção (
parent_id: array → pool → volume; cluster → hipervisor → VM) e relações do coletor (maps_to,runs_on…: um datastore e suas VMs, um volume e os hosts que o acessam). - Métricas extensivas (IOPS, throughput) somam dos filhos para o pai, e cada contribuinte recebe um percentual do total; as intensivas (latência, utilização) mostram o valor próprio de cada recurso, ordenado do pior para o melhor.
- Novo endpoint
POST /api/v1/entities/{id}/breakdown(dimensões disponíveis, contribuintes com valor, participação, série e saúde), respeitando o escopo de tenant do usuário.
6.0.0 — outubro de 2026¶
Instalador que dimensiona o ambiente¶
- O instalador (
./install.sh) começa perguntando quantos ativos serão geridos nos próximos 24 meses — máquinas virtuais, TB de armazenamento e/ou portas de SAN — e, a partir da resposta, recomenda o ambiente: porte, vCPUs, memória, armazenamento (com tipo de disco), containers com réplicas e CPU/RAM de cada um, número de servidores e como alocar os recursos. Base de cálculo embackend/quantix/common/sizing.py(benchmark de escala). - Ambientes muito grandes passam a uma instalação em cluster com vários servidores: o instalador
pergunta nome e IP de cada nó, nome/VIP público e modo de DNS, mostra exatamente quais registros A
(ou linhas de
/etc/hosts) criar, confere a resolução e roda um preflight em todos os nós. - Novos comandos:
./install.sh plan [--json](só o dimensionamento),./install.sh expand(converte um host único em cluster, com migração do histórico do ClickHouse e rollback) e./install.sh agent(instala o agente do host).
Atualização e construção de cluster pela plataforma¶
- Administração › Plataforma (somente superadministrador): dispara a atualização de versão (envio do pacote, verificação SHA-256, backup e rollback automáticos) e a construção/expansão do cluster, com um assistente que pergunta o que for necessário (IPs e nomes dos nós, VIP, ajustes de DNS, acesso SSH) e acompanha a execução com log ao vivo.
- Um agente de host (
deploy/agent, serviço systemd) executa essas operações no servidor sem dar o socket do Docker aos containers. Autentica porQV_AGENT_TOKENe só aceita conexões locais ou de redes privadas.
Saúde dos coletores¶
- Cada coletor informa sua utilização (janela de 15 min: slots, saturação de ciclo, CPU e memória). Acima de 70 % (configurável em Configurações › Coleta) a tela de Coletores sugere criar mais coletores, com link direto para o cadastro e para o guia de instalação de coletor remoto.
- Novos ajustes:
collection.collector_utilization_warn_pct,collection.collector_utilization_critical_pctecollection.collector_device_capacity.
Avaliação e licenciamento¶
- Instalação nova nasce como avaliação de 45 dias com coleta ativa. Terminado o período sem licença, a coleta é desligada e a console fica somente consulta, com aviso do fim do teste.
- Administração › Licença: aplica a chave de licença (assinada), mostra o ID da instalação, a vigência e o volume licenciado × em uso. Acima do volume licenciado há aviso; acima de 110 % novos dispositivos ficam bloqueados.
- As chaves são geradas por uma ferramenta separada do fornecedor (assinatura Ed25519); a plataforma guarda apenas a chave pública. Estado de avaliação selado com a chave mestra e proteção contra retorno do relógio.
Descoberta de rede¶
- Administração › Descoberta de rede: varre faixas de IP (pelo coletor escolhido, local ou remoto) e identifica arrays, switches SAN e gerenciadores de virtualização ainda não cadastrados, por impressão digital não autenticada (portas, certificado TLS, páginas públicas). Os resultados marcam o que já é gerenciado e abrem o assistente de dispositivo pré-preenchido. Varredura limitada em taxa e somente leitura.
Proteção da propriedade¶
- Imagens do backend passam a conter apenas o bytecode do pacote (sem os arquivos
.py); a interface já ia minificada e sem mapas de código. Identificador de build gravado nas imagens e visível em Administração › Sistema. Aviso de propriedade (NOTICE.md) e marca de origem no código.
5.3.s — outubro de 2026 (versão de segurança)¶
Revisão de segurança da plataforma com base no OWASP Top 10 2021, OWASP API Security Top 10 2023, OWASP ASVS 4.0 e CWE, e varredura de dependências e imagens em bases públicas (PyPI Advisory/OSV, GitHub Advisory Database, NVD, Debian Security Tracker e Alpine SecDB) com pip-audit, npm audit, Trivy e Bandit. Relatório completo em Segurança › Relatório 5.3.s.
Controle de acesso (OWASP A01 / API1, API3, API5 — CWE-269, CWE-285, CWE-639)¶
- Configuração da plataforma (usuários, papéis, diretórios, configurações, auditoria, canais e regras de alerta, runbooks, coletores, backups) passa a exigir permissão global: um papel concedido só em um tenant não administra mais a plataforma inteira.
- Anti-escalonamento de privilégio: ninguém concede papéis ou permissões que não possui; acesso
total (
*) e o atributo superadministrador só por superadministradores; ninguém altera os próprios papéis ou o próprio estado; superadministradores só são alterados por outro superadmin. - Isolamento entre tenants nos dispositivos (credencial e coletor do mesmo tenant), importação, achados, automação (alvo e achado do mesmo tenant), aplicações (membros e prévia), assistente de IA (entidades, topologia e visão geral) e nos dados enviados pelos coletores (cada coletor só envia métricas e inventário dos dispositivos que lhe pertencem).
- Criação e rotação de token de coletor e teste de conexão “pelo servidor da API” restritos a superadministradores.
Injeção (OWASP A03 — CWE-78, CWE-94, CWE-1336)¶
- Runbooks Ansible: parâmetros aceitos só se declarados no runbook, com tipo, faixa e formato
validados; textos com marcadores de template são recusados; todas as variáveis entregues ao
Ansible são
!unsafe(nunca avaliadas como Jinja); hosts e usuários SSH validados; comandos montados comargv/quotee--antes do host. - Corrigido erro de YAML no runbook
rescan_esxi. - Expressões regulares de regras de aplicação com tempo limite (CWE-1333) e erro tratado.
Autenticação e sessão (OWASP A07 — CWE-287, CWE-613, CWE-208, CWE-620)¶
- JWT com PyJWT (substitui
python-jose, CVE-2026-85394, eecdsa, CVE-2024-23342), claims obrigatórias e revogação: troca de senha, redefinição, desativação e logout invalidam os tokens já emitidos (token_version). - Refresh token só em cookie
HttpOnly; SameSite=Strict(fora dolocalStorage); o access token não é mais aceito via cookie. - Senha temporária: até trocá-la, o usuário só acessa as rotas de troca de senha.
- Login com tempo constante para usuários inexistentes, mensagem genérica para conta bloqueada, limite de 10 tentativas/min por IP no nginx (HTTP 429) e usuário de diretório preso ao seu diretório. Tokens de API não criam tokens nem trocam senha; validade de 1 a 365 dias.
- StartTLS do LDAP que falha interrompe a conexão antes do envio da senha (CWE-319).
SSRF e segredos (OWASP A10, A02 — CWE-918, CWE-312, CWE-209)¶
- Destinos de webhooks, Teams/Slack, ServiceNow, provedor de IA, SMTP e LDAP validados: loopback, link-local (metadados de nuvem), multicast e serviços internos da plataforma são recusados, inclusive quando o nome resolve para esses endereços. Redes privadas continuam permitidas.
- Trocar o destino de um canal, diretório ou integração exige digitar o segredo de novo (o segredo salvo não é enviado a um destino novo). URLs de webhook com token passam a ser segredo cifrado.
- Clientes REST dos plugins não seguem redirecionamentos para outro host.
- Mensagens de erro do provedor de IA e do teste de canal ficam só no log.
Entrada e recursos (OWASP API4 — CWE-400, CWE-409, CWE-611)¶
- Descompressão do envio do coletor limitada a 512 MiB; preferências limitadas a 64 KB; corpo das requisições limitado a 25 MB (exceto envio de backup e ingestão).
- XML do IBM Spectrum Virtualize lido com
defusedxml(XXE / entity expansion). - Restauração recusa backup sem a impressão digital da
QV_MASTER_KEY. /metricsacessível só de redes privadas.
Dependências e imagens (OWASP A06)¶
- Python:
msgpack≥ 1.2.3 (CVE-2026-114613, GHSA-6v7p-g79w-8964),urllib3≥ 2.8.0 (CVE-2026-97687, CVE-2026-97689),setuptools≥ 78.1.1 (CVE-2025-47273),pip≥ 25. - Frontend:
react-router-dom7.18 (GHSA-9jcx-v3wj-wh4m, GHSA-wrjc-x8rr-h8h6, GHSA-337j-9hxr-rhxg, GHSA-2w69-qvjg-hvjx, GHSA-2j2x-hqr9-3h42),echarts6.1 (GHSA-fgmj-fm8m-jvvx),vite6.4 (18 avisos, entre eles GHSA-vg6x-rcgg-rjx6 e GHSA-x574-m823-4x7w),esbuild(GHSA-67mh-4wv8-2f99) eeslint9.39 (GHSA-xffm-g5w8-qvg7).npm audit: 0 vulnerabilidades. - Imagem backend em Debian 13 (trixie) com pacotes atualizados: corrige zlib (CVE-2023-45853), sqlite (CVE-2025-7458), openssh-client (CVE-2026-60002 e outros), curl, util-linux, systemd, ncurses, perl e OpenLDAP (CVE-2023-2953).
- Imagem web em nginx 1.29 (Alpine atual) com
apk upgrade: corrige OpenSSL (CVE-2026-31789 e outros), curl, expat, libpng, libxml2, musl, pcre2, nghttp2, c-ares, brotli, tiff e zlib.
Correções¶
quantix-update.shpassa a incluir a documentação do produto (/docs/) na imagem web.
Compatibilidade¶
- Usuários com papéis só por tenant deixam de ver telas de administração global (comportamento esperado). Revise os papéis em Administração › Usuários e papéis após atualizar.
- Todas as sessões abertas precisam entrar de novo depois da atualização.
- Canais de Teams/Slack já cadastrados continuam funcionando; ao editar o destino, informe a URL.
5.3.0 — outubro de 2026¶
Coleta e dispositivos¶
- Diagnóstico de falhas: erros de “Testar conexão” e dos ciclos de coleta mostram título, causa
provável, o que verificar e o detalhe técnico, para os 18 plugins (credencial, DNS, porta recusada,
rede inalcançável, timeout, certificado, porta sem HTTPS, conexão encerrada, endereço que não é a
API esperada, HTTP 404/4xx/5xx, comando SSH recusado e formato inesperado), com dicas específicas
de cada plataforma (ex.:
/sdk/vimServiceVersions.xmlno vSphere,feature nxapino Cisco MDS). RestClientpreserva a exceção original, trata timeouts de conexão e sinaliza respostas que não são JSON (páginas HTML, portais de login).- Excluir dispositivo com os dados: opção “Remover também os dados coletados” (insights, mudanças,
exceções de threshold, métricas e histórico de saúde). Aviso na tela de Dispositivos e limpeza dos
dados de dispositivos excluídos anteriormente (
/api/v1/admin/data/orphans). - O comando de instalação de coletor remoto usa a versão em execução.
Relatórios e IA¶
- Relatórios em PDF de qualquer relatório (resumo diário e relatórios da IA), com a identidade Quantix, a logo da organização, tabelas, listas e “Página N de M” (ReportLab, fontes DejaVu).
- Logo dos relatórios: envio em Administração › Sistema (PNG, JPG ou WebP até 2 MB).
- IA gera relatórios: botão “Gerar relatório com IA” (temas executivo, capacidade, performance,
SAN, virtualização ou personalizado; períodos de 24 h a 90 dias) e ferramenta
create_pdf_reportno chat do assistente, com download do PDF na conversa.
Operação¶
- Backup e restauração pela plataforma (Administração › Sistema): PostgreSQL completo e,
opcionalmente, o histórico de métricas do ClickHouse; download, envio de arquivo
.qvbak, restauração com backup de segurança automático, verificação daQV_MASTER_KEYe compatibilidade de colunas entre versões. Backup automático diário configurável (Configurações › Backup) e CLIquantix backup create | list | restore. - Atualização com rollback:
deploy/scripts/quantix-update.sh update | rollback [--with-data] | status(backup, ponto de rollback com arquivos e imagens, verificação de saúde e retorno automático em caso de falha). Histórico de versões em Administração › Sistema.
Correções¶
/api/docs(Documentação da API) aparecia em branco: o Swagger UI vinha de um CDN bloqueado pela CSP e indisponível sem internet. Agora é servido pela própria API (swagger-ui-dist 5.17.14, embutido na imagem e conferido por SHA-256). O ReDoc (/api/redoc), que tinha o mesmo problema, foi retirado.
Novas variáveis¶
backup.enabled,backup.hour,backup.keep,backup.include_metrics.
Atualizando a partir da 1.0.0¶
- Na pasta da instalação:
bash deploy/scripts/quantix-update.sh update quantix-vision-ai-5.3.zip. As tabelas novas (brand_assets,platform_versions) são criadas automaticamente no primeiro boot.
1.0.0 — outubro de 2026¶
Primeira versão.
Instalação¶
- Instalador guiado
./install.sh(local ou via SSH): perguntas mínimas, arquivo de respostas para modo não interativo, verificações do servidor (preflight) antes de qualquer alteração, imagens por registro, build no servidor ou pacote offline (./install.sh bundle), ajuste automático dos limites de CPU ao servidor, comandosstatus,setup-linkeupgrade. - Assistente de primeira execução
/setup(token de instalação): administrador, organização, certificado HTTPS (PEM ou PFX, com validação), diretório AD/LDAP com grupos → papéis, e-mail e revisão. - Troca do certificado HTTPS pela GUI (Administração › Sistema) com recarga automática do nginx.
- Bootstrap da API serializado por advisory lock do PostgreSQL (vários workers iniciando juntos).
Coleta¶
- Contrato de plugins (
test_connection,collect_inventory,collect_performance) com catálogo canônico de 25 tipos de objeto, 12 relações e 33 métricas. - 17 plugins de fabricante: Dell PowerMax/VMAX, Unity, PowerStore, PowerScale; Pure FlashArray, FlashBlade; NetApp ONTAP; Huawei OceanStor; IBM Storage Virtualize, DS8000; Hitachi VSP; HPE 3PAR/Primera/Alletra; Infinidat InfiniBox; Brocade FOS; Cisco MDS; VMware vSphere; Nutanix Prism. Mais o simulador de laboratório com anomalias injetadas.
- Coletor com agendamento alinhado, isolamento por dispositivo, tarefas sob demanda (testar, coletar agora, recarregar) e transporte NATS ou HTTPS para sites remotos.
Dados¶
- NATS JetStream (stream
QV_DATA, object storeqv-inventory) e ingestores horizontais com ack após persistência. - ClickHouse com tabelas bruta, horária, diária, último valor e histórico de saúde. TTL por camada
configurável na GUI. Modo cluster nativo (
Replicated*+Distributed, failover de conexão). - PostgreSQL para inventário/topologia/configuração, com aplicação atômica de snapshots e trilha de mudanças.
Análise¶
- Ratings com thresholds dinâmicos (mídia, tamanho de I/O, modelo de capacidade de controladora, velocidade de porta) e exceções por objeto/dispositivo/tipo.
- Change detection robusta (mediana/MAD sazonal), previsão Theil-Sen, balanceamento por CV, 7 regras de configuração SAN/virtualização, correlação por WWPN/NAA, aplicações de negócio.
- Ciclo de vida dos achados com prioridade, resolução automática, silenciamento e notas.
- Resumo executivo diário (engine e/ou IA).
Experiência¶
- Interface web pt-BR (React) com visão geral, dashboards (12 tipos de widget, compartilhamento, duplicação, CSV, impressão/PDF), exploradores de inventário, página de objeto, topologia ponta a ponta, insights, capacidade, mudanças, aplicações e automação.
- Assistente de IA com ferramentas (Anthropic ou compatível OpenAI/on-premise), anonimização e explicação de achados.
- Alertas: webhook, Microsoft Teams, Slack, e-mail, syslog, ServiceNow, com deduplicação e runbooks.
- Automação Ansible com 6 runbooks, aprovação e segregação de funções.
Segurança e operação¶
- JWT, tokens de API, LDAP/AD/FreeIPA com grupos aninhados, RBAC por tenant, cifragem Fernet,
Argon2, auditoria, bloqueio de conta,
reset-admin. - Docker Compose (host único, scale, cluster, laboratório), Ansible (instalação, coletores, backup, restauração, upgrade), Helm, backup/restore, benchmark de escala, documentação MkDocs.
Correções finais¶
- Lotes de métricas agora são divididos em mensagens de até 50 mil linhas (~3,4 MB), abaixo do limite de 8 MiB do NATS.
- Runbook de rescan de HBAs (
rescan_host_paths) passa a conectar via SSH no host ESXi alvo.
Limitações conhecidas¶
- Plugins validados apenas com respostas gravadas, sem teste em hardware real.
- Imagens Docker não construídas no ambiente de desenvolvimento desta versão. DDL de cluster ClickHouse validado só via chdb.
- Escopo de tenant não aplicado em todos os endpoints (detalhes).
- Tamanho dos rollups: o estado do percentil (TDigest) torna
metrics_1h/metrics_1dmaiores que a tabela bruta no longo prazo. Recomenda-se retenção 180/730 dias em ambientes grandes. Evoluções previstas:CODEC(ZSTD)nas colunas de estado (−35 % medido) e percentil opcional no rollup diário. - Engine com várias réplicas: jobs não executam em paralelo, mas podem executar com mais frequência que o intervalo (HA).
- Endereços adicionais de um dispositivo não são usados para failover automático (o plugin usa o primeiro).
general.languageegeneral.timezoneainda não têm efeito (interface pt-BR, fuso America/Sao_Paulo).- NATS indisponível causa perda dos ciclos publicados pelo coletor nesse período (não há fila local).