Saltar al contenido principal

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

Descripción General​

Se han añadido dos nuevas herramientas de diagnóstico para ayudar al personal de operaciones a solucionar 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 a 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 del 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 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 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 del 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 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 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 procesamiento de llamada de emergencia

  5. Opciones

    • Saltar Autorización OCS: Omitir el cobro en línea (simulación más rápida)
    • Saltar Búsqueda HLR: Omitir 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 del cobro 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 puntos de decisión
    • Ayuda a entender por qué se establecieron ciertas variables

Casos de Uso​

Pruebas Previas al Vuelo​

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

Pasos:

  1. Realiza el cambio de configuración en el entorno de desarrollo/pruebas
  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 red
    • Destino fuera de red
  4. Verifica que todas las variables sean correctas
  5. Revisa las notas de procesamiento para cualquier problema
  6. Implementa 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 el origen como un número de prueba
  4. Establece la IP de origen en 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 el origen como el suscriptor problemático
  3. Ingresa el destino como un número de prueba
  4. Establece la IP de origen en la IP de tu CSCF
  5. Desmarca "Saltar Autorización OCS" si estás probando el cobro
  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 denegó la llamada

Prueba del Manejo de Llamadas de Emergencia​

Escenario: Verificar que las llamadas de emergencia funcionen correctamente

Pasos:

  1. Abre el Simulador de Llamadas
  2. Ingresa el origen 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 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 de 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

Comparando Datos de 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 "Saltar 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 "Saltar Autorización OCS" y "Saltar 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 varias 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 las 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

    • Verificación rápida del estado de roaming
    • Verificar el desvío de llamadas desde el HLR
    • Probar la conectividad SS7 MAP

  3. Documenta los 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 los 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 de cambiar la 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 de Sh"

  • Suscriptor no provisionado en HSS
  • HSS es inaccesible
  • 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 "Saltar Autorización OCS" si no estás probando OCS
  • Desmarca "Saltar 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 para 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