Guia de Operações do OmniWeb
OmniWeb é o portal de gerenciamento unificado e baseado na web da Omnitouch para toda uma rede central móvel. É uma única interface que traz monitoramento em tempo real, configuração, rastreamento de protocolo, análise de logs, painéis e gerenciamento do ciclo de vida do software para cada função de rede (NF) em uma única interface — EPC, IMS, CS Core, 5G Core, SS7, mensagens, cobrança e a infraestrutura de suporte que as executa.
Em vez de fazer login em uma dúzia de CLIs de elementos, Grafana, Loki e Homer separadamente, um operador abre o OmniWeb e pode:
- Ver a rede inteira de uma só vez através de mapas de topologia interativos e saúde por elemento.
- Visualizar, editar e alterar configurações de NF — adicionar uma rota no SMSC, provisionar um assinante no HSS, limpar uma sessão no UPF — através de uma interface consistente.
- Assistir logs estruturados em tempo real para qualquer elemento e rastrear um único assinante por toda a rede (Diameter, GTP-C, PFCP, SIP, MAP).
- Abrir painéis e estatísticas do Grafana incorporados, sem sair do portal.
- Gerenciar versões de software e ciclo de vida em toda a frota.
Cada função de rede é operada através do mesmo conjunto de padrões. Este guia documenta esses padrões genéricos uma vez — eles se aplicam a cada NF.
Visão de topologia do OmniWeb — a única interface sobre EPC, IMS, CS Core e 5G Core. Elementos ativos são clicáveis e levam diretamente às suas páginas de gerenciamento.
Como o OmniWeb consome a telemetria de sinalização da própria rede, ele pode reconstruir o fluxo de chamadas de um único assinante ao vivo — sem captura de pacotes para fazer upload — e desenhá-lo como uma escada ordenada por tempo através de cada elemento que a tocou:
Fluxos de Rastreio de Sessão Ao Vivo — a anexação LTE de um assinante reconstruída diretamente da telemetria de sinalização da rede, correlacionando S1AP, Diameter S6a e GTP-C através do eNodeB, MME, HSS, SGW-C e PGW-C em uma escada. Clique em qualquer mensagem para sua decodificação e hex. Veja Logs & Rastreio de Assinantes.
Mapa da Documentação
Comece Aqui
- Arquitetura — Como o OmniWeb funciona: o SPA, o proxy de backend, o modelo de configuração e como ele se comunica com cada NF, Loki e Grafana.
- Operações Comuns — Os padrões compartilhados por cada elemento: como visualizar, editar e alterar configurações de NF; como ler logs; como o polling, visualização de configuração e RBAC se comportam. Leia isso uma vez e se aplica em todos os lugares.
Observabilidade & Solução de Problemas
- Painéis e Estatísticas do Grafana — Painéis incorporados, estatísticas de elementos e alertas.
- Logs & Rastreio de Assinantes — Logs estruturados em tempo real do Loki, Rastreio de Sessão entre redes (siga um assinante de ponta a ponta) e captura SIP do Homer.
- Homer — Captura SIP — A interface de captura SIP do Homer incorporada e auto-autenticada: pesquise SIP capturado e reconstrua a escada de sinalização de uma chamada; como isso difere do Rastreio de Sessão.
- Rastreio de Chamadas (SIP Trace) - Pesquise chamadas gravadas, abra um detalhe completo da chamada com qualidade de voz por perna (MOS) e jitter, siga a escada SIP de múltiplos saltos através do IMS, visualize o gráfico de QoS, ouça o áudio gravado, baixe o PCAP e assista chamadas ao vivo e a saúde do agente de captura. Alimentado por agentes de captura de pacotes agrupados nos elementos IMS.
- Topologia da Rede — As visões de topologia de única interface e a Lista de Hosts da infraestrutura.
- Arquivo de Configuração - Backups de configuração de dispositivos: roteadores enviam sua própria exportação para o OmniWeb via FTP, e o arquivo mantém cada versão pesquisável, ordenável e comparável.
Plataforma
- Referência da API (OpenAPI / Swagger) — Navegue e experimente a API REST do controlador em
/api/docs; a especificação OpenAPI está em/api/openapi.json. - Gerenciamento de Software — Versionamento, repositório APT e ciclo de vida do software.
- Dispositivos de Teste — Controle remotamente telefones conectados via ADB em locais remotos; faça chamadas, envie mensagens e execute testes programados de VoLTE / sinal / conectividade exportados para o Prometheus.
- Simulador RAN — Crie eNodeBs e UEs virtuais para exercitar um núcleo ao vivo sem hardware: anexações, sessões de dados, registro IMS com localização de célula, SMS/chamadas, cenários de falha e testes de carga — controláveis a partir de Dispositivos de Teste.
- Teste de Rede (Teste de Carga) — Gere carga de sinalização sintética em um núcleo ao vivo com o Simulador RAN: anexações, sessões de dados e registros IMS, execute sob demanda ou em um cronograma com resultados exportados para o Prometheus.
- Núcleo 5G — Painéis por NF para o plano de controle 5GC (NRF, AMF, SMF, UDM/UDR, AUSF, PCF, CHF, NSSF, BSF, SCP): saúde, registros, contextos de UE, sessões PDU, pools de IP do SMF e ações de limpeza de estado.
- Editor de Sites — Leia o arquivo de configuração bruto por site (elementos, hosts,
fivegc, monitoramento) em um visualizador com destaque de sintaxe; a fonte da verdade da qual o OmniWeb deriva cada site. - OmniRoam — Automação de Testes de Roaming — Execute os livros de testes de roaming da GSMA (IR.38, IR.48, VoLTE) automaticamente contra uma rede ao vivo, capture pass/fail com evidências, agende execuções rotineiras e exporte o workbook da GSMA concluído. Links para Livros de Teste, Executando Testes, o Explorador de Livros de Teste e Documentos Concluídos.
- OmniRoam — Acordos de Roaming & Automação de Email — O lado comercial/provisionamento do OmniRoam: encaminhe um email de parceiro e o OmniRoam extrai os fatos, cria ou atualiza o acordo, gera e assina eletronicamente a documentação AA.12/AA.13/CLL/TCC/TNS, arquiva e levanta ordens de trabalho com notificações de webhook + email para o responsável.
- Banco de SIM — Inventário distribuído de cada SIM em cada leitor através de todos os agentes — centrado no leitor, com presença de cartão, identidade e ferramentas de sistema de arquivos/APDU por slot.
- Ferramentas de Cartão SIM — Ferramentas de baixo nível por cartão que alcançam qualquer leitor em qualquer agente: o Explorador de Sistema de Arquivos SIM (navegar/editar/decodificar EFs), o Terminal APDU (enviar APDUs brutos, de um único disparo ou sessão com estado), o Log APDU (rastreamento ao vivo modem↔SIM) e gerenciamento de perfis eSIM (eUICC).
- Kit de Ferramentas SIM (STK) — Cliente de applet STK interativo. Navegue pelos menus do operador, acione serviços residentes no SIM e execute comandos proativos em qualquer cartão em um leitor conectado.
- SIM Remoto & SIM Virtual — Apresente qualquer SIM a qualquer modem pela rede via emuladores de cartão, e emule um SIM virtual (imagem salva + chaves HSS) para que um modem se conecte como um assinante para o qual você não tem cartão físico.
- Gerenciamento de SIM OTA — Leia e edite os arquivos de um SIM remoto via aérea com pacotes RFM/RAM seguros (03.48 / SCP80) — um leitor no host, um agente remoto ou SMPP para um SIM de campo — além de perfis de segurança reutilizáveis e campanhas de fan-out.
- Autenticação & Controle de Acesso — Visão geral do modelo de controle de acesso, vinculando a:
- Login & Sessões JWT — fluxo de login, tempo de vida do token, um-login-abrange-pilha.
- Controle de Acesso Baseado em Papéis — permissões e aplicação por elemento e por método.
- Login com Chave SSH — acesso SSH ao host central, chaves servidas ao vivo do OmniWeb.
- Registro de Auditoria — auditoria de portal, login SSH e comandos.
Arquitetura em Resumo
Cada solicitação do navegador carrega um JWT. O backend verifica, confere as permissões baseadas em função para o elemento alvo e método HTTP, e então encaminha (proxy) a chamada para a própria API de gerenciamento do elemento. Grafana, Loki e Homer são acessados através do mesmo gateway autenticado, portanto, um único login no OmniWeb governa toda a pilha. Veja Arquitetura para a descrição completa.
Funções de Rede Suportadas
O OmniWeb administra cada função no núcleo da Omnitouch. Todas são gerenciadas através dos mesmos padrões genéricos descritos em Operações Comuns — este é o inventário do que pode ser administrado, não um manual por elemento.
| Domínio | Funções de rede |
|---|---|
| EPC | HSS, MME, SGW-C, PGW-C / SMF, UPF |
| Núcleo 5G | AMF, SMF, UDM, UDR, AUSF, PCF, NSSF, BSF, SCP, CHF, NRF |
| IMS | P-CSCF, I-CSCF, S-CSCF, TAS, ePDG, Direito (OmniSEP) |
| CS Core & SS7 | MSC, STP, HLR, Gateway CAMEL |
| Mensagens | SMSC, Gateway SMPP, IP-SM-GW, DRA |
| Localização | LCS (OmniLCS) |
| Cobrança & Acesso | OCS, TWAG, Monitor de RAN, Servidor de Licença |
| Exposição & IoT | SCEF (OmniSCEF) |
Adicionar outra instância de qualquer um desses é apenas uma mudança de configuração — veja o modelo de configuração. A implantação e configuração do OmniWeb são gerenciadas via Ansible; não edite arquivos de configuração diretamente nos hosts. Quando várias instâncias do mesmo tipo estão presentes, o OmniWeb fornece um menu suspenso por instância e uma visão de frota para status agregado — veja Visões de Múltiplas Instâncias & Frota.
O Que Você Pode Fazer Com o OmniWeb
Cada tarefa abaixo utiliza a mesma mecânica genérica, documentada em Operações Comuns.
| Objetivo | Onde no OmniWeb | Como funciona |
|---|---|---|
| Obter uma visão geral da rede | Visões de topologia (EPC / IMS / CS Core / 5GC) | Topologia |
| Provisionar ou editar um assinante | Elemento → aba de dados → formulário de adicionar/editar | Editando & Mudando Configurações de NF |
| Adicionar ou mudar uma rota | Elemento → Roteamento → formulário de adicionar/editar | Editando & Mudando Configurações de NF |
| Limpar / liberar uma sessão ou chamada | Elemento → Sessões / Chamadas → ação | Executando Ações |
| Ler configuração (segredos mascarados) | Elemento → Configuração | Visualizando Configuração |
| Assistir logs ao vivo para um elemento | Elemento → Logs | Logs & Rastreio |
| Seguir um assinante pela rede | Rastreio de Sessão → pesquisar IMSI/MSISDN | Logs & Rastreio |
| Analisar um fluxo de chamada SIP/VoIP em detalhe | Homer / Captura SIP (barra lateral, auto-detectado) | Homer |
| Verificar a qualidade de voz (MOS) de uma chamada ou ouvi-la | Rastreio de Sessão → Rastreio de Chamadas → abrir uma chamada | Rastreio de Chamadas |
| Inspecionar uma função de rede 5GC | Núcleo 5G → painel NF | Núcleo 5G |
| Testar carga do núcleo (Diameter / SIP) | Teste de Rede | Teste de Rede |
| Navegar ou editar o sistema de arquivos de um cartão / enviar APDUs brutos | SIMs → Sistema de Arquivos SIM / Terminal APDU | Ferramentas de Cartão SIM |
| Navegar pelos menus STK em um applet SIM | SIMs → Kit de Ferramentas SIM | Kit de Ferramentas SIM |
| Gerenciar perfis eSIM em um eUICC | SIMs → eSIM (LPA) | Ferramentas de Cartão SIM |
| Ler a configuração bruta de um site | Editor de Sites | Editor de Sites |
| Ver painéis e estatísticas | Elemento → Painéis, ou barra lateral do Grafana | Grafana |
| Gerenciar versões de software | Software | Gerenciamento de Software |
| Testar um telefone real em um local remoto | Dispositivos de Teste → frota / console | Dispositivos de Teste |
| Executar um livro de testes de roaming da GSMA | Testes de Roaming → Livros de Teste | OmniRoam |
| Ler ou editar os arquivos de um SIM via aérea | SIMs → OTA | Gerenciamento de SIM OTA |
| Gerenciar usuários e permissões | Configurações → Permissões | Autenticação |
Polling em Tempo Real (aplica-se em todos os lugares)
Todas as páginas operacionais atualizam automaticamente em um intervalo configurável. Um Indicador de Polling no cabeçalho de cada página mostra:
- Se o polling está ativo (ponto verde) ou pausado.
- O intervalo de polling (tipicamente 5 segundos; configurável por elemento via
pollIntervalMs). - Se uma busca está atualmente em progresso (spinner).
- O timestamp da última atualização bem-sucedida.
O polling pode ser ativado ou desativado por página. Algumas páginas — consoles interativos e ferramentas de diagnóstico — não fazem polling automaticamente e requerem uma atualização manual. O comportamento do polling é documentado uma vez em Operações Comuns.