Dispositivos e sensores

Visão geral

A tela Dispositivos apresenta uma árvore ao vivo no formato sonda, grupos, dispositivos e sensores. Cada nível mostra contadores coloridos por status, e a tela inteira se atualiza sozinha a cada 10 segundos, sem recarregar a página e sem interromper o que você estiver fazendo (modais abertas e arrastes não são atropelados pelo refresh).

Conceitos essenciais

Status dos sensores

Toda a área usa os mesmos 6 estados: Ok (verde), Atenção (âmbar), Crítico (vermelho), Offline (cinza-escuro), Pausado e Sem dados.

Barra superior

• Abas de visualização: Visualização Simples, 3D, GEO e Mapa de Calor. A última escolha fica memorizada no navegador.
• Densidade: Compacto, Médio ou Grande, também persistida por navegador.
• Botão Recolher / expandir tudo.
• Busca Buscar dispositivo, IP ou sensor...: casa nome do grupo, nome ou IP do dispositivo e nome do sensor, expandindo os grupos com resultado. Atalhos: a tecla / foca a busca e Esc limpa.
• Botão Logs: abre o histórico de incidentes.
• Engrenagem Configurações (somente administradores): abre as configurações da área.
• Botão Adicionar (somente administradores): menu com Adicionar dispositivo e Adicionar grupo.

Trabalhando na árvore

• Clicar em um contador de status de um grupo filtra aquele escopo para mostrar apenas os sensores daquele status (o filtro vale para toda a subárvore; clique de novo para limpar).
• Clique no dispositivo para abrir o painel dele; clique no sensor para abrir o detalhe; o menu ⋮ traz as ações de cada item; o cabeçalho de um grupo colapsa e expande (o estado fica salvo no navegador).
• Administradores podem arrastar e soltar para reordenar sensores, dispositivos e grupos.
• O rodapé mostra o relógio e a contagem regressiva da próxima atualização. Quando um status muda, o item pisca sutilmente: vermelho ou âmbar quando piora, verde quando melhora.

Grupos e dispositivos

Grupos organizam a árvore e centralizam configuração; dispositivos são os equipamentos monitorados. A cadeia de herança de credenciais é: dispositivo, depois grupo, depois padrões do sistema (definidos nas Configurações avançadas).

Criar ou editar um grupo

1. Abra o menu ⋮ da raiz ou de um grupo e escolha Adicionar grupo (ou Editar grupo).
2. Na aba Geral, preencha o Nome do grupo (obrigatório) e o Grupo pai. A opção Raiz (sem grupo) coloca o grupo no topo; um grupo não pode ser pai de si mesmo.
3. Na aba SNMP, ligue Customizar SNMP se este grupo usar credenciais próprias. Desligado, o grupo usa o SNMP padrão do sistema.
4. A aba Detecção automática transforma o grupo em um grupo de varredura (veja Detecção automática).
5. Salve. O sistema confirma com Grupo salvo.

Campos SNMP disponíveis ao ligar Customizar SNMP:

Criar ou editar um dispositivo

1. Clique em Adicionar e depois em Adicionar dispositivo (ou use o ⋮ de um grupo). Para alterar, use ⋮ do dispositivo e Editar.
2. Na aba Geral, informe Nome, IP, Grupo e Equipamento (a marca). A marca é o que habilita a descoberta automática de sensores pelo catálogo.
3. Na aba SNMP, escolha Herdar do grupo pai ou Personalizado (mesmos campos do grupo).
4. Na aba SSH, mesmo esquema: herdar ou personalizar Usuário, Senha e Porta SSH (padrão 22). Essas credenciais alimentam o Terminal SSH e o backup do equipamento.
5. Na aba Avançado, configure a descoberta automática de sensores, coordenadas e notas (detalhes abaixo).
6. Salve. O sistema confirma com Dispositivo salvo e, se a descoberta estiver ligada, ela roda imediatamente em segundo plano.

Marcas disponíveis no campo Equipamento: Ubiquiti, Mikrotik, Cisco, Juniper, Huawei, Fiberhome, ZTE, Intelbras, PARKS, v-Solution, Mimosa, Cambium Networks, Ceragon, VOLT, XPS, ALGcom, Rondotec, Linux, DATACOM, JFA, a10, além de Genérico e Nenhum.

Campos da aba Avançado:

Adicionar vários dispositivos de uma vez

Na aba Geral, marque Adicionar vários dispositivos para cadastrar um lote compartilhando grupo, equipamento, SNMP e SSH. Preencha o campo Dispositivos (um por linha) no formato Nome;IP ou apenas o IP (nesse caso o nome vira o próprio IP). Ao final o sistema informa quantos foram adicionados e quantos falharam.

Menus de ação (⋮)

Sensores

Um sensor é uma métrica coletada do dispositivo. Você pode deixá-los nascer pela descoberta automática (recomendado) ou adicioná-los manualmente a partir do catálogo.

Adicionar sensor manualmente

1. No ⋮ do dispositivo, escolha Adicionar sensor, ou clique no cartão + Novo sensor no fim da lista de sensores.
2. A modal abre na categoria "Sensores mais usados", com a busca já focada. Use Buscar modelo de sensor... para pesquisar em todas as categorias (mínimo 2 caracteres) ou o botão ‹ Voltar para navegar pela grade de categorias e marcas.
3. Cada cartão de modelo mostra nome, descrição, o selo Configurar ou Descoberta SNMP, o equipamento compatível e as bolinhas de Impacto de CPU (1 a 5).
4. Clique nos modelos para marcar e desmarcar (multi-seleção): o rodapé vira Adicionar (N). Modelos de consulta SNMP direta entram no lote; os que exigem entrada abrem a configuração um a um, com opção Pular.

Modelos com configuração própria:

• Ping: permite cadastrar vários alvos de uma vez, em pares Nome do sensor e IP ou domínio, com o botão + Adicionar outro IP. O primeiro alvo vem preenchido com o IP do dispositivo.
• Sensor agregador: informe o Nome do sensor e os IDs dos sensores de origem (separados por vírgula). Na 7.2 o agregador soma fontes de qualquer dispositivo.
• Descoberta SNMP (walk): a tela mostra "Consultando o equipamento… pode levar alguns segundos" com progresso e, ao terminar, uma tabela dos itens encontrados, com filtro por nome, opção de marcar todos e o botão Criar sensores. Sem itens, aparece "Nada encontrado no equipamento".

Ao concluir, o sistema confirma com Sensor criado (ou a quantidade criada). Erros reais de SNMP são exibidos com o texto devolvido pelo equipamento.

Editar um sensor

No ⋮ do sensor, escolha Editar Sensor para abrir as propriedades:

Grupos de sensores

Para organizar dispositivos com muitos sensores, use ⋮ do dispositivo e Grupos de sensores. Clique em Novo grupo de sensores, informe o Nome do grupo, escolha a Cor e marque os Sensores que pertencem a ele. Na árvore, os sensores agrupados aparecem sob um cabeçalho colorido e colapsável, com pílulas de status.

Copiar modelo de sensor

A ação Copiar modelo de sensor (no ⋮ do dispositivo) cria um modelo reutilizável a partir dos sensores de um dispositivo: informe o Nome do modelo (mínimo de 5 caracteres), use os atalhos Todos e Nenhum e escolha os sensores exportáveis. O modelo criado aparece depois como opção ao adicionar sensores em outros dispositivos. Alguns tipos específicos de OLT e óptica não são exportáveis.

Catálogo por marca

Todos os sensores nascem de modelos de um catálogo organizado por categorias e marcas, mantido pela equipe Ravi. É esse catálogo que alimenta tanto a modal Adicionar sensor quanto a descoberta automática: a cobertura de novos equipamentos cresce sem depender de atualização do sistema.

Descoberta automática de sensores

Com a opção Criar sensores automaticamente para este dispositivo ligada (aba Avançado do dispositivo), o Ravi consulta o equipamento e cria sozinho os sensores que a marca suporta. A descoberta roda na hora, ao salvar o dispositivo, e depois periodicamente a cada 5 minutos.

• Ping: testa o ping real e só cria o sensor se houver resposta. Suporta IPv6.
• Interfaces: varre as interfaces por SNMP e cria um sensor de tráfego para cada interface Ethernet operacional, nomeando pelo nome real da porta e registrando velocidade e MAC.
• Demais sensores: para cada modelo do catálogo compatível com a marca, o sistema testa o OID no equipamento e só cria o sensor se vier um valor válido. Nunca duplica sensores existentes.
• Sensores novos nascem com coleta A cada minuto.

Se a lista de sensores da aba Avançado estiver vazia, verifique a marca: sem Equipamento selecionado na aba Geral, a tela avisa "Selecione a marca do equipamento na aba Geral para habilitar a descoberta automática."

Detecção automática

A Detecção automática transforma um grupo em um grupo de varredura: o Ravi varre uma faixa de IPs e cria sozinho os dispositivos que responderem, já com nome, marca e sensores. É a forma mais rápida de popular o monitoramento de uma rede inteira.

Configurar

1. Edite (ou crie) um grupo e abra a aba Detecção automática.
2. Ligue Ativar detecção automática.
3. Preencha a Faixa de IPs: aceita CIDR (192.168.1.0/24), faixa (192.168.1.10-50 ou 192.168.1.10-192.168.2.50) ou IPs separados por vírgula.
4. Escolha a Frequência e o nível de Criar sensores (tabela abaixo).
5. Salve o grupo. Com a detecção ligada, a varredura inicia automaticamente ("Varredura iniciada"). Para rodar de novo a qualquer momento, use Escanear agora.

Escanear agora e progresso

O botão Escanear agora dispara a varredura na hora, com barra de progresso ao vivo, mensagem de fase e os contadores IPs na faixa, Hosts ativos, Criados e Ignorados. O progresso também aparece dentro do nó do grupo na árvore; ao terminar, a árvore se atualiza sozinha com os dispositivos criados. O botão Cancelar varredura interrompe o trabalho de forma segura. O botão só funciona com o grupo já salvo ("Salve o grupo para poder escanear.").

Como a varredura se comporta

• A faixa tem teto de segurança de 8.192 IPs; o excedente é cortado e a mensagem de progresso avisa. Para faixas maiores, divida em grupos.
• Para cada host vivo, a varredura testa SNMP com cada comunidade configurada (do grupo ou do padrão do sistema) até uma responder. Com resposta, o dispositivo é criado já com o nome real do equipamento, a marca detectada automaticamente (Mikrotik, Ubiquiti, Huawei, Cisco, Fiberhome, V-Sol, Datacom, ZTE e outras) e as credenciais SNMP que funcionaram gravadas no próprio dispositivo.
• Host que não responde SNMP vira dispositivo "só ping", herdando o SNMP do grupo. Se as credenciais do grupo forem corrigidas depois, ele passa a descobrir sensores no ciclo seguinte.
• Varreduras agendadas rodam conforme a Frequência; um trabalho preso há mais de 30 minutos é marcado como erro automaticamente, nada fica travado.
• A varredura não roda durante a geração do backup do sistema; ela aguarda e executa em seguida.

Sondas remotas Novo na 7.2

Sondas remotas permitem monitorar redes em outros locais (POPs, datacenters, redes atrás de NAT) através de um agente que se conecta a este servidor. Os dispositivos delas aparecem na mesma árvore, sob o nó de cada sonda.

Adicionar e parear

1. No fim da árvore, clique no cartão Adicionar nó/servidor remoto.
2. Na modal Nova sonda remota, informe o Nome da sonda e salve ("Sonda adicionada").
3. A tela Parear sonda abre em seguida com o token de pareamento. Use Copiar token e informe esse token no agente instalado no local remoto.
4. Enquanto o agente não conecta, o nó mostra "Aguardando primeira sincronização da sonda".

Estado e gerenciamento

• O nó da sonda exibe o selo Remota ou Offline, o endereço, a última sincronização e a latência em milissegundos.
• A sonda é considerada online se enviou sinal de vida nos últimos 90 segundos.
• A engrenagem Gerenciar sonda oferece: Parear sonda (mostra o token atual), Renomear, Gerar novo token e Remover sonda.
• Ao remover uma sonda, os dispositivos dela voltam para a sonda local (a tela avisa antes de confirmar).
• Todas as ações de sonda entram no histórico de ações do sistema.

Painel do dispositivo

Clicar em um dispositivo (na árvore ou pelo nome nas outras visualizações) abre o painel dele: um resumo de tudo o que está sendo coletado, sem sair da tela.

• Topo com IP e contadores por status.
• Um card por sensor, com bolinha de status, valor atual, nome e sparkline das últimas 24 horas (carregada em segundo plano, para até 60 sensores).
• Cada card mostra também a referência técnica do sensor (id, índice ou interface e tag), copiável com um clique.
• Clicar em um card abre o Detalhe do sensor.
• Rodapé com Adicionar sensor, Editar e OK. Na 7.2, editar é uma ação explícita: o clique no dispositivo abre este painel, não o formulário.
• Dispositivo sem sensores mostra "Este dispositivo não possui sensores."

Detalhe do sensor

O detalhe do sensor concentra o histórico da métrica: gráfico interativo, mínimos e máximos, leituras cruas e exportação. Abra clicando no sensor na árvore ou em um card do painel do dispositivo.

• Abas de período: Últimas 24h, 7 dias e 30 dias.
• Gráfico interativo com zoom por arrasto, tooltip e navegador de período (ocultos no celular). Até cerca de 3.000 pontos por período, com redução automática de resolução em séries maiores.
• Percentil 95: em sensores de tráfego, uma linha tracejada vermelha marca o percentil 95 do período, com o valor formatado na melhor unidade (bps a tbps).
• Cartões Mín e Máx por coletor, além do resumo de status do período.
• Tabela Leituras: coluna Data mais as colunas do modelo, com a linha colorida pelo status. Paginação com 5, 10, 20, 50 ou Todos por página, cobrindo as últimas 5.000 leituras.

Os botões Exportar PDF e Parecer IA do rodapé estão descritos em Relatório PDF e parecer IA.

Condições e alertas

Cada sensor avalia condições a cada coleta e, quando uma condição dispara, gera um incidente com a gravidade configurada e notifica pelos canais ativos (som na tela, Telegram, WhatsApp, e-mail e push). Quando o problema fecha, sai o aviso de resolvido.

Herdar ou customizar

Por padrão, o sensor herda as condições do modelo do catálogo ("Herdando os alertas padrão do modelo. Clique em Customizar para editar."). No ⋮ do sensor, abra Condições de alerta:

• Customizar alertas copia as condições do modelo para o sensor e libera a edição.
• Herdar padrões do modelo descarta as customizações e volta ao padrão.

Estrutura: condições e regras

Uma condição tem descrições de problema e de resolvido (campos Descrição do problema e Descrição de resolvido, em PT, EN e ES) e uma ou mais regras encadeadas. Use Adicionar condição e Adicionar regra para montar; edição e exclusão ficam nos ícones de cada item, com confirmação.

O momento do disparo depende também do campo Considerar crítico do sensor (imediatamente, após 2, 3 ou 5 falhas seguidas, ou nunca). Os canais de notificação, sons e modelos de mensagem são configurados nas Configurações avançadas da área; para conectar WhatsApp, Telegram e e-mail no sistema, veja Alertas e notificações.

Mapa de calor, 3D e Geo

Além da Visualização Simples, a barra superior oferece três visualizações alternativas sobre os mesmos dados. A escolha fica memorizada por navegador.

Mapa de Calor Novo na 7.2

O Mapa de Calor é uma matriz dispositivo × tempo: cada célula mostra a pior severidade registrada pelos sensores do dispositivo naquele intervalo, com legenda dos 6 status. Períodos: 24h (24 células de 1 hora), 7 dias (28 células de 6 horas) e 30 dias (30 células de 1 dia). A visualização lê o histórico real e se atualiza a cada minuto; só aparecem dispositivos com alguma leitura no período. Clicar no nome do dispositivo abre o menu de ações. É a melhor forma de enxergar padrões, como quedas recorrentes de madrugada.

3D

Grafo de força ligando localhost, grupos, dispositivos e sensores, colorido por status. Em celulares, tablets ou bases com mais de cerca de 500 sensores, entra automaticamente o modo leve: só grupos e dispositivos aparecem, e clicar em um dispositivo materializa os sensores dele (clique de novo para abrir o menu, com a opção Ocultar sensores). O menu ⋮ completo funciona sobre os nós.

GEO

Mapa geográfico (base clara no tema claro, escura no tema escuro) com marcadores dos grupos e dispositivos que têm Latitude e Longitude preenchidas, coloridos pelo status. O mapa enquadra os pontos automaticamente na primeira carga, e o clique em um marcador abre o mesmo menu de ações da árvore.

Histórico de incidentes

O botão Logs da barra superior abre, em tela cheia, o histórico de incidentes da área: cada disparo de alerta com sua mensagem, canais de envio e resolução.

• Filtros Todos, Em aberto e Resolvidos, busca por sensor, dispositivo ou mensagem, e botão Atualizar. O topo mostra o total de incidentes e quantos estão em aberto.
• Colunas dinâmicas com seletor (Colunas) e Restaurar padrão, persistidas por navegador: Data, Dispositivo, Sensor, Mensagem, Envio, Tempo decorrido e Status. Em telas estreitas o padrão inicial omite Data, Envio e Tempo.
• Coluna Envio: pílulas T (Telegram), E (e-mail), W (WhatsApp) e P (push). Verde indica envio realizado (no problema e/ou na resolução); vermelho indica falha de envio. O tooltip de cada pílula detalha o resultado.
• Coluna Status: "Resolvido!" ou "Não resolvido". Incidentes em aberto mostram o tempo decorrido correndo ao vivo.
• A tela carrega os 500 incidentes mais recentes, com os não resolvidos primeiro.

Relatório PDF e parecer IA

No rodapé do Detalhe do sensor há dois botões independentes: um gera o relatório em PDF, o outro pede uma análise por inteligência artificial. Um não depende do outro.

Exportar PDF

O botão Exportar PDF gera um relatório com o gráfico, os mínimos e máximos e todas as leituras recebidas no período, em ordem cronológica. A geração roda em segundo plano: uma modal mostra a barra de progresso "Gerando PDF...", depois "PDF gerado com sucesso" e o botão Baixar PDF. Fechar a modal cancela a geração. Mesmo com muitos dados, o navegador não trava.

Parecer IA

O botão Parecer IA envia as últimas 60 leituras do sensor para a IA e devolve uma análise técnica curta: tendências, anomalias e recomendações. Só usa IA quem clicar. Requer a IA configurada no sistema; se ela estiver indisponível, o PDF continua funcionando normalmente.

Terminal SSH do dispositivo Novo na 7.2 Somente Master

A ação Terminal SSH (no ⋮ do dispositivo) abre um painel lateral com um terminal real e interativo, já autenticado no equipamento com as credenciais SSH cadastradas (aba SSH do dispositivo ou o SSH padrão herdado). A senha nunca chega ao navegador.

• No celular, o terminal ganha uma barra com Enter, Ctrl+C, Tab e setas, além de um botão Ctrl+C fixo no topo para interromper comandos presos.
• O botão <_ do cabeçalho da tela abre o mesmo terminal no shell do servidor Ravi local.

Configurações da área

A engrenagem Configurações da barra superior (somente administradores) reúne os ajustes de exibição e os padrões da área. Cada seção salva apenas os próprios campos, então alterar uma parte nunca zera as demais.

Configurações de exibição

Ao salvar, a tela confirma com "Configurações salvas". O link Configurações avançadas (alertas, WhatsApp, Telegram, SNMP) leva às abas abaixo.

Configurações avançadas

• SNMP padrão / SSH: os valores usados por todo dispositivo ou grupo em modo herdar. SNMP padrão com versão, comunidade (ou usuário, nível de segurança, protocolos e senhas em v3) e porta; SSH padrão com usuário, senha e porta.
• Alertas: Som de alerta com Quando tocar (Offline e alertas, Somente offline ou Desativado) e escolha do Som (1 a 6); Notificações WhatsApp e Telegram, cada um com Herdar padrões, Customizar ou Desativado, e Prioridade (offline e alertas, ou só offline).
• Telegram: lista de contatos da área. Adicionar Telegram pede Chat ID, Token, Descrição, a janela de horário Início e Fim em que o contato recebe alertas, e a Prioridade.
• Mensagens: modelos das notificações, com Mensagem de problema encontrado e Mensagem de problema resolvido, cada uma com Título e Mensagem. Variáveis disponíveis: #id_sensor, #ip, #tag, #nome e #valor.