Pular para conteúdo

Variáveis da plataforma

Todas as variáveis abaixo são editadas em Administração › Configurações (nenhum arquivo precisa ser alterado). Valores secretos são cifrados com a chave mestra e nunca são exibidos.

Geral

Chave Descrição Tipo Padrão Faixa
general.instance_name Nome da instalação str Quantix Vision AI
general.language Idioma padrão select pt-BR pt-BR, en
general.timezone Fuso horário str America/Sao_Paulo
general.base_url URL pública da plataforma. Usada em links de notificações e relatórios. str vazio

Coleta

Chave Descrição Tipo Padrão Faixa
collection.default_perf_interval_s Intervalo padrão de performance. Aplicado a novos dispositivos. int 300 s 60 – 3600 s
collection.default_inventory_interval_s Intervalo padrão de inventário int 3600 s 300 – 86400 s
collection.port_perf_interval_s Intervalo de performance de switches. Portas SAN se beneficiam de granularidade de 1 minuto. int 60 s 30 – 900 s
collection.request_timeout_s Timeout de requisição int 60 s 5 – 600 s
collection.max_parallel_devices Dispositivos coletados em paralelo por coletor int 32 1 – 256
collection.spool_max_mb Spool do coletor: tamanho máximo. Fila local em disco quando o NATS/ingestão fica fora; ao estourar, descarta o mais antigo. int 200 MB 0 – 100000 MB
collection.spool_max_age_h Spool do coletor: idade máxima. Descarta itens do spool mais antigos que isso. int 24 h 0 – 8760 h
collection.allow_beta_plugins Permitir plugins beta. Ligado por padrão. Desligado, os conectores em beta somem do cadastro; os devices já existentes continuam coletando, com o selo BETA. bool True
collection.failover_after_min Failover de coletor após. Sem heartbeat por este tempo, os dispositivos do coletor são redistribuídos entre os demais do mesmo grupo (site); voltam quando ele retorna. int 5 min 1 – 120 min
collection.auto_assign Atribuir coletor automaticamente. Distribui novos dispositivos entre coletores online pelo menor número de dispositivos. bool True
collection.collector_utilization_warn_pct Utilização de coletor para alerta. Acima deste valor (maior entre slots ocupados, duração dos ciclos, CPU e memória do coletor) a tela de coletores sugere criar coletores adicionais. int 70 % 10 – 100 %
collection.collector_utilization_critical_pct Utilização de coletor crítica. Acima deste valor o coletor é marcado como crítico: ciclos tendem a atrasar ou estourar o timeout. int 90 % 10 – 100 %
collection.collector_device_capacity Capacidade estimada por coletor. Dispositivos (equivalentes a intervalo de 5 min) que um coletor atende. Usado só para estimar a utilização de coletores de versões anteriores, que não reportam a própria carga. int 25 dispositivos 1 – 5000 dispositivos

Ingestão

Chave Descrição Tipo Padrão Faixa
ingestion.stream_max_bytes_gb Buffer de ingestão: tamanho. Tamanho do buffer QV_DATA. Dimensione para aguentar o ClickHouse fora pelo tempo desejado (ver Dimensionamento). 0 = sem limite de tamanho. int 20 GB 0 – 100000 GB
ingestion.stream_max_age_h Buffer de ingestão: retenção. Idade máxima das mensagens no buffer antes do descarte. int 24 h 1 – 720 h
ingestion.backpressure_pct Contrapressão a partir de. Acima desta ocupação do buffer, os coletores passam a reter no spool local em vez de publicar, até o buffer esvaziar. int 80 % 10 – 100 %

Retenção de dados

Chave Descrição Tipo Padrão Faixa
retention.raw_days Dados brutos. Pontos no intervalo de coleta. int 35 dias 1 – 400 dias
retention.hourly_days Agregado horário int 400 dias 30 – 1830 dias
retention.daily_days Agregado diário int 1830 dias 365 – 3650 dias
retention.findings_days Achados resolvidos int 365 dias 30 – 1830 dias
retention.audit_days Log de auditoria int 730 dias 90 – 3650 dias

Engine de análise

Chave Descrição Tipo Padrão Faixa
analytics.ratings_interval_s Frequência do cálculo de saúde int 300 s 60 – 3600 s
analytics.change_baseline_days Período de referência (change detection). Dias usados como linha de base, mesma hora do dia. int 14 dias 3 – 60 dias
analytics.change_z_warning Desvio robusto para aviso. Z-score robusto (mediana/MAD) que dispara aviso. float 4.0 2 – 20
analytics.change_z_critical Desvio robusto para crítico float 7.0 3 – 30
analytics.change_min_hours Persistência mínima. Horas consecutivas fora do padrão antes de gerar achado. int 3 h 1 – 24 h
analytics.forecast_history_days Histórico para previsão de capacidade int 90 dias 14 – 730 dias
analytics.balance_cv_warning Desequilíbrio (coeficiente de variação). Coeficiente de variação de carga entre componentes pares. float 0.35 0.1 – 2.0
analytics.balance_min_load_mbps Carga mínima para avaliar balanceamento float 50 MB/s
analytics.correlation_interval_s Frequência de correlação de topologia int 900 s 300 – 86400 s

Thresholds

Chave Descrição Tipo Padrão Faixa
thresholds.flash_latency_warn_ms Latência flash: aviso float 2.0 ms
thresholds.flash_latency_crit_ms Latência flash: crítico float 5.0 ms
thresholds.hybrid_latency_warn_ms Latência híbrido/HDD: aviso float 10.0 ms
thresholds.hybrid_latency_crit_ms Latência híbrido/HDD: crítico float 20.0 ms
thresholds.vm_latency_warn_ms Latência de VM: aviso float 10.0 ms
thresholds.vm_latency_crit_ms Latência de VM: crítico float 25.0 ms
thresholds.util_warn_pct Utilização: aviso float 70.0 %
thresholds.util_crit_pct Utilização: crítico float 85.0 %
thresholds.capacity_warn_pct Ocupação de capacidade: aviso float 80.0 %
thresholds.capacity_crit_pct Ocupação de capacidade: crítico float 90.0 %
thresholds.capacity_days_warn Esgotamento previsto: aviso int 90 dias
thresholds.capacity_days_crit Esgotamento previsto: crítico int 30 dias
thresholds.port_errors_warn Erros de porta por hora: aviso int 10
thresholds.port_errors_crit Erros de porta por hora: crítico int 100
thresholds.bb_credit_zero_warn_ms Tempo sem buffer credit/intervalo: aviso float 100.0 ms
thresholds.bb_credit_zero_crit_ms Tempo sem buffer credit/intervalo: crítico float 1000.0 ms
thresholds.repl_lag_warn_s Atraso de replicação: aviso float 300.0 s
thresholds.repl_lag_crit_s Atraso de replicação: crítico float 1800.0 s

Inteligência artificial

Chave Descrição Tipo Padrão Faixa
ai.enabled Habilitar IA generativa. Sem IA, a engine continua gerando insights por regras e estatística. bool False
ai.mode Modo de operação. local_only: só o bloco primário (IA local). cloud_first: primário (nuvem) com fallback automático para o secundário (local) via circuit breaker. local_first: primário (local) e o secundário (nuvem) só para tarefas pesadas (relatórios). select local_only local_only, cloud_first, local_first
ai.provider Provedor (primário) select anthropic anthropic, copilot, openai_compatible
ai.model Modelo. No Microsoft Copilot (Azure OpenAI), informe o nome do deployment (ex.: gpt-4o). str claude-sonnet-5-5
ai.base_url URL base (Copilot / OpenAI compatível). Copilot (Azure OpenAI): a URL do recurso, ex.: https://.openai.azure.com. str vazio
ai.azure_api_version api-version (Copilot / Azure). Usado apenas pelo provedor Microsoft Copilot (Azure OpenAI). Ex.: 2024-10-21. str 2024-10-21
ai.api_key Chave de API. Copilot (Azure OpenAI): a chave do recurso (enviada no cabeçalho api-key). secret —
ai.daily_summary Resumo executivo diário bool True
ai.daily_summary_hour Hora do resumo diário int 7 h 0 – 23 h
ai.max_tokens Máximo de tokens por resposta int 4096 256 – 32000
ai.share_entity_names Enviar nomes de objetos ao provedor. Desligue para anonimizar nomes de hosts/VMs antes de enviar ao LLM. Vale para qualquer provedor de nuvem, inclusive no modo com fallback. bool True
ai.secondary.provider Provedor (secundário) select openai_compatible anthropic, copilot, openai_compatible
ai.secondary.model Modelo (secundário). Ex.: qwen2.5:14b-instruct (GPU) ou qwen2.5:7b-instruct (CPU) para a IA local. str vazio
ai.secondary.base_url URL base (secundário). IA local Ollama no compose: http://ollama:11434/v1. str http://ollama:11434/v1
ai.secondary.azure_api_version api-version (secundário / Azure) str 2024-10-21
ai.secondary.api_key Chave de API (secundário). O Ollama local não exige chave; deixe em branco. secret —
ai.cloud_timeout_s Timeout de alcançabilidade da nuvem. Checagem leve do endpoint de nuvem (circuit breaker). Timeout/rede/5xx → cai para o local. float 5.0 s 1.0 – 60.0 s
ai.cloud_check_ttl_s Cache do estado da nuvem. Por quanto tempo o resultado da checagem de alcançabilidade fica em cache. int 60 s 5 – 3600 s

Notificações

Chave Descrição Tipo Padrão Faixa
notifications.smtp_host Servidor SMTP str vazio
notifications.smtp_port Porta SMTP int 587
notifications.smtp_security Segurança da conexão. none (sem cifra), starttls (upgrade na 587) ou ssl (TLS implícito na 465). select starttls none, starttls, ssl
notifications.smtp_starttls STARTTLS (compat.). Legado; use 'Segurança da conexão'. Mantido para compatibilidade com a 7.5. bool True
notifications.smtp_verify_tls Validar certificado TLS bool True
notifications.smtp_ca CA de confiança (PEM). Opcional: cole o certificado da CA interna para validar o servidor SMTP. text vazio
notifications.smtp_auth Autenticação. password (usuário/senha), oauth2_m365 ou oauth2_google (client credentials, XOAUTH2). select password none, password, oauth2_m365, oauth2_google
notifications.smtp_user Usuário SMTP str vazio
notifications.smtp_password Senha SMTP secret —
notifications.oauth_tenant_id OAuth: tenant/diretório. Microsoft 365: o ID do tenant (diretório). str vazio
notifications.oauth_client_id OAuth: client ID str vazio
notifications.oauth_client_secret OAuth: client secret secret —
notifications.smtp_from Remetente str quantix@localhost
notifications.smtp_from_name Nome de exibição str Quantix Vision AI
notifications.smtp_reply_to Responder para str vazio
notifications.smtp_timeout_s Timeout de envio int 30 s 5 – 300 s
notifications.lang Idioma dos e-mails select pt pt, en
notifications.rate_per_min Limite de envio por minuto int 60 1 – 6000
notifications.max_attempts Tentativas por mensagem int 8 1 – 20
notifications.dedup_minutes Janela de deduplicação int 240 min 5 – 10080 min

Segurança

Chave Descrição Tipo Padrão Faixa
security.local_auth_enabled Permitir login com base interna. Desabilite para exigir diretório. O superadministrador local continua permitido. bool True
security.password_min_length Tamanho mínimo de senha int 12 8 – 64
security.lockout_attempts Tentativas antes do bloqueio int 5 3 – 20
security.lockout_minutes Duração do bloqueio int 15 min 1 – 1440 min
security.session_minutes Duração da sessão (access token) int 30 min 5 – 720 min
security.audit_reads Auditar consultas bool False

Backup

Chave Descrição Tipo Padrão Faixa
backup.enabled Backup automático diário. Gera um backup por dia no volume de dados da plataforma (Administração › Sistema › Backup). bool True
backup.hour Hora do backup automático int 2 h 0 – 23 h
backup.keep Backups automáticos mantidos. Os mais antigos são apagados. Backups manuais e de antes de restaurar/atualizar não entram na conta. int 7 1 – 90
backup.include_metrics Incluir histórico de métricas no backup automático. Desligado: só configuração, inventário, achados e relatórios (pequeno). Ligado: inclui as séries do ClickHouse, que podem ocupar muitos GB. bool False
backup.send_remote Enviar para os destinos remotos após o backup. Após cada backup automático, envia para os destinos de backup habilitados (Fase 4). bool False
backup.encryption_password Senha de backup (destino remoto). Cifra os backups no destino remoto (AES-256-GCM), separada da chave mestra. SEM ela não há restore. Guarde uma cópia: ela é mostrada uma vez. secret —
backup.copy_env Copiar o .env (chave mestra) cifrado para o destino. Desligado por padrão. Ligado: inclui o .env cifrado com a senha de backup — sem a chave mestra, as credenciais dos equipamentos não podem ser decifradas no restore. bool False
backup.remote_stale_hours Alerta de backup remoto atrasado. O autodiagnóstico alerta se o último envio remoto bem-sucedido passou deste tempo. int 24 h 1 – 720 h

Cofre de credenciais

Chave Descrição Tipo Padrão Faixa
security.master_key_source Origem da chave mestra. file: .env 0600 (padrão). passphrase: cifrada por senha digitada na inicialização (modo selado). external: buscada no Segura/OpenBao e mantida só em memória. select file file, passphrase, external
vault.rotation_enabled Rotação de senhas pelo Quantix. DESLIGADA por padrão. Com ela desligada, nenhuma credencial rotaciona. Mesmo ligada, a rotação é opt-in por credencial. bool False
vault.rotate_after_withdrawal Rotacionar após o saque. Opção à parte, desligada por padrão: só vale para credenciais com rotação selecionada. bool False
vault.mfa_totp_required Exigir TOTP no saque. Além do código por e-mail, exige um app autenticador (TOTP). Break-glass sempre exige TOTP. bool False
vault.withdrawal_reveal_seconds Tempo de exibição da senha sacada int 60 s 10 – 600 s
vault.dual_approval Aprovação dupla no saque. Um segundo Guardião do cofre precisa aprovar antes de liberar o segredo. bool False
vault.default_backend Backend padrão do cofre select internal internal, segura
vault.segura_base_url Segura: URL base. Ex.: https://pam.cliente.com. Confirme os caminhos da API na versão do cliente. str vazio
vault.segura_client_id Segura: client ID str vazio
vault.segura_client_secret Segura: client secret secret —
vault.segura_verify_tls Segura: validar certificado TLS bool True
vault.segura_cache_ttl_s Segura: cache da senha em memória. A senha buscada fica em memória por este tempo; zerada ao haver erro de autenticação. int 300 s 0 – 3600 s

Detecção de ransomware

Chave Descrição Tipo Padrão Faixa
ransomware.enabled Detecção de ransomware. Correlaciona sinais da telemetria (queda de redução de dados, pico de escrita, exclusão de snapshots, alertas nativos) num escore de risco. Complementar, não substitui EDR/antivírus. bool False
ransomware.sensitivity Sensibilidade select medium low, medium, high