Saúde do assinante nas telas

A aba Saúde da rede e o selo Caso nas telas de cliente, CPE, ONU, Graph e Radius — estado, caso aberto, casos anteriores, quem vê o quê e como abrir um caso sem sair da tela.

Saúde do assinante nas telas

Onde aparece: busca unificada, cadastro de clientes, dispositivos (CPE), ONUs, Graph, usuários RADIUS e dashboard
Permissão necessária: qualquer uma das permissões de leitura da tabela abaixo · health.view e health.manage juntos para atuar

Quem atende o cliente não precisa ir até a Fila para saber se existe um problema de rede aberto para ele. A Saúde da rede do assinante aparece nas mesmas telas em que o atendimento já olha o cliente: o estado, o caso aberto, a cadeia (OLT → PON → ONU → CPE → conexão), os casos anteriores e o histórico de motivos.

aba "Saúde da rede" na tela do cliente da busca unificada, com um caso aberto

Quem vê a saúde em cada tela

A leitura segue a regra "quem já vê a tela, vê a saúde dela": basta ter uma das permissões abaixo, mesmo sem health.view.

TelaO que aparecePermissão de leitura
Busca Unificada — detalhe do clienteSelo no cabeçalho, faixa e linha no Atendimento, dica junto do Reiniciar, marca no caminho da internet, Eventos recentes e a aba Saúde da rede — veja Na tela do clientecustomers.view ou clients.view
Busca Unificada — listaColuna Casocustomers.view ou clients.view
Cadastro de ClientesPainel na ficha do cliente e coluna Caso na listaclients.view
Detalhe do CPEAba Saúde (casos de rede, cadeia e a nota do equipamento) e selo ao lado do selo de homologaçãocpe.view
DispositivosColuna Caso, logo depois de PPPoEcpe.view
ONUs autorizadasSelo no detalhe da ONU (com faixa de alerta e bloco junto ao card Cliente) e selo na célula Status da listaolt.onus.view
Mapa de ONUs e CaixasAnel de caso aberto no marcador da ONU e na porta da caixaolt.onus.view
Telemetria do Cliente (Graph)Aba Saúde da rede e selo no cabeçalhograph.dashboard.view
Busca de Clientes (Graph)Selo na linha da sessão ativagraph.search.view
Usuários RADIUSPainel no detalhe do usuário e coluna Casoradius.users.view
Fila e demais telas de Saúde da RedeTudo, inclusive trilha, notas e anexoshealth.view

Quando o usuário não tem nenhuma das permissões da lista, o painel simplesmente não aparece (a tela funciona normalmente, sem erro).

O que cada pessoa enxerga

Ler a saúde pela tela do cliente não dá acesso a tudo o que a Fila mostra. O que é exibido depende de o usuário ter ou não health.view.

InformaçãoCom health.viewSó com a permissão da tela
Estado, severidade e motivos com o valor medidoSimSim
Cadeia do cliente (OLT → PON → ONU → CPE → conexão)SimSim
Status do caso, datas e causa do encerramentoSimSim
Em atendimento / Sem responsávelSimSim
Nome do responsável pelo casoSimNão
Nomes na linha do tempo (quem moveu, comentou, encerrou)SimNão
Notas internas e nota de encerramentoSimNão
AnexosSimNão
Telefone e endereço do cliente no casoSimNão
Saúde da CPE (nota e gráfico de 14 dias)SimSó com cpe.widget.score.view

Ao montar um grupo em Sistema → Usuários e Grupos → Grupos, lembre que health.view é o que libera nomes, notas, anexos e dados de contato. Quem recebe apenas olt.onus.view, cpe.view, clients.view, customers.view, graph.search.view, graph.dashboard.view ou radius.users.view vê o que está errado e há quanto tempo, mas não quem está cuidando nem o que foi conversado.

Os mesmos recortes valem para o Conector de IA (MCP): a ferramenta get_subscriber_health nunca devolve nomes, notas, anexos nem telefone e endereço, mesmo que o usuário do conector tenha health.view.

Os quatro estados

Cada conexão do assinante (cada login PPPoE) mostra um destes estados, sempre com ícone e texto — nunca só cor:

EstadoTexto na telaQuando
Caso abertoCaso aberto · <severidade>Existe um card aberto para a conexão.
Em observaçãoEm observaçãoHá um motivo pendente ou ativo, mas ainda sem card.
Sem caso abertoSem caso abertoA rotina avaliou a conexão nos últimos 7 dias e não encontrou nada acima.
Sem avaliaçãoSem avaliaçãoA rotina não avaliou a conexão nos últimos 7 dias.

Sem caso aberto não é o mesmo que "saudável". O sistema só afirma que não há problema detectado — por isso o texto nunca diz "Saudável" e nunca usa verde. E Sem avaliação significa que a rotina de detecção ainda não leu esta conexão (conexão nova, sem ONU/CPE vinculada ou rotina parada), não que ela está bem.

O painel Saúde da rede

painel completo com estado, caso aberto, cadeia, Saúde da CPE, casos resolvidos e histórico

O painel segue sempre esta ordem:

  1. Estado — severidade, "Atualizado há…" e o botão Abrir caso.
  2. Uma seção por conexão quando o cliente tem mais de uma. Cada seção traz:
    • o caso aberto, com os motivos e o valor medido, a indicação Em atendimento ou Sem responsável, o selo de reincidência (Reincidente ×N), o aviso Coberto por incidente na PON (quando a queda é coletiva — veja Incidentes de PON) e o botão Ver caso;
    • os motivos em observação, ainda sem card;
    • a cadeia do cliente, elo a elo.
  3. Saúde da CPE — a nota geral do equipamento com a variação e as barras por dimensão (só aparece quando o usuário tem permissão para ver a nota).
  4. Gráfico de 14 dias da Saúde da CPE. Na tela de Detalhe do CPE ele não é repetido, porque a aba Saúde já traz a nota e o histórico de análises do equipamento (sub-aba Histórico). Na aba da tela do cliente da busca unificada também não aparece: o bloco Saúde da CPE traz só a nota e as barras.
  5. Casos resolvidos, com Ver mais.
  6. Histórico de motivos, com Ver mais.

Casos resolvidos e histórico

  • A lista é sem limite de tempo e paginada (Ver mais).
  • Cada encerramento conta como um caso resolvido. Quando o mesmo problema volta, o sistema reabre o mesmo card (e soma à reincidência); mesmo assim, os encerramentos anteriores continuam na lista, com data, causa (Normalizou sozinho ou Encerrado manualmente) e — para quem tem health.view — nota e responsável.
  • O histórico acompanha o cliente e o login, não a conexão. Se a conexão sair do ERP na sincronização, os casos e motivos antigos continuam disponíveis.
  • Cliente inativo também mostra histórico.

Mensagens do painel

SituaçãoO que a tela mostra
CarregandoEsqueleto de cada seção.
ErroNão foi possível carregar a saúde da rede, com Tentar de novo. O botão apenas relê a saúde; nunca dispara atualização, diagnóstico ou qualquer comando no ACS.
Sem cliente vinculadoSem cliente vinculado — vincule um cliente para ver a saúde da rede. Acontece, por exemplo, em ONU ou CPE que ainda não foi ligada a um cliente.
Chave ambíguaEsta chave aponta para mais de um cliente. Escolha qual: com a lista de clientes candidatos. Ocorre quando duas fichas apontam para a mesma CPE.
Cliente sem conexãoEste cliente não tem conexão vinculada.
Login sem dados de saúdeSem dados de saúde da rede para este login.
Sem permissãoO painel não aparece.

Abrir qualquer uma dessas telas não escreve nada no ACS — o painel só lê dados que a rotina de detecção já gravou.

Na tela do cliente (busca unificada)

Na tela do cliente, a saúde da rede aparece em camadas, da mais discreta à mais completa. Todas leem a mesma consulta do login em atendimento, e nenhuma bloqueia ou muda uma ação: elas só avisam.

tela do cliente com caso aberto: selo no cabeçalho, faixa, diagnóstico, dica do Reiniciar, caminho da internet e eventos recentes

OndeO que mostra
Cabeçalho do perfil (no celular, na linha de pills)Selo com a gravidade do caso aberto (por exemplo, Crítica), Em observação ou Sem avaliação (em cinza). Cliente sem caso não tem selo — a ausência não quer dizer saudável.
Faixa no topo do AtendimentoCaso aberto · gravidade, até 3 motivos (e +N quando há mais), Em atendimento ou Sem responsável e o botão Ver caso, que abre a aba Saúde da rede. Avisos extras: Em outro login deste cliente e Coberto por incidente na PON.
DiagnósticoUma linha abaixo do título: "Caso de rede aberto (Crítica): Sinal óptico fraco. A falha está antes do equipamento do cliente.", com o link Ver na Saúde da rede.
ReiniciarUma dica abaixo do botão (veja abaixo).
Caminho da internetMarca no elo e chip na linha correspondente (veja abaixo).
Eventos recentesCaso de rede aberto e Caso de rede resolvido, só do login em atendimento. Clicar abre o caso (ou a aba).
Aba Saúde da redeA 4ª aba, depois de Atendimento e Histórico, com um contador quando há caso aberto (no celular o rótulo é Saúde).
Chips de loginQuando o cliente tem mais de um login, o que tem caso aberto leva um ícone de coração.

O Histórico não ganhou nenhuma seção nova.

Se a leitura dos casos falhar, a faixa mostra Não foi possível ler os casos de rede. com Tentar de novo. O botão só relê a consulta de saúde; nunca toca no ACS.

A dica do Reiniciar

A dica aparece junto do botão Reiniciar, só quando ele está visível, e é puramente informativa: o botão continua habilitado e funciona como sempre.

SituaçãoTexto
A falha está antes do equipamento do cliente (OLT, PON ou ONU)Reiniciar o roteador não deve resolver: a falha está antes do equipamento do cliente.
A falha está do lado do clienteHá caso de rede aberto no lado do cliente. Veja o caso antes de reiniciar.
Caso aberto sem elo definidoHá caso de rede aberto neste cliente. Veja o caso antes de reiniciar.
O caso é de outro login do mesmo clienteO caso de rede aberto é de outro login deste cliente.

Marca no caminho da internet

No caminho da internet (Fibra, Roteador, Wi-Fi, Conexão e Portas), o nó do elo afetado ganha uma marca pequena de coração e a linha correspondente ganha um chip:

  • com caso aberto: Caso de rede: ONU com falha;
  • sem caso, quando só a medição da rotina acusa: Rede: PON em atenção.

Os elos da cadeia de saúde aparecem no caminho assim: Wi-Fi → Wi-Fi; CPE → Roteador; OLT, PON e ONU → Fibra; Conexão → Conexão; CGNAT → Portas. A marca nunca troca o estado do nó (um nó pode continuar OK e ter a marca), e abaixo do caminho aparece uma linha com o veredito da cadeia.

Quando o equipamento e a rotina medem coisas diferentes, a tela avisa: "Medições diferentes. Veja a aba Saúde da rede." — como no cliente de dois logins mais abaixo, em que a Fibra aparece OK na leitura do equipamento, mas há um caso aberto na PON.

Elo sem medição fica em cinza, com o texto Sem dado. Isso não é o mesmo que estar bem: a marca só aparece para elos em atenção ou com falha, e um elo sem medição nunca vira marca nem verde.

Caso em outro login

Um cliente pode ter vários logins PPPoE (por exemplo, casa e loja). Quando o caso aberto é de outro login, a tela do login atual mostra a faixa com Em outro login deste cliente e o texto "Caso de rede aberto em outro login deste cliente (Alta): … Este login não tem falha medida.". A dica do Reiniciar fica só informativa, e o caminho da internet do login atual segue como medido.

login sem falha medida, com o caso aberto em outro login do mesmo cliente

cliente com dois logins: o chip do login com caso aberto leva um coração e a Fibra mostra a marca de caso

A aba Saúde da rede da tela do cliente

A aba traz o painel completo descrito acima. Particularidades:

  • as conexões vêm com o login atual primeiro (Login atual / Outro login);
  • só nesta aba aparece a cadeia do cliente (OLT → PON → ONU → CPE → conexão); no Atendimento ela não é repetida. A cadeia mostra o que a rotina de saúde mediu; o caminho da internet do Atendimento mostra a leitura ao vivo do equipamento. Por isso um elo pode aparecer sem medição da rotina na cadeia e OK no caminho — são duas fontes diferentes, e nenhuma está errada;
  • o bloco Saúde da CPE mostra a nota e as barras, sem o gráfico de 14 dias, com a explicação "Pontuação de analytics do equipamento. Diferente da nota geral do Atendimento.";
  • os links do painel abrem em nova aba;
  • a aba continua visível mesmo quando o login não tem dados de saúde; ela só some para quem não tem nenhuma permissão de leitura;
  • Ver caso segue a regra de permissões: sem health.view, abre a visão somente leitura.

cliente Sem avaliação: aba Saúde da rede com a cadeia em cinza

No celular, o selo vai para a linha de pills do cabeçalho e a aba aparece como Saúde, com o ícone acima do texto.

tela do cliente no celular: selo na linha de pills, aba Saúde com contador e dica do Reiniciar

Selo e coluna Caso nas listas

lista de Dispositivos com a coluna Caso (selos por severidade)

Nas listas, a coluna Caso mostra um selo só para quem tem caso aberto:

  • ícone, texto da severidade e, quando houver mais de um caso, ×2;
  • um ícone de pessoa quando alguém já assumiu o caso;
  • a cor segue a severidade (Baixa · Média · Alta · Crítica).

Linha sem selo não significa saudável — significa apenas que não há caso aberto. O cabeçalho da coluna repete o aviso: "Mostra só casos de rede abertos. Sem marca não significa saudável."

Clicar no selo abre o caso (com health.view, no mesmo painel da Fila) ou leva à tela do assinante. A lista consulta tudo de uma vez, em lote, por página. Se a consulta falhar, o cabeçalho da coluna mostra um aviso com Tentar de novo — a falha nunca fica silenciosa.

Ver e atuar no caso

O botão Ver caso se comporta conforme a permissão:

PermissãoO que acontece
health.view + health.manageAbre o painel de detalhe da Fila, com tudo: trilha, notas e anexos. Dá para assumir, mover, comentar e encerrar o caso sem sair da tela do cliente.
health.viewAbre o mesmo painel em leitura: os botões de ação não aparecem.
health.manage sem health.viewIgual a só a permissão da tela (linha abaixo): somente leitura. Os botões de ação não aparecem.
Só a permissão da telaMostra o caso dentro da própria tela, com a faixa Somente leitura: status, motivos com valor medido e Em atendimento. Sem trilha, nomes, notas nem anexos.

caso aberto em modo Somente leitura (sem health.view)

Todas as ações nos casos — assumir, mover, comentar, resolver e abrir caso — exigem health.manage e health.view juntos. Sem health.view, a visualização é só leitura, mesmo que o grupo tenha health.manage.

Na tela do cliente da busca unificada, o Ver caso da faixa do Atendimento abre a aba Saúde da rede; é nela que a tabela acima se aplica.

Depois de qualquer ação (assumir, mover, comentar, encerrar), o painel e os selos da lista se atualizam sozinhos.

Nas janelas de cadastro — a ficha do cliente e o detalhe do usuário RADIUS — o painel aparece dentro da janela, sem abrir o painel lateral por cima. Ali, Ver caso leva para a Fila (com health.view) ou para a busca unificada.

Abrir caso a partir da tela

O botão Abrir caso aparece no painel para quem tem health.manage e health.view. É o mesmo assistente de Abrir caso na mão, com o primeiro passo já respondido:

  • uma conexão — o assistente pula o passo De quem é o caso?;
  • várias conexões — o passo 1 lista só as conexões desse cliente;
  • nenhuma conexão — o botão fica desabilitado, com a explicação "Sem conexão vinculada: não há onde abrir o caso.";
  • todas já têm caso — aviso "Todas as conexões já têm caso aberto."

Mapa de ONUs, caixas e dashboard

  • Mapa de ONUs e Caixas: a ONU (ou a porta da caixa) com caso aberto ganha um anel magenta em volta do marcador, mais grosso para severidade crítica ou alta e mais fino para média ou baixa. A cor do sinal não muda. O popup ganha a linha "Caso de rede aberto · <severidade>" e a legenda ganha o item Caso de rede aberto. Se a consulta dos casos falhar, o mapa e a caixa mostram o aviso Casos indisponíveis no momento e os marcadores continuam normais.
  • Dashboard: o card Casos de rede mostra os casos abertos por severidade e leva à Fila. Severidades sem caso aparecem em cinza, sem destaque. Só aparece para quem tem health.view.

card Casos de rede no dashboard, com os casos abertos por severidade

Outros detalhes

  • Nas telas de CPE e do Graph, uma faixa de alerta no topo avisa quando o assinante tem caso aberto.
  • O selo com ×2 (mais de um caso) leva à tela do assinante. Com o teclado, Enter no selo abre o caso.
  • O selo também aparece no título dos modais (por exemplo, no cadastro de clientes).

marcador de ONU com anel de caso aberto + popup

Dois nomes, duas coisas

Para não confundir, o sistema usa nomes diferentes:

NomeO que éOnde vem
Saúde da CPEA nota (0–100) do equipamento, calculada pelas análises da CPE (Equipamento, WAN, Wi-Fi, Dispositivos, Diagnósticos).Módulo de análises, por CPE
Saúde da redeOs casos abertos e resolvidos do assinante, gerados pelas regras da Saúde da Rede.Rotina de detecção

Uma CPE pode ter nota boa e ainda assim o assinante ter um caso aberto (por exemplo, sinal óptico ruim na ONU), e o contrário também vale.

Para o suporte

  • "O painel diz Sem avaliação." Verifique a última execução da rotina e se o cliente tem ONU/CPE vinculada.
  • "A lista não mostra selo, mas o cliente reclama." Só aparecem casos abertos. Abra o painel do assinante: o motivo pode estar Em observação (ainda sem card) ou o problema pode não ser medido pelas regras.
  • "Não vejo o nome do responsável." É esperado sem health.view; peça ao administrador do seu grupo, se fizer sentido para a sua função.
  • "A dica do Reiniciar apareceu, mas o botão funciona." É o esperado: a dica só avisa. Veja o caso antes de reiniciar.
  • "O cliente não tem selo no cabeçalho." Selo aparece só para caso aberto, em observação ou sem avaliação. Sem selo não significa saudável.
  • "O elo está em cinza, com Sem dado." O elo não foi medido. Não é o mesmo que estar bem.
  • "Duas fichas apontam para a mesma CPE." É o caso do aviso de chave ambígua; corrija o vínculo no Cadastro de Clientes.

Nesta página