دليل المستخدم - أداة البحث في HLR ومحاكي المكالمات

نظرة عامة

تمت إضافة أداتين تشخيصيتين جديدتين لمساعدة موظفي العمليات في استكشاف مشاكل توجيه المكالمات دون التأثير على حركة المرور الحية.

أداة البحث في HLR

الغرض

تستعلم أداة البحث في HLR عن سجل الموقع المنزلي (HLR) عبر بروتوكول SS7 MAP لاسترجاع معلومات توجيه المشترك في الوقت الفعلي.

الوصول

انتقل إلى /hlr أو انقر على "HLR" في قائمة التنقل.

ما تعرضه

بالنسبة لأي رقم هاتف، تعرض أداة البحث في HLR:

1. MSRN (رقم التجوال لمحطة الهاتف المحمول)

   • رقم توجيه مؤقت يتم تعيينه عندما يتجول المشترك إلى شبكة 2G/3G
   • موجود فقط إذا كان المشترك يتجول حاليًا
   • يستخدمه خطة الاتصال لتوجيه المكالمات إلى موقع المشترك الحالي المتجول

2. إعدادات إعادة توجيه المكالمات

   • تكوين إعادة توجيه المكالمات في الوقت الفعلي من HLR
   • الأنواع: غير مشروط، مشغول، عدم الرد، غير متاح
   • يعرض رقم وجهة التوجيه
   • يظهر ما إذا كانت الإشعارات مفعلة

3. متغيرات خطة الاتصال

   • بالضبط أي متغيرات قناة سيتم تعيينها
   • تتطابق المتغيرات مع تلك المستخدمة في معالجة المكالمات الفعلية
   • يظهر كيف تتجاوز بيانات HLR بيانات Sh

حالات الاستخدام

تشخيص مشاكل التجوال

السيناريو: فشل المكالمة الواردة إلى المشترك المتجول أو توجيهها بشكل غير صحيح

الخطوات:

1. افتح صفحة البحث في HLR
2. أدخل رقم هاتف المشترك
3. انقر على "استعلام عن بيانات HLR"
4. تحقق من وجود MSRN في النتائج
5. إذا كان MSRN موجودًا: المشترك يتجول، تحقق من صحة MSRN
6. إذا لم يكن هناك MSRN: قد يكون المشترك في LTE/VoLTE (لا حاجة لـ MSRN)

التحقق من إعادة توجيه المكالمات

السيناريو: عدم عمل إعادة توجيه المكالمات كما هو متوقع

الخطوات:

1. افتح صفحة البحث في HLR
2. أدخل رقم هاتف المشترك
3. انقر على "استعلام عن بيانات HLR"
4. ابحث عن "إعادة توجيه المكالمات" في النتائج
5. تحقق من نوع التوجيه (غير مشروط، مشغول، إلخ)
6. تحقق من رقم وجهة التوجيه
7. ملاحظة: بيانات HLR تتجاوز أي بيانات Sh/HSS

اختبار اتصال HLR

السيناريو: تحقق من أن بوابة SS7 MAP تعمل

الخطوات:

1. افتح صفحة البحث في HLR
2. أدخل أي رقم مشترك معروف
3. انقر على "استعلام عن بيانات HLR"
4. تحقق من "خطأ" في النتائج
5. إذا كان هناك خطأ: تحقق من اتصال بوابة SS7 MAP
6. الأخطاء الشائعة:
   • "SS7 MAP معطل" - تحقق من التكوين
   • "انتهاء الوقت" - مشكلة في الشبكة إلى HLR
   • "لا يوجد رقم VLR" - المشترك غير متصل أو غير موجو��

صندوق المعلومات

تتضمن صفحة البحث في HLR معلومات تعليمية تشرح:

• ما هو MSRN ومتى يتم استخدامه
• كيف تعمل إعادة توجيه المكالمات في HLR
• كيف يتكامل ذلك مع معالجة المكالمات
• أساسيات بروتوكول SS7 MAP

أداة محاكي المكالمات

الغرض

تتيح لك أداة محاكي المكالمات محاكاة توجيه المكالمات بالكامل دون إجراء مكالمة فعلية أو التأثير على حركة المرور الحية.

الوصول

انتقل إلى /simulator أو انقر على "محاكي" في قائمة التنقل.

الميزات

معلمات الإدخال

1. رقم المصدر (المتصل)

   • رقم هاتف الطرف المتصل
   • بالنسبة لمكالمات MT: يمكن أن يكون أي رقم
   • بالنسبة لمكالمات MO: يجب أن يكون مشتركًا موفرًا

2. رقم الوجهة (الطرف المدعو)

   • رقم هاتف الطرف المدعو
   • بالنسبة لمكالمات MT: يجب أن يكون مشتركًا موفرًا
   • بالنسبة لمكالمات MO: يمكن أن يكون أي رقم
   • لحالات الطوا��ئ: استخدم "urn:service:sos" أو ما شابه

3. عنوان IP المصدر

   • عنوان IP لمصدر إشارة SIP
   • يجب أن يكون في allowed_sbc_source_ips (لـ MT) أو allowed_cscf_ips (لـ MO)
   • يحدد مصير المكالمة (MT مقابل MO)

4. فرض المصير

   • تلقائي: تحديد من عنوان IP (سلوك عادي)
   • MT: فرض إنهاء الهاتف المحمول (وارد)
   • MO: فرض بدء الهاتف المحمول (صادر)
   • طوارئ: فرض معالجة مكالمات الطوارئ

5. الخيارات

   • تخطي تفويض OCS: تجاوز الشحن عبر الإنترنت (محاكاة أسرع)
   • تخطي البحث في HLR: تجاوز استعلام SS7 MAP (محاكاة أسرع)

المخرجات

يعرض المحاكي نتائج شاملة:

1. لافتة نوع المكالمة

   • MT، MO، أو طوارئ
   • مشفرة بالألوان للتعرف السريع
   • يعرض أرقام المصدر والوجهة

2. خطوات المعالجة (العمود الأيسر)

   • بيانات المشترك: النتائج من واجهة Sh (HSS)
   • بيانات HLR: النتائج من استعلام SS7 MAP (MT فقط)
   • تفويض OCS: النتائج من الشحن عبر الإنترنت (MO فقط)
   • حالة الشبكة: ما إذا كانت الوجهة على شبكتك (MO فقط)

3. متغيرات خطة الاتصال (العمود الأيمن)

   • كل متغير سيتم تعيينه على القناة
   • مرتبة أبجديًا لسهولة القراءة
   • قيم مشفرة بالألوان (أخضر للعادي، أحمر للأخطاء)

4. ملاحظات المعالجة

   • شرح خطوة بخطوة لما حدث
   • يصف تدفق البيانات ونقاط القرار
   • يساعد في فهم سبب تعيين متغيرات معينة

حالات الاستخدام

اختبار ما قبل الطيران

السيناريو: اختبار تغيير التكوين قبل نشره في الإنتاج

الخطوات:

1. إجراء تغيير التكوين في بيئة التطوير/الاختبار
2. افتح محاكي المكالمات
3. اختبار سيناريوهات متعددة:
   • مكالمة MT من SBC الخاص بك
   • مكالمة MO من CSCF الخاص بك
   • مكالمة طوارئ
   • وجهة على الشبكة
   • وجهة خارج الشبكة
4. تحقق من صحة جميع المتغيرات
5. تحقق من ملاحظات المعالجة لأي مشاكل
6. نشر في الإنتاج بثقة

تصحيح مشاكل مكالمات MT

السيناريو: فشل المكالمات الواردة إلى المشترك

الخطوات:

1. افتح محاكي المكالمات
2. أدخل الوجهة كمشترك المشكلة
3. أدخل المصدر كرقم اختبار
4. اضبط عنوان IP المصدر على عنوان IP الخاص بـ SBC
5. اترك فرض المصير كـ "تلقائي"
6. انقر على "محاكاة المكالمة"
7. تحقق من قسم بيانات المشترك لنجاح استعلام Sh
8. تحقق من قسم بيانات HLR لـ MSRN أو إعادة التوجيه
9. تحقق من المتغيرات النهائية لـ hangup_case
10. إذا كانت hangup_case هي "UNALLOCATED_NUMBER": المشترك غير موفر
11. إذا بدت المتغيرات صحيحة: قد تكون المشكلة في قالب خطة الاتصال

تصحيح مشاكل مكالمات MO

السيناريو: فشل المكالمات الصادرة من المشترك

الخطوات:

1. افتح محاكي المكالمات
2. أدخل المصدر كمشترك المشكلة
3. أدخل الوجهة كرقم اختبار
4. اضبط عنوان IP المصدر على عنوان IP الخاص بـ CSCF
5. أ��غِ تحديد "تخطي تفويض OCS" إذا كنت تختبر الشحن
6. انقر على "محاكاة المكالمة"
7. تحقق من قسم بيانات المتصل لنجاح استعلام Sh
8. تحقق من قسم تفويض OCS للنجاح/الفشل
9. تحقق من حالة الشبكة للتحقق من التوجيه الصحيح
10. تحقق من المتغيرات النهائية لـ allocated_time أو hangup_case
11. إذا كانت hangup_case هي "OUTGOING_CALL_BARRED": OCS رفض المكالمة

اختبار معالجة مكالمات الطوارئ

السيناريو: تحقق من أن مكالمات الطوارئ تعمل بشكل صحيح

الخطوات:

1. افتح محاكي المكالمات
2. أدخل المصدر كمشترك اختبار
3. أدخل الوجهة كـ "urn:service:sos"
4. اضبط أي عنوان IP (مكالمات الطوارئ تتجاوز مصادقة IP)
5. انقر على "محاكاة المكالمة"
6. تحقق من أن نوع المكالمة يظهر "طوارئ (SOS)"
7. تحقق من أن hangup_case هو "none" (مكالمات الطوارئ دائمًا تستمر)
8. تحقق من أنه تم تجاوز OCS و HLR
9. تحقق من استرجاع بيانات المتصل لمعلومات الموقع

تدريب الموظفين

السيناريو: تعليم موظفي العمليات كيفية عمل توجيه المكالمات

الخطوات:

1. افتح محاكي المكالمات
2. قم بتشغيل سيناريوهات مختلفة واشرح كل قسم:
   • عرض مكالمة MT وشرح استعلامات Sh + HLR
   • عرض مكالمة MO وشرح تفويض OCS
   • عرض مكالمة طوارئ وشرح سلوك التجاوز
   • عرض IP غير المصرح به وشرح الرفض
3. دع الموظفين يجربون تركيبات مختلفة
4. استخدم ملاحظات المعالجة لشرح كل قرار
5. قارن المتغيرات بين السيناريوهات المختلفة

مقارنة بيانات Sh مقابل بيانات HLR

السيناريو: فهم كيف تتجاوز HLR بيانات Sh

الخطوات:

1. افتح محاكي المكالمات لمكالمة MT
2. ألغِ تحديد "تخطي البحث في HLR"
3. انقر على "محاكاة المكالمة"
4. قارن متغيرات بيانات المشترك مقابل متغيرات بيانات HLR
5. تحقق من المتغيرات النهائية لمعرفة أي القيم انتصرت
6. ملاحظة: بيانات HLR دائمًا تأخذ الأولوية لـ:
   • MSRN
   • call_forward_all_destination
   • call_forward_not_reachable_destination

نصائح

• استخدم "تخطي تفويض OCS" و "تخطي البحث في HLR" لمحاكاة أسرع عند اختبار جوانب أخرى
• انسخ/الصق أرقام الهواتف من السجلات إلى المحاكي للاختبار السريع
• استخدم "فرض المصير" لاختبار أنواع المكالمات المحددة بغض النظر عن IP
• تحقق من ملاحظات المعالجة إذا كنت غير متأكد من سبب تعيين متغيرات معينة
• قم بتشغيل المحاكاة عدة مرات للتحقق من الاتساق
• قارن نتائج المحاكاة بسجلات المكالمات الفعلية

القيود

المحاكي:

• لا يقوم فعليًا بإجراء المكالمات
• لا يؤثر على نظام توجيه المكالمات
• لا يستهلك حصة OCS (حتى لو تم استعلام OCS)
• لا يولد CDRs
• آمن للاستخدام على الأنظمة الإنتاجية

المحاكي يفعل:

• استعلام عن واجهة Sh الفعلية (HSS) إذا لم يتم تخطيها
• استعلام عن HLR الفعلي عبر SS7 MAP إذا لم يتم تخطيها
• استعلام عن OCS ا��فعلي إذا لم يتم تخطيها
• عرض بالضبط ما سيحدث في مكالمة حقيقية
• استخدام قيم التكوين الحقيقية

التكامل مع المراقبة

تتكامل الأداتان مع مقاييس Prometheus:

• يتم احتساب عمليات البحث في HLR عبر الأداة في hlr_lookups_total
• يتم احتساب محاكيات المكالمات في call_simulations_total{call_type, source}
• يتم تتبع أوقات المعالجة في مقاييس المدة المعنية

يساعد هذا في:

• تتبع استخدام أدوات التشخيص
• مراقبة أداء الاستعلامات التشخيصية
• تحديد المستخدمين الكثيفين لأدوات التشخيص

للحصول على وثائق المقاييس الكاملة: راجع metrics.md لجميع المقاييس المتاحة، وأمثلة الاستعلام، وإعداد المراقبة.

أفضل الممارسات

1. استخدم محاكي المكالمات أولاً

   • قبل إجراء تغييرات في التكوين
   • عند استكشاف مشاكل محددة للمشترك
   • لفهم تدفق المكالمات للتدريب

2. استخدم البحث في HLR من أجل

   • التح��ق السريع من حالة التجوال
   • التحقق من إعادة توجيه المكالمات من HLR
   • اختبار اتصال SS7 MAP

3. وثق النتائج

   • التقط لقطات شاشة لنتائج المحاكي
   • لاحظ أي سلوك غير متوقع
   • شارك النتائج مع الفريق للتحليل

4. قارن بالسجلات

   • قم بتشغيل المحاكاة بنفس المعلمات مثل المكالمة الفاشلة
   • قارن متغيرات المحاكي بسجلات المكالمات الفعلية
   • حدد التباينات

5. اختبار منتظم

   • فحوصات عشوائية أسبوعية باستخدام المحاكي
   • اختبار كل نوع مكالمة (MT/MO/Emergency)
   • تحقق من تكامل OCS و HLR

استكشاف أخطاء الأدوات

مشاكل البحث في HLR

الأداة تظهر "SS7 MAP معطل"

• تحقق من config/runtime.exs لـ ss7_map.enabled
• أعد تشغيل التطبيق بعد تغيير التكوين

الأداة تظهر أخطاء انتهاء الوقت

• تحقق من أن بوابة SS7 MAP قابلة للوصول
• تحقق من الاتصال بالشبكة إلى HLR
• تحقق من ss7_map.timeout_ms في التكوين

الأداة تظهر "لا يوجد رقم VLR"

• المشترك غير متصل أو غير موجود في HLR
• طبيعي بالنسبة للمشتركين الذين تم إيقاف تشغيلهم
• طبيعي بالنسبة للأرقام غير الموجودة

مشاكل محاكي المكالمات

المحاكي يظهر "لا توجد بيانات Sh"

• المشترك غير موفر في HSS
• HSS غير قابل للوصول
• تحقق من تكوين diameter.sh_application

المحاكي يظهر "عنوان IP غير مصرح به"

• IP غير موجود في allowed_sbc_source_ips أو allowed_cscf_ips
• استخدم "فرض المصير" لتجاوز المصادقة المعتمدة على IP

المحاكي يظهر "معلمات مطلوبة مفقودة"

• جميع الحقول مطلوبة باستثناء الخيارات
• أدخل أرقام هواتف صحيحة
• أدخل عنوان IP صحيح

المحاكي يستغرق وقتًا طويلاً

• ألغِ تحديد "تخطي تفويض OCS" إذا لم تكن تختبر OCS
• ألغِ تحديد "تخطي البحث في HLR" إذا لم تكن تختبر HLR
• تحقق من أداء النظام الفعلي (أوقات استجابة Sh/HLR/OCS)

الدعم

للمشاكل المتعلقة بهذه الأدوات:

1. تحقق من سجلات التطبيق للأخطاء
2. تحقق من التكوين (Sh، HLR، OCS)
3. اختبر الاتصال بالأنظمة الخارجية
4. اتصل بفريق الدعم مع لقطات الشاشة ورسائل الخطأ