Pular para conteúdo

Laboratório (tudo em um)

O modo laboratório sobe uma plataforma completa com ClickHouse embutido (chdb) e o simulador, para demonstração, POC, treinamento e desenvolvimento. Arquivo: docker-compose.lab.yml.

Diferença em relação à produção Por quê
sem servidor ClickHouse: a API usa chdb em /var/lib/quantix/chdb (volume quantix-lab-data) menos containers e memória
ingestor e engine rodam dentro do processo da API (QV_EMBEDDED_WORKERS=true) o chdb só pode ser aberto por um processo
API com 1 worker o chdb mantém lock exclusivo do diretório de dados
imagem de backend com tag -lab (--build-arg WITH_CHDB=true) inclui a dependência chdb
automação opcional (--profile automation) —

Subir

make gen-env            # .env com segredos fortes (preserva os existentes)
make build-lab build-web
make demo               # sobe o lab e carrega 21 dias de histórico simulado
# acesso: https://<host>/   usuário admin, senha = QV_ADMIN_PASSWORD do .env

Manualmente:

docker compose -f docker-compose.lab.yml up -d --wait api      # bootstrap (schema, admin, coletor)
docker compose -f docker-compose.lab.yml stop collector api    # libera o lock do chdb
docker compose -f docker-compose.lab.yml --profile demo run --rm demo-seed demo-seed --days 21
docker compose -f docker-compose.lab.yml up -d

O que a carga de demonstração cria

quantix demo-seed --days N --arrays 2 --hosts 40 --step 900 cria (se não existirem) os dispositivos simulados array-00 (all-flash), array-01 (híbrido), SAN-FABRIC-A, SAN-FABRIC-B, vcenter-prod e prism-central, aplica o inventário e grava N dias de histórico (um ponto a cada 15 min) direto no banco de séries. A coleta contínua segue depois pelo coletor (simulador). Anomalias injetadas para a engine encontrar:

  • Pool0 do array-00 crescendo rápido (previsão de esgotamento);
  • volume 7 de cada array com pico de latência nas últimas 36 h e aumento de carga no array-00 nas últimas 10 h (change detection);
  • controladora A do array-01 com ~75 % da carga (balanceamento);
  • volumes sem mapeamento (órfãos), host-005 sem caminho no fabric B (fabric único);
  • porta 3 de cada switch com erros CRC crescentes, porta do host-009 com slow drain;
  • zona com membro não logado (zona morta), VM vm-0042 com rajadas de I/O.

Em ~1 minuto após subir, a engine roda o primeiro ciclo e os insights aparecem.

chdb e o lock do diretório

O demo-seed grava direto no chdb e por isso exige a API parada (o alvo make demo faz isso). Com a API em execução, a carga falha ao abrir o diretório. O mesmo vale para qualquer ferramenta que abra /var/lib/quantix/chdb.

Em produção (ClickHouse servidor), a carga de demonstração pode rodar com a plataforma no ar: make seed (quantix demo-seed com QV_TSDB_BACKEND=clickhouse).

Ambiente de desenvolvimento sem Docker

O backend roda direto em um virtualenv (pip install -e 'backend[dev,automation]'), com PostgreSQL 16 e nats-server locais e QV_TSDB_BACKEND=chdb. Um exemplo de variáveis:

export QV_PG_DSN=postgresql+asyncpg://quantix@127.0.0.1:5433/quantix
export QV_TSDB_BACKEND=chdb QV_CHDB_PATH=/var/tmp/qvchdb QV_DATA_DIR=/var/tmp/qvdata
export QV_NATS_URL=nats://127.0.0.1:4223 QV_EMBEDDED_WORKERS=true
export QV_ADMIN_PASSWORD='Admin@12345678' QV_COLLECTOR_TOKEN=qvc_devtoken_local QV_API_URL=http://127.0.0.1:8000
quantix api --port 8000 --workers 1 &   # API + ingestor + engine
quantix collector &                     # coletor
cd frontend && npm install && npm run dev   # http://localhost:5173 (proxy /api → :8000)