Pular para conteúdo

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.

Configurações

  • 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).