Concentradora (PPPoE)

Visão geral Novo na 7.2

O ambiente Concentradora mostra, em uma única tela, todas as sessões PPPoE ativas nas concentradoras do provedor. O Ravi Monitor coleta as sessões por SNMP (somente leitura) e apresenta cada assinante com usuário, IP, VLAN e tráfego acumulado. Opcionalmente, ele também mede latência, jitter e perda de pacotes por ping disparado do servidor Ravi para o IP de cada assinante.

Marcas suportadas: Mikrotik (RouterOS), Huawei e Cisco. Na versão 7.2 a tela foi totalmente repaginada, com a mesma base visual dos ambientes Dispositivos e OLT: colmeia de hexágonos (uma célula por sessão), tabela com colunas configuráveis, chips de status clicáveis, busca instantânea, tema claro e escuro e três níveis de densidade.

Para que o NOC usa esta tela

• Ver quem está online e offline em cada concentradora, em tempo quase real.
• Encontrar assinantes com latência ruim ou em loop de reconexão (status Reconexões).
• Auditar quedas de sessão no histórico (modal Logs).
• Gerar PDFs do histórico do assinante (latência, tráfego e sessões) para o suporte.

Como chegar

No menu principal, abra Concentradora (no celular o rótulo aparece como PPPoE). A tela abre em /concentradora/ com o título Concentradoras.

No topo ficam a faixa de cards (um card por concentradora, com logo da marca, nome, IP, estrela de favorito, status e contagem de sessões), as abas de visualização Colmeia, Tabela e Ambos, o seletor de Densidade (Compacto, Confortável, Espaçoso), a busca global Buscar usuário, IP, MAC… e o botão Logs. Administradores também veem o botão de engrenagem (Configurações) e o botão Adicionar concentradora.

Ao entrar, a tela restaura a última concentradora que você estava vendo. Se for o primeiro acesso, ela escolhe automaticamente a melhor candidata (favorita online, depois online com dados, e assim por diante). Favoritas aparecem primeiro na faixa de cards, e o favorito é individual por usuário.

Plano e permissões

Normal+ A coleta de concentradoras depende do plano de assinatura, que também limita quantas concentradoras são coletadas ao mesmo tempo:

Acima do limite, as concentradoras excedentes continuam cadastradas, mas não são sincronizadas. Uma tentativa de sincronização manual devolve o aviso de limite de execuções do plano atingido.

O acesso à área é controlado pela permissão concentradora do grupo de usuários (veja Usuários e permissões):

O usuário Master sempre tem acesso de administrador. Além do nível, o grupo pode restringir quais concentradoras cada usuário enxerga: concentradoras fora da lista liberada do grupo não aparecem na tela. A exibição do endereço IP da concentradora para usuários comuns segue a opção global Exibir endereço IP das configurações do ambiente Dispositivos; administradores sempre veem o IP.

Requisitos no equipamento

• SNMP habilitado (v1 ou v2c), com comunidade e porta corretas, alcançável a partir do servidor Ravi.
• Mikrotik: RouterOS versão 6 ou superior. Versões anteriores não são coletadas.
• Para medir latência, jitter e perda: o servidor Ravi precisa alcançar os IPs dos assinantes por ICMP.

Como funciona a coleta

Cada coleta é uma fotografia das sessões da concentradora: o sistema varre as sessões por SNMP, dispara o teste de ping em lote (quando habilitado), detecta reconexões (pela reinicialização da interface da sessão e por mudança de IP ou VLAN), fecha as sessões que sumiram, gravando a data em Desconectado em, e atualiza os históricos por assinante.

O intervalo entre coletas é automático e adaptativo: começa em 5 minutos e, se a coleta de uma concentradora demora mais do que o intervalo comporta, o sistema aumenta sozinho o intervalo daquela concentradora (os níveis vão de 5 minutos até 6 horas). A data e a duração da última sincronização aparecem no cabeçalho do painel. Nunca rodam duas coletas simultâneas da mesma concentradora, e as coletas ficam suspensas enquanto o backup diário do servidor Ravi está em execução.

Cadastrar concentradora

O cadastro registra o equipamento BNG/BRAS que o Ravi vai consultar por SNMP. Cada cadastro corresponde a um equipamento. Apenas administradores da área podem cadastrar.

1. No menu, abra Concentradora.
2. Clique em Adicionar concentradora.
3. Preencha a aba Geral (nome, IP, marca) e, se necessário, a aba SNMP.
4. Salve. O sistema mostra o toast Concentradora adicionada — testando conexão… e testa o SNMP em segundo plano.

Aba Geral

Aba SNMP

Validações e teste de conexão

• Nome e IP são obrigatórios (aviso Preencha nome e IP).
• Novo na 7.2 O sistema recusa duplicidade de IP + porta SNMP: Já existe uma concentradora com esse IP e porta SNMP. Se o mesmo equipamento precisar aparecer duas vezes, use outra porta SNMP.

Após salvar, o teste de conexão define o status do card:

Menu de ações do card

Cada card tem um menu de ações (ícone de três pontos) com:

• Editar concentradora: reabre o formulário (somente administradores). Ao salvar aparece o toast Concentradora atualizada.
• Favoritar / Desfavoritar: qualquer usuário; favoritas vêm primeiro na faixa de cards e a preferência é individual.
• Zerar monitoramento: administradores. Pede confirmação (Zerar monitoramento?) e avisa que a fotografia atual das sessões é copiada para backup e a colmeia fica vazia até a próxima coleta. Útil para limpar sessões fantasma acumuladas, por exemplo após renomear usuários em massa.
• Excluir concentradora: administradores. Pede confirmação (Excluir concentradora?) e remove o cadastro, o monitoramento, os registros de assinantes e o histórico de quedas daquela concentradora.

Criar, editar, excluir e zerar concentradoras ficam registrados no Histórico de ações, no idioma de quem executou.

Modal Configurações da área Somente Master

O botão de engrenagem da toolbar abre o modal Configurações da Concentradora (disponível para administradores da área), com três abas:

Padrões: valores globais usados por todas as concentradoras que herdam do sistema.

Telegram: lista de canais Telegram do módulo. Clique em + Adicionar canal e informe Descrição, Chat ID, Token, a janela de horário (Início e Fim, padrão 00:00 a 23:59) e a Prioridade (Alta, Normal ou Baixa). Para os detalhes de como criar o bot e obter o Chat ID, veja Telegram.

Sincronização: uma linha por concentradora, com status, data da última sincronização (ou Nunca sincronizada) e o botão Sincronizar, que dispara a coleta imediata em segundo plano. O sistema recusa a sincronização se o plano não tem direito, se o limite do plano foi atingido, se a concentradora está pausada ou sem conexão, ou se já existe uma coleta daquela concentradora em andamento.

Acompanhar sessões

Selecionada a concentradora na faixa de cards, o painel mostra o cabeçalho (logo, nome, IP quando permitido, data e hora da última sincronização, total de sessões e selo Online/Sem conexão), a linha de chips de status, a colmeia e a tabela de sessões. As abas Colmeia, Tabela e Ambos controlam o que fica visível (o padrão é Ambos).

Se ainda não houver dados, o painel mostra Sem dados de monitoramento com a explicação correspondente: a concentradora está online mas ainda não há sessões coletadas, ou ela ainda não foi sincronizada com sucesso. Nesse caso, aguarde a próxima coleta automática.

Chips de status

Os chips resumem as sessões por situação. Clicar em um chip filtra a colmeia e a tabela ao mesmo tempo; clicar de novo limpa o filtro.

As cores dos hexágonos da colmeia seguem os status; Reconexões e Latência alta ganham um brilho de destaque.

Colmeia

A seção Colmeia desenha um hexágono por sessão e comporta dezenas de milhares de sessões sem travar. O controle Tamanho ajusta o tamanho dos hexágonos, e a Densidade da toolbar também influencia. Passe o mouse sobre um hexágono para ver o tooltip com usuário, IP, VLAN, status, latência, jitter, perda, download e upload; clique para abrir o painel da sessão. No celular ou tablet, o toque abre a sessão diretamente.

Tabela

A seção Sessões lista as mesmas sessões em formato de tabela, com busca própria (Buscar nesta tabela…) sincronizada com a busca global da toolbar. A busca procura em usuário, IP e VLAN.

O botão Colunas permite mostrar e ocultar colunas. Só aparecem colunas que têm valor naquela concentradora (por exemplo, VLAN só é oferecida se a marca fornece VLAN). O link Restaurar padrão volta ao conjunto original. A escolha persiste no navegador e vale para todas as concentradoras.

Clique no cabeçalho para ordenar (ordenação numérica onde faz sentido). A tabela pagina em blocos de 2.000 linhas: o rodapé mostra quantas linhas estão visíveis, com os botões Ver mais e Ver tudo. Quando o filtro não encontra nada, aparece Nenhuma sessão corresponde aos filtros.

Painel da sessão

Clicar em uma sessão (na colmeia ou na tabela) abre o painel do assinante: um modal com o nome do assinante no título (com o MAC separado, quando o usuário vem no formato nome-MAC), o selo de status colorido e uma grade somente leitura com IP, VLAN, Latência, Jitter, Perda, Download, Upload e Desconectado em. Campos sem valor são omitidos.

Relatórios PDF do assinante Novo na 7.2

Quando o assinante já tem histórico coletado, o rodapé do painel mostra três botões que abrem o relatório em nova aba:

Piores casos Novo na 7.2

O botão Piores casos, na barra de controles do painel da concentradora, responde de imediato à pergunta "quem está pior agora?". O modal é calculado na hora, sobre os dados já carregados na tela, sem nova consulta ao servidor, e traz quatro rankings:

Cada lista mostra por padrão 12 itens; o tamanho é ajustável no campo Qtd. piores casos do modal Configurações da Concentradora (mínimo 3). Células sem valor exibem um traço, e uma lista sem nenhum caso mostra Sem dados.

Exportar CSV Novo na 7.2

O botão Exportar CSV gera, direto no navegador, uma planilha com as sessões da concentradora aberta. A exportação respeita os filtros ativos: saem exatamente as sessões que estão visíveis segundo o chip de status e a busca do momento.

1. Abra a concentradora desejada e aplique (ou limpe) os filtros: chip de status e busca.
2. Clique em Exportar CSV.
3. O arquivo concentradora_{id}_sessoes.csv é baixado imediatamente.

Formato do arquivo:

• Colunas: Usuário; IP; VLAN; Download (bytes); Upload (bytes); Latência (ms); Jitter (ms); Perda (%); Status; Desconectado em.
• Separador ; e codificação UTF-8 com BOM: abre corretamente no Excel sem ajustes.

Logs de quedas

O botão Logs, na toolbar da tela, abre o modal Logs de quedas (PPPoE): o histórico de quedas de sessão dos assinantes, agora nativo na tela nova. Use-o para auditar quando um cliente caiu, quanto tempo ficou conectado e quanto trafegou na sessão.

1. Na tela Concentradoras, clique em Logs.
2. No seletor, mantenha Todas as concentradoras ou escolha uma específica (a concentradora aberta já vem pré-selecionada).
3. Use o campo Buscar usuário, IP… para filtrar por usuário, IP ou nome da concentradora.

A lista vem ordenada da queda mais recente para a mais antiga e traz por padrão os 300 últimos registros. Quando não há nada registrado, o modal mostra Nenhuma queda registrada.

Solução de problemas rápida

Para outros sintomas, veja Solução de problemas.