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 Usuário (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 é roteada 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)

Verificação do 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 "Encaminhamento de Chamadas" 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 qualquer dado do Sh/HSS

Testando a Conectividade do HLR​

Cenário: Verificar 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á "Erro" nos resultados
  5. Se houver erro: Verifique a conectividade do gateway SS7 MAP
  6. Erros comuns:
    • "SS7 MAP está desativado" - Verifique a configuração
    • "Timeout" - Problema de rede para o HLR
    • "Sem Número VLR" - 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 "Simulador" no menu de navegação.

Recursos​

Parâmetros de Entrada​

  1. Número de Origem (Chamador)

    • Número de telefone da parte que está chamando
    • 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 chamadas de emergência

  5. Opções

    • Pular Autorização OCS: Ignorar cobrança online (simulação mais rápida)
    • Pular 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. Passos 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 alfabeticamente 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 desenvolvimento/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 na rede
    • Destino fora da rede
  4. Verifique se todas as variáveis estão corretas
  5. Verifique as notas de processamento para quaisquer problemas
  6. Implante 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 Disposição Forçada como "Auto"
  6. Clique em "Simular Chamada"
  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 template 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 "Pular Autorização OCS" se estiver testando cobrança
  6. Clique em "Simular Chamada"
  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: Verificar 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 "Simular Chamada"
  6. Verifique se o Tipo de Chamada mostra "Emergência (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 as 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 "Pular HLR Lookup"
  3. Clique em "Simular Chamada"
  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 "Pular Autorização OCS" e "Pular 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 "Forçar Disposição" para testar tipos de chamadas específicos, independentemente do IP
  • Verifique as Notas de Processamento se você não tiver certeza do motivo pelo qual 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 faz chamadas reais
  • NÃO afeta o sistema de roteamento de chamadas
  • NÃO consome cota do OCS (mesmo que o 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 pulada
  • Consultar o HLR real via SS7 MAP se não for pulada
  • Consultar o OCS real se não for pulada
  • 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 consultas 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
    • Verificar o encaminhamento de chamadas do HLR
    • Testar a conectividade do SS7 MAP

  3. Documente as Descobertas

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

  4. Compare com os 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 do OCS e HLR

Solucionando Problemas das Ferramentas​

Problemas com HLR Lookup​

A ferramenta mostra "SS7 MAP está desativado"

  • 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 "Sem Número VLR"

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

Problemas com o Simulador de Chamadas​

O simulador mostra "Sem dados Sh"

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

O simulador mostra "IP de origem não autorizado"

  • IP não está em allowed_sbc_source_ips ou allowed_cscf_ips
  • Use "Forçar Disposição" para substituir a autenticação baseada em IP

O simulador mostra "Faltando parâmetros obrigatórios"

  • 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 demora muito

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

Suporte​

Para problemas com essas ferramentas:

  1. Verifique os logs da aplicação para 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