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