Pular para o conteúdo principal

HLR Lookup e Simulador de Chamadas - Guia do Usuário

Visão Geral​

Duas novas ferramentas de diagnóstico foram adicionadas para ajudar a equipe de operações a solucionar problemas de roteamento de chamadas sem afetar o tráfego ao vivo.

Ferramenta HLR Lookup​

Propósito​

A ferramenta HLR Lookup consulta o Registro de Localização do Home (HLR) via protocolo SS7 MAP para recuperar informações de roteamento de assinantes em tempo real.

Acesso​

Navegue até /hlr ou clique em "HLR" no menu de navegação.

O Que Mostra​

Para qualquer número de telefone, o HLR Lookup exibe:

  1. MSRN (Número de Roaming da Estação Móvel)

    • Número de roteamento temporário atribuído quando o assinante está em roaming para a rede 2G/3G
    • Presente apenas se o assinante estiver atualmente em roaming
    • Usado pelo plano de discagem para roteamento de chamadas para a localização atual do assinante em roaming

  2. Configurações de Encaminhamento de Chamadas

    • Configuração de encaminhamento de chamadas em tempo real do HLR
    • Tipos: Incondicional, Ocupado, Sem Resposta, Não Acessível
    • Mostra o número de destino do encaminhamento
    • Mostra se a notificação está habilitada

  3. Variáveis do Plano de Discagem

    • Exatamente quais variáveis de canal serão definidas
    • As variáveis correspondem às usadas no processamento real de chamadas
    • Mostra como os dados do HLR substituem os dados do Sh

Casos de Uso​

Diagnóstico de Problemas de Roaming​

Cenário: Chamada recebida para assinante em roaming falha ou roteia incorretamente

Passos:

  1. Abra a página HLR Lookup
  2. Insira o número de telefone do assinante
  3. Clique em "Lookup HLR Data"
  4. Verifique se há MSRN nos resultados
  5. Se MSRN presente: O assinante está em roaming, verifique se o MSRN é válido
  6. Se não houver MSRN: O assinante pode estar em LTE/VoLTE (sem MSRN necessário)

Verificando o Encaminhamento de Chamadas​

Cenário: Encaminhamento de chamadas não funcionando como esperado

Passos:

  1. Abra a página HLR Lookup
  2. Insira o número de telefone do assinante
  3. Clique em "Lookup HLR Data"
  4. Procure por "Call Forwarding" nos resultados
  5. Verifique o tipo de encaminhamento (Incondicional, Ocupado, etc.)
  6. Verifique o número de destino do encaminhamento
  7. Nota: Os dados do HLR substituem quaisquer dados do Sh/HSS

Testando a Conectividade do HLR​

Cenário: Verifique se o gateway SS7 MAP está funcionando

Passos:

  1. Abra a página HLR Lookup
  2. Insira qualquer número de assinante conhecido
  3. Clique em "Lookup HLR Data"
  4. Verifique se há "Error" nos resultados
  5. Se houver erro: Verifique a conectividade do gateway SS7 MAP
  6. Erros comuns:
    • "SS7 MAP is disabled" - Verifique a configuração
    • "Timeout" - Problema de rede para o HLR
    • "No VLR Number" - Assinante offline ou não existe

Caixa de Informações​

A página HLR Lookup inclui informações educacionais explicando:

  • O que é MSRN e quando é usado
  • Como o encaminhamento de chamadas funciona no HLR
  • Como isso se integra ao processamento de chamadas
  • Noções básicas do protocolo SS7 MAP

Ferramenta Simulador de Chamadas​

Propósito​

O Simulador de Chamadas permite simular o roteamento completo de chamadas sem realmente fazer uma chamada ou afetar o tráfego ao vivo.

Acesso​

Navegue até /simulator ou clique em "Simulator" no menu de navegação.

Recursos​

Parâmetros de Entrada​

  1. Número de Origem (Chamador)

    • Número de telefone da parte que chama
    • Para chamadas MT: Pode ser qualquer número
    • Para chamadas MO: Deve ser um assinante provisionado

  2. Número de Destino (Parte Chamado)

    • Número de telefone da parte chamada
    • Para chamadas MT: Deve ser um assinante provisionado
    • Para chamadas MO: Pode ser qualquer número
    • Para Emergência: Use "urn:service:sos" ou similar

  3. Endereço IP de Origem

    • Endereço IP da fonte de sinalização SIP
    • Deve estar em allowed_sbc_source_ips (para MT) ou allowed_cscf_ips (para MO)
    • Determina a disposição da chamada (MT vs MO)

  4. Forçar Disposição

    • Auto: Determinar a partir do endereço IP (comportamento normal)
    • MT: Forçar Terminação Móvel (entrada)
    • MO: Forçar Origem Móvel (saída)
    • Emergência: Forçar processamento de chamada de emergência

  5. Opções

    • Ignorar Autorização OCS: Ignorar cobrança online (simulação mais rápida)
    • Ignorar HLR Lookup: Ignorar consulta SS7 MAP (simulação mais rápida)

Saída​

O simulador mostra resultados abrangentes:

  1. Banner do Tipo de Chamada

    • MT, MO ou Emergência
    • Colorido para identificação rápida
    • Mostra números de origem e destino

  2. Etapas de Processamento (Coluna da Esquerda)

    • Dados do Assinante: Resultados da interface Sh (HSS)
    • Dados do HLR: Resultados da consulta SS7 MAP (apenas MT)
    • Autorização OCS: Resultados da cobrança online (apenas MO)
    • Status On-Net: Se o destino está na sua rede (apenas MO)

  3. Variáveis do Plano de Discagem (Coluna da Direita)

    • Cada variável que seria definida no canal
    • Classificadas em ordem alfabética para fácil leitura
    • Valores coloridos (verde para normal, vermelho para erros)

  4. Notas de Processamento

    • Explicação passo a passo do que aconteceu
    • Descreve o fluxo de dados e pontos de decisão
    • Ajuda a entender por que certas variáveis foram definidas

Casos de Uso​

Teste Pré-Voo​

Cenário: Testando alteração de configuração antes de implantar em produção

Passos:

  1. Faça a alteração de configuração no ambiente de dev/teste
  2. Abra o Simulador de Chamadas
  3. Teste vários cenários:
    • Chamada MT do seu SBC
    • Chamada MO do seu CSCF
    • Chamada de emergência
    • Destino on-net
    • Destino off-net
  4. Verifique se todas as variáveis estão corretas
  5. Verifique as notas de processamento para quaisquer problemas
  6. Implemente em produção com confiança

Depuração de Problemas de Chamada MT​

Cenário: Chamadas recebidas para assinante falhando

Passos:

  1. Abra o Simulador de Chamadas
  2. Insira o destino como o assinante problemático
  3. Insira a origem como número de teste
  4. Defina o IP de origem para o IP do seu SBC
  5. Deixe a Forçar Disposição como "Auto"
  6. Clique em "Simulate Call"
  7. Verifique a seção Dados do Assinante para o sucesso da consulta Sh
  8. Verifique a seção Dados do HLR para MSRN ou encaminhamento
  9. Verifique as Variáveis Finais para hangup_case
  10. Se hangup_case for "UNALLOCATED_NUMBER": Assinante não provisionado
  11. Se as variáveis parecerem corretas: O problema pode estar no modelo do plano de discagem

Depuração de Problemas de Chamada MO​

Cenário: Chamadas de saída do assinante falhando

Passos:

  1. Abra o Simulador de Chamadas
  2. Insira a origem como o assinante problemático
  3. Insira o destino como número de teste
  4. Defina o IP de origem para o IP do seu CSCF
  5. Desmarque "Skip OCS Authorization" se estiver testando cobrança
  6. Clique em "Simulate Call"
  7. Verifique a seção Dados do Chamador para o sucesso da consulta Sh
  8. Verifique a seção Autorização OCS para sucesso/falha
  9. Verifique o Status On-Net para verificar o roteamento correto
  10. Verifique as Variáveis Finais para allocated_time ou hangup_case
  11. Se hangup_case for "OUTGOING_CALL_BARRED": OCS negou a chamada

Testando o Manuseio de Chamadas de Emergência​

Cenário: Verifique se as chamadas de emergência funcionam corretamente

Passos:

  1. Abra o Simulador de Chamadas
  2. Insira a origem como assinante de teste
  3. Insira o destino como "urn:service:sos"
  4. Defina qualquer IP de origem (chamadas de emergência ignoram a autenticação de IP)
  5. Clique em "Simulate Call"
  6. Verifique se o Tipo de Chamada mostra "Emergency (SOS)"
  7. Verifique se hangup_case é "none" (chamadas de emergência sempre prosseguem)
  8. Verifique se OCS e HLR foram ignorados
  9. Verifique se os dados do chamador foram recuperados para informações de localização

Treinando a Equipe​

Cenário: Ensinando a equipe de operações como funciona o roteamento de chamadas

Passos:

  1. Abra o Simulador de Chamadas
  2. Execute vários cenários e explique cada seção:
    • Mostre a chamada MT e explique as consultas Sh + HLR
    • Mostre a chamada MO e explique a autorização OCS
    • Mostre a chamada de emergência e explique o comportamento de bypass
    • Mostre IP não autorizado e explique a rejeição
  3. Faça a equipe tentar diferentes combinações
  4. Use Notas de Processamento para explicar cada decisão
  5. Compare variáveis entre diferentes cenários

Comparando Dados Sh vs HLR​

Cenário: Entendendo como o HLR substitui os dados do Sh

Passos:

  1. Abra o Simulador de Chamadas para chamada MT
  2. Desmarque "Skip HLR Lookup"
  3. Clique em "Simulate Call"
  4. Compare as variáveis de Dados do Assinante com as variáveis de Dados do HLR
  5. Verifique as Variáveis Finais para ver quais valores prevaleceram
  6. Nota: Os dados do HLR sempre têm precedência para:
    • MSRN
    • call_forward_all_destination
    • call_forward_not_reachable_destination

Dicas​

  • Use "Skip OCS Authorization" e "Skip HLR Lookup" para simulações mais rápidas ao testar outros aspectos
  • Copie/cole números de telefone dos logs no simulador para testes rápidos
  • Use "Force Disposition" para testar tipos de chamadas específicos, independentemente do IP
  • Verifique as Notas de Processamento se você não tiver certeza do porquê certas variáveis foram definidas
  • Execute a simulação várias vezes para verificar a consistência
  • Compare os resultados da simulação com os logs de chamadas reais

Limitações​

O simulador:

  • NÃO realiza chamadas de fato
  • NÃO afeta o sistema de roteamento de chamadas
  • NÃO consome cota OCS (mesmo que OCS seja consultado)
  • NÃO gera CDRs
  • É seguro usar em sistemas de produção

O simulador FAZ:

  • Consultar a interface Sh real (HSS) se não for ignorada
  • Consultar o HLR real via SS7 MAP se não for ignorada
  • Consultar OCS real se não for ignorada
  • Mostrar exatamente o que aconteceria em uma chamada real
  • Usar valores de configuração reais

Integração com Monitoramento​

Ambas as ferramentas se integram com métricas do Prometheus:

  • Consultas HLR via a ferramenta são contadas em hlr_lookups_total
  • Simulações de chamadas são contadas em call_simulations_total{call_type, source}
  • Tempos de processamento são rastreados nas respectivas métricas de duração

Isso ajuda a:

  • Rastrear o uso da ferramenta de diagnóstico
  • Monitorar o desempenho de consultas de diagnóstico
  • Identificar usuários intensivos de ferramentas de diagnóstico

Para documentação completa de métricas: Veja metrics.md para todas as métricas disponíveis, exemplos de consulta e configuração de monitoramento.

Melhores Práticas​

  1. Use o Simulador de Chamadas Primeiro

    • Antes de fazer alterações de configuração
    • Ao solucionar problemas específicos de assinantes
    • Para entender o fluxo de chamadas para treinamento

  2. Use HLR Lookup Para

    • Verificação rápida do status de roaming
    • Verificação do encaminhamento de chamadas do HLR
    • Testar a conectividade SS7 MAP

  3. Documente Descobertas

    • Tire capturas de tela dos resultados do simulador
    • Anote qualquer comportamento inesperado
    • Compartilhe resultados com a equipe para análise

  4. Compare com Logs

    • Execute a simulação com os mesmos parâmetros da chamada falhada
    • Compare as variáveis do simulador com os logs de chamadas reais
    • Identifique discrepâncias

  5. Testes Regulares

    • Verificações semanais com o simulador
    • Teste cada tipo de chamada (MT/MO/Emergência)
    • Verifique a integração OCS e HLR

Solução de Problemas das Ferramentas​

Problemas com HLR Lookup​

A ferramenta mostra "SS7 MAP is disabled"

  • Verifique config/runtime.exs para ss7_map.enabled
  • Reinicie a aplicação após a alteração de configuração

A ferramenta mostra erros de timeout

  • Verifique se o gateway SS7 MAP é acessível
  • Verifique a conectividade da rede com o HLR
  • Verifique ss7_map.timeout_ms na configuração

A ferramenta mostra "No VLR Number"

  • Assinante está offline ou não existe no HLR
  • Normal para assinantes que estão desligados
  • Normal para números inexistentes

Problemas com o Simulador de Chamadas​

O simulador mostra "No Sh data"

  • Assinante não provisionado no HSS
  • HSS está inacessível
  • Verifique a configuração diameter.sh_application

O simulador mostra "Source IP is not authorized"

  • IP não está em allowed_sbc_source_ips ou allowed_cscf_ips
  • Use "Force Disposition" para ignorar a autenticação baseada em IP

O simulador mostra "Missing required parameters"

  • Todos os campos são obrigatórios, exceto opções
  • Insira números de telefone válidos
  • Insira um endereço IP válido

O simulador leva muito tempo

  • Desmarque "Skip OCS Authorization" se não estiver testando OCS
  • Desmarque "Skip HLR Lookup" se não estiver testando HLR
  • Verifique o desempenho real do sistema (tempos de resposta Sh/HLR/OCS)

Suporte​

Para problemas com essas ferramentas:

  1. Verifique os logs da aplicação em busca de erros
  2. Verifique a configuração (Sh, HLR, OCS)
  3. Teste a conectividade com sistemas externos
  4. Entre em contato com a equipe de suporte com capturas de tela e mensagens de erro