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 que ofrece monitoreo en tiempo real, configuración, rastreo de protocolos, análisis de registros, tableros 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, facturación 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 toda la red 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, provisionar 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 rastrear un solo suscriptor a través de toda la red (Diameter, GTP-C, PFCP, SIP, MAP).
- Abrir tableros y estadísticas de Grafana incrustados en línea, sin salir del portal.
- Gestionar versiones de software y ciclo de vida a través de 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 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 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. Vea Registros y Rastreo de Suscriptores.
Mapa de Documentación
Comience Aquí
- Arquitectura — Cómo funciona OmniWeb: la SPA, el proxy de 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 funcionan la consulta, la visualización de configuraciones y el RBAC. Lea esto una vez y se aplica en todas partes.
Observabilidad y Solución de Problemas
- Tableros y Estadísticas de Grafana — Tableros incrustados, estadísticas de elementos y alertas.
- Registros y Rastreo de Suscriptores — Registros estructurados en tiempo real de Loki, Rastreo de Sesiones a través de la red (seguir 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: busque SIP capturado y reconstruya la escalera de señalización de una llamada; cómo se diferencia del Rastreo de Sesiones.
- Rastreo de Llamadas (Rastreo SIP) - Busque llamadas grabadas, abra un detalle completo de la llamada con calidad de voz por pierna (MOS) y jitter, siga la escalera SIP de múltiples saltos a través del IMS, vea el gráfico de QoS, escuche el audio grabado, descargue el PCAP y observe llamadas en vivo y la salud del agente de captura. Impulsado por agentes de captura de paquetes integrados en los elementos IMS.
- Topología de Red — Las vistas de topología de un solo panel y la Lista de Hosts de infraestructura.
- Archivo de Configuración - Copias de seguridad de configuración de dispositivos: los enrutadores envían su propia exportación a OmniWeb a través de FTP, y el archivo mantiene cada versión buscable, ordenable y diferenciable.
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 — Establezca 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 señalización sintética en un núcleo en vivo con el Simulador RAN: adjuntos, sesiones de datos y registros IMS, ejecutados bajo demanda o en un horario con resultados exportados a Prometheus.
- Núcleo 5G — Tableros 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 de IP de SMF y acciones de limpieza de estado.
- Editor de Sitios — Lea el archivo de configuración crudo 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 un 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 alcanzan cualquier lector en cualquier agente: el Explorador de Sistema de Archivos SIM (navegar/editar/decodificar EFs), el Terminal APDU (enviar APDUs en crudo, de un solo disparo o sesión con estado), el Registro APDU (traza en vivo modem↔SIM) y gestión de perfiles eSIM (eUICC).
- Kit de Herramientas SIM (STK) — Cliente interactivo de applet STK. Navegue por los menús del operador, active servicios residentes en SIM y ejecute comandos proactivos en cualquier tarjeta en un lector conectado.
- 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 fan-out.
- Autenticación y Control de Acceso — Visión general del modelo de control de acceso, vinculándose a:
- Inicio de Sesión y Sesiones JWT — flujo de inicio de sesión, duración del token, un inicio de sesión abarca toda la pila.
- Control de Acceso Basado en Roles — permisos y aplicación por elemento y por método.
- Inicio de Sesión con Clave SSH — acceso SSH central al host, claves servidas en vivo desde OmniWeb.
- Registro de Auditoría — auditoría de portal, inicio de sesión SSH y comandos.
Arquitectura a Simple Vista
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 alcanzan 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 del mismo conjunto de 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) |
| Facturación y Acceso | OCS, TWAG, Monitor RAN, Servidor de Licencias |
| Exposición e IoT | SCEF (OmniSCEF) |
Agregar otra instancia de cualquiera de estos es un cambio de configuración únicamente — 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 presentes, 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 |
| Provisionar 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 | Viendo Configuración |
| Observar registros en vivo para un elemento | Elemento → Registros | Registros y Rastreo |
| Seguir a un suscriptor a través de la red | Rastreo de Sesiones → buscar IMSI/MSISDN | Registros y Rastreo |
| Analizar un flujo de llamada SIP/VoIP en detalle | Homer / Captura SIP (barra lateral, auto-detectado) | Homer |
| Comprobar la calidad de voz de una llamada (MOS) o escucharla | Rastreo de Sesiones → Rastreo de Llamadas → abrir una llamada | Rastreo de Llamadas |
| Inspeccionar una función de red 5GC | Núcleo 5G → tablero 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 crudo | SIMs → Sistema de Archivos SIM / Terminal APDU | Herramientas de Tarjeta SIM |
| Navegar por los menús STK en un applet SIM | SIMs → Kit de Herramientas SIM | Kit de Herramientas SIM |
| Gestionar perfiles eSIM en un eUICC | SIMs → eSIM (LPA) | Herramientas de Tarjeta SIM |
| Leer la configuración cruda de un sitio | Editor de Sitios | Editor de Sitios |
| Ver tableros y estadísticas | Elemento → Tableros, 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 pausada.
- 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.