Solução de problemas
Sintomas comuns do dia a dia, a causa provável e o que fazer, área por área. Se o problema persistir depois de seguir as orientações, veja como falar com o suporte.
Monitoramento e sensores
Problemas de coleta em dispositivos, sensores, OLTs e concentradoras quase sempre se resumem a três causas: credencial ou comunidade SNMP errada, alcance de rede bloqueado entre o servidor Ravi e o equipamento, ou o ciclo de coleta que ainda não rodou. Comece por aqui antes de suspeitar de defeito.
Dispositivos e sensores
| Sintoma | Causa provável e o que fazer |
|---|---|
| Dispositivo criado pela detecção automática ficou só com ping, sem sensores SNMP | O SNMP não respondeu durante a descoberta e o dispositivo herdou a configuração do grupo. Corrija a comunidade SNMP no grupo (ou no dispositivo) e aguarde o próximo ciclo de 5 minutos, ou reabra e salve o dispositivo. |
| Botão Escanear agora recusa a varredura | O grupo precisa estar salvo com Ativar detecção automática ligado e a Faixa de IPs preenchida. Se já houver varredura em andamento, o clique apenas acompanha o trabalho atual. |
| Varredura não acontece no horário agendado | O agendador pausa durante a geração do backup diário do sistema. Aguarde alguns minutos e, se a varredura agendada não iniciar sozinha, use Escanear agora. |
| Varredura terminou como "Interrompido inesperadamente" ou "Tempo limite excedido" | O processo de varredura falhou ou passou de 30 minutos. O sistema marca o erro sozinho para nada ficar preso: basta escanear de novo. Faixas acima de 8.192 IPs são truncadas, divida em grupos menores. |
| Sensor de conexões (PPPoE/DHCP) não foi criado na descoberta | Comportamento proposital: quando o equipamento responde zero ao contador (típico de OID de outro fabricante), o sensor não é criado para evitar dado inútil. |
| Não consigo ligar Criar sensores automaticamente | Selecione antes a marca do equipamento na aba Geral. Atenção: desligar o toggle e salvar remove as marcações de descoberta do dispositivo. |
| Excluí dispositivos e eles continuam aparecendo na árvore | Exclusões em massa respondem na hora e processam em segundo plano. A árvore se atualiza sozinha nos segundos seguintes. |
| Terminal SSH do dispositivo não conecta | "SSH não configurado neste dispositivo" indica falta de usuário ou IP (verifique a aba SSH ou o SSH padrão). "Sem conexão" indica porta inacessível a partir do servidor. "Falha na autenticação SSH" indica credenciais erradas. O terminal está disponível apenas para usuários Master e Admin. |
| Sonda remota sempre "Offline" | Agente parado no host remoto, sem alcance de rede até o servidor Ravi, ou token trocado. Gerar novo token exige reconfigurar o agente com o token novo. |
| Mapa de Calor vazio | Sem leituras históricas no período (sensores recém-criados) ou dispositivos sem sensores. Aguarde acumular coletas. |
| Parecer IA retorna erro | A IA do sistema não está configurada ou está indisponível no momento. O Exportar PDF continua funcionando normalmente: são recursos independentes. |
| Gráfico sem a linha de percentil 95 | A linha só aparece em sensores de tráfego com dados no período consultado. |
| Usuário não enxerga os IPs dos dispositivos | É uma opção de permissão, não defeito: o grupo de acesso está com nível "visualizar" e a opção global Exibir endereço IP, nas Configurações da área Dispositivos, está desligada. |
| Logo após uma atualização, sensores de tráfego mostram valor bruto, sem unidade | Cache interno do servidor desatualizado. A 7.2 já reinicia o serviço certo após a migração; se ocorrer, reiniciar o serviço PHP-FPM no servidor resolve na hora. |
OLT
| Sintoma | Causa provável e o que fazer |
|---|---|
| Card fica "Sem conexão" logo após cadastrar | Em SNMP: comunidade, versão ou porta erradas, ou ACL na OLT bloqueando o IP do servidor Ravi. Em Telnet: usuário, senha ou porta ("Erro de login ou senha"). Confira também se escolheu Herdar do sistema sem ter preenchido os Padrões nas Configurações da área. |
| Card "Online" mas o painel diz "Sem dados de monitoramento" | A conexão validou, mas a primeira coleta ainda não rodou. Aguarde o próximo ciclo ou use Sincronizar agora. |
| Descobrir ONUs pendentes não encontra nada | A OLT precisa estar Online, o plano precisa incluir a descoberta e a marca precisa ter suporte (Huawei, Fiberhome, ZTE, PARKS e Nokia). DATACOM aparece no seletor, mas não possui varredura de pendentes. |
| Fiberhome mostrando "Rompimento" para ONU apenas desligada | Comportamento da marca: o SNMP da Fiberhome reporta perda de sinal em quedas de energia da ONU. O sistema exibe o dado que a OLT entrega. |
| Alerta de ONU demorou muito para disparar | O alerta só é avaliado no momento da coleta. Reduza o intervalo Coletar a cada da OLT. |
| Gráfico da ONT diz "Sem histórico de sinal para o período." | ONU recém-adicionada (ainda sem coletas suficientes), monitoramento zerado recentemente, ou intervalo de coleta muito longo. |
| Sinal marcado como baixo, mas o cliente opera normalmente | Revise o Alerta de sinal (dBm) daquela OLT (padrão -26). Redes com orçamento óptico maior podem operar abaixo desse valor sem problema. |
| Provisionei uma ONU Huawei e ela sumiu após reboot da OLT | Faltou persistir a configuração na OLT: use Configurações, aba Huawei, botão Salvar nas OLTs Huawei. |
| Filtros e colunas "voltaram sozinhos" em outro computador | Colunas visíveis, densidade e tamanho da colmeia são preferências por navegador, não por conta. Ajuste em cada estação. |
Concentradora
| Sintoma | Causa provável e o que fazer |
|---|---|
| Card fica em "Sem conexão" | O SNMP não responde a partir do servidor Ravi: comunidade, versão ou porta erradas, ACL SNMP no equipamento ou firewall no caminho. O re-teste é automático a cada minuto: corrija o SNMP e aguarde. |
| Card "Online" mas "Sem dados de monitoramento" | Primeira coleta ainda não rodou, ou a concentradora está além do limite do plano (apenas as primeiras são coletadas). |
| Concentradora não atualiza há muito tempo | Veja a duração da última coleta no card: coletas lentas elevam o intervalo automaticamente (até 6 horas). Melhore a resposta SNMP do equipamento (CPU, ACL) para acelerar. |
| Latência, Jitter e Perda vazios | Teste de ping desabilitado na concentradora, ou o IP do assinante não é alcançável a partir do servidor Ravi (CGNAT ou firewall no caminho). |
| Sessão nova não aparece na tabela | A tela mostra a última fotografia da coleta. A sessão aparece no próximo ciclo (intervalo adaptativo, mínimo de 5 minutos). |
| Mikrotik não coleta | RouterOS anterior à versão 6 não é suportado pelo coletor. |
Preferências de visualização (colunas, densidade, favoritos, última OLT aberta) ficam salvas no navegador de cada operador, não na conta. Não é perda de configuração quando mudam de uma estação para outra.
Flow
No Flow, separe o diagnóstico em três camadas: o coletor está vivo, o fluxo está chegando e a detecção ou mitigação está calibrada. O card Saúde do Flow no dashboard detalha as duas primeiras.
| Sintoma | Causa provável e o que fazer |
|---|---|
| Indicador "Coletor offline" | O serviço coletor está parado ou o retrato ao vivo está desatualizado há mais de 30 segundos. Consulte o card Saúde do Flow para o detalhe. |
| Chip do exportador "Sem fluxo recebido" ou "Sem fluxo ainda" | Verifique nesta ordem: o roteador parou de exportar; o IP de origem dos pacotes é diferente do cadastrado (configure o export source no equipamento); no Huawei, o sampler não foi habilitado por slot; firewall bloqueando a porta UDP de coleta usada pelo exportador (2055, 4739, 9995, 9996 ou 6343). Servidor atrás de NAT precisa de redirecionamento dessas portas para o IP público informado: use Detectar IP público e observe o aviso de NAT. O guia por marca e o Revisar configuração (IA) corrigem os casos de configuração. |
| Explorer e Sankey vazios | Amostragem do Explorer desligada: ative em Configurações do Flow. Lembre que a retenção padrão das amostras é de 48 horas, então janelas de 7 dias ficam parciais. |
| Nenhum ataque foi detectado até hoje | Sem prefixos cadastrados em Minhas redes o Flow não sabe o que é vítima. O Score de risco aponta isso como fator "Nenhuma rede monitorada". |
| "Cadê o alerta do ataque de 100 Mbps?" | Comportamento intencional da severidade por impacto: pico abaixo do Piso de tráfego configurado na detecção (padrão 200 Mbps) nunca é crítico, e a severidade mínima padrão dos alertas é Critical. Se quiser mais avisos, reduza a severidade mínima para Warning nas configurações de alerta. |
| Nenhum alerta do Flow chega | Canal em modo Herdar sem o padrão do sistema configurado, janela de silêncio ou manutenção ativa, ou severidade mínima em Critical enquanto os eventos são Warning. Confira também as configurações de notificação. |
| Anomalias nunca disparam ou disparam em horário estranho | O baseline compara por hora local. Confira o fuso horário do sistema nas Configurações: fuso errado desalinha toda a comparação. |
| Evento "Mitigando" sem efeito na rede | Use o diagnóstico de viabilidade da mitigação: peer BGP não cadastrado, serviço de BGP parado, sessão BGP caída (TCP 179 não aceito no roteador) ou família FlowSpec não negociada com o vizinho. Nesse último caso, habilite a família no roteador ou use o RTBH. |
| Sessão BGP de mitigação não sobe | O endereço local configurado no vizinho do roteador é diferente do esperado, ou o exportador está sem ASN preenchido (informe no Ajuste avançado). |
| Link de aprovação da mitigação não abre no celular | URL pública não preenchida ou incorreta (o padrão usa o endereço do próprio servidor; se for IP privado, não abre fora da rede local), ou o link expirou (uso único; validade padrão de 15 minutos, ajustável nas Configurações do Flow). Peça um novo alerta ou aprove pela interface. |
| Toggle de ClickHouse ou GeoIP não liga | Gate de capacidade do servidor: a aba Capacidade do servidor mostra o motivo. O botão desabilitado não é defeito, é proteção contra sobrecarga. |
| Chat de configuração por IA não abre | Motor de IA ausente ou quebrado no servidor. Rode a atualização do sistema (ela verifica e reinstala o ambiente de IA). O cadastro manual do exportador continua disponível. |
| PDF sem gráfico ou país "Desconhecido" nas origens | Servidor sem saída à internet: gráficos de PDF e geolocalização de origens dependem de serviços externos. O restante do Flow funciona offline; para o mapa, ative os tiles offline. |
| Cards de Clientes, Mapa, Saúde ou Risco sumiram para um usuário | O usuário pertence a um grupo com escopo por exportador: cards de visão geral do provedor são ocultados de propósito para esse perfil. |
| Alertas pararam durante upgrade ou manutenção | Janela de manutenção ativa (selo no topo da tela). O estado de saúde não oscila durante a janela justamente para não gerar avalanche de avisos depois. |
| Alertas do Flow nunca saíram em instalação antiga | Rotinas agendadas sem permissão de execução, cenário corrigido pela atualização. Rode a atualização do sistema; se nunca alertou nada desde a instalação, esse é o primeiro suspeito. |
Números do Explorer, do Sankey e do mapa de fluxos são estimativas por amostragem (as telas indicam o fator). Para faturamento use os Relatórios: o percentil 95 é calculado sobre a contagem integral do coletor, já corrigida pela taxa de amostragem do exportador (a medição mais precisa disponível).
Notificações
Quando um alerta não chega, valide primeiro o canal (pareamento, token, credenciais) e depois a rota do alerta (prioridade, janela de horário, herança de canais). O modal de Logs mostra, na coluna Envio, por quais canais cada incidente foi enviado.
| Sintoma | Causa provável e o que fazer |
|---|---|
| WhatsApp não envia alertas | Na maioria dos casos o aparelho está despareado: abra o quadro do WhatsApp e escaneie o QR Code de novo. Confira também se os contatos de destino estão selecionados na lista. Lembre que a integração não é oficial e desconexões esporádicas fazem parte do funcionamento. |
| QR Code do WhatsApp não carrega ("Carregando QR Code" eterno) | O serviço interno de WhatsApp está parado no servidor. Reinicie aplicando a atualização do sistema ou entre em contato com o suporte para reativá-lo. |
| Contatos do WhatsApp sem nome ou com dígitos ocultos | Limitação do endereçamento do próprio WhatsApp para contatos não sincronizados. Use a linha de adicionar número manualmente no topo da lista. |
| Telegram: Buscar Chat ID não encontra nada | O bot ainda não recebeu nenhuma mensagem. Envie um "oi" para o bot no Telegram e clique em Verificar Mensagens Recentes de novo. |
| Alertas de ONU não chegam no Telegram | Verifique, na área da OLT: Notificações Telegram em "Desativadas" nos Padrões, Chat ID ou Token errados no canal, horário fora da janela Início e Fim do bot, ou coleta parada (sem coleta não há detecção). |
| E-mail nunca envia, sem mensagem de erro | O canal de e-mail só é acionado com os 4 campos preenchidos: servidor, usuário, senha e porta. Faltando qualquer um, o canal fica silenciosamente inativo. Prefira conta dedicada, porta 587 com SSL/TLS e confira SPF/DKIM do domínio, pois o remetente é o próprio usuário SMTP. |
| Aviso de problema chega, mas o de "PROBLEMA RESOLVIDO" não | O aviso de resolvido sai por um verificador próprio que roda junto do ciclo de coleta. Se só os resolvidos faltam, o canal está bom: verifique na tela Serviços se o monitoramento está rodando normalmente e acione o suporte se persistir. |
| Usuário não recebe push no app RAVI Mobile | O aparelho precisa estar conectado pelo QR Code da página de perfil do usuário. Além disso, o push respeita permissões: cada técnico só recebe push dos grupos de dispositivos que o grupo de acesso dele pode ver. |
Teste o canal antes de esperar um incidente real: o quadro do WhatsApp tem o botão Testar conexão, que envia uma mensagem de teste na hora.
Acesso e conta
Bloqueios de login, verificação em duas etapas e sessões encerradas têm quase sempre explicação de segurança prevista. Antes de resetar qualquer coisa, identifique qual proteção foi acionada.
| Sintoma | Causa provável e o que fazer |
|---|---|
| Tela de login pede para aguardar 10 minutos e não mostra o campo de senha | Bloqueio de força bruta ativo após 3 erros. O bloqueio vale para a faixa de IP: colegas atrás do mesmo NAT podem ser bloqueados juntos. Aguarde 10 minutos e tente de novo. |
| Usuário com 2FA ativo não é solicitado do código | O aparelho foi marcado como confiável em um login anterior (opção Confiar neste dispositivo, validade de 30 dias). Comportamento esperado. |
| Perdeu o celular e os códigos de backup do 2FA | Um usuário Master ou Admin usa Resetar 2FA na lista de usuários. Sem outro administrador disponível, acione o suporte da Ravi. |
| "Sessão de login expirada, entre novamente" no passo do código 2FA | O passo do código passou de 5 minutos. Refaça o login desde a senha. Após 6 erros de código a mensagem muda para "muitas tentativas, entre novamente", com a mesma solução. |
| Banner "Sua sessão foi encerrada porque este usuário fez login em outro dispositivo." | Na 7.2, isso significa que a sessão foi desconectada pelo card Dispositivos conectados do perfil (ou por revogação em massa). Login simultâneo não derruba mais ninguém. |
| Conta "relogando sozinha" em máquina compartilhada | Cookie de lembrar-me válido naquele navegador. Faça logout ali (o logout esquece o aparelho) ou desconecte a sessão pelo card de dispositivos do perfil. |
| Não recebe o e-mail de recuperação de senha | Usuário sem e-mail cadastrado no perfil, nome de usuário digitado errado, ou servidor sem saída SMTP para a internet. |
| Sistema deslogou todo mundo de uma vez | Bloqueio por atraso de mensalidade ou servidor há mais de 3 dias sem sincronizar com a central (verifique a saída HTTPS do servidor). Regularize a cobrança ou libere o acesso e atualize o registro. |
| Recursos sumiram do sistema após o período de teste | Fim do TRIAL: o plano cai para FREE automaticamente. Registre a licença pelo aviso Registrar agora!. |
| Criou um usuário e ele virou Master sem querer | O grupo escolhido tem DNS, Dispositivos, OLT e Concentradora todos em "Incluir e gerenciar". Reduza qualquer um deles para o usuário ficar como Admin. |
| Alterou as permissões do grupo e "não aplicou" | As permissões do grupo passam a valer nas próximas telas carregadas; o tipo do usuário (Master/Admin) só é recalculado ao salvar o usuário. Peça para o usuário sair e entrar de novo se algo parecer preso na sessão. |
| Tema volta ao claro em outro computador | O tema é salvo no navegador, não na conta. Sem escolha manual, o sistema segue o tema do sistema operacional. |
| Sistema abre em idioma "errado" para um usuário | Verifique o card Idioma no perfil do usuário (a preferência da conta vence o padrão do sistema) e a escolha de idioma feita na tela de login daquele navegador. |
Em máquinas compartilhadas, oriente a equipe a não marcar Confiar neste dispositivo: a confiança do 2FA dura 30 dias e não tem revogação individual pela interface.
Falar com o suporte
Se o problema não se encaixa nos sintomas acima, ou se as ações indicadas não resolveram, acione o suporte da Ravi Systems pelos canais oficiais publicados no site ravimonitor.com.br.
Para o atendimento ser rápido, tenha em mãos:
- A versão do sistema: ela aparece no rodapé da tela inicial do Ravi Monitor.
- O horário do ocorrido (data e hora, com o fuso do servidor): é o que permite localizar o evento nos registros.
- O sintoma exato: a mensagem de erro como aparece na tela (um print ajuda) e em qual tela ou ação ela ocorre.
- O que você já tentou seguindo esta página.
Alterações feitas pelos usuários ficam registradas no Histórico de ações, com autor e horário. Consultar o histórico antes de abrir o chamado costuma responder "o que mudou" logo antes do problema começar. Veja Histórico de ações.
Planos e recursosLimites de OLTs, concentradoras e exportadores por plano.
Como funcionam as notificaçõesCanais, prioridades e herança de destino.
Capacidade do servidor (Flow)Por que alguns recursos pesados aparecem bloqueados.
AtualizaçõesComo o sistema se atualiza e o que verificar quando a versão não chega.