Menu da wiki
release 2.34.0 · 94ad7526c36b · 2026-09-11

Consulta Cliente

Grupo: NOC · Rota: /cliente · Permissão: qualquer usuário autenticado (VIEWER+)

Consulta Cliente (Raio-X do assinante): busca por CPF, nome, código, login ou IP e mostra sessão PPPoE, IP público/CGNAT, sinal e caminho óptico, estabilidade 24h, timeline de eventos e o botão Limpar MAC.

Screenshot oficial

Como usar

A Consulta Cliente é o Raio-X do assinante: busque por CPF, nome, login PPPoE ou IP e veja num painel só — está online? qual IP/CGNAT? como está o sinal da ONU? o que aconteceu nos últimos dias?

  1. Digite CPF, nome ou login e consulte.
  2. Visão geral: status da sessão PPPoE, IP público/CGNAT, teto de banda real da sessão.
  3. Caminho óptico: OLT → PON → ONU com o sinal em cada ponta e gauge de saúde.
  4. Timeline: quedas, trocas de equipamento e eventos recentes do assinante.

Tela: Consulta Cliente (/cliente)

  • campo: CPF, nome ou login...
  • botao: Consultar
  • badge: ONLINE
Nota: O ping/latência até o CPE é medido na hora pelo agente. "Não responde ping" não significa offline — muitos roteadores bloqueiam ICMP.

Quando o cliente troca o roteador, o HubSoft pode segurar o MAC antigo travado na autenticação e o PPPoE novo não sobe. O Raio-X resolve isso sem abrir o ERP.

  1. Consulte o cliente no Raio-X.
  2. Clique em "Limpar MAC".
  3. O NetOps grava o MAC coringa no HubSoft e a próxima tentativa de conexão do equipamento novo autentica.

"Tá lento" quase nunca é o uplink. Siga a cadeia no NetOps, do assinante pro núcleo:

  1. Raio-X do assinante: está online? O sinal óptico está bom (RX > -27 dBm)? Sinal ruim = problema físico, encaminha visita.
  2. Porta PON do cliente: a porta inteira está degradada ou só ele? Veja também se há queda em massa na região.
  3. Teto da sessão: compare o teto real (CIR/PIR no BNG) com o plano contratado no ERP — plano errado aparece aqui.
  4. CGNAT: esgotamento de portas no equipamento de NAT causa lentidão "fantasma" com sinal perfeito — cheque a utilização de portas do assinante.
Nota: Sinal bom + teto certo + CGNAT ok = investigue o Wi-Fi do cliente (posição do roteador, 2.4 GHz congestionado) antes de escalar.