Guía de Operaciones de OmniWeb
OmniWeb es el portal de gestión unificado y basado en web de Omnitouch para toda una red central móvil. Es un único panel de control que ofrece monitoreo en tiempo real, configuración, seguimiento de protocolos, análisis de registros, paneles de control y gestión del ciclo de vida del software para cada función de red (NF) en una sola interfaz: EPC, IMS, CS Core, 5G Core, SS7, mensajería, carga y la infraestructura de soporte que las ejecuta.
En lugar de iniciar sesión en una docena de CLIs de elementos, Grafana, Loki y Homer por separado, un operador abre OmniWeb y puede:
- Ver la red completa de un vistazo a través de mapas de topología interactivos y salud por elemento.
- Ver, editar y cambiar configuraciones de NF — agregar una ruta en el SMSC, aprovisionar un suscriptor en el HSS, limpiar una sesión en el UPF — a través de una interfaz de usuario consistente.
- Observar registros estructurados en tiempo real para cualquier elemento y seguir a un solo suscriptor a través de toda la red (Diameter, GTP-C, PFCP, SIP, MAP).
- Abrir paneles de control y estadísticas de Grafana incrustados en línea, sin salir del portal.
- Gestionar versiones de software y ciclo de vida en toda la flota.
Cada función de red se opera a través del mismo conjunto de patrones. Esta guía documenta esos patrones genéricos una vez: se aplican a cada NF.
Vista de topología de OmniWeb — el único panel de control a través de EPC, IMS, CS Core y 5G Core. Los elementos activos son clicables y llevan directamente a sus páginas de gestión.
Debido a que OmniWeb consume la telemetría de señalización de la propia red, puede reconstruir el flujo de llamada de un solo suscriptor en vivo — sin necesidad de capturar paquetes para subir — y dibujarlo como una escalera ordenada por tiempo a través de cada elemento que lo tocó:
Flujos de Sesión en Vivo — el adjunto LTE de un suscriptor reconstruido directamente de la telemetría de señalización de la red, correlacionando S1AP, Diameter S6a y GTP-C a través del eNodeB, MME, HSS, SGW-C y PGW-C en una escalera. Haga clic en cualquier mensaje para su decodificación y hex. Ver Registros y Seguimiento de Suscriptores.
Mapa de Documentación
Comience Aquí
- Arquitectura — Cómo funciona OmniWeb: la SPA, el proxy backend, el modelo de configuración y cómo se comunica con cada NF, Loki y Grafana.
- Operaciones Comunes — Los patrones compartidos por cada elemento: cómo ver, editar y cambiar configuraciones de NF; cómo leer registros; cómo se comportan la consulta, la visualización de configuraciones y RBAC. Lea esto una vez y se aplica en todas partes.
Observabilidad y Solución de Problemas
- Paneles de Grafana y Estadísticas — Paneles incrustados, estadísticas de elementos y alertas.
- Registros y Seguimiento de Suscriptores — Registros estructurados en tiempo real de Loki, Seguimiento de Sesiones a través de la red (seguir a un suscriptor de extremo a extremo) y captura SIP de Homer.
- Homer — Captura SIP — La interfaz de usuario de captura SIP de Homer incrustada y auto-autenticada: buscar SIP capturado y reconstruir la escalera de señalización de una llamada; cómo se diferencia del Seguimiento de Sesiones.
- Topología de Red — Las vistas de topología de un solo panel y la Lista de Hosts de infraestructura.
Plataforma
- Referencia de API (OpenAPI / Swagger) — Navegue y pruebe la API REST del controlador en
/api/docs; la especificación OpenAPI se encuentra en/api/openapi.json. - Gestión de Software — Versionado, repositorio APT y ciclo de vida del software.
- Dispositivos de Prueba — Controle de forma remota teléfonos conectados por ADB en sitios remotos; realice llamadas, envíe mensajes de texto y ejecute pruebas programadas de VoLTE / señal / conectividad exportadas a Prometheus.
- Simulador RAN — Configure eNodeBs y UEs virtuales para ejercitar un núcleo en vivo sin hardware: adjuntos, sesiones de datos, registro IMS con ubicaci��n de celda, SMS/llamadas, escenarios de interrupción y pruebas de carga — controlables desde Dispositivos de Prueba.
- Pruebas de Red (Prueba de Carga) — Impulse carga de Diameter (Seagull) y SIP/IMS (SIPp) en el núcleo desde generadores de auto-registro: establezca una tasa, aumente, pause/drene/pare por generador o en toda la piscina, con medidores de CPU en vivo.
- Núcleo 5G — Paneles de control por NF para el plano de control 5GC (NRF, AMF, SMF, UDM/UDR, AUSF, PCF, CHF, NSSF, BSF, SCP): salud, registros, contextos de UE, sesiones PDU, grupos IP de SMF y acciones de limpieza de estado.
- Editor de Sitios — Lea el archivo de configuración en bruto por sitio (elementos, hosts,
fivegc, monitoreo) en un visor con resaltado de sintaxis; la fuente de verdad de la que OmniWeb deriva cada sitio. - OmniRoam — Automatización de Pruebas de Roaming — Ejecute automáticamente los libros de pruebas de roaming de GSMA (IR.38, IR.48, VoLTE) contra una red en vivo, capture aprobaciones/rechazos con evidencia, programe ejecuciones rutinarias y exporte el libro de trabajo de GSMA completado. Enlaces a Libros de Pruebas, Ejecución de Pruebas, el Explorador de Libros de Pruebas y Documentos Completados.
- OmniRoam — Acuerdos de Roaming y Automatización de Correo Electrónico — El lado comercial/provisionamiento de OmniRoam: reenvíe un correo electrónico de socio y OmniRoam extrae los hechos, crea o actualiza el acuerdo, genera y firma electrónicamente la documentación AA.12/AA.13/CLL/TCC/TNS, la archiva y genera órdenes de trabajo con notificaciones por webhook + correo electrónico al asignado.
- Banco de SIM — Inventario distribuido de cada SIM en cada lector a través de todos los agentes — centrado en el lector, con presencia de tarjeta, identidad y herramientas de sistema de archivos/APDU por ranura.
- Herramientas de Tarjeta SIM — Herramientas de bajo nivel por tarjeta que acceden a través de cualquier lector en cualquier agente: el Explorador de Sistema de Archivos SIM (navegar/editar/decodificar EFs), el Terminal APDU (enviar APDUs en bruto, de una sola vez o sesión con estado), el Registro APDU (traza en vivo de módem↔SIM) y gestión de perfiles eSIM (eUICC).
- SIM Remota y SIM Virtual — Presente cualquier SIM a cualquier módem a través de la red mediante emuladores de tarjetas, y emule una SIM virtual (imagen guardada + claves HSS) para que un módem se adjunte como un suscriptor para el cual no tiene tarjeta física.
- Gestión de SIM OTA — Lea y edite los archivos de una SIM remota por aire con paquetes RFM/RAM asegurados (03.48 / SCP80) — un lector en el host, un agente remoto, o SMPP a una SIM de campo — además de perfiles de seguridad reutilizables y campañas de difusión.
- Autenticación y Control de Acceso — Descripción general del modelo de control de acceso, vinculando a:
- Inicio de Sesión y Sesiones JWT — flujo de inicio de sesión, duración del token, inicio de sesión único abarcando la pila.
- Control de Acceso Basado en Roles — permisos y aplicación por elemento y método.
- Inicio de Sesión con Clave SSH — acceso SSH al host central, claves servidas en vivo desde OmniWeb.
- Registro de Auditoría — auditoría de portal, inicio de sesión SSH y comandos.
Arquitectura a Gran Escala
Cada solicitud desde el navegador lleva un JWT. El backend lo verifica, comprueba los permisos basados en roles para el elemento objetivo y el método HTTP, y luego reenvía (proxy) la llamada a la propia API de gestión del elemento. Grafana, Loki y Homer se acceden a través de la misma puerta de enlace autenticada, por lo que un solo inicio de sesión en OmniWeb rige toda la pila. Vea Arquitectura para el desglose completo.
Funciones de Red Soportadas
OmniWeb administra cada función en el núcleo de Omnitouch. Todas se gestionan a través de los mismos patrones genéricos descritos en Operaciones Comunes — este es el inventario de lo que se puede administrar, no un manual por elemento.
| Dominio | Funciones de red |
|---|---|
| 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, Derecho (OmniSEP) |
| CS Core & SS7 | MSC, STP, HLR, Puerta de enlace CAMEL |
| Mensajería | SMSC, Puerta de enlace SMPP, IP-SM-GW, DRA |
| Ubicación | LCS (OmniLCS) |
| Carga y Acceso | OCS, TWAG, Monitor RAN, Servidor de Licencias |
| Exposición e IoT | SCEF (OmniSCEF) |
Agregar otra instancia de cualquiera de estos es solo un cambio de configuración — vea el modelo de configuración. El despliegue y la configuración de OmniWeb se gestionan a través de Ansible; no edite los archivos de configuración directamente en los hosts. Cuando hay múltiples instancias del mismo tipo, OmniWeb proporciona un menú desplegable por instancia y una vista de flota para el estado agregado — vea Vistas de Múltiples Instancias y Flota.
Lo Que Puede Hacer Con OmniWeb
Cada tarea a continuación utiliza la misma mecánica genérica, documentada en Operaciones Comunes.
| Objetivo | Dónde en OmniWeb | Cómo funciona |
|---|---|---|
| Obtener una visión general de la red | Vistas de topología (EPC / IMS / CS Core / 5GC) | Topología |
| Aprovisionar o editar un suscriptor | Elemento → pestaña de datos → formulario de agregar/editar | Editando y Cambiando Configuraciones de NF |
| Agregar o cambiar una ruta | Elemento → Enrutamiento → formulario de agregar/editar | Editando y Cambiando Configuraciones de NF |
| Limpiar / liberar una sesión o llamada | Elemento → Sesiones / Llamadas → acción | Ejecutando Acciones |
| Leer configuración (secretos enmascarados) | Elemento → Configuración | Visualizando Configuración |
| Observar registros en vivo para un elemento | Elemento → Registros | Registros y Seguimiento |
| Seguir a un suscriptor a través de la red | Seguimiento de Sesiones → buscar IMSI/MSISDN | Registros y Seguimiento |
| Analizar un flujo de llamada SIP/VoIP en detalle | Homer / Captura SIP (barra lateral, auto-detectado) | Homer |
| Inspeccionar una función de red 5GC | Núcleo 5G → panel de control de NF | Núcleo 5G |
| Realizar pruebas de carga en el núcleo (Diameter / SIP) | Pruebas de Red | Pruebas de Red |
| Navegar o editar el sistema de archivos de una tarjeta / enviar APDUs en bruto | SIMs → Sistema de Archivos SIM / Terminal APDU | Herramientas de Tarjeta SIM |
| Gestionar perfiles eSIM en un eUICC | SIMs → eSIM (LPA) | Herramientas de Tarjeta SIM |
| Leer la configuración en bruto de un sitio | Editor de Sitios | Editor de Sitios |
| Ver paneles de control y estadísticas | Elemento → Paneles de Control, o barra lateral de Grafana | Grafana |
| Gestionar versiones de software | Software | Gestión de Software |
| Probar un teléfono real en un sitio remoto | Dispositivos de Prueba → flota / consola | Dispositivos de Prueba |
| Ejecutar un libro de pruebas de roaming de GSMA | Pruebas de Roaming → Libros de Pruebas | OmniRoam |
| Leer o editar los archivos de una SIM por aire | SIMs → OTA | Gestión de SIM OTA |
| Gestionar usuarios y permisos | Configuración → Permisos | Autenticación |
Consulta en Tiempo Real (aplica en todas partes)
Todas las páginas operativas se actualizan automáticamente en un intervalo configurable. Un Indicador de Consulta en el encabezado de cada página muestra:
- Si la consulta está activa (punto verde) o en pausa.
- El intervalo de consulta (típicamente 5 segundos; configurable por elemento a través de
pollIntervalMs). - Si una recuperación está actualmente en progreso (spinner).
- La marca de tiempo de la última actualización exitosa.
La consulta se puede activar o desactivar por página. Algunas páginas — consolas interactivas y herramientas de diagnóstico — no consultan automáticamente y requieren una actualización manual. El comportamiento de consulta se documenta una vez en Operaciones Comunes.