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-0042com 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)