Guía de Operaciones de OmniSGW

OmniSGW - Gateway de Servicio (SGW)

por Omnitouch Network Services

---

Tabla de Contenidos

1. Descripción General
2. Arquitectura
3. Interfaces de Red
4. Conceptos Clave
5. Comenzando
6. Configuración
7. Interfaz Web - Panel de Operaciones en Tiempo Real
8. Monitoreo y Métricas
9. Documentación Detallada
10. Recursos Adicionales
11. Contribuciones
12. Soporte

---

Descripción General

OmniSGW es una implementación de Gateway de Servicio (SGW) de alto rendimiento para redes 3GPP LTE Evolved Packet Core (EPC), desarrollada por Omnitouch Network Services. Gestiona las funciones para la movilidad del UE y la gestión de portadoras, incluyendo:

• Gestión de Sesiones - Creación, modificación y terminación de sesiones de datos del UE (Equipo de Usuario)
• Coordinación de Movilidad - Manejo de traspasos entre eNodeBs con reenvío de datos
• Gestión de Portadoras - Creación y modificación de portadoras dedicadas para diferentes requisitos de QoS
• Información de Carga - Seguimiento de eventos de sesión para carga fuera de línea
• Coordinación del Plano de Usuario - Control del SGW-U (Plano de Usuario) para el reenvío de paquetes

Qué Hace SGW-C

• Acepta solicitudes de sesión del MME a través de la interfaz S11 (GTP-C)
• Coordina con PGW-C para conectividad PDN a través de la interfaz S5/S8 (GTP-C)
• Gestiona el ciclo de vida de las portadoras incluyendo creación, modificación y eliminación
• Programa reglas de reenvío en SGW-U a través de la interfaz Sxa (PFCP)
• Maneja la movilidad del UE gestionando los traspasos entre eNodeBs
• Proporciona paginación de datos en bajada para sesiones suspendidas
• Rastrea información de carga para sistemas de facturación fuera de línea

---

Arquitectura

Descripción General de Componentes

Arquitectura de Procesos

SGW-C está construido sobre Elixir/OTP y utiliza una arquitectura de procesos supervisados:

• Supervisor de Aplicación - Supervisor de nivel superior que gestiona todos los componentes
• Intermediarios de Protocolo - Manejan mensajes de protocolo entrantes/salientes (S11, S5/S8, Sxa)
• Procesos de Sesión - Un GenServer por sesión activa del UE
• Registros - Rastrean recursos asignados (TEIDs, SEIDs, IDs de Carga, etc.)
• Gestor de Nodo PFCP - Mantiene asociaciones PFCP con pares SGW-U

Cada componente está supervisado y se reiniciará automáticamente en caso de fallo, asegurando la fiabilidad del sistema.

Las métricas de salud del sistema en tiempo real se pueden monitorear a través de la página de la Aplicación de la Interfaz Web:

---

Interfaces de Red

SGW-C implementa tres interfaces primarias de 3GPP:

Interfaz S11 (GTP-C v2)

Propósito: Señalización del plano de control entre MME y SGW-C

Protocolo: GTP-C Versión 2 sobre UDP

Mensajes Clave:

• Solicitud/Respuesta de Creación de Sesión
• Solicitud/Respuesta de Eliminación de Sesión
• Solicitud/Respuesta de Modificación de Portadora
• Solicitud/Respuesta de Creación de Portadora
• Solicitud/Respuesta de Eliminación de Portadora
• Notificación/Aceptación de Datos en Bajada

Configuración: Ver Documentación de la Interfaz S11

Interfaz Sxa (PFCP)

Propósito: Señalización del plano de control entre SGW-C y SGW-U

Protocolo: PFCP (Protocolo de Control de Reenvío de Paquetes) sobre UDP

Mensajes Clave:

• Solicitud/Respuesta de Configuración de Asociación
• Solicitud/Respuesta de Establecimiento de Sesión
• Solicitud/Respuesta de Modificación de Sesión
• Solicitud/Respuesta de Eliminación de Sesión
• Solicitud/Respuesta de Informe de Sesión
• Solicitud/Respuesta de Latido

Configuración: Ver Documentación de la Interfaz PFCP/Sxa

Interfaz S5/S8 (GTP-C v2)

Propósito: Señalización del plano de control entre SGW-C y PGW-C para conectividad PDN

Protocolo: GTP-C Versión 2 sobre UDP

Mensajes Clave:

• Solicitud/Respuesta de Creación de Sesión
• Solicitud/Respuesta de Eliminación de Sesión
• Solicitud/Respuesta de Modificación de Portadora
• Solicitud/Respuesta de Creación de Portadora
• Solicitud/Respuesta de Eliminación de Portadora

Configuración: Ver Documentación de la Interfaz S5/S8

---

Conceptos Clave

Sesión del UE

Una Sesión del UE representa un dispositivo móvil activo conectado a la red. Cada sesión gestiona:

• IMSI (Identidad Internacional del Suscriptor Móvil) - Identificador único del suscriptor
• GUTI (Identificador Temporal Global Único) - Identificador temporal del UE del MME
• MSISDN - Número de teléfono móvil
• TAI (Identificador del Área de Seguimiento) - Área de localización actual
• TEIDs de Sesión - Identificadores de punto final de túnel para S11 y S5/S8
• Portadoras Activas - Lista de portadoras de datos asociadas

Conexión PDN

Una Conexión PDN (Red de Datos de Paquetes) representa la conexión de datos de un UE a través de un PGW-C específico. Cada sesión tiene:

• APN (Nombre del Punto de Acceso) - Identifica la red externa
• ID de Carga - Identificador único para la facturación entre SGW y PGW
• TEID (ID de Punto Final de Túnel) - Identificador de túnel de la interfaz S5/S8
• SEID (ID de Punto Final de Sesión) - Identificador de sesión de la interfaz Sxa
• Portadora Predeterminada - Creada con cada conexión PDN
• Portadoras Dedicadas - Portadoras adicionales para necesidades específicas de QoS

Contexto de Portadora

Una portadora representa un flujo de tráfico con características específicas de QoS:

• Portadora Predeterminada - Creada con cada conexión PDN para tráfico de mejor esfuerzo
• Portadoras Dedicadas - Portadoras adicionales para requisitos de servicio específicos (voz, video, etc.)
• EBI (ID de Portadora EPS) - Identificador único para cada portadora dentro de una sesión
• Parámetros de QoS - QCI (Identificador de Clase de QoS), ARP (Prioridad de Asignación y Retención), tasas de bits (MBR, GBR)

Reglas de PFCP

El SGW-C programa el SGW-U con reglas de procesamiento de paquetes:

• PDR (Regla de Detección de Paquetes) - Coincide paquetes (uplink/downlink)
• FAR (Regla de Acción de Reenvío) - Especifica el comportamiento de reenvío
• QER (Regla de Aplicación de QoS) - Aplica límites de tasa de bits
• BAR (Regla de Acción de Buffering) - Controla el almacenamiento en búfer de paquetes durante los traspasos

Ver Documentación de la Interfaz Sxa para más detalles.

Movilidad y Traspaso

SGW-C soporta la movilidad del UE a través de eNodeBs:

• Traspaso Intra-MME - Traspaso dentro del mismo MME (sin cambio de SGW)
• Traspaso Inter-MME - Traspaso entre MMEs con reubicación de SGW
• Reenvío de Datos - Almacenamiento en búfer y reenvío de datos durante el traspaso
• Actualización del Área de Seguimiento - Re-registro del UE al moverse entre áreas

---

Comenzando

Requisitos Previos

• Elixir ~1.16
• Erlang/OTP 26+
• Conectividad de red a MME, SGW-U y PGW-C
• Comprensión de la arquitectura LTE EPC

Verificando la Operación

Verifique los registros para el inicio exitoso:

[info] Iniciando OmniSGW...
[info] Iniciando Exportador de Métricas en 127.0.0.40:42068
[info] Iniciando Intermediario S11 en 127.0.0.10
[info] Iniciando Intermediario S5/S8 en 127.0.0.15
[info] Iniciando Intermediario Sxa en 127.0.0.20
[info] Iniciando Gestor de Nodo PFCP
[info] OmniSGW iniciado exitosamente

Acceda a las métricas en http://127.0.0.40:42068/metrics (dirección configurada).

---

Configuración

Toda la configuración en tiempo de ejecución se define en config/runtime.exs. La configuración está estructurada en varias secciones:

Descripción General de la Configuración

Referencia Rápida de Configuración

Sección	Propósito	Documentación
metrics	Exportador de métricas de Prometheus	Guía de Monitoreo
s11	Interfaz GTP-C al MME	Configuración S11
s5s8	Interfaz GTP-C al PGW-C	Configuración S5/S8
sxa	Interfaz PFCP al SGW-U	Configuración Sxa

Vea la Guía de Configuración Completa para información detallada.

---

Interfaz Web - Panel de Operaciones en Tiempo Real

OmniSGW incluye una Interfaz Web integrada para monitoreo y operaciones en tiempo real, proporcionando visibilidad instantánea del estado del sistema sin necesidad de herramientas de línea de comandos o consultas de métricas.

Accediendo a la Interfaz Web

http://<omnisgw-ip>:<web-port>/

Páginas Disponibles:

Página	URL	Propósito	Tasa de Actualización
Sesiones UE	/ue_sessions	Ver todas las sesiones y portadoras activas del UE	2 segundos
Sesiones PFCP	/pfcp_sessions	Ver sesiones PFCP con SGW-U	2 segundos
Estado SGW-U	/sgwu_status	Monitorear asociaciones de pares PFCP	2 segundos
Registros	/logs	Transmisión de registros en tiempo real	En Vivo

Características Clave

Actualizaciones en Tiempo Real:

• Todas las páginas se actualizan automáticamente (sin necesidad de recarga manual)
• Transmisión de datos en vivo desde los procesos de OmniSGW
• Indicadores de estado codificados por colores (verde/rojo)

Buscar y Filtrar:

• Buscar sesiones por IMSI, GUTI, número de teléfono
• Filtrado instantáneo sin recarga de página

Detalles Expandibles:

• Haga clic en cualquier fila para ver detalles completos de la sesión
• Inspeccionar todas las portadoras activas y parámetros de QoS
• Ver configuración y capacidades de pares

Sin Autenticación Requerida (Uso Interno):

• Acceso directo desde la red de gestión
• Diseñado para el uso del equipo de NOC/operaciones
• Vincular solo a la IP de gestión por seguridad

Flujos de Trabajo Operativos

Solución de Problemas de Sesiones:

1. El usuario informa un problema de conectividad
2. Abra la página de Sesiones UE
3. Busque por IMSI o número de teléfono
4. Verifique que la sesión exista y tenga correcto:
   - Área de Seguimiento
   - Portadoras activas y su QoS
   - Puntos finales de túnel establecidos
   - Asociación PGW-C correcta
5. Si no se encuentra la sesión → Verifique los registros para la razón de rechazo

Verificación de Salud del Sistema:

1. Abra la página de Estado SGW-U → Verifique que todos los pares SGW-U estén "Asociados"
2. Abra Sesiones UE → Verifique el conteo de sesiones activas vs. capacidad
3. Monitoree la distribución de portadoras a través de APNs

Monitoreo de Capacidad:

• Mire el conteo de Sesiones UE
• Compare con la capacidad licenciada/esperada
• Identifique los tiempos de uso máximo
• Monitoree la distribución por tipo de servicio

Interfaz Web vs. Métricas

Use la Interfaz Web para:

• Detalles de sesión y portadora individuales
• Estado de pares en tiempo real
• Verificaciones rápidas de salud
• Solución de problemas de usuarios específicos
• Verificación de configuración

Use Métricas de Prometheus para:

• Tendencias históricas
• Alertas y notificaciones
• Gráficos de planificación de capacidad
• Análisis de rendimiento
• Monitoreo a largo plazo

Mejor Práctica: Use ambos juntos - Interfaz Web para operaciones inmediatas, Prometheus para tendencias y alertas.

---

Monitoreo y Métricas

Además de la Interfaz Web, OmniSGW expone métricas compatibles con Prometheus para monitoreo:

Métricas Disponibles

• Métricas de Sesión

  • teid_registry_count - TEIDs S11/S5S8 activos
  • seid_registry_count - Sesiones PFCP activas
  • charging_id_registry_count - IDs de carga activos
  • active_ue_sessions - Total de sesiones activas del UE
  • active_bearers - Total de portadoras activas en todas las sesiones

• Métricas de Mensajes

  • s11_inbound_messages_total - Mensajes GTP-C recibidos en S11
  • s5s8_inbound_messages_total - Mensajes GTP-C recibidos en S5/S8
  • sxa_inbound_messages_total - Mensajes PFCP recibidos
  • Distribuciones de duración de manejo de mensajes

• Métricas de Error

  • s11_inbound_errors_total - Errores de protocolo S11
  • s5s8_inbound_errors_total - Errores de protocolo S5/S8
  • sxa_inbound_errors_total - Errores de protocolo Sxa

Accediendo a Métricas

Las métricas se exponen a través de HTTP en el punto final configurado:

curl http://127.0.0.40:42068/metrics

Vea la Guía de Monitoreo y Métricas para la configuración del panel y alertas.

---

Documentación Detallada

Esta sección proporciona una visión general completa de toda la documentación de OmniSGW. Los documentos están organizados por tema y caso de uso.

Estructura de Documentación

Documentación de OmniSGW
├── OPERATIONS.md (Esta Guía)
│
└── docs/
    ├── Configuración y Configuración
    │   ├── configuration.md          Referencia completa de runtime.exs
    │
    ├── Interfaces de Red
    │   ├── sxa-interface.md          Sxa/PFCP (comunicación SGW-U)
    │   ├── s11-interface.md          S11 (comunicación MME)
    │   └── s5s8-interface.md         S5/S8 (comunicación PGW-C)
    │
    └── Operaciones
        ├── session-management.md     Ciclo de vida de la sesión UE
        ├── bearer-management.md      Operaciones de portadora
        ├── cdr-format.md             Formatos de registros de carga fuera de línea
        └── monitoring.md             Métricas de Prometheus y alertas

Documentación por Tema

🚀 Comenzando

Documento	Descripción	Propósito
OPERATIONS.md	Guía principal de operaciones (este documento)	Visión general y comienzo rápido

⚙️ Configuración

Documento	Descripción
configuration.md	Referencia completa de configuración runtime.exs

🔌 Interfaces de Red

Documento	Descripción
sxa-interface.md	Interfaz PFCP/Sxa al SGW-U
s11-interface.md	Interfaz GTP-C S11 al MME
s5s8-interface.md	Interfaz GTP-C S5/S8 al PGW-C

📊 Operaciones y Monitoreo

Documento	Descripción
session-management.md	Ciclo de vida y operaciones de sesión UE
bearer-management.md	Creación, modificación, eliminación de portadoras
cdr-format.md	Formato de datos de carga fuera de línea
monitoring.md	Métricas de Prometheus, paneles de Grafana, alertas

Rutas de Lectura

Para Operadores de Red

1. OPERATIONS.md - Visión general (este documento)
2. configuration.md - Configuración
3. monitoring.md - Monitoreo
4. session-management.md - Operaciones diarias

Para Ingenieros de Red

1. OPERATIONS.md - Visión general de la arquitectura (este documento)
2. sxa-interface.md - Control del plano de usuario
3. s11-interface.md - Gestión móvil
4. s5s8-interface.md - Conectividad PDN
5. session-management.md - Ciclo de vida de la sesión
6. bearer-management.md - Operaciones de portadora

Para Configuración y Despliegue

1. configuration.md - Referencia completa
2. monitoring.md - Configurar monitoreo

---

Recursos Adicionales

Especificaciones 3GPP

Especificación	Título
TS 29.274	GTP-C v2 (interfaces S11 y S5/S8)
TS 29.244	PFCP (interfaz Sxa)
TS 32.251	Carga del dominio de Paquetes
TS 32.298	Codificación de CDR
TS 23.401	Arquitectura EPC