Saltar al contenido principal

HLR Lookup y Simulador de Llamadas - Guía del Usuario

Resumen​

Se han añadido dos nuevas herramientas de diagnóstico para ayudar al personal de operaciones a resolver problemas de enrutamiento de llamadas sin afectar el tráfico en vivo.

Herramienta HLR Lookup​

Propósito​

La herramienta HLR Lookup consulta el Registro de Ubicación del Hogar (HLR) a través del protocolo SS7 MAP para recuperar información de enrutamiento de suscriptores en tiempo real.

Acceso​

Navega a /hlr o haz clic en "HLR" en el menú de navegación.

Lo Que Muestra​

Para cualquier número de teléfono, el HLR Lookup muestra:

  1. MSRN (Número de Roaming de Estación Móvil)

    • Número de enrutamiento temporal asignado cuando el suscriptor está en roaming en una red 2G/3G
    • Solo presente si el suscriptor está actualmente en roaming
    • Utilizado por el plan de marcado para enrutar llamadas a la ubicación actual del suscriptor en roaming

  2. Configuraciones de Desvío de Llamadas

    • Configuración de desvío de llamadas en tiempo real desde el HLR
    • Tipos: Incondicional, Ocupado, Sin Respuesta, No Alcanzable
    • Muestra el número de destino de desvío
    • Muestra si la notificación está habilitada

  3. Variables del Plan de Marcado

    • Exactamente qué variables de canal se establecerán
    • Las variables coinciden con las utilizadas en el procesamiento real de llamadas
    • Muestra cómo los datos del HLR anulan los datos de Sh

Casos de Uso​

Diagnóstico de Problemas de Roaming​

Escenario: La llamada entrante a un suscriptor en roaming falla o se enruta incorrectamente

Pasos:

  1. Abre la página de HLR Lookup
  2. Ingresa el número de teléfono del suscriptor
  3. Haz clic en "Buscar Datos HLR"
  4. Verifica si hay MSRN en los resultados
  5. Si MSRN está presente: El suscriptor está en roaming, verifica que el MSRN sea válido
  6. Si no hay MSRN: El suscriptor puede estar en LTE/VoLTE (no se necesita MSRN)

Verificación del Desvío de Llamadas​

Escenario: El desvío de llamadas no funciona como se esperaba

Pasos:

  1. Abre la página de HLR Lookup
  2. Ingresa el número de teléfono del suscriptor
  3. Haz clic en "Buscar Datos HLR"
  4. Busca "Desvío de Llamadas" en los resultados
  5. Verifica el tipo de desvío (Incondicional, Ocupado, etc.)
  6. Verifica el número de destino de desvío
  7. Nota: Los datos del HLR anulan cualquier dato de Sh/HSS

Prueba de Conectividad HLR​

Escenario: Verificar que la puerta de enlace SS7 MAP esté funcionando

Pasos:

  1. Abre la página de HLR Lookup
  2. Ingresa cualquier número de suscriptor conocido
  3. Haz clic en "Buscar Datos HLR"
  4. Verifica si hay "Error" en los resultados
  5. Si hay error: Verifica la conectividad de la puerta de enlace SS7 MAP
  6. Errores comunes:
    • "SS7 MAP está deshabilitado" - Verifica la configuración
    • "Tiempo de espera" - Problema de red hacia el HLR
    • "Sin Número VLR" - Suscriptor fuera de línea o no existe

Caja de Información​

La página de HLR Lookup incluye información educativa que explica:

  • Qué es MSRN y cuándo se utiliza
  • Cómo funciona el desvío de llamadas en el HLR
  • Cómo se integra esto con el procesamiento de llamadas
  • Conceptos básicos del protocolo SS7 MAP

Herramienta Simulador de Llamadas​

Propósito​

El Simulador de Llamadas te permite simular el enrutamiento completo de llamadas sin realmente realizar una llamada o afectar el tráfico en vivo.

Acceso​

Navega a /simulator o haz clic en "Simulador" en el menú de navegación.

Características​

Parámetros de Entrada​

  1. Número de Origen (Llamante)

    • Número de teléfono de la parte que llama
    • Para llamadas MT: Puede ser cualquier número
    • Para llamadas MO: Debe ser un suscriptor provisionado

  2. Número de Destino (Parte Llamada)

    • Número de teléfono de la parte llamada
    • Para llamadas MT: Debe ser un suscriptor provisionado
    • Para llamadas MO: Puede ser cualquier número
    • Para Emergencias: Usa "urn:service:sos" o similar

  3. Dirección IP de Origen

    • Dirección IP de la fuente de señalización SIP
    • Debe estar en allowed_sbc_source_ips (para MT) o allowed_cscf_ips (para MO)
    • Determina la disposición de la llamada (MT vs MO)

  4. Forzar Disposición

    • Auto: Determinar desde la dirección IP (comportamiento normal)
    • MT: Forzar Terminación Móvil (entrante)
    • MO: Forzar Origen Móvil (saliente)
    • Emergencia: Forzar el procesamiento de llamadas de emergencia

  5. Opciones

    • Omitir Autorización OCS: Pasar por alto la carga en línea (simulación más rápida)
    • Omitir Búsqueda HLR: Pasar por alto la consulta SS7 MAP (simulación más rápida)

Salida​

El simulador muestra resultados completos:

  1. Banner de Tipo de Llamada

    • MT, MO o Emergencia
    • Codificado por colores para identificación rápida
    • Muestra números de origen y destino

  2. Pasos de Procesamiento (Columna Izquierda)

    • Datos del Suscriptor: Resultados de la interfaz Sh (HSS)
    • Datos HLR: Resultados de la búsqueda SS7 MAP (solo MT)
    • Autorización OCS: Resultados de la carga en línea (solo MO)
    • Estado On-Net: Si el destino está en tu red (solo MO)

  3. Variables del Plan de Marcado (Columna Derecha)

    • Cada variable que se establecería en el canal
    • Ordenadas alfabéticamente para fácil lectura
    • Valores codificados por colores (verde para normal, rojo para errores)

  4. Notas de Procesamiento

    • Explicación paso a paso de lo que sucedió
    • Describe el flujo de datos y los puntos de decisión
    • Ayuda a entender por qué se establecieron ciertas variables

Casos de Uso​

Pruebas Pre-Despliegue​

Escenario: Probar un cambio de configuración antes de desplegar en producción

Pasos:

  1. Realiza el cambio de configuración en el entorno de desarrollo/prueba
  2. Abre el Simulador de Llamadas
  3. Prueba múltiples escenarios:
    • Llamada MT desde tu SBC
    • Llamada MO desde tu CSCF
    • Llamada de Emergencia
    • Destino en la red
    • Destino fuera de la red
  4. Verifica que todas las variables sean correctas
  5. Revisa las notas de procesamiento para cualquier problema
  6. Despliega en producción con confianza

Depuración de Problemas de Llamadas MT​

Escenario: Las llamadas entrantes al suscriptor están fallando

Pasos:

  1. Abre el Simulador de Llamadas
  2. Ingresa el destino como el suscriptor problemático
  3. Ingresa la fuente como número de prueba
  4. Establece la IP de origen a la IP de tu SBC
  5. Deja la Disposición Forzada como "Auto"
  6. Haz clic en "Simular Llamada"
  7. Verifica la sección de Datos del Suscriptor para el éxito de la búsqueda Sh
  8. Verifica la sección de Datos HLR para MSRN o desvío
  9. Verifica las Variables Finales para hangup_case
  10. Si hangup_case es "UNALLOCATED_NUMBER": Suscriptor no provisionado
  11. Si las variables parecen correctas: El problema puede estar en la plantilla del plan de marcado

Depuración de Problemas de Llamadas MO​

Escenario: Las llamadas salientes del suscriptor están fallando

Pasos:

  1. Abre el Simulador de Llamadas
  2. Ingresa la fuente como el suscriptor problemático
  3. Ingresa el destino como número de prueba
  4. Establece la IP de origen a la IP de tu CSCF
  5. Desmarca "Omitir Autorización OCS" si estás probando la carga
  6. Haz clic en "Simular Llamada"
  7. Verifica la sección de Datos del Llamante para el éxito de la búsqueda Sh
  8. Verifica la sección de Autorización OCS para éxito/fallo
  9. Verifica el Estado On-Net para confirmar el enrutamiento correcto
  10. Verifica las Variables Finales para allocated_time o hangup_case
  11. Si hangup_case es "OUTGOING_CALL_BARRED": OCS negó la llamada

Prueba de Manejo de Llamadas de Emergencia​

Escenario: Verificar que las llamadas de emergencia funcionen correctamente

Pasos:

  1. Abre el Simulador de Llamadas
  2. Ingresa la fuente como suscriptor de prueba
  3. Ingresa el destino como "urn:service:sos"
  4. Establece cualquier IP de origen (las llamadas de emergencia omiten la autenticación IP)
  5. Haz clic en "Simular Llamada"
  6. Verifica que el Tipo de Llamada muestre "Emergencia (SOS)"
  7. Verifica que hangup_case sea "none" (las llamadas de emergencia siempre proceden)
  8. Verifica que OCS y HLR fueron omitidos
  9. Verifica que se recuperaron los datos del llamante para la información de ubicación

Capacitación del Personal​

Escenario: Enseñar al personal de operaciones cómo funciona el enrutamiento de llamadas

Pasos:

  1. Abre el Simulador de Llamadas
  2. Ejecuta varios escenarios y explica cada sección:
    • Muestra la llamada MT y explica las búsquedas Sh + HLR
    • Muestra la llamada MO y explica la autorización OCS
    • Muestra la llamada de Emergencia y explica el comportamiento de omisión
    • Muestra IP no autorizada y explica el rechazo
  3. Haz que el personal pruebe diferentes combinaciones
  4. Usa las Notas de Procesamiento para explicar cada decisión
  5. Compara variables entre diferentes escenarios

Comparación de Datos Sh vs HLR​

Escenario: Entender cómo HLR anula los datos de Sh

Pasos:

  1. Abre el Simulador de Llamadas para una llamada MT
  2. Desmarca "Omitir Búsqueda HLR"
  3. Haz clic en "Simular Llamada"
  4. Compara las variables de Datos del Suscriptor con las variables de Datos HLR
  5. Verifica las Variables Finales para ver qué valores prevalecieron
  6. Nota: Los datos del HLR siempre tienen prioridad para:
    • MSRN
    • call_forward_all_destination
    • call_forward_not_reachable_destination

Consejos​

  • Usa "Omitir Autorización OCS" y "Omitir Búsqueda HLR" para simulaciones más rápidas al probar otros aspectos
  • Copia/pega números de teléfono de los registros en el simulador para pruebas rápidas
  • Usa "Forzar Disposición" para probar tipos de llamadas específicos independientemente de la IP
  • Revisa las Notas de Procesamiento si no estás seguro de por qué se establecieron ciertas variables
  • Ejecuta la simulación múltiples veces para verificar consistencia
  • Compara los resultados de la simulación con los registros de llamadas reales

Limitaciones​

El simulador:

  • NO realiza realmente llamadas
  • NO afecta el sistema de enrutamiento de llamadas
  • NO consume cuota de OCS (incluso si se consulta OCS)
  • NO genera CDRs
  • Es seguro usar en sistemas de producción

El simulador SÍ:

  • Consulta la interfaz Sh real (HSS) si no se omite
  • Consulta el HLR real a través de SS7 MAP si no se omite
  • Consulta OCS real si no se omite
  • Muestra exactamente lo que sucedería en una llamada real
  • Utiliza valores de configuración reales

Integración con Monitoreo​

Ambas herramientas se integran con métricas de Prometheus:

  • Las búsquedas HLR a través de la herramienta se cuentan en hlr_lookups_total
  • Las simulaciones de llamadas se cuentan en call_simulations_total{call_type, source}
  • Los tiempos de procesamiento se rastrean en métricas de duración respectivas

Esto ayuda a:

  • Rastrear el uso de herramientas de diagnóstico
  • Monitorear el rendimiento de las consultas de diagnóstico
  • Identificar usuarios intensivos de herramientas de diagnóstico

Para la documentación completa de métricas: Consulta metrics.md para todas las métricas disponibles, ejemplos de consultas y configuración de monitoreo.

Mejores Prácticas​

  1. Usa el Simulador de Llamadas Primero

    • Antes de realizar cambios de configuración
    • Al solucionar problemas específicos de suscriptores
    • Para entender el flujo de llamadas para capacitación

  2. Usa HLR Lookup Para

    • Comprobar rápidamente el estado de roaming
    • Verificar el desvío de llamadas desde el HLR
    • Probar la conectividad SS7 MAP

  3. Documenta Hallazgos

    • Toma capturas de pantalla de los resultados del simulador
    • Anota cualquier comportamiento inesperado
    • Comparte los resultados con el equipo para análisis

  4. Compara con Registros

    • Ejecuta la simulación con los mismos parámetros que la llamada fallida
    • Compara las variables del simulador con los registros de llamadas reales
    • Identifica discrepancias

  5. Pruebas Regulares

    • Revisiones semanales con el simulador
    • Prueba cada tipo de llamada (MT/MO/Emergencia)
    • Verifica la integración de OCS y HLR

Solución de Problemas de las Herramientas​

Problemas con HLR Lookup​

La herramienta muestra "SS7 MAP está deshabilitado"

  • Verifica config/runtime.exs para ss7_map.enabled
  • Reinicia la aplicación después del cambio de configuración

La herramienta muestra errores de tiempo de espera

  • Verifica que la puerta de enlace SS7 MAP sea accesible
  • Verifica la conectividad de red al HLR
  • Verifica ss7_map.timeout_ms en la configuración

La herramienta muestra "Sin Número VLR"

  • El suscriptor está fuera de línea o no existe en el HLR
  • Normal para suscriptores que están apagados
  • Normal para números que no existen

Problemas con el Simulador de Llamadas​

El simulador muestra "Sin datos Sh"

  • Suscriptor no provisionado en HSS
  • HSS es inalcanzable
  • Verifica la configuración de diameter.sh_application

El simulador muestra "La IP de origen no está autorizada"

  • IP no está en allowed_sbc_source_ips o allowed_cscf_ips
  • Usa "Forzar Disposición" para anular la autenticación basada en IP

El simulador muestra "Faltan parámetros requeridos"

  • Todos los campos son obligatorios excepto las opciones
  • Ingresa números de teléfono válidos
  • Ingresa una dirección IP válida

El simulador tarda demasiado

  • Desmarca "Omitir Autorización OCS" si no estás probando OCS
  • Desmarca "Omitir Búsqueda HLR" si no estás probando HLR
  • Verifica el rendimiento real del sistema (tiempos de respuesta de Sh/HLR/OCS)

Soporte​

Para problemas con estas herramientas:

  1. Verifica los registros de la aplicación en busca de errores
  2. Verifica la configuración (Sh, HLR, OCS)
  3. Prueba la conectividad con sistemas externos
  4. Contacta al equipo de soporte con capturas de pantalla y mensajes de error