Regras

O que o sistema considera problema — construtor visual de condições, papéis, confirmação por leituras e simulação obrigatória.

Regras

Menu: Saúde da Rede → Regras
Permissão necessária: health.view (ver) · health.rules.manage (criar, editar, ativar/desativar, apagar)

Define o que a rotina de detecção considera problema. Cada regra compara métricas com limites e, quando confirmada, ativa um motivo — que abre card, complementa um card existente ou abre um incidente de PON.

Tela Regras

A tela separa:

  • Regras do sistema — vieram de fábrica; podem ser calibradas e desativadas, nunca apagadas.
  • Criadas por você — regras personalizadas da sua rede.

A lista de regras

ColunaO que mostra
Nome e ChaveO nome que aparece nas telas e o identificador fixo da regra.
PapelO que a regra faz quando confirma (veja abaixo).
SeveridadeA prioridade do card que ela abre.
Motivos vivosQuantos motivos desta regra estão ativos agora.
AtivaA chave que liga e desliga a regra.
AçõesEditar, Duplicar (cria uma cópia para ajustar) e Excluir.

O botão Nova regra fica no topo. Sem health.rules.manage, a lista é só de leitura.

Papel da regra

PapelO que faz quando confirma
Abre cardCria um card na Fila para o assinante.
Complementa card existenteAnexa o motivo a um card já aberto — não cria outro.
Abre incidente de PONCria uma queda coletiva na PON, em vez de cards individuais.

O construtor visual

Nada de sintaxe: a condição é montada escolhendo em listas — contexto (a conexão, o CPE, a ONU, a PON, o cliente), métrica, operador e valor, combináveis com E/OU e grupos aninhados. Enquanto você monta, o painel Em português traduz a árvore em uma frase: QUANDO a ONU desta conexão estiver com sinal óptico abaixo de −27 dBm ENTÃO abrir um card.

Métricas disponíveis vêm do catálogo (fonte · unidade · natureza · verificável): quedas de sessão, sinal óptico de ONU e CPE, memória, temperatura, nota geral da CPE, nota do Wi-Fi, dispositivos com Wi-Fi fraco, tempo sem contato, portas CGNAT negadas, ONUs offline/sinal ruim na PON, entre outras.

Campos que mudam o comportamento

CampoEfeito
Leituras para ativarQuantas leituras seguidas confirmando antes de ativar o motivo — uma leitura isolada não abre card.
Período de silêncio (min)Para métricas de evento (sem estado para reler): o motivo encerra depois desse tempo sem novas ocorrências.
SeveridadeBaixa · Média · Alta · Crítica — define a prioridade do card.
ChaveImutável após a criação; identifica a regra no histórico.

Uma regra que abre card precisa usar métrica verificável (com estado para reler depois da ação) — card que não consegue fechar sozinho não pode ser criado automaticamente. O construtor avisa quando a combinação não fecha.

editor de regra com condições e frase em português

Simulação obrigatória

Antes de ativar, o botão Testar roda a regra contra a rede de hoje, sem criar nada: quantos assinantes casariam, quantos não, quantos foram pulados (e por quê — fonte indisponível, sujeito não resolvido, sem dado) e o resumo honesto: "Geraria N cards novos numa fila de M hoje". Só depois de simular o botão Salvar e ativar libera (antes, ele mostra a dica Simule a regra antes de ativar); Salvar desativada está sempre disponível e guarda a regra sem ligá-la. Se você mudar uma condição depois de testar, simule de novo.

resultado da simulação da regra

Regras com histórico de motivos não podem ser apagadas — apenas desativadas. Isso preserva a trilha de Resultados e das execuções antigas.

Nesta página