دليل المستخدم لأداة البحث في 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. اتصل بفريق الدعم مع لقطات الشاشة ورسائل الخطأ