DBS TELECOM

DBS TELECOM

NOC · Monitoramento e topologia da rede

🔒 Acesso restrito a operadores autorizados · tentativas de login são registradas Esqueceu a senha? Fale com o administrador do sistema.
DBS TELECOM
MAPA: ROOT
Cabos
Fibra 100G
Fibra 10G
Fibra 1G
Cabo RJ45 (mostra 10M/100M/1G)
Rádio (ondas = tráfego)
Sem tipo: cor pela carga
Caído (LINK DOWN)
Pontos andando = tráfego; mais rápidos, mais carga.
Cards
Online
Offline
Monitoramento pausado
Passivo (sem gerência)
Mapa
Atalho de outro mapa
Tudo cadastrado no Zeus
ASSISTENTE IA
Os dados deste mapa são enviados à IA. Ela pode errar — confira antes de agir.
Sistema
EQUIPAMENTO

GESTÃO DE OBJETO

Ações
Editar

Layout travado. Destrave o cadeado [L] para editar este item.

Cada campo salva sozinho ao ser alterado.

Só Super Admin. Desativado, o host fica cinza no mapa, não gera alerta de queda nem WhatsApp e é desativado também no Zabbix; reativar liga ele de volta lá.

Origem atual dos dados
Z?

Cria o host no Z2 pelo preset do modelo, passa este card pra ele e desativa o host antigo. Ou vincule a um host que já existe:

Se este host cair ou voltar, avisa nesse grupo. Sem grupo, nenhuma mensagem é enviada por ele (nem pelos cabos que usam ele como fonte de dados).

Largura236px
Ações
Editar

O cabo fica vermelho sozinho quando um dos hosts das pontas cai (ping down).

Host fonte de dados (Zabbix)
Porta / interface

Layout travado. Destrave o cadeado [L] para editar este cabo.

Equipamento

Monitoramento
Clientes
Ferramentas
noc@infinity-dude

Top 10 incidentes

Quem mais caiu nos últimos 7 dias.

Caídos agora

Equipamentos offline neste momento, por mapa. Atualiza sozinho a cada 20 s.

Registro de ocorrências

Últimas quedas dos equipamentos, com a hora em que voltaram.

Registro no Z2

Só Super Admin. Cria host novo no Zabbix Z2 a partir de um preset (templates, grupos, macros e SNMP do modelo). Não altera nada que já existe no Z2.

App no celular

Instale o NOC na tela inicial e receba as quedas no próprio aparelho, além do WhatsApp.

1. Instalar

2. Notificações neste aparelho

Só chegam avisos dos mapas que o seu usuário enxerga. Várias quedas juntas viram um aviso só.

Meus aparelhos

Previsão de problemas

Como funciona esta tela

Lixeira

Só Super Admin. Restaure o que foi apagado ou exclua de vez: some do banco, do histórico, do monitoramento e dos caches (o Zabbix não é alterado).

Histórico de mudanças

Quem mudou o quê no mapa, com opção de desfazer. Ctrl+Z desfaz a sua última mudança (com o cadeado aberto). Guardado por 90 dias.

Disponibilidade (SLA)

Tempo no ar de cada equipamento e de cada POP no mês, pelas quedas registradas no Zabbix.

Capacidade dos enlaces

Pico de uso de cada cabo: a hora mais cheia (média de 1 h, entrada ou saída) frente à capacidade.

Manual de operação e atalhos

Como usar o mapa no dia a dia. Atalhos apagados pedem uma permissão que seu perfil não tem.

🖱️ Mouse

Clique

Seleciona um card ou cabo. Clique no vazio fecha o painel.

Arrastar

Move o mapa; com o layout destravado, move o card.

Botão direito

Abre o painel lateral do card ou cabo (no celular: segurar o dedo).

Duplo clique

Num mapa/POP, entra nele; num equipamento, abre as notas.

Roda

Zoom. De longe os cards viram bolinhas coloridas.

🔎 Consultar

FCtrl F

Localizar equipamento (nome ou IP) ou mapa/POP.

O

Caídos agora: tudo offline, de todos os mapas.

R

Top 10 incidentes (equipamentos e POPs que mais caíram).

E

Registro de ocorrências: quedas e retornos.

Ctrl Z

Desfaz a sua última mudança no mapa (cadeado aberto). Histórico completo no menu Sistema.

D

Disponibilidade (SLA) do mês, por POP e por equipamento, com PDF.

P

Previsão de problemas: sinal de fibra ou rádio piorando antes de cair.

U

Capacidade dos enlaces: cabos mais cheios no horário de pico.

I

Assistente IA: pergunte sobre o mapa aberto.

H

Esconde/mostra os menus (modo TV).

Esc

Fecha janelas e painéis e tira a seleção.

📟 Com um equipamento selecionado

M

Telemetria: métricas, gráficos, interfaces e alarmes. Num mapa/POP: alarmes e energia.

C

Copia o IP.

W

Abre a página web do equipamento numa aba nova.

X

Abre no Winbox já conectado (configure abaixo, uma vez por PC).

🔗 Com um cabo selecionado

M

Gráficos do cabo: tráfego, sinal da SFP ou do rádio.

Delete

Apaga o cabo.

✏️ Editar o mapa precisa de permissão e do layout destravado

L

Trava/destrava o layout (o cadeado).

A

Adicionar ao mapa: equipamento do Zabbix, submapa ou passivo.

Ctrl B

Cria um elemento passivo (DIO, caixa de emenda, rack) no centro da tela.

F2

Renomeia o card selecionado.

Ctrl C

Copia o card: colado vira um atalho pro mesmo equipamento.

Ctrl X

Recorta o card pra mover pra outro mapa.

Ctrl V

Cola o card copiado/recortado no centro da tela.

Delete

Remove o card selecionado do mapa.

🎨 O que as cores dizem

Verde: online.

Vermelho: offline (sem ping); "OFFLINE há X" no card.

Bolinha/etiqueta laranja ou amarela: alarme ativo no Zabbix.

Cinza: inativo (em manutenção) ou passivo.

Cabo vermelho: a porta ou o equipamento do cabo caiu (LINK DOWN).

Raio azul: equipamento (ou mapa inteiro) já cadastrado no Zeus.

🪟 Configurar o Winbox no Windows uma vez só, por PC

Pra tecla X / botão WINBOX abrir o equipamento já conectado, o Windows precisa repassar o link winbox: pro WinBox. Informe o caminho do WinBox.exe neste PC e baixe os 2 arquivos: mova o .bat pra pasta do WinBox e dê duplo clique no .reg.

NOTAS TÉCNICAS

Adicionar ao mapa

Entra no mapa aberto agora: —, no centro da tela.

Vira um card neste mapa; duplo clique entra nele pra desenhar o POP. O card avisa quando algo lá dentro cai, e a tecla M nele mostra alarmes e energia do POP.
Peça da rede que não é monitorada pelo Zabbix: aparece cinza e serve pra ligar cabos e documentar o caminho da fibra. Atalho: Ctrl+B.

Localizar

Equipamento por nome ou IP, ou um mapa/POP pelo nome. Use ↑ ↓ e Enter.

Acessos · Usuários

Perfil = o que a pessoa pode fazer · Mapas = onde ela pode ver.

UsuárioPerfilMapasÚltimo acesso
HoraTipoEventoIP

IPs bloqueados agora

Tentativas de login com falha

HoraIPUsuário digitadoResultado

Quando bloquear

O IP é bloqueado quando, dentro da janela, erra a senha N vezes ou tenta N usuários diferentes.

Continua valendo também o bloqueio por usuário (5 senhas erradas na mesma conta = 15 min).

Quem está conectado

Online = usou o sistema nos últimos 30 min. A sessão vale 2 h sem uso; depois disso expira sozinha (quem só fechou a aba sem sair fica como "expirada").

Minha conta

Trocar minha senha

A senha nova vale a partir do próximo login.
O administrador pediu que você defina uma senha própria antes de continuar.

    Visual dos cards

    Como os equipamentos e mapas aparecem pra você. Cada usuário escolhe o seu, e a escolha vale em qualquer navegador ou celular.

    Atualização do sistema

    Baixa a versão mais nova do GitHub e reinicia o serviço desta instância.

    Instalada
    Lendo a versão…
    Repositório oficial · main
    Procurando atualizações no GitHub…
    Saída do terminal
    Reiniciando o servidorA tela reconecta sozinha em alguns segundos.

    Buscar CTO

    Pendências do IXC

    O que não bate entre as OLTs e o cadastro do IXC. Corrija no IXC: a lista se atualiza na próxima sincronização.

    Configurações do sistema

    Nada encontrado.
    Monitoramento
    Integrações
    Avisos no WhatsApp
    Inteligência artificial
    Sistema

    Servidores Zabbix

    De onde vêm hosts, alarmes e gráficos. A ordem define o prefixo: o 1º é o Z1, o 2º o Z2…

    Banco de dados

    MySQL onde ficam mapa, cabos, usuários, auditoria e o histórico dos alertas.

    ⚠️ O banco precisa aceitar as credenciais novas antes de salvar: senão o sistema não sobe depois do reinício.

    Conexão do WhatsApp

    Conexão com a Evolution API, usada por todos os avisos: queda e retorno de host e cabo e o plantão crítico.

    A instância do WhatsApp precisa já estar conectada na Evolution (ver o Manager da Evolution).
    Quem recebe o quê: o grupo de cada equipamento fica no painel de edição do host (seção Notificações); o texto das mensagens em Mensagens; o grupo do plantão em Plantão crítico.

    Zeus Agent

    Integração com o Zeus: selo ⚡ de "já cadastrado" nos cards e credenciais cifradas no export.

    Consulta de cadastro
    Valida se o equipamento já está cadastrado no Zeus (qualquer empresa) e mostra o selo ⚡ azul no card. A chave é gerada no Zeus em Configurações → Integração InfinityDude NOC; uma chave só vale pra todas as empresas.
    Criptografia do export
    Preenchida, Usuário/Senha/Porta SSH no export de equipamentos saem cifrados: só quem tem a chave privada (no Zeus) decifra.

    Sistema do provedor

    Mostra o cliente de cada ONU e de cada station de rádio (abas ONUs, Assinantes e Pendências). Escolha o sistema que o provedor usa e preencha só ele. O NOC só consulta: nunca grava nada no IXC, no SGP nem no Vigo.

    🔐 Crie no IXC um usuário só de consulta pro NOC (sem permissão de alterar) e gere o token dele em Configurações → Usuários → Token. O token vai no formato id:token. Quem vê o nome do cliente é quem tem a permissão "Ver clientes (IXC)" no perfil.
    No SGP o cliente da ONU é achado pelo nome na descrição da ONU na OLT (igual ao nome do contrato); o serial do cadastro FTTH do SGP só entra quando o nome não casa.
    🔐 Gere o Token + App em Administração → Integrações → Tokens, de preferência restrito às rotas de listagem (fttx/onu/list, ws/radius/radacct/list/all, ura/listacontrato) e sem permissão de baixar/cancelar títulos.
    A API do Vigo usa o login de um funcionário (cadastro de Funcionários), não o usuário de entrar no sistema. Vêm os clientes liberados e os logins PPPoE de cada um; o NOC só consulta, mesmo que o funcionário seja "full".
    Sincronização
    Leva ~1–3 min. Só leitura.

    Concentrador PPPoE (MikroTik)

    Acesso só de leitura à API do RouterOS: quem está conectado agora, o serviço PPPoE (POP/VLAN) e o MAC do equipamento de cada cliente.

    Com o Vigo, o MAC da sessão casa com a station do rádio e com a ONU. Também alimenta a aba PPPoE do card Concentrador. No RouterOS, libere este servidor em /ip service api e use um usuário só com api + read.

    Detecção de queda

    Textos de trigger do Zabbix que deixam host e cabo vermelhos no mapa. Cada template nomeia as triggers de um jeito ("PING DOWN", "Dispositivo Offline"…): se um host caiu e o mapa não ficou vermelho, falta o termo aqui.

    Host offline
    Um termo por linha. Trigger ativa do host contendo um deles = host e cabos ligados a ele vermelhos.
    Porta / interface caída
    Um termo por linha. Vale pro cabo com uma porta como fonte de tráfego (ex.: "Porta eth0 mudou o status para DOWN").

    Fabricantes (SNMP)

    Quando o equipamento não diz o fabricante por texto, ele sai do PEN (número SNMP do fabricante) no item "Equipment Vendor". Adicione aqui PEN → nome, sem mexer em código.

    PENFabricante

    Logos dos fabricantes

    A logo aparece no ícone do card do equipamento, na cor escolhida aqui. Fabricante sem logo sai com as iniciais. Salva na hora, sem reiniciar: o mapa muda depois de apertar F5.

    Envie SVG, PNG ou WEBP com fundo transparente, até 512 KB. Com Pintar na cor ligado, a logo vira uma cor só (fica igual às outras); desligado, mantém as cores originais. JPG não tem fundo transparente, então sai sem pintar.

    Mensagens de queda e retorno

    Texto enviado ao grupo de cada equipamento. A prévia ao lado atualiza enquanto você digita.

    Variáveis: {nome}{mapa}{hora}{link} host {origem}{destino}{hora} cabo
    Host caiu
    Host voltou
    Cabo caiu
    Cabo voltou

    Plantão crítico

    Só o que é grave e verídico vai pro grupo do plantão: uma mensagem curta com o impacto e a causa provável escritos pela IA, e outra quando normaliza.

    O que chama o plantão
    • Switch, roteador ou OLT grande offline (5+ cabos ligados, ou OLT)
    • Rota de fibra 10G/100G com a porta down
    • POP inteiro fora (80% dos equipamentos do mapa)
    • Queda em massa: muitos hosts em 5 min
    • Zabbix sem visão: um servidor inteiro sem enxergar a rede
    Mapa em manutenção (painel do mapa → Manutenção) não chama. O que cair no mesmo minuto vira uma mensagem só. Sem IA disponível, vai a mensagem simples.
    Regras
    Usa o grupo já salvo e o que está fora agora; a mensagem chega marcada como 🧪 TESTE.

    Rádios do UNMS

    Avisa no WhatsApp a queda e a volta dos rádios do UNMS/UISP que ainda não estão no mapa. Rádio que tem card no mapa (mesmo IP, MAC ou nome) é avisado pelo mapa, nunca pelos dois. Só consulta o UNMS, não altera nada lá. Salva na hora, sem reiniciar.

    Conexão com o UNMS
    Consulta a cada 1 minuto. Ao ligar, quem já está fora não gera aviso; só as quedas dali pra frente. 3 ou mais quedas no mesmo minuto saem numa mensagem só, separadas por site.
    Mapa automático pelo UNMS
    Cria o submapa Monitorados por UNMS com um submapa por site, na posição geográfica, os rádios de cada site e os cabos entre um site e o que o alimenta. Esses cards são monitorados só pelo UNMS (queda pela Outage, sinal, canal, capacidade), sem Zabbix, e avisam no grupo acima. Só acrescenta: o que já existe não é movido nem apagado, então dá pra rodar de novo quando entrar site ou rádio novo no UNMS. Rádio que já tem card do Zabbix no mapa fica de fora.
    Quem avisa cada rádio

    Assistente IA (Claude)

    Chave e modelo usados pelo assistente (tecla I), pelo botão Analisar e pelo texto do plantão crítico. Sem a chave, nada de IA aparece no sistema: o botão do assistente, a tecla I, os botões Analisar e a Qualidade da IA ficam escondidos (depois de salvar, aperte F5).

    Gerada em console.anthropic.com → API Keys; o uso é cobrado na conta dessa chave. Quem pode usar o assistente é definido pela permissão "Assistente IA" nos perfis.
    Valores aproximados pra um mapa médio; mapas grandes custam mais. O custo dos alertas do plantão aparece em Qualidade da IA.

    Qualidade da IA

    Avalie cada alerta crítico que foi pro grupo do plantão: as métricas saem daqui. Cada avaliação salva sozinha.

    Chave das sessões

    Chave secreta que assina as sessões de login (JWT). Bloqueio de IP, tentativas e sessões ativas ficam no menu Sistema → Segurança.

    64 caracteres aleatórios
    ⚠️ Trocar a chave derruba todas as sessões: todo mundo precisa entrar de novo.

    Marca da empresa

    Logo, nome e cores do sistema todo: tela de login, título da aba, cabeçalho do mapa, ícone e nome do app do celular e os relatórios em PNG e PDF. Salva na hora, sem reiniciar — quem já está com o sistema aberto vê depois de apertar F5.

    Logo da empresa
    sem logo
    PNG com fundo transparente fica melhor no fundo escuro. JPG ou WEBP também servem, até 2 MB. A logo também vira o ícone do app do celular e da aba do navegador. Sem logo, sai a padrão.
    Cores
    Prévia
    Configurações salvas — reiniciando o servidor...
    Nenhuma alteração

    Backup do sistema

    Cópia de segurança, restauração e inventário dos equipamentos.

    Vai no arquivo
    • Banco de dados completo (mapa, cabos, usuários, auditoria, histórico de alertas)
    • Arquivo .env (senhas e configurações)
    • Estado do NOC (estado_noc.json)
    • Ícones customizados
    Não vai
    • Código-fonte (já está no GitHub)
    • logs.txt (grande demais)
    • Bibliotecas Python
    🔐 O arquivo leva as senhas do .env: guarde num lugar seguro.
    Atenção: restaurar sobrescreve o banco de dados e as configurações atuais desta instância, e o serviço reinicia sozinho. Baixe um backup do estado atual antes, se tiver dúvida.
    Restaurar um backup automático
    Volta o banco e as configurações só desta instância (…) para a data escolhida; as outras não são tocadas. Antes, o banco atual é salvo na VM, e o serviço reinicia sozinho no fim.
    Carregando backups…
    Agendamento
    Vale para a VM inteira: um backup de todas as instâncias por dia.
    Conta do Google Drive
    A VM não tem navegador, então a autorização é feita num computador com o rclone (baixar para Windows): abra a pasta dele, digite cmd na barra de endereço e cole o comando gerado aqui.
    Sem ID/chave, usa o acesso compartilhado do rclone (vai ser desligado pelo Google).
    🔐 Guarde essa senha fora da VM (gerenciador de senhas, papel). Sem ela, ninguém consegue abrir os backups do Drive.
    Últimas linhas do log do backup
    
                        
    Inventário de equipamentos (.txt)
    Nome, IP, fabricante, categoria, usuário, senha e porta SSH/Winbox de todos os equipamentos dos mapas, pra cadastrar em outro sistema (ex.: Zeus).
    Verificando se as credenciais saem cifradas…
    Restauração concluída — reiniciandoA tela reconecta sozinha em alguns segundos.

    Registrar host no Zabbix

    Cria o host com SNMP, os templates do modelo e os grupos escolhidos.

    1Equipamento
    2Modelo e SNMP
    3Templates vêm do modelo; ajuste se precisar
    4Grupos nenhum selecionado
    Selecione um servidor Zabbix
    * obrigatório

    Varredura de rede

    Pinga uma faixa de IPs e cruza com os equipamentos cadastrados nos mapas.

    Até /24 (256 endereços).
    Informe uma faixa e clique em Escanear.