HLR Lookup et Simulateur d'Appels - Guide de l'Utilisateur

Aperçu

Deux nouveaux outils de diagnostic ont été ajoutés pour aider le personnel opérationnel à résoudre les problèmes de routage des appels sans affecter le trafic en direct.

Outil HLR Lookup

Objectif

L'outil HLR Lookup interroge le Home Location Register (HLR) via le protocole SS7 MAP pour récupérer des informations de routage des abonnés en temps réel.

Accès

Naviguez vers /hlr ou cliquez sur "HLR" dans le menu de navigation.

Ce qu'il Montre

Pour tout numéro de téléphone, l'HLR Lookup affiche :

1. MSRN (Mobile Station Roaming Number)

   • Numéro de routage temporaire attribué lorsque l'abonné se déplace vers un réseau 2G/3G
   • Présent uniquement si l'abonné est actuellement en itinérance
   • Utilisé par le plan de numérotation pour acheminer les appels vers l'emplacement actuel de l'abonné en itinérance

2. Paramètres de Renvoi d'Appels

   • Configuration de renvoi d'appels en temps réel depuis le HLR
   • Types : Inconditionnel, Occupé, Pas de Réponse, Non Joignable
   • Montre le numéro de destination du renvoi
   • Indique si la notification est activée

3. Variables de Plan de Numérotation

   • Exactement quelles variables de canal seront définies
   • Les variables correspondent à celles utilisées dans le traitement réel des appels
   • Montre comment les données HLR remplacent les données Sh

Cas d'Utilisation

Diagnostic des Problèmes d'Itinérance

Scénario : Un appel entrant vers un abonné en itinérance échoue ou est mal routé

Étapes :

1. Ouvrez la page HLR Lookup
2. Entrez le numéro de téléphone de l'abonné
3. Cliquez sur "Lookup HLR Data"
4. Vérifiez la présence de MSRN dans les résultats
5. Si MSRN présent : L'abonné est en itinérance, vérifiez que le MSRN est valide
6. Si pas de MSRN : L'abonné peut être en LTE/VoLTE (pas de MSRN nécessaire)

Vérification du Renvoi d'Appels

Scénario : Le renvoi d'appels ne fonctionne pas comme prévu

Étapes :

1. Ouvrez la page HLR Lookup
2. Entrez le numéro de téléphone de l'abonné
3. Cliquez sur "Lookup HLR Data"
4. Recherchez "Call Forwarding" dans les résultats
5. Vérifiez le type de renvoi (Inconditionnel, Occupé, etc.)
6. Vérifiez le numéro de destination du renvoi
7. Remarque : Les données HLR remplacent toutes les données Sh/HSS

Test de Connectivité HLR

Scénario : Vérifiez que la passerelle SS7 MAP fonctionne

Étapes :

1. Ouvrez la page HLR Lookup
2. Entrez n'importe quel numéro d'abonné connu
3. Cliquez sur "Lookup HLR Data"
4. Vérifiez la présence d'une "Erreur" dans les résultats
5. Si erreur : Vérifiez la connectivité de la passerelle SS7 MAP
6. Erreurs courantes :
   • "SS7 MAP est désactivé" - Vérifiez la configuration
   • "Délai d'attente" - Problème de réseau vers le HLR
   • "Pas de numéro VLR" - Abonné hors ligne ou n'existe pas

Boîte d'Information

La page HLR Lookup inclut des informations éducatives expliquant :

• Ce qu'est le MSRN et quand il est utilisé
• Comment fonctionne le renvoi d'appels dans le HLR
• Comment cela s'intègre au traitement des appels
• Les bases du protocole SS7 MAP

Outil Simulateur d'Appels

Objectif

Le Simulateur d'Appels vous permet de simuler un routage d'appels complet sans réellement passer un appel ou affecter le trafic en direct.

Accès

Naviguez vers /simulator ou cliquez sur "Simulator" dans le menu de navigation.

Fonctionnalités

Paramètres d'Entrée

1. Numéro Source (Appelant)

   • Numéro de téléphone de la partie appelante
   • Pour les appels MT : Peut être n'importe quel numéro
   • Pour les appels MO : Doit être un abonné provisionné

2. Numéro de Destination (Partie Appelée)

   • Numéro de téléphone de la partie appelée
   • Pour les appels MT : Doit être un abonné provisionné
   • Pour les appels MO : Peut être n'importe quel numéro
   • Pour Urgence : Utilisez "urn:service:sos" ou similaire

3. Adresse IP Source

   • Adresse IP de la source de signalisation SIP
   • Doit être dans allowed_sbc_source_ips (pour MT) ou allowed_cscf_ips (pour MO)
   • Détermine la disposition de l'appel (MT vs MO)

4. Forcer la Disposition

   • Auto : Déterminer à partir de l'adresse IP (comportement normal)
   • MT : Forcer Mobile Terminating (entrant)
   • MO : Forcer Mobile Originating (sortant)
   • Urgence : Forcer le traitement des appels d'urgence

5. Options

   • Ignorer l'Autorisation OCS : Contourner la facturation en ligne (simulation plus rapide)
   • Ignorer HLR Lookup : Contourner la requête SS7 MAP (simulation plus rapide)

Sortie

Le simulateur affiche des résultats complets :

1. Bannière de Type d'Appel

   • MT, MO ou Urgence
   • Codé par couleur pour une identification rapide
   • Montre les numéros source et destination

2. Étapes de Traitement (Colonne de Gauche)

   • Données Abonné : Résultats de l'interface Sh (HSS)
   • Données HLR : Résultats de la recherche SS7 MAP (MT uniquement)
   • Autorisation OCS : Résultats de la facturation en ligne (MO uniquement)
   • Statut On-Net : Si la destination est sur votre réseau (MO uniquement)

3. Variables de Plan de Numérotation (Colonne de Droite)

   • Chaque variable qui serait définie sur le canal
   • Triées par ordre alphabétique pour une lecture facile
   • Valeurs codées par couleur (vert pour normal, rouge pour erreurs)

4. Notes de Traitement

   • Explication étape par étape de ce qui s'est passé
   • Décrit le flux de données et les points de décision
   • Aide à comprendre pourquoi certaines variables ont été définies

Cas d'Utilisation

Test Pré-Vol

Scénario : Tester un changement de configuration avant de le déployer en production

Étapes :

1. Apportez un changement de configuration dans l'environnement dev/test
2. Ouvrez le Simulateur d'Appels
3. Testez plusieurs scénarios :
   • Appel MT depuis votre SBC
   • Appel MO depuis votre CSCF
   • Appel d'urgence
   • Destination sur le réseau
   • Destination hors réseau
4. Vérifiez que toutes les variables sont correctes
5. Vérifiez les notes de traitement pour tout problème
6. Déployez en production en toute confiance

Débogage des Problèmes d'Appels MT

Scénario : Les appels entrants vers un abonné échouent

Étapes :

1. Ouvrez le Simulateur d'Appels
2. Entrez la destination comme l'abonné problématique
3. Entrez la source comme numéro de test
4. Définissez l'adresse IP source sur l'IP de votre SBC
5. Laissez Forcer la Disposition sur "Auto"
6. Cliquez sur "Simulate Call"
7. Vérifiez la section Données Abonné pour le succès de la recherche Sh
8. Vérifiez la section Données HLR pour MSRN ou renvoi
9. Vérifiez les Variables Finales pour hangup_case
10. Si hangup_case est "UNALLOCATED_NUMBER" : Abonné non provisionné
11. Si les variables semblent correctes : Le problème peut être dans le modèle de plan de numérotation

Débogage des Problèmes d'Appels MO

Scénario : Les appels sortants de l'abonné échouent

Étapes :

1. Ouvrez le Simulateur d'Appels
2. Entrez la source comme l'abonné problématique
3. Entrez la destination comme numéro de test
4. Définissez l'adresse IP source sur l'IP de votre CSCF
5. Décochez "Ignorer l'Autorisation OCS" si vous testez la facturation
6. Cliquez sur "Simulate Call"
7. Vérifiez la section Données de l'Appelant pour le succès de la recherche Sh
8. Vérifiez la section Autorisation OCS pour succès/échec
9. Vérifiez le Statut On-Net pour vérifier le routage correct
10. Vérifiez les Variables Finales pour allocated_time ou hangup_case
11. Si hangup_case est "OUTGOING_CALL_BARRED" : OCS a refusé l'appel

Tester le Traitement des Appels d'Urgence

Scénario : Vérifiez que les appels d'urgence fonctionnent correctement

Étapes :

1. Ouvrez le Simulateur d'Appels
2. Entrez la source comme abonné de test
3. Entrez la destination comme "urn:service:sos"
4. Définissez n'importe quelle adresse IP (les appels d'urgence contournent l'authentification IP)
5. Cliquez sur "Simulate Call"
6. Vérifiez que le Type d'Appel affiche "Urgence (SOS)"
7. Vérifiez que hangup_case est "none" (les appels d'urgence avancent toujours)
8. Vérifiez que l'OCS et le HLR ont été contournés
9. Vérifiez que les données de l'appelant ont été récupérées pour les informations de localisation

Formation du Personnel

Scénario : Enseigner au personnel opérationnel comment fonctionne le routage des appels

Étapes :

1. Ouvrez le Simulateur d'Appels
2. Exécutez divers scénarios et expliquez chaque section :
   • Montrez un appel MT et expliquez les recherches Sh + HLR
   • Montrez un appel MO et expliquez l'autorisation OCS
   • Montrez un appel d'urgence et expliquez le comportement de contournement
   • Montrez une IP non autorisée et expliquez le rejet
3. Faites essayer au personnel différentes combinaisons
4. Utilisez les Notes de Traitement pour expliquer chaque décision
5. Comparez les variables entre différents scénarios

Comparaison des Données Sh vs HLR

Scénario : Comprendre comment HLR remplace les données Sh

Étapes :

1. Ouvrez le Simulateur d'Appels pour un appel MT
2. Décochez "Ignorer HLR Lookup"
3. Cliquez sur "Simulate Call"
4. Comparez les variables de Données Abonné avec celles de Données HLR
5. Vérifiez les Variables Finales pour voir quelles valeurs ont prévalu
6. Remarque : Les données HLR ont toujours la priorité pour :
   • MSRN
   • call_forward_all_destination
   • call_forward_not_reachable_destination

Conseils

• Utilisez "Ignorer l'Autorisation OCS" et "Ignorer HLR Lookup" pour des simulations plus rapides lors des tests d'autres aspects
• Copiez/collez les numéros de téléphone à partir des journaux dans le simulateur pour des tests rapides
• Utilisez "Forcer la Disposition" pour tester des types d'appels spécifiques indépendamment de l'IP
• Vérifiez les Notes de Traitement si vous n'êtes pas sûr pourquoi certaines variables ont été définies
• Exécutez la simulation plusieurs fois pour vérifier la cohérence
• Comparez les résultats de la simulation avec les journaux d'appels réels

Limitations

Le simulateur :

• Ne passe PAS réellement d'appels
• N'affecte PAS le système de routage des appels
• Ne consomme PAS le quota OCS (même si l'OCS est interrogé)
• Ne génère PAS de CDRs
• Est sûr à utiliser sur des systèmes de production

Le simulateur FAIT :

• Interroger l'interface Sh réelle (HSS) si non ignorée
• Interroger le HLR réel via SS7 MAP si non ignoré
• Interroger l'OCS réel si non ignoré
• Montrer exactement ce qui se passerait dans un appel réel
• Utiliser des valeurs de configuration réelles

Intégration avec la Surveillance

Les deux outils s'intègrent avec les métriques Prometheus :

• Les recherches HLR via l'outil sont comptées dans hlr_lookups_total
• Les simulations d'appels sont comptées dans call_simulations_total{call_type, source}
• Les temps de traitement sont suivis dans les métriques de durée respectives

Cela aide à :

• Suivre l'utilisation des outils de diagnostic
• Surveiller la performance des requêtes de diagnostic
• Identifier les utilisateurs intensifs des outils de diagnostic

Pour une documentation complète des métriques : Voir metrics.md pour toutes les métriques disponibles, des exemples de requêtes et la configuration de la surveillance.

Meilleures Pratiques

1. Utilisez d'abord le Simulateur d'Appels

   • Avant de faire des changements de configuration
   • Lors du dépannage de problèmes spécifiques aux abonnés
   • Pour comprendre le flux d'appels pour la formation

2. Utilisez HLR Lookup Pour

   • Vérification rapide du statut d'itinérance
   • Vérification du renvoi d'appels depuis le HLR
   • Tester la connectivité SS7 MAP

3. Documentez les Résultats

   • Prenez des captures d'écran des résultats du simulateur
   • Notez tout comportement inattendu
   • Partagez les résultats avec l'équipe pour analyse

4. Comparez aux Journaux

   • Exécutez la simulation avec les mêmes paramètres que l'appel échoué
   • Comparez les variables du simulateur avec les journaux d'appels réels
   • Identifiez les écarts

5. Tests Réguliers

   • Vérifications ponctuelles hebdomadaires avec le simulateur
   • Testez chaque type d'appel (MT/MO/Urgence)
   • Vérifiez l'intégration OCS et HLR

Dépannage des Outils

Problèmes HLR Lookup

L'outil affiche "SS7 MAP est désactivé"

• Vérifiez config/runtime.exs pour ss7_map.enabled
• Redémarrez l'application après le changement de configuration

L'outil affiche des erreurs de délai d'attente

• Vérifiez que la passerelle SS7 MAP est accessible
• Vérifiez la connectivité réseau vers le HLR
• Vérifiez ss7_map.timeout_ms dans la configuration

L'outil affiche "Pas de numéro VLR"

• L'abonné est hors ligne ou n'existe pas dans le HLR
• Normal pour les abonnés qui sont éteints
• Normal pour les numéros inexistants

Problèmes Simulateur d'Appels

Le simulateur affiche "Pas de données Sh"

• Abonné non provisionné dans le HSS
• HSS est inaccessible
• Vérifiez la configuration diameter.sh_application

Le simulateur affiche "L'adresse IP source n'est pas autorisée"

• IP non dans allowed_sbc_source_ips ou allowed_cscf_ips
• Utilisez "Forcer la Disposition" pour contourner l'authentification basée sur l'IP

Le simulateur affiche "Paramètres requis manquants"

• Tous les champs sont requis sauf les options
• Entrez des numéros de téléphone valides
• Entrez une adresse IP valide

Le simulateur prend trop de temps

• Décochez "Ignorer l'Autorisation OCS" si vous ne testez pas l'OCS
• Décochez "Ignorer HLR Lookup" si vous ne testez pas le HLR
• Vérifiez la performance réelle du système (temps de réponse Sh/HLR/OCS)

Support

Pour des problèmes avec ces outils :

1. Vérifiez les journaux d'application pour des erreurs
2. Vérifiez la configuration (Sh, HLR, OCS)
3. Testez la connectivité vers des systèmes externes
4. Contactez l'équipe de support avec des captures d'écran et des messages d'erreur