Configurações¶
Administração › Configurações reúne todas as variáveis operacionais da plataforma, agrupadas
por categoria. Os formulários são gerados a partir do registro no código
(common/settings_registry.py), com tipo, faixa válida, padrão e descrição. Nenhum arquivo
precisa ser editado. Leitura: view; alteração: settings.manage.

- Valores fora da faixa são recusados (HTTP 422, com mensagem por campo) e nada é gravado.
- Segredos (
ai.api_key,notifications.smtp_password) são cifrados e exibidos como********. - As alterações valem em até ~30 s para API, coletores e engine (cache de configurações). A engine relê a cada ciclo.
- Alterar retenção aplica imediatamente o novo TTL nas tabelas do ClickHouse.
- Toda alteração vai para a auditoria (
settings_updated, com os valores novos, exceto segredos).
A tabela completa (chave, descrição, tipo, padrão, faixa) é gerada do código: Variáveis da plataforma.
As mais importantes¶
| Variável | Padrão | Quando mudar |
|---|---|---|
general.base_url |
vazio | defina com a URL pública (ex.: https://quantix.empresa.local): ela entra nos links das notificações e no comando de instalação de coletores |
collection.default_perf_interval_s / port_perf_interval_s |
300 / 60 s | intervalos menores aumentam a granularidade e o volume de dados (ver sizing). Valem para novos dispositivos |
collection.max_parallel_devices |
32 | coletores com muitos dispositivos lentos |
collection.request_timeout_s |
60 s | gerências lentas (arrays grandes, links WAN) |
retention.raw_days / hourly_days / daily_days |
35 / 400 / 1830 | principal alavanca de disco do ClickHouse. Para ambientes grandes, recomenda-se 35 / 180 / 730 (disco) |
analytics.change_z_warning / change_z_critical / change_min_hours |
4 / 7 / 3 h | muitos achados de mudança: aumente z ou a persistência |
analytics.balance_cv_warning |
0,35 | sensibilidade do balanceamento |
thresholds.* |
ver referência | limites globais de saúde. Para casos específicos use exceções |
ai.enabled, ai.provider, ai.model, ai.base_url, ai.api_key |
desligado, anthropic, claude-sonnet-5-5 |
habilitar o assistente (IA) |
ai.share_entity_names |
ligado | desligue para anonimizar nomes enviados ao provedor |
notifications.smtp_*, dedup_minutes |
— / 240 min | e-mail e deduplicação de alertas |
security.local_auth_enabled |
ligado | desligue para exigir diretório (superadministradores locais continuam podendo entrar) |
security.session_minutes, lockout_*, password_min_length |
30 min, 5 tentativas/15 min, 12 | política de segurança |
security.audit_reads |
desligado | registrar também perguntas à IA |
Variáveis sem efeito na v1.0.0
general.language e general.timezone são exibidas, mas ainda não são usadas pelo código: a
interface é sempre pt-BR e as datas são mostradas em America/Sao_Paulo. As variáveis
thresholds.flash_latency_* e thresholds.hybrid_latency_* são usadas (a engine monta a
chave dinamicamente conforme a mídia).