HLR Lookup et Simulateur d'Appel - 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, le 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
   • Affiche 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. Ouvrir la page HLR Lookup
2. Entrer le numéro de téléphone de l'abonné
3. Cliquer sur "Lookup HLR Data"
4. Vérifier la présence de MSRN dans les résultats
5. Si MSRN présent : L'abonné est en itinérance, vérifier 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. Ouvrir la page HLR Lookup
2. Entrer le numéro de téléphone de l'abonné
3. Cliquer sur "Lookup HLR Data"
4. Rechercher "Call Forwarding" dans les résultats
5. Vérifier le type de renvoi (Inconditionnel, Occupé, etc.)
6. Vérifier 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érifier que la passerelle SS7 MAP fonctionne

Étapes :

1. Ouvrir la page HLR Lookup
2. Entrer n'importe quel numéro d'abonné connu
3. Cliquer sur "Lookup HLR Data"
4. Vérifier la présence d'une "Erreur" dans les résultats
5. Si erreur : Vérifier la connectivité de la passerelle SS7 MAP
6. Erreurs courantes :
   • "SS7 MAP est désactivé" - Vérifier la configuration
   • "Délai d'attente" - Problème 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
• Notions de base sur le protocole SS7 MAP

Outil Simulateur d'Appel

Objectif

Le Simulateur d'Appel vous permet de simuler un routage d'appel 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 les Urgences : Utiliser "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éterminé à 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
   • Affiche 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 : Indique 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. Apporter un changement de configuration dans l'environnement de développement/test
2. Ouvrir le Simulateur d'Appel
3. Tester 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érifier que toutes les variables sont correctes
5. Vérifier les notes de traitement pour tout problème
6. Déployer en production en toute confiance

Débogage des Problèmes d'Appel MT

Scénario : Les appels entrants vers l'abonné échouent

Étapes :

1. Ouvrir le Simulateur d'Appel
2. Entrer la destination comme l'abonné problématique
3. Entrer la source comme numéro de test
4. Définir l'IP source sur l'IP de votre SBC
5. Laisser la Disposition Forcée sur "Auto"
6. Cliquer sur "Simulate Call"
7. Vérifier la section Données Abonné pour le succès de la recherche Sh
8. Vérifier la section Données HLR pour MSRN ou renvoi
9. Vérifier 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'Appel MO

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

Étapes :

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

Tester le Traitement des Appels d'Urgence

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

Étapes :

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

Former le Personnel

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

Étapes :

1. Ouvrir le Simulateur d'Appel
2. Exécuter divers scénarios et expliquer chaque section :
   • Montrer un appel MT et expliquer les recherches Sh + HLR
   • Montrer un appel MO et expliquer l'autorisation OCS
   • Montrer un appel d'urgence et expliquer le comportement de contournement
   • Montrer une IP non autorisée et expliquer le rejet
3. Faire essayer au personnel différentes combinaisons
4. Utiliser les Notes de Traitement pour expliquer chaque décision
5. Comparer les variables entre différents scénarios

Comparer les Données Sh vs HLR

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

Étapes :

1. Ouvrir le Simulateur d'Appel pour un appel MT
2. Décochez "Skip HLR Lookup"
3. Cliquer sur "Simulate Call"
4. Comparer les variables de Données Abonné avec les variables de Données HLR
5. Vérifier les Variables Finales pour voir quelles valeurs ont prévalu
6. Remarque : Les données HLR prennent toujours le pas sur :
   • MSRN
   • call_forward_all_destination
   • call_forward_not_reachable_destination

Conseils

• Utilisez "Skip OCS Authorization" et "Skip HLR Lookup" pour des simulations plus rapides lors de tests d'autres aspects
• Copier/coller les numéros de téléphone à partir des journaux dans le simulateur pour des tests rapides
• Utilisez "Force 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 de quota OCS (même si l'OCS est interrogé)
• Ne génère PAS de CDR
• Est sûr à utiliser sur des systèmes de production

Le simulateur FAIT :

• Interroger l'interface Sh réelle (HSS) si non contournée
• Interroger le HLR réel via SS7 MAP si non contourné
• Interroger l'OCS réel si non contourné
• 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 sur les 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. Utiliser d'abord le Simulateur d'Appel

   • 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. Utiliser 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. Documenter les Découvertes

   • Prendre des captures d'écran des résultats du simulateur
   • Noter tout comportement inattendu
   • Partager les résultats avec l'équipe pour analyse

4. Comparer aux Journaux

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

5. Tests Réguliers

   • Vérifications ponctuelles hebdomadaires avec le simulateur
   • Tester chaque type d'appel (MT/MO/Urgence)
   • Vérifier 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 un 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'Appel

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'IP source n'est pas autorisée"

• IP non dans allowed_sbc_source_ips ou allowed_cscf_ips
• Utilisez "Force 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 "Skip OCS Authorization" si vous ne testez pas l'OCS
• Décochez "Skip 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 de l'application pour des erreurs
2. Vérifiez la configuration (Sh, HLR, OCS)
3. Testez la connectivité aux systèmes externes
4. Contactez l'équipe de support avec des captures d'écran et des messages d'erreur