Serviços e relatórios
Esta página cobre o módulo Serviços (monitoramento distribuído de serviços de internet), a geração de relatórios em PDF e o histórico de incidentes com colunas dinâmicas.
Módulo Serviços
O módulo Serviços mostra, em tempo real, se serviços populares de internet (aplicativos de mensagem, bancos, jogos, CDNs e outros) estão funcionando no Brasil, na sua região e a partir da sua rede. É como um "Downdetector" privado dos provedores: servidores Ravi Monitor distribuídos pelo país testam os mesmos alvos a cada minuto e a central consolida a visão global e regional.
O valor prático é imediato: quando chove reclamação de "internet lenta", a tela responde em segundos se o problema é da sua rede ou se o serviço em questão está instável no Brasil inteiro ou apenas na sua região.
O módulo trabalha com dois tipos de serviço:
| Tipo | De onde vem | Quem testa | Para onde vão os dados |
|---|---|---|---|
| Catálogo Central | Lista mantida pela central do Ravi Monitor (aplicativos, bancos, jogos, CDNs...). | Todos os servidores participantes, incluindo o seu. | Enviados à central, que devolve a visão global e regional consolidada. |
| Serviços Locais | Cadastrados por você (servidores internos, gateways, roteadores). | Apenas o seu servidor. | Ficam somente neste servidor; nada é enviado à central. |
Pré-requisitos
- Permissão: o usuário precisa do item Serviços habilitado nas permissões do seu grupo de usuários. Contas Master têm acesso sempre.
- Ativação: o módulo vem desativado de fábrica. Na primeira visita a tela exibe "O monitoramento está desativado" com um botão Configurações para ativar.
- Internet: o servidor precisa de saída para a internet. Sem conectividade, o ciclo de testes é abortado por proteção contra falsos positivos e a tela pode indicar Central indisponível. Nesse caso ela continua exibindo os Dados locais coletados pelo próprio servidor.
Ativar o módulo
- No menu superior, abra Serviços.
- Clique em Configurações para abrir o modal Configurações de Serviços.
- Na seção Módulo de Serviços, ative o Monitoramento de Serviços. Ao ativar, este servidor passa a participar como probe do monitoramento distribuído.
- Salve. Na primeira sincronização a tela pode mostrar "Aguardando dados da central" por alguns minutos, até o primeiro ciclo completo.
Ao participar da rede colaborativa, seu servidor testa os alvos do catálogo uma vez por minuto e envia os resultados à central. O consumo de banda é mínimo. Os Serviços Locais nunca saem do seu servidor: os resultados deles não são enviados à central.
Tela principal
- Alertas Ativos: cartões com os incidentes relevantes neste momento, com contagem e horário da última atualização.
- Favoritos: serviços que você fixou em destaque no topo da tela.
- Categorias: os serviços do catálogo aparecem agrupados por categoria, em seções dobráveis, cada serviço como um card com status colorido.
- Serviços Locais: seção separada no fim da página com os serviços cadastrados por você.
- Incidentes Recentes: linha do tempo dos últimos 7 dias, com selos EM CURSO e RESOLVIDO.
- Busca: o campo "Buscar serviço por nome..." filtra os cards.
Os status possíveis de um serviço:
| Status | Significado |
|---|---|
| Operacional | Serviço respondendo normalmente em todos os probes. |
| Instabilidade regional | Falhas concentradas em uma região do país. |
| Instabilidade geral | Falhas intermitentes em várias regiões. |
| Degradado | Serviço responde, mas com desempenho fora do normal. |
| Offline parcial | Indisponível para parte dos probes. |
| Offline geral | Indisponível de forma generalizada. |
Detalhe de um serviço
Clique em qualquer card para abrir a página de detalhe, que compara a sua rede com o resto do país:
- Minha Latência vs Média Global, com o gráfico Latência — Última Hora (os pontos acumulam a cada minuto).
- Visão Global: mapa de calor com a situação de todos os probes participantes.
- Por Região: quadro por região do Brasil (Norte, Nordeste, Centro-Oeste, Sudeste, Sul e Internacional), incluindo o percentual de Perda.
- Timeline — Últimas 24 horas e Incidentes — 24h: ocorrências detectadas automaticamente quando há falhas persistentes por 2 minutos ou mais. Os textos indicam a abrangência, por exemplo Indisponibilidade geral, Indisponibilidade parcial, Instabilidade geral detectada, Serviço degradado, e sinalizam quando o incidente não afeta a sua região.
- Informações: tipo de teste, alvo, porta e timeout usados na medição.
Configurações de Serviços
O modal Configurações de Serviços reúne todas as opções do módulo:
| Seção | O que controla |
|---|---|
| Módulo de Serviços | Liga e desliga o Monitoramento de Serviços neste servidor. |
| Geolocalização | Posição do seu probe no mapa de calor. É obtida automaticamente na primeira execução, mas você pode corrigir latitude e longitude e clicar em Salvar posição. A origem exibida pode ser Automática (IP), Manual (após corrigir e salvar a posição), Financeiro (API) ou Não configurada. |
| Alertas Ativos | Filtra quais alertas aparecem na seção Alertas Ativos da tela principal (detalhes abaixo). |
| Favoritos | Serviços exibidos em destaque no topo da tela. Escolha no seletor Selecionar serviço... (grupos Catálogo Central e Serviços Locais) e arraste para reordenar. |
| Serviços Locais | Cadastro dos alvos monitorados apenas por este probe (detalhes abaixo). |
Filtros de Alertas Ativos
Os filtros vêm com configurações inteligentes por padrão e evitam poluir a tela com incidentes que não afetam a sua operação:
| Campo | Opções |
|---|---|
| Minha UF | Estado usado para filtrar alertas regionais. É detectada automaticamente pelas coordenadas e pode ser corrigida manualmente. |
| Alertas Regionais | Somente quando minha região é afetada (padrão), Todas as regiões ou Não exibir alertas regionais. |
| Severidade Mínima | Todas as severidades, Instabilidade geral e acima (padrão), Apenas degradação severa e acima ou Apenas offline geral. |
Cadastrar um serviço local
Serviços locais servem para vigiar recursos internos da rede, como servidores, roteadores e gateways, com a mesma cadência de 1 minuto do catálogo. Na seção Serviços Locais, clique em Adicionar serviço local e preencha:
| Campo | O que faz |
|---|---|
| Nome | Identificação do serviço nos cards (ex.: Gateway Principal). |
| Alvo | IP ou domínio a testar. |
| Tipo | Método do teste: ICMP (Ping), HTTP (Head), TCP (Porta) ou DNS. |
| Porta | Porta do alvo; o campo só aparece para os tipos TCP e HTTP. |
| Timeout | Tempo máximo de espera pela resposta. |
| Categoria | Agrupamento livre na tela (ex.: Infraestrutura). |
| Logo | Imagem exibida no card do serviço. |
O módulo Serviços não envia notificações por Telegram, WhatsApp ou e-mail: os Alertas Ativos são um painel visual dentro da própria tela. Para receber avisos de queda de equipamentos e sensores da sua rede, use os alertas do monitoramento (veja Alertas e notificações).
Comportamento automático
- Os testes rodam a cada minuto para todos os alvos ativos: ICMP em lote, HTTP, DNS e TCP.
- Se o servidor detecta que está sem internet ou com um backup em execução, o ciclo é pulado para não gerar falso positivo.
- Uma rotina diária limpa caches de médias com mais de 30 dias.
Solução de problemas do módulo
| Sintoma | Causa provável e verificação |
|---|---|
| Tela mostra Central indisponível ou todos os cards em cinza | Servidor sem saída para a internet, sistema ainda não registrado na central, ou central temporariamente fora. A tela cai para Dados locais enquanto isso; confira a conectividade do servidor. |
| "Aguardando dados da central" não some | Primeira sincronização ainda em andamento. Aguarde alguns ciclos de 1 minuto; se persistir, verifique a conectividade. |
| Alertas demais ou de menos na seção Alertas Ativos | Ajuste Minha UF, Alertas Regionais e Severidade Mínima no modal Configurações de Serviços. |
| Serviço local sempre em falha | Confira Alvo, Tipo, Porta (para TCP e HTTP) e Timeout; teste o alvo manualmente a partir do servidor. |
Relatórios em PDF
O Ravi Monitor gera relatórios em PDF em dois lugares principais: no painel do sensor (dados de monitoramento de um sensor em um período) e no Flow (post-mortem de ataques e comparativos de tráfego). Na 7.2 a geração passou a rodar em segundo plano, então relatórios grandes não travam o navegador.
Exportar PDF de um sensor Novo na 7.2
O relatório do sensor traz o gráfico do período, a tabela de mínimos e máximos (Mín e Máx) e a tabela completa de Leituras do intervalo selecionado.
- Na tela de Dispositivos, abra o painel do dispositivo e clique no sensor desejado.
- Escolha o período do detalhe: 24h, 7d ou 30d.
- Clique em Exportar PDF.
- A geração roda em segundo plano: a modal mostra "Gerando PDF..." com o progresso. Volumes grandes são processados em lotes, sem travar a tela.
- Ao concluir, aparece "PDF gerado com sucesso" com o botão Baixar PDF.
No mesmo painel existe o botão separado Parecer IA: ele pede uma análise técnica do sensor à inteligência artificial e não gera PDF. São duas ações independentes; use cada uma quando precisar. Detalhes na seção Relatório PDF e parecer IA da área de Dispositivos.
Os PDFs gerados ficam guardados por usuário no servidor: cada operador vê e baixa apenas os seus. Pela API é possível iniciar, acompanhar, listar, cancelar, baixar e excluir gerações.
Na Concentradora, o painel da sessão PPPoE oferece atalhos diretos para os relatórios de latência, tráfego e sessões do assinante, úteis para anexar em chamados de suporte. Veja o Painel da sessão.
Os PDFs não são apagados automaticamente. Em servidores com pouco disco, faça uma limpeza periódica dos relatórios antigos.
PDFs do Flow
- Post-mortem automático de ataque: quando um ataque de severidade crítica encerra, o Flow gera o PDF do incidente (timeline, principais origens, ASNs e países, threat intel e ação sugerida) e o anexa ao e-mail de ataque encerrado. Também dá para gerar o post-mortem sob demanda na tela do Flow, e o envio automático pode ser desligado nas configurações do Flow. Veja Post-mortem automático.
- Relatórios comparativos: os comparativos período-a-período do Flow também saem em PDF. Veja Relatórios e percentil 95.
Se o PDF travar em "Gerando..."
A geração tem proteções embutidas, e o próprio job reporta o erro em poucos minutos:
- Job aguardando que não inicia em 60 segundos vira erro, com orientação para verificar as permissões do servidor.
- Job sem progresso por 3 minutos é encerrado com a mensagem de processo travado.
- Processo morto no meio do caminho vira erro indicando possível falta de memória ou timeout.
Se as falhas se repetirem em relatórios grandes, verifique memória e espaço em disco do servidor antes de tentar de novo, ou exporte um período menor (24h em vez de 30d).
Logs do sistema
O histórico de incidentes registra cada problema detectado nos sensores (queda ou alerta de limite), quando foi resolvido e por quais canais o aviso saiu. É a primeira parada para responder perguntas como "quando esse enlace caiu?" e "por que não recebi o alerta?".
Abrir e filtrar Novo na 7.2
- Na tela de Dispositivos, clique no botão Logs. A modal abre com o histórico de incidentes.
- Use os filtros Todos, Em aberto e Resolvidos para restringir por situação.
- Digite no campo "Filtrar por sensor, dispositivo ou mensagem…" para buscar um incidente específico.
- Clique em Atualizar para recarregar a lista.
Colunas dinâmicas
O botão Colunas permite escolher quais colunas exibir. A escolha fica salva por navegador, então cada operador monta a visão que prefere. O link Restaurar padrão volta ao conjunto original. Em telas estreitas o padrão inicial mostra apenas Dispositivo, Sensor, Mensagem e Status.
| Coluna | Conteúdo |
|---|---|
| Data | Quando o incidente foi registrado. |
| Dispositivo | Equipamento afetado. |
| Sensor | Sensor que gerou o incidente. |
| Mensagem | Descrição do problema (e da solução, quando resolvido). |
| Envio | Por quais canais o alerta saiu: Telegram, e-mail, WhatsApp e push. |
| Tempo decorrido | Duração do incidente até a resolução. |
| Status | Em aberto ou resolvido. |
A coluna Envio é a melhor amiga do diagnóstico de notificação: se o incidente está lá mas um canal não aparece como enviado, o problema está na configuração daquele canal ou na cadeia de herança, não no monitoramento. Veja Herança de canais.
Ciclo de vida de um incidente
Quando um sensor cai ou estoura um limite, o incidente entra na lista como Em aberto e os canais configurados são acionados na hora. Quando o sensor volta ao normal, o mesmo registro é marcado como resolvido, a coluna Tempo decorrido passa a mostrar a duração total e os mesmos canais que receberam o problema recebem a mensagem de problema resolvido. Se os avisos de problema chegam mas os de resolvido não, veja a página de Solução de problemas.
Retenção
Incidentes resolvidos com mais de 30 dias são apagados automaticamente pela manutenção do banco, e excluir um sensor apaga os logs dele. Esse comportamento é fixo: para guardar histórico mais longo, exporte relatórios em PDF periodicamente.
Outros históricos
- Histórico de ações de usuários (auditoria): registra quem criou, editou ou excluiu o quê na interface, no idioma de quem fez a ação. Fica na área de usuários das Configurações gerais; veja Histórico de ações.
- Logs de alertas da OLT: histórico próprio da área de fibra, com duração e situação de cada alerta; veja Logs de alertas.
- Logs de quedas da Concentradora: desconexões de sessões PPPoE com horários de conexão e desconexão; veja Logs de quedas.