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:// |
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 |