OLT e fibra (GPON)

Visão geral Novo na 7.2

O ambiente OLT concentra o monitoramento de todas as suas redes GPON em uma única tela. Você cadastra as OLTs (o seletor de marca traz 17 opções, cobrindo 15 fabricantes: a V-Solution e a Intelbras aparecem duas vezes, uma por protocolo) e o Ravi Monitor passa a coletar automaticamente, por SNMP ou Telnet, o estado de todas as ONUs/ONTs: status (online, offline, rompimento), sinal óptico RX/TX nas duas pontas, voltagem, temperatura, distância, MAC/serial, hora de conexão e motivo da queda.

A tela é acessada pelo menu principal, item OLT. Na 7.2 ela foi totalmente repaginada, com o mesmo design das demais telas novas: tema claro/escuro, três densidades de exibição e modais nativas. Os principais recursos:

• Colmeia: mapa de hexágonos, um por ONU, colorido por status. Aguenta milhares de ONUs sem travar, inclusive no celular.
• Tabela de ONTs com colunas configuráveis e ordenação por qualquer coluna.
• Painel da ONT com histórico de sinal (24h, 7 dias, 30 dias) e ações remotas (sincronizar, reiniciar, excluir).
• Inspecionar: consulta ao vivo na OLT a cada ~4 segundos, com o painel Alterações na rede para acompanhar manutenção de campo em tempo real.
• Autorizar: fila de ONUs pendentes com descoberta em várias OLTs e provisionamento pela interface.
• Alertas automáticos (rompimento de fibra, por exemplo) por Telegram e WhatsApp, com histórico em Logs de alertas.

Layout da tela

• Toolbar fixa no topo: abas de visualização Colmeia / Tabela / Ambos (padrão: Ambos), seletor de Densidade (Compacto, Confortável, Espaçoso), busca global Buscar ONT, MAC, serial, descrição… e os botões Autorizar, Logs, a engrenagem de Configurações e Adicionar OLT (os dois últimos só para administradores da área).
• Faixa de cards de OLT: um card por OLT, favoritas primeiro, depois em ordem alfabética. Cada card traz a estrela de favorito, a logo da marca, nome, IP (quando permitido), o selo de status (Online, Sem conexão ou Nova), a contagem de ONTs e o menu de Ações (⋮).
• Painel da OLT selecionada: cabeçalho com logo, nome, IP, data da última sincronização e total de ONTs, seguido dos filtros, da colmeia e/ou da tabela.

Ao abrir a tela, o sistema seleciona automaticamente a última OLT que você usou (se ela tiver dados) ou a melhor candidata disponível. A seleção fica gravada no navegador.

A busca global pesquisa por nome, descrição, MAC, serial e também pela posição slot/pon/ont. Filtros, busca, colmeia e tabela trabalham sempre sobre o mesmo conjunto: o que você vê na colmeia é exatamente o que está na tabela.

Conceitos básicos

Pré-requisitos e permissões

• O servidor do Ravi Monitor precisa alcançar a OLT por SNMP (UDP, porta padrão 161) e/ou Telnet/SSH, conforme a marca. A versão de SNMP suportada é v1 ou v2c.
• A quantidade de OLTs monitoradas depende do plano contratado: há planos limitados a 1 OLT, planos com até 4 OLTs e planos com OLTs ilimitadas. Ao ultrapassar o limite, o sistema exibe a mensagem de upgrade e o cadastro é bloqueado. O limite também vale para a coleta automática. Limite por plano
• Permissão da área OLT: usuário administrador vê tudo, cadastra, edita, exclui e abre as Configurações; usuário com permissão de visualização apenas consulta. O usuário Master sempre tem nível de administrador.
• Usuário comum só enxerga as OLTs liberadas para o seu grupo de usuários. O IP da OLT só aparece para administradores, a menos que a opção global de exibição de IP esteja ativa no sistema.

Coleta e alertas automáticos

Um agendador roda a cada minuto, percorre as OLTs Ativas e dispara a coleta da marca quando o relógio bate com o intervalo escolhido em Coletar a cada. Uma OLT recém-cadastrada é coletada já no primeiro ciclo. O sistema nunca roda duas coletas simultâneas da mesma OLT: se a anterior ainda estiver em andamento, o ciclo é pulado.

Após cada coleta, o motor de alertas compara cada ONU com as regras configuradas (a regra padrão é a detecção de rompimento). Quando uma ONU passa a violar uma regra, o sistema registra a ocorrência (fica Em aberto nos Logs), envia a notificação pelos canais ativos (Telegram e/ou WhatsApp) e, quando a condição normaliza, marca Resolvido e envia a mensagem de resolução com o tempo decorrido. As mensagens saem no idioma do sistema (PT/EN/ES).

Cadastrar uma OLT

O cadastro define como o Ravi Monitor se conecta à OLT e com que frequência coleta os dados. Apenas administradores da área OLT podem cadastrar e editar.

1. No menu principal, abra OLT.
2. Clique em Adicionar OLT na toolbar (ou, para alterar uma existente, abra o menu ⋮ do card e escolha Editar OLT).
3. Preencha a aba Geral (campos abaixo). Nome, IP e marca são o mínimo necessário.
4. Se a OLT não usar os padrões do sistema, ajuste as abas SNMP e SSH / Telnet escolhendo Personalizado.
5. Clique em Adicionar (ou Salvar, na edição). O toast confirma: OLT adicionada, testando conexão…

Aba Geral

Marcas suportadas

V-Solution, Huawei, Fiberhome, ZTE, Ubiquiti, PARKS, Nokia, Phyhome, C-DATA, Intelbras (Telnet), Digistar, V-Solution (Telnet), DATACOM, Cianet, Overtek, Intelbras (SNMP) e Furukawa.

A maioria das marcas coleta por SNMP. Coletam por Telnet: Intelbras (Telnet), V-Solution (Telnet), C-DATA e Nokia.

Abas SNMP e SSH / Telnet

O que acontece depois de salvar

• Um teste de conexão roda em segundo plano alguns segundos depois: consulta SNMP para marcas SNMP, login Telnet para marcas Telnet. O resultado vira o status do card: Online (conectou) ou Sem conexão (falhou, com o motivo Erro de login ou senha ou Erro de conexão). Enquanto não é testada nem sincronizada, a OLT fica como Nova.
• A primeira coleta completa acontece no próximo ciclo automático (OLT nova é coletada já no primeiro minuto) ou na hora, com Sincronizar agora.

Estado vazio e primeira sincronização

Sem nenhuma OLT cadastrada, a tela mostra Nenhuma OLT disponível. e, para administradores, a orientação de clicar em + OLT. Uma OLT recém-cadastrada (ou com o monitoramento zerado) exibe o painel Sem dados de monitoramento com o diagnóstico do caso: a OLT está online mas ainda não há ONTs coletadas, ou ainda não foi sincronizada com sucesso. O administrador pode clicar em Sincronizar agora: a coleta dispara na hora e a tela acompanha o progresso (Sincronizando…) até o toast Sincronização concluída, recarregando os dados sozinha.

Menu de ações do card (⋮)

Colmeia, tabela e colunas

A colmeia dá a visão espacial e imediata da saúde da PON; a tabela traz os dados detalhados de cada ONT. As abas Colmeia, Tabela e Ambos na toolbar escolhem o que exibir.

Filtros do painel

• Selects Slot: todos e PON: todos filtram por slot e porta PON. Ao trabalhar em uma porta específica, prefira filtrar por Slot/PON.
• Chips de status clicáveis com contagem: Online, Sinal em alerta, Sinal baixo, Rompimento, Offline e Sem dados. Clicar filtra colmeia e tabela por aquele status; clicar de novo remove o filtro.
• O contador N de M ONTs mostra quantas ONTs passaram no filtro.

Colmeia

• O controle Tamanho (slider de 10 a 40 px) ajusta o tamanho dos hexágonos. A Densidade da toolbar também influencia (Compacto, Confortável e Espaçoso usam tamanhos crescentes); em telas de toque o padrão é um pouco maior.
• Passar o mouse sobre um hexágono mostra um tooltip com nome, posição, sinal e status; o clique abre o painel da ONT.
• Com filtro ou busca ativa, os hexágonos que não casam ficam esmaecidos, preservando o mapa espacial da PON.
• Status críticos (Rompimento e Sinal baixo) ganham brilho na colmeia para saltarem aos olhos.

Tabela de ONTs

A seção ONTs tem busca própria (Buscar nesta tabela…, sincronizada com a busca da toolbar) e o botão Colunas, que liga e desliga cada coluna. A escolha persiste por navegador e vale para todas as OLTs; o link Restaurar padrão volta ao conjunto original.

• Colunas padrão: Status, Slot, PON, ONT, Nome, Descrição, MAC, RX (ONT), TX (ONT), RX (OLT), Temperatura, Distância e Motivo.
• No seletor Colunas aparecem apenas as colunas que têm valor naquela OLT: colunas 100% vazias são ocultadas automaticamente.
• Clique no cabeçalho para ordenar (asc/desc). Colunas numéricas ordenam numericamente.
• Clicar em qualquer linha abre o painel da ONT, igual ao clique no hexágono.

Paginação

Para não travar com dezenas de milhares de ONUs, a tela carrega blocos de 2.000 itens. Abaixo da colmeia aparecem o contador Mostrando X de Y e os botões Ver mais (mais 2.000) e Ver tudo. Colmeia e tabela crescem juntas.

Painel da ONT

O painel de detalhe abre ao clicar em uma ONU, na colmeia ou na tabela. Ele reúne a identificação, os dados ópticos, o histórico de sinal e as ações remotas sobre aquela ONT.

• Selo de status e posição no formato Slot X · PON Y · ONT Z.
• Campos editáveis Nome e Descrição: o botão Salvar grava (toast Dados salvos). A edição é um apelido local do Ravi Monitor, não altera nada na OLT.
• Grade de dados (só aparecem os que existem para aquela ONU): RX (ONT), RX (OLT) e TX (ONT) em dBm, Voltagem (V), Temperatura (°C), Distância (m), Bias (mA), MAC, Serial, Conectado em e Motivo (razão da última queda).

Histórico de sinal

O gráfico mostra a evolução do sinal nos períodos 24h, 7 dias e 30 dias. A legenda é clicável para ligar e desligar as séries RX (ONT), RX (OLT), TX (ONT) e Temp (°C); a temperatura vem desligada por padrão. Sem dados no período, aparece Sem histórico de sinal para o período.

Ações no rodapé

Autorizar ONUs

A fila de autorização reúne as ONUs novas detectadas nas PONs e ainda não provisionadas, de todas as OLTs, e permite autorizá-las direto pela interface. Abra pelo botão Autorizar na toolbar: surge a modal Autorizar ONUs.

• Cada pendência é um card com serial (SN), OLT, Slot/PON e a data em que a ONU foi vista. O contador mostra N pendente(s).
• Fila vazia: Nenhuma ONU pendente. Use "Descobrir" para varrer as OLTs.

Descobrir ONUs pendentes

1. Na modal Autorizar ONUs, clique em Descobrir ONUs pendentes.
2. Na modal Descobrir ONUs, marque as OLTs a varrer (todas vêm marcadas): Selecione as OLTs para varrer ONUs não autorizadas:
3. Clique em Iniciar varredura. A varredura roda em segundo plano, OLT por OLT, e a fila atualiza sozinha: Varredura iniciada — as ONUs aparecerão conforme forem descobertas. Ao final, Varredura concluída.

• A descoberta funciona nas marcas Huawei, Fiberhome, ZTE e PARKS e só varre OLTs Online (OLTs sem conexão são ignoradas).
• Requer plano com descoberta A varredura de descoberta não está disponível no plano limitado a 1 OLT; está liberada nos planos superiores.

Autorizar ou descartar uma pendência

• Autorizar: abre o formulário de provisionamento específico da marca (Huawei, Fiberhome, ZTE e Nokia têm formulário próprio). O provisionamento usa os modelos de autorização por marca/modelo; no caso Fiberhome, depende do campo Modelo do cadastro da OLT, e no Huawei entra o GEMPort do cadastro.
• Remover: descarta a pendência da fila, com a confirmação Remover ONU pendente? (não mexe na OLT).

Inspecionar ao vivo

O Inspecionar consulta a OLT diretamente, a cada ~4 segundos, e mostra as ONTs em tempo real. É o recurso ideal para acompanhar um técnico em campo: você vê a ONU cair e voltar na hora, sem esperar a coleta agendada. Disponível para as marcas Huawei, Fiberhome, ZTE, PARKS e DATACOM, no menu ⋮ do card da OLT, item Inspecionar.

1. No card da OLT, abra o menu ⋮ e clique em Inspecionar.
2. Opcionalmente, restrinja o escopo com a busca Buscar descrição ou MAC… e os campos ID ONT, Slot e PON (útil para focar na porta ou no cliente em manutenção).
3. Clique em Iniciar monitoramento. O botão vira Parar enquanto a sessão roda.

Durante a sessão, a modal exibe:

• Barra de chips com contagem ao vivo: Online, Alerta, Sinal baixo, Rompimento, Offline e Sem info, além do número do ciclo e do total de ONTs;
• Tabela ao vivo com Status, Nome, Provisionamento e RX (dBm), destacando as linhas que mudaram no último ciclo.

Painel Alterações na rede

O painel Alterações na rede é um card cronológico que registra toda ONT que mudou de status durante a sessão: novo status, horário, nome, provisionamento, a transição "de → para" e o RX. Comportamento:

• Quando a ONU reconecta, a entrada vira Voltou online e some sozinha alguns segundos depois.
• Mudanças para pior ficam fixas até serem resolvidas ou removidas manualmente com o botão Limpar.
• Ao clicar em Parar, o painel congela e nada mais some sozinho.

Mensagens de erro comuns: A OLT não respondeu à consulta (verifique acesso SNMP/credenciais). e Nenhuma ONT retornada para os filtros.

Status das ONUs

O status de cada ONU combina o estado reportado pela OLT com o sinal RX da ONT comparado ao Alerta de sinal (dBm) configurado no cadastro. É esse status que colore a colmeia e a coluna Status da tabela.

Status da OLT (card)

Configurações

A engrenagem na toolbar abre a modal Configurações da OLT, visível apenas para administradores da área. São quatro abas.

Aba Padrões

Define os valores herdados por toda OLT cadastrada com Herdar do sistema:

O botão Salvar grava tudo (padrões e canais Telegram) de uma vez; toast Configurações salvas.

Aba Telegram

Canais de Telegram específicos do ambiente OLT, independentes dos bots globais do sistema. Cada canal tem Descrição, Chat ID, Token, janela de envio Início / Fim (padrão 00:00 a 23:59) e Prioridade (Alta, Normal ou Baixa). Use + Adicionar canal para incluir e o × para remover.

• Fora da janela Início–Fim o bot não recebe mensagens (silêncio noturno, por exemplo).
• Regra de roteamento: se as Notificações Telegram da OLT estão Ativadas e o Telegram global do sistema também está ativo, os alertas de OLT saem pelos bots globais; caso contrário, saem pelos canais desta aba. Desativadas silencia os alertas por Telegram do ambiente OLT; os envios por WhatsApp têm controle próprio, na configuração global de WhatsApp do sistema.

Aba Sincronização

Lista todas as OLTs com o status (Online, Sem conexão ou Nova), a data da última sincronização (ou Nunca sincronizada) e um botão Sincronizar por OLT. Ao clicar, a coleta dispara imediatamente e a tela acompanha o progresso (Sincronizando…) até o toast Sincronização concluída. Se a coleta daquela OLT já estiver em execução, o sistema avisa e não duplica.

Aba Huawei

A seção Salvar configuração (Huawei) envia o comando save via Telnet para todas as OLTs Huawei ativas, persistindo a configuração no equipamento. Clique em Salvar nas OLTs Huawei (o botão fica desabilitado se não houver Huawei ativa).

Logs de alertas

O botão Logs na toolbar abre a modal Logs de alertas, o histórico de todos os alertas do ambiente OLT (rompimentos detectados, por exemplo), com o estado atual e a duração de cada ocorrência.

• Abas-filtro: Todos, Em aberto e Resolvidos.
• Seletor Todas as OLTs para filtrar por uma OLT específica e busca Buscar OLT, MAC, alerta…
• São exibidos até 300 registros por consulta, os mais recentes primeiro.