Pular para conteúdo

Regras da engine

Todas as regras que geram achados na v1.0.0, extraídas do código de backend/quantix/engine/. A chave completa o fingerprint (regra:objeto:chave), ou seja, um objeto pode ter um achado por chave. Grace é o número de execuções seguidas sem o achado até a resolução automática (2 em todas).

Performance, capacidade, erros e replicação (ratings.py, a cada analytics.ratings_interval_s)

Regra Categoria Objetos Condição Severidade Recomendação (resumo)
perf_latency performance volume (≥ 5 IOPS), pool, sistema, controladora; VM, datastore, cluster, hipervisor média de lat_ms em 20 min ≥ limite (flash/híbrido × fator de I/O; VM 10/25 ms) aviso / crítico pelo limite volume: topologia, carga de pool/controladora, migrar ou QoS; pool: redistribuir/ampliar; sistema: identificar componente; controladora: utilização e balanceamento. No máx. 100 achados de volume por ciclo
perf_util performance controladora (modelo de capacidade ou CPU), porta de storage e de switch (velocidade negociada), sistema util_pct ≥ thresholds.util_*_pct (70/85) aviso / crítico controladora: rebalancear ownership; porta de array: distribuir hosts, multipath round-robin; porta de switch: trunking/ISLs
capacity_used capacity sistema, pool, datastore, file system, bucket, cluster cap_used_pct ≥ thresholds.capacity_*_pct (80/90) aviso / crítico recuperar espaço (órfãos, snapshots, UNMAP), mover dados, planejar expansão
port_errors errors porta de switch, porta de storage, HBA CRC + enc-out + falhas de link + descartes C3 na última hora ≥ thresholds.port_errors_* (10/100) aviso / crítico trocar/limpar cabo e SFP, verificar velocidade; zerar contadores (runbook) para confirmar
slow_drain errors idem média de bb_credit_zero_ms na última hora ≥ thresholds.bb_credit_zero_*_ms (100/1000) aviso / crítico HBA/driver/firmware do host, velocidade negociada, FPIN/port fencing, descartes nas ISLs
repl_lag availability replicação repl_lag_s ≥ thresholds.repl_lag_*_s (300/1800) aviso / crítico banda/latência do link, carga de escrita na origem
vm_cpu_ready performance VM cpu_ready_pct ≥ 5 / 10 % aviso / crítico reduzir vCPUs, DRS, revisar consolidação
host_resources performance hipervisor, cluster cpu_pct ≥ 80/92 % (chave cpu_pct); mem_pct ≥ 90/97 % (chave mem_pct) aviso / crítico rebalancear VMs ou adicionar capacidade

Mudança de workload (change_detection.py, 1 h)

Regra Categoria Séries Condição Severidade
change (chave = métrica) change sistema (iops, mbps, lat_ms), controladora (iops, lat_ms), pool (iops, lat_ms), porta de storage/switch (mbps), hipervisor (iops, cpu_pct), VM (iops, lat_ms), volume (iops, lat_ms), cluster (iops), datastore (iops) z robusto (mediana/MAD da mesma hora em change_baseline_days) além de ±change_z_warning por ≥ change_min_hours horas seguidas no mesmo sentido crítico: z_max ≥ change_z_critical em sentido ruim; aviso: sentido ruim; info: melhora. No máx. 150 por execução

Balanceamento (balance.py, 1 h)

Regra Categoria Grupo Condição Severidade
balance (chave controller:iops, storage_port:mbps, hypervisor:cpu_pct) balance controladoras de um sistema; portas front-end de um sistema; hipervisores de um cluster (≥ 2 membros, carga média mínima) CV da média de 24 h ≥ analytics.balance_cv_warning (0,35) aviso; crítico se CV ≥ 2 × limite

Capacidade prevista (forecast.py, 6 h)

Regra Categoria Objetos Condição Severidade
capacity_forecast (chave full) capacity sistema, pool, datastore, file system, cluster, bucket (≥ 5 dias de histórico) dias até 100 % (Theil-Sen) ≤ thresholds.capacity_days_warn (90) aviso; crítico se ≤ capacity_days_crit (30)

Configuração e topologia (config_rules.py, junto com a correlação)

Regra Categoria Objeto Condição Severidade Recomendação (resumo)
single_fabric availability host (visão do array) com volumes mapeados todos os iniciadores FC logados em um único fabric crítico se 1 iniciador; aviso se vários conectar HBA ao outro fabric e zonear; conferir multipath
single_fabric availability hipervisor HBAs logadas em um único fabric crítico cabeamento/zoning da 2ª HBA; rescan (runbook)
datastore_paths availability hipervisor relação uses com datastore e paths < 2 aviso esxcli storage nmp path list, portas mortas, zoning
orphan_volumes configuration sistema de storage volumes sem maps_to, sem replicação/backing, role não réplica/snapshot, vistos há > 1 dia info (< 20 volumes) / aviso confirmar e remover; marcar réplicas/clones
dead_zone configuration zona membro WWPN não logado em nenhum switch monitorado info remover zonas de servidores desativados; verificar conexão
unzoned_login configuration porta de switch WWPN logado que não é membro de zona ativa (exceto portas de array). Máx. 500 info criar a zona ou desabilitar a porta
asymmetric_zoning configuration host número diferente de portas de destino zoneadas por fabric aviso igualar portas de array por fabric
mapped_not_logged availability host volumes mapeados, iniciadores FC sem login (havendo switches monitorados) info remover mapeamentos de servidores desligados ou verificar HBA/cabos

Correlação (correlator.py, sem achados)

Gera relações logged_in, same_as, backed_by e zoned_with (origem correlator); ver Engine.