انتقل إلى المحتوى الرئيسي

دليل العمليات

📖 العودة إلى الوثائق الرئيسية

يغطي هذا المستند ميزات المراقبة والإدارة التشغيلية المتاحة في لوحة التحكم.

الوثائق ذات الصلة​

الوثائق الأساسية​

أدوات المراقبة والاختبار​

معالجة المكالمات والخدمات​

واجهات التكامل​

العمليات​

تغطي هذه القسم ميزات المراقبة والإدارة التشغيلية المتاحة في لوحة تحكم OmniTAS.

جدول المحتويات​

عرض المشتركين​

يوفر عرض المشتركين مراقبة في الوقت الحقيقي لتسجيلات المشتركين في IMS المخزنة في قاعدة بيانات تسجيل SIP الخاصة بـ Sofia.

الوصول: انتقل إلى /subscribers في لوحة التحكم

الميزات​

  • قائمة التسجيلات: عرض جميع تسجيلات المشتركين النشطة
  • تفاصيل التسجيل: انقر على أي تسجيل لعرض التفاصيل الكاملة بما في ذلك:
    • مستخدم SIP والنطاق
    • URI الاتصال
    • حالة التسجيل وانتهاء الصلاحية
    • معلومات الشبكة (IP، المنفذ، اسم المضيف)
    • تفاصيل المصادقة
    • موقع برج الهاتف المحمول (عند توفره عبر P-Access-Network-Info)
      • MCC/MNC، نوع الراديو، TAC/LAC، معرف البرج
      • الإحداثيات الجغرافية ونطاق التغطية
      • عرض خريطة تفاعلية مدعومة من بيانات OpenStreetMap وOpenCellID

عرض المشتركين

تفاصيل التسجيل

مصدر البيانات​

يتم استعلام بيانات التسجيل مباشرة من قاعدة بيانات تسجيل Sofia، مما يوفر رؤية في الوقت الحقيقي لحالة ارتباط المشتركين. يتم حل مواقع أبراج الهاتف المحمول باستخدام قاعدة بيانات OpenCellID عندما يقدم المشتركون رؤوس P-Access-Network-Info في رسائل SIP REGISTER الخاصة بهم.

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

  • مراقبة تسجيلات المشتركين النشطة
  • التحقق من حالة ارتباط المشتركين
  • استكشاف مشكلات التسجيل
  • تدقيق اتصال المشتركين

سجلات تفاصيل المكالمات (CDR)​

يوفر عرض CDR الوصول إلى سجلات تفاصيل المكالمات المخزنة بواسطة TAS لأغراض الفوترة واستكشاف الأخطاء وتحليل البيانات.

الوصول: انتقل إلى /cdr في لوحة التحكم

عرض CDR

الميزات​

  • عرض مقسم: تصفح سجلات المكالمات (100 لكل صفحة مع عناصر التحكم ��لسابقة/التالية)
  • بحث متقدم: بحث قوي يدعم المطابقة الدقيقة، العكس/الاستبعاد، والعديد من المصطلحات
  • اختيار الأعمدة: تخصيص الحقول المعروضة
    • انقر على زر "الأعمدة" لفتح نافذة اختيار الأعمدة
    • حدد/ألغِ تحديد الأعمدة الفردية
    • إجراءات سريعة تحديد الكل / إلغاء تحديد الكل
    • يستمر الاختيار عبر الجلسات (يتم حفظه في التخزين المحلي للمتصفح)
    • يظهر عداد "X / Y الأعمدة"
  • أعمدة قابلة للفرز: انقر على أي رأس عمود للفرز (تصاعدي/تنازلي)
    • مؤشرات بصرية (▲ تصاعدي، ▼ تنازلي)
    • العمود المفروز مميز باللون الأزرق
    • يعيد تعيين إلى الصفحة 1 عند تغيير الفرز
  • خيارات تصفية متعددة:
    • بحث نصي: البحث عبر جميع الحقول مع مشغلات متقدمة
    • تصفية نطاق التاريخ: التصفية حسب تاريخ ووقت البدء/الانتهاء (اختيار التاريخ والوقت)
    • تصفية محددة للحقل: التصفية حسب القيمة الدقيقة للحقل (سبب الإنهاء، معرف المتصل، الوجهة، السياق)
    • عرض التصفية النشطة: تظهر شرائح بصرية توضح الفلاتر النشطة حاليًا
    • مسح الكل: إزالة جميع الفلاتر النشطة بنقرة واحدة
  • معلومات مفصلة: انقر على أي صف CDR للتوسع وعرض جميع الحقول:
    • أطراف المكالمة (اسم/رقم معرف المتصل، رقم الوجهة)
    • الطوابع الزمنية (البداية، الإجابة، النهاية)
    • المدة والثواني المفوترة
    • سبب الإنهاء (ملون: أخضر=طبيعي، أصفر=ملغى، أحمر=خطأ)
    • UUIDs المكالمات (A-leg وB-leg)
    • السياق ورمز الحساب
    • جميع الحقول المتاحة في قاعدة البيانات بترتيب أبجدي
  • أسباب الإنهاء الملونة:
    • 🟢 أخضر: NORMAL_CLEARING
    • 🟡 أصفر: المكالمات الملغاة
    • 🔴 أحمر: ظروف الخطأ
  • العدد الإجمالي: عرض في الوقت الحقيقي لعدد السجلات المطابقة الإجمالية
  • تصميم متجاوب: تتناسب الفلاتر بشكل مناسب على ال��اشات الأصغر

كيفية الاستخدام​

  1. عرض أساسي:

    • يتم تحميل الصفحة مع أحدث 100 سجل CDR (مرتبة حسب start_stamp تنازليًا)
    • يتم عرض العدد الإجمالي للسجلات في الزاوية العلوية اليمنى
    • استخدم أزرار السابق / التالي للتنقل بين الصفحات
    • انقر على أي صف للتوسع ورؤية جميع الحقول

  2. تخصيص الأعمدة:

    • انقر على زر "الأعمدة" في الزاوية العلوية اليمنى
    • تظهر نافذة تحتوي على جميع الحقول المتاحة
    • حدد/ألغِ تحديد الحقول لعرض/إخفاء الأعمدة
    • استخدم "تحديد الكل" أو "إلغاء تحديد الكل" للاختيار السريع
    • يتم حفظ الإعدادات تلقائيًا في المتصفح
    • أغلق النافذة لتطبيق التغييرات

  3. فرز البيانات:

    • انقر على أي رأس عمود للفرز حسب هذا الحقل
    • النقر الأول: تنازلي (▼)
    • النقر الثاني: تصاعدي (▲)
    • النقر الثالث: العودة إلى التنازلي
    • العمود المفروز مميز باللون الأزرق

  4. البحث عن السجلات:

    • أدخل استعلام البحث في مربع "البحث"
    • يدعم مشغلات متقدمة (انظر بناء جملة البحث أدناه)
    • يبحث عبر عدة حقول: caller_id_number، destination_number، uuid، caller_id_name، hangup_cause
    • انقر على "تطبيق" لتنفيذ البحث

  5. تصفية حسب نطاق التاريخ:

    • استخدم اختيارات التاريخ "تاريخ البدء" و**"تاريخ الانتهاء"**
    • يتطلب كلا التاريخين لتصفية التاريخ
    • يدعم اختيار التاريخ والوقت
    • انقر على "تطبيق" للتصفية

  6. تصفية حسب حقل محدد:

    • اختر الحقل من قائمة "اختر الحقل للتصفية":
      • سبب الإنهاء
      • معرف المتصل
      • الوجهة
      • السياق
    • أدخل القيمة الدقيقة في "أدخل قيمة التصفية"
    • انقر على "تطبيق" للتصفية

  7. دمج الفلاتر:

    • يمكن استخدام جميع الفلاتر في وقت واحد:
      • يعمل البحث النصي + نطاق التاريخ + تصفية الحقل معًا
    • تظهر الفلاتر النشطة كشرائح أسفل نموذج التصفية
    • انقر على "مسح الكل" لإزالة جميع الفلاتر دفعة واحدة

  8. عرض التفاصيل:

    • انقر على أي صف CDR للتوسع
    • يظهر جميع حقول قاعدة البيانات في تخطيط شبكي
    • يتم عرض الحقول بترتيب أبجدي
    • سبب الإنهاء ملون لتسهيل التعرف السريع
    • انقر على الصف مرة أخرى للانهيار

بناء جملة البحث المتقدم​

يدعم مربع البحث بناء جملة قوي لاستعلام دقيق لتصفية السجلات عبر عدة حقول في وقت واحد.

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

يتحقق محرك البحث من جميع الحقول القابلة للبحث في كل سجل CDR. يتم تضمين السجل في النتائج عندما يتطابق مع معايير البحث الخاصة بك في أي من هذه الحقول:

  • caller_id_number
  • destination_number
  • uuid
  • caller_id_name
  • hangup_cause

مشغلات البحث (يمكن دمجها):

  1. بحث يحتوي (افتراضي):

    • بناء الجملة: term (بدون علامات اقتباس)
    • المطابقة: سجلات حيث أي حقل يحتوي على المصطلح في أي مكان ضمنه
    • SQL: يستخدم LIKE '%term%' عبر جميع الحقول القابلة للبحث مرتبطة بـ OR
    • مثال: 61480 يتطابق مع "61480123456"، "55561480999"، إلخ.

  2. مطابقة دقيقة:

    • بناء الجملة: "term" (مع علامات اقتباس مزدوجة)
    • المطابقة: سجلات حيث أي حقل يساوي بالضبط المصطلح
    • SQL: يستخدم = 'term' عبر جميع الحقول القابلة للبحث مرتبطة بـ OR
    • مثال: "911" يتطابق فقط مع "911" بالضبط، وليس "9115" أو "1911"

  3. عكس/استبعاد:

    • بناء الجملة: !term (علامة تعجب في المقدمة، بدون علامات اقتباس)
    • المطابقة: سجلات حيث لا حقل يحتوي على المصطلح
    • SQL: يستخدم NOT LIKE '%term%' عبر جميع الحقول القابلة للبحث مرتبطة بـ AND
    • مثال: !NORMAL يستبعد أي سجل يحتوي على "NORMAL" في أي حقل

  4. عكس دقيق/استبعاد:

    • بناء الجملة: !"term" (علامة تعجب + علامات اقتباس مزدوجة)
    • المطابقة: ��جلات حيث لا حقل يساوي بالضبط المصطلح
    • SQL: يستخدم != 'term' عبر جميع الحقول القابلة للبحث مرتبطة بـ AND
    • مثال: !"NORMAL_CLEARING" يستبعد السجلات حيث أي حقل يساوي بالضبط "NORMAL_CLEARING"

  5. مصطلحات متعددة مع AND:

    • بناء الجملة: term1 AND term2 (AND غير حساسة لحالة الأحرف)
    • المطابقة: سجلات تتطابق مع جميع المصطلحات (يمكن أن تتطابق كل مصطلح مع حقول مختلفة)
    • تتم معالجة كل مصطلح بمشغل خاص به (علامات الاقتباس، !، إلخ.)
    • يتم دمج المصطلحات مع AND في SQL
    • مثال: "911" AND "12345" يجد السجلات التي تحتوي على "911" في حقل واحد و "12345" في آخر

منطق تنفيذ البحث:

لكل سجل CDR:
  للبحث العادي (بدون !):
    - تحقق مما إذا كان أي حقل يحتوي/يساوي المصطلح → تضمين إذا كان TRUE
    - SQL: field1 LIKE '%term%' OR field2 LIKE '%term%' OR ...

  للبحث العكسي (!):
    - تحقق مما إذا كانت جميع الحقول لا تحتوي/تساوي المصطلح → تضم��ن إذا كان TRUE
    - SQL: field1 NOT LIKE '%term%' AND field2 NOT LIKE '%term%' AND ...

  للبحث باستخدام AND:
    - يتم تقييم كل مصطلح بشكل منفصل
    - يجب أن تكون جميع شروط المصطلحات TRUE → تضمين إذا كان TRUE
    - SQL: (term1_conditions) AND (term2_conditions) AND ...

أمثلة بحث معقدة:

الاستعلامكيف يعملالنتيجة
61480بحث يحتوي عبر جميع الحقولجميع السجلات التي تحتوي على "61480" في أي مكان (المتصل، الوجهة، UUID، إلخ.)
"911"مطابقة دقيقة عبر جميع الحقولسجلات حيث أي حقل يساوي بالضبط "911"
!NORMAL_CLEARINGبحث عكسي يحتوييستبعد السجلات التي تحتوي على "NORMAL_CLEARING" في أي حقل (المكالمات الفاشلة)
!"NORMAL_CLEARING"عكس دقيقيستبعد السجلات حيث أي حقل يساوي بالضبط "NORMAL_CLEARING"
"911" AND "12345""911" دقيقة و "12345" دقيقةسجلات تحتوي على كلا القيمتين (مثل، المتصل="12345"، الوجهة="911")
!NORMAL AND 61480عكس يحتوي "NORMAL" و يحتوي "61480"مكالمات غير طبيعية تتضمن "61480"
!"ANSWER" AND !NORMALعكس دقيق "ANSWER" و عكس يحتوي "NORMAL"استبعاد المكالمات التي تم الرد عليها وأي شيء يحتوي على "NORMAL"
61480 AND !NORMAL_CLEARINGيحتوي على "61480" و عكس يحتوي "NORMAL_CLEARING"المكالمات الفاشلة التي تتضمن "61480"

حالات الاستخدام العملية:

  • البحث عن رقم محدد: 61480123456 - بحث يحتوي يجد المطابقات الجزئية
  • البحث عن مكالمات الطوارئ الدقيقة: "911" - فقط المكالمات إلى "911" بالضبط
  • جميع المكالمات الفاشلة: !NORMAL_CLEARING - استبعاد المكالمات الناجحة
  • مكالمات فاشلة لمتصل محدد: "61480123456" AND !NORMAL - دمج المتصل الدقيق مع العكس
  • استبعاد أرقام الاختبار: !test AND !demo - عمليات بحث عكسية متعددة
  • استكشاف الأخطاء المعقدة: 61480 AND !"ANSWER" AND !CANCEL - يحتوي على مصطلح واحد، استبعاد الآخرين بدقة وجزئية

مصدر البيانا��​

يتم استعلام بيانات CDR مباشرة من قاعدة بيانات CDR SQLite الخاصة بـ TAS.

قد يختلف المخطط بين النشر بناءً على المتطلبات المحددة.

خيارات تصدير CDR​

مهم: يمكن تصدير سجلات CDR بتنسيقات مختلفة لدعم التكامل مع أنظمة الفوترة، ومنصات التحليل، وأدوات التقارير.

يختلف مخطط قاعدة بيانات CDR وتنسيقات التصدير حسب النشر. عند إعداد النظام الخاص بك، يرجى طلب تنسيقات إخراج CDR المحددة التي تحتاجها من مهندس التكامل الخاص بك. تشمل تنسيقات التصدير الشائعة:

  • CSV (قيم مفصولة بفواصل)
  • JSON (لتكامل API)
  • XML
  • الوصول المباشر إلى قاعدة البيانات
  • تصديرات بتنسيق مخصص

يمكن لمهندس التكامل الخاص بك تكوين آليات تصدير CDR مصممة وفقًا لمتطلباتك التشغيلية والفوترة.

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

  • استكشاف أخطاء المكالمات: البحث عن مكالمات محددة حسب الرقم أو UUID لاستكشاف المشكلات
  • تسوية ��لفوترة: التصفية حسب نطاق التاريخ لمطابقة فترات الفوترة
  • تحليل الجودة: التصفية حسب سبب الإنهاء لتحديد أنماط المشاكل
  • تدقيق مكالمات الطوارئ: البحث عن "911" للتحقق من معالجة مكالمات الطوارئ
  • دعم العملاء: البحث عن مكالمات العملاء المحددين حسب معرف المتصل أو الوجهة
  • تحليل الأنماط: الفرز حسب المدة أو الطوابع الزمنية لتحديد الشذوذ
  • الامتثال والاحتفاظ بالسجلات: فلاتر نطاق التاريخ للتقارير التنظيمية
  • تحليل المكالمات الفاشلة: استخدام !NORMAL_CLEARING للعثور على جميع المكالمات الفاشلة
  • تقارير قائمة على السياق: التصفية حسب السياق لتحليل تدفقات المكالمات المحددة

التكوين​

الأعمدة المرئية الافتراضية​

يمكنك تكوين الحقول التي يتم عرضها افتراضيًا في LiveView عن طريق تعيين cdrs_field_list في config/runtime.exs الخاص بك:

config :tas,
  cdrs_field_list: [
    "caller_id_number",
    "destination_number",
    "start_stamp",
    "duration",
    "hangup_cause"
  ]

السلوك:

  • إذا لم يتم تعيين cdrs_field_list: يتم عرض جميع حقول CDR المتاحة افتراضيًا
  • إذا تم تعيين cdrs_field_list: يتم عرض الحقول المحددة فقط افتراضيًا، ولكن تظل جميع الحقول الأخرى متاحة في نافذة اختيار الأعمدة
  • إذا كان حقل في القائمة غير موجود في بيانات CDR، فسيتم تخطيه تلقائيًا
  • يمكن تحديد أسماء الحقول كسلاسل نصية أو ذرات
  • يمكن للمستخدمين اختيار أعمدة إضافية يدويًا من نافذة اختيار الأعمدة في أي وقت

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

  • تعيين عرض افتراضي نظيف مع عرض الحقول الأساسية فقط
  • تقليل الحمل المعلوماتي للمستخدمين الجدد
  • توحيد تخطيط الأ��مدة الأولية عبر جميع المستخدمين
  • الاحتفاظ بالحقول المتقدمة مخفية افتراضيًا ولكن لا تزال قابلة للوصول

مثال على التكوين:

# عرض معلومات المكالمة الأساسية فقط افتراضيًا
cdrs_field_list: [
  "start_stamp",
  "caller_id_number",
  "destination_number",
  "duration",
  "billsec",
  "hangup_cause"
]

ملاحظة: يقوم هذا التكوين بتعيين الأعمدة المرئية الافتراضية. تظل جميع حقول CDR متاحة في نافذة "الأعمدة" - يمكن للمستخدمين عرض/إخفاء أي حقل يحتاجونه يدويًا.

استكشاف الأخطاء​

لم يتم العثور على نتائج​
  1. تحقق من الأخطاء المطبعية في مصطلحات البحث
  2. حاول إزالة علامات الاقتباس للبحث بشكل أوسع
  3. تحقق من وجود المصطلح في الحقول القابلة للبحث
  4. تحقق من أن نطاق التاريخ ليس صارمًا جدًا
الكثير من النتائج​
  1. أضف المزيد من مصطلحات AND لتضييق النطاق
  2. استخدم المطابقة الدقيقة مع علا��ات الاقتباس
  3. تطبيق فلاتر نطاق التاريخ
  4. استخدم الفلاتر المحددة للحقل
نتائج غير متوقعة​
  1. تذكر أن البحث ينطبق على جميع الحقول القابلة للبحث
  2. تحقق مما إذا كان المصطلح يظهر في حقل غير متوقع (مثل UUID)
  3. استخدم المطابقة الدقيقة لتجنب المطابقات الجزئية
  4. تحقق من منطق العكس (AND مقابل OR)

نصائح​

  • اختيار الأعمدة: إخفاء الأعمدة غير المستخدمة للتركيز على البيانات ذات الصلة وتحسين الأداء
  • دمج الفلاتر: استخدم البحث + نطاق التاريخ + تصفية الحقل معًا لاستعلامات دقيقة
  • أداء نطاق التاريخ: تعيد نطاقات التاريخ الضيقة نتائج أسرع لقاعدة البيانات الكبيرة
  • الفرز للتحليل: الفرز حسب المدة للعثور على المكالمات الطويلة/القصيرة، أو حسب الطابع الزمني لرؤية أنماط المكالمات
  • شرائح الفلاتر النشطة: استخدم الشرائح المرئية للتحقق من الفلاتر النشطة ��اليًا
  • الإعدادات الدائمة: يتم حفظ اختيارات الأعمدة لكل متصفح، مما يكون مفيدًا لمهام التحليل المختلفة
  • ترميز الألوان: مسح سريع لأسباب الإنهاء - الأخضر جيد، الأحمر يحتاج إلى تحقيق
  • تفاصيل قابلة للتوسع: انقر على الصفوف لرؤية جميع الحقول دون تشويش العرض الرئيسي
  • مشغلات البحث: اتقن بناء جملة البحث لتصفية قوية:
    • استخدم علامات الاقتباس للمطابقات الدقيقة: "911"
    • استخدم ! للاستبعاد: !NORMAL_CLEARING
    • دمج مع AND: "61480" AND !NORMAL
  • التقسيم: تذكر أن الفلاتر تستمر عبر الصفحات - استخدم التقسيم لمراجعة مجموعات النتائج الكبيرة

مراقبة المكالمات النشطة​

يوفر عرض المكالمات النشطة معلومات في الوقت الحقيقي حول المكالمات الجارية عبر النظام.

الوصول: انتقل إلى /calls في لوحة التحكم

الميزات​

  • حالة في الوقت الحقيقي: عرض مباشر لجلسات المكالما�� النشطة
  • تفاصيل المكالمات: عرض متغيرات القناة ومعلومات حالة المكالمة
  • تتبع UUID: مراقبة معرفات المكالمات لكل من A-leg وB-leg

خادم مؤتمرات IMS​

يوفر خادم مؤتمرات IMS قدرات مؤتمرات متعددة الأطراف متوافقة مع معايير IMS الخاصة بـ 3GPP (RFC 4579، RFC 4575، TS 24.147).

الوصول: انتقل إلى /conference في لوحة التحكم

الوثائق: انظر دليل مستخدم خادم مؤتمرات IMS للحصول على وثائق مفصلة

الميزات​

  • مراقبة في الوقت الحقيقي: عرض مباشر للمؤتمرات النشطة والمشاركين
  • لوحة إحصائيات المؤتمر:
    • عدد المؤتمرات النشطة
    • إجمالي المشاركين عبر جميع المؤتمرات
    • عدد مؤتمرات الفيديو
    • عدد المؤتمرات المقفلة
    • تفاصيل تكوين الخادم (النطاق، MNC/MCC، الحد الأقصى للمشاركين)
  • قائمة المؤتمرات: عرض جميع المؤتمرات النشطة مع:
    • معرف المؤتمر وURI SIP
    • عدد المشاركين ��لحاليين
    • هوية منشئ المؤتمر
  • تفاصيل المؤتمر: انقر على أي مؤتمر للتوسع وعرض:
    • معلومات كاملة عن المؤتمر (الحالة، حالة الفيديو، حالة القفل، حالة التسجيل)
    • قائمة كاملة بالمشاركين مع الأدوار والحالات
    • حالة فيديو المشاركين
  • إجراءات التحكم في المؤتمر:
    • قفل/فتح المؤتمرات للتحكم في الوصول
    • تمكين/تعطيل الفيديو للمؤتمرات
    • تحديثات الحالة في الوقت الحقيقي مع ردود الفعل على الإجراءات
  • تحديث تلقائي: تحديث تلقائي قابل للتكوين (افتراضي: 5 ثوانٍ) للمراقبة في الوقت الحقيقي

إدارة وحدة التحكم OmniTAS​

جميع عمليات المؤتمر متاحة أيضًا من خلال وحدة التحكم OmniTAS باستخدام الأمر ims_conference:

ims_conference list                    # قائمة بجميع المؤتمرات النشطة
ims_conference info <conf_id>          # عرض تفاصيل المؤتمر
ims_conference stats                   # عرض إحصائيات الخادم
ims_conference lock <conf_id>          # قفل مؤتمر
ims_conference unlock <conf_id>        # فتح مؤتمر
ims_conference video <conf_id> on|off  # التحكم في الفيديو
ims_conference record <conf_id> start|stop  # التحكم في التسجيل
ims_conference add <conf_id> <sip_uri>     # إضافة مشارك
ims_conference remove <conf_id> <uuid>     # إزالة مشارك
ims_conference destroy <conf_id>       # إنهاء المؤتمر

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

  • المراقبة التشغيلية: رؤية في الوقت الحقيقي للمؤتمرات النشطة واستخدام الموارد
  • إدارة السعة: مراقبة عدد المشاركين واستخدام الفيديو لإدارة النطاق الترددي
  • استكشاف الأخطاء: تشخيص مشكلات الوصول إلى المؤتمر، ومشاكل اتصال المشاركين
  • تحكم المؤتمر: قفل المؤتمرات للخصوصية، إدارة الفيديو للتحكم في النطاق الترددي
  • الامتثال: مراقبة وتسجيل المؤتمرات للامتثال التنظيمي

الامتثال لـ 3GPP​

ينفذ خادم المؤتمر المواصفات الأساسية لمؤتمرات IMS الخاصة بـ 3GPP:

  • TS 24.147: المؤتمرات باستخدام نظام الشبكة الأساسية IM
  • RFC 4579: SIP Call Control - المؤتمرات لوكلاء المستخدمين
  • RFC 4575: حزمة أحداث SIP لحالة المؤتمر
  • RFC 5239: إطار عمل للمؤتمرات المركزية

حالة البوابة​

راقب حالة وصحة بوابات SIP/الخطوط المتصلة بـ TAS.

الوصول: انتقل إلى /gw في لوحة التحكم

الميزات​

  • حالة التسجيل: عرض حالة تسجيل البوابة
  • إحصائيات المكالمات: تتبع المكالمات الواردة/الصادرة والفشل
  • مراقبة Ping: أوقات Ping SIP OPTIONS وقابلية الوصول
  • تفاصيل البوابة: معلومات كاملة عن التكوين والحالة

القياسات المراقبة​

  • حالة تسجيل SIP
  • وقت Ping (متوسط وقت استجابة SIP OPTIONS)
  • وقت التشغيل (الثواني منذ إعادة تشغيل الملف الشخصي)
  • المكالمات الواردة / المكالمات الصادرة
  • المكالمات الفاشلة الواردة / المكالمات الفاشلة الصادرة
  • آخر وقت Ping وتكرار

حالة نظير Diameter​

راقب اتصال نظير Diameter لواجهات Sh وRo.

الوصول: انتقل إلى /diameter في لوحة التحكم

الميزات​

  • حالة النظير: حالة الاتصال لكل نظير تم تكوينه
  • دعم التطبيق: عرض التطبيقات المدعومة من Diameter (Sh، Ro)
  • حالة مراقبة Watchdog: مراقبة Watchdog Diameter

عارض سجلات النظام​

عارض سجلات موحد في الوقت الحقيقي لكل من TAS Backend (Elixir) وTAS Call Processing (FreeSWITCH).

الوصول: انتقل إلى /logs في لوحة التحكم

عرض السجلات

الميزات​

  • تدفق السجلات الموحد: عرض السجلات من كل من TAS Backend وCall Processing في واجهة واحدة
  • تحديثات في الوقت الحقيقي: بث مباشر لرسائل السجل أثناء حدوثها (تحديث تلقائي كل 1 ثانية)
  • مستويات السجل الملونة:
    • 🟣 الكونسول - رسائل خاصة بالكونسول (بنفسجي/ماجنتا)
    • 🔴 تنبيه/حرج - مشكلات عاجلة تتطلب اهتمامًا فوريًا (أحمر)
    • 🟠 خطأ - ظروف الخطأ (أحمر فاتح)
    • 🟡 تحذي�� - رسائل تحذيرية (أصفر)
    • 🔵 إشعار - رسائل معلوماتية ملحوظة (سماوي)
    • 🔵 معلومات - رسائل معلوماتية عامة (أزرق)
    • ⚪ تصحيح - سجلات تصحيح/تفصيلية (رمادي)
  • شارات المصدر:
    • 🔵 TAS Backend - سجلات تطبيق Elixir (شارة زرقاء)
    • 🟣 TAS Call Processing - سجلات FreeSWITCH (شارة بنفسجية)
  • مؤشرات الحدود اليسرى: حدود يسارية ملونة تتطابق مع مستوى السجل للتمكين من المسح البصري السريع
  • فلاتر متعددة:
    • فلتر المصدر: جميع المصادر / TAS Backend / TAS Call Processing
    • فلتر المستوى: جميع / كونسول / تنبيه / حرج / خطأ / تحذير / إشعار / معلومات / تصحيح
    • بحث نصي: بحث عن الكلمات الرئيسية في الوقت الحقيقي عبر رسائل السجل
  • إيقاف/استئناف: تجميد بث السجل لتحليل إدخالات معينة دون فقدان السياق
  • مسح السجلات: إزالة جميع إدخالات السجل الحالية من العرض
  • عداد السجلات: يظهر السجلات المصفاة مقابل السجلات الإجمالية (مثل "عرض 150 من 500 سجل")
  • سلوك الذيل: يحتفظ بآخر 500 إدخال سجل لأداء أفضل
  • عرض البيانات الوصفية: اسم الملف ورقم السطر لمراجع الشيفرة المصدرية (عند توفرها)
  • عرض قابل للتمرير: حاوية ثابتة الارتفاع مع تمرير تلقائي لأحدث السجلات

كيفية الاستخدام​

  1. عرض أساسي:

    • يتم تحميل الصفحة مع أحدث 500 إدخال سجل من كلا المصدرين
    • تظهر السجلات في الوقت الحقيقي كما يتم إنشاؤها
    • تظهر أحدث السجلات في الأعلى
    • يتم تحديثها تلقائيًا كل 1 ثانية

  2. تصفية حسب المصدر:

    • اختر من قائمة "المصدر":
      • جميع المصادر - عرض سجلات TAS Backend وCall Processing
      • TAS Backend - سجلات تطبيق Elixir فقط
      • TAS Call Processing - سجلات FreeSWITCH/خطة الاتصال فقط
    • يتم تطبيق الفلتر على الفور

  3. تصفية حسب مستوى السجل:

    • اختر من قائمة "المستوى":
      • الجميع - عرض جميع مستويات السجل
      • الكونسول حتى التصحيح - عرض فقط ذلك المستوى المحدد
    • مفيد للتركيز على الأخطاء أو تصحيح مشكلات محددة

  4. البحث عن الكلمات الرئيسية:

    • اكتب في مربع "بحث السجلات..."
    • بحث غير حساس لحالة الأحرف عبر رسائل السجل
    • يتم تصفية النتائج في الوقت الحقيقي أثناء الكتابة
    • يجمع مع فلاتر المصدر والمستوى

  5. إيقاف/استئناف البث:

    • انقر على زر "إيقاف" (برتقالي) لتجميد تحديثات السجل
    • يظهر مؤشر "موقوف" في الرأس
    • مراجعة إدخالات سجل معينة دون مقاطعة سجلات جديدة
    • انقر على زر "استئناف" (أخضر) لإعادة تشغيل البث المباشر

  6. مسح السجلات:

    • انقر على زر "مسح" (أحمر) لإزالة جميع السجلات المعروضة
    • يمسح كل من سجلات TAS Backend وCall Processing
    • ستظهر سجلات جديدة كما يتم إنشاؤها

  7. قراءة إدخالات السجل:

    • الطابع الزمني: يظهر الوقت بتنسيق HH:MM:SS.ميلي ثانية
    • شارة المصدر: تشير إلى TAS Backend (أزرق) أو Call Processing (بنفسجي)
    • مستوى السجل: مستوى ملون داخل الأقواس [خطأ]، [معلومات]، إلخ.
    • الملف/السطر: موقع الشيفرة المصدرية (عند توفرها)
    • الرسالة: محتوى رسالة السجل الفعلي

مستويات السجل موضحة​

المستوىاللونعند الاستخدامالمثال
الكونسولبنفسجيرسائل خاصة بالكونسولمخرجات كونسول FreeSWITCH ذات الأولوية العالية
تنبيهأحمريتطلب إجراء فوريفشل مكون النظام
حرجأحمرظروف حرجةفقدان اتصال قاعدة البيانات
خطأأحمر فاتحظروف الخطأفشل في معالجة المكالمة، تكوين غير صالح
تحذيرأصفرظروف التحذيراستخدام دالة مهجورة، محاولة إعادة
إشعارسماويأحداث ملحوظة عاديةإعادة تحميل التكوين، بدء الخدمة
معلوماتأزرقرسائل معلوماتيةتم الاتصال بالمكالمة، تم إرسال طلب Diameter
تصحيحرماديرسائل مستوى التصحيحدخول/خروج الدالة، قيم المتغيرات

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

  • استكشاف الأخطاء في الوقت الحقيقي: مراقبة السجلات أثناء المكالمة النشطة لاستكشاف المشكلات
  • تحقيق الأخطاء: تصفية بمستويات الخطأ/الحرج للعثور على المشكلات
  • تحليل تدفق المكالمات: البحث عن Call-ID أو رقم الهاتف لتتبع مسار المكالمة
  • مراقبة الأداء: مراقبة التحذيرات والأخطاء أثناء اختبار التحميل
  • استكشاف تكامل: تصفية TAS Backend لرؤية رسائل Diameter/Sh/Ro
  • استكشاف خطة الاتصال: تصفية TAS Call Processing لرؤية توجيه المكالمات في FreeSWITCH
  • مراقبة صحة النظام: الاحتفاظ بالسجلات مفتوحة لمراقبة الشذوذ
  • التطوير والاختبار: استخدام مستوى التصحيح لرؤية سلوك التطبيق التفصيلي

نصائح​

  • دمج الفلاتر: استخدم المصدر + المستوى + البحث معًا للتصفية الدقيقة
    • مثال: المصدر="TAS Backend" + المستوى="خطأ" + البحث="Diameter" → العثور على أخطاء Diameter
  • توقف قبل البحث: أوقف البث قبل كتابة استعلام البحث لتجنب تمرير السجلات
  • استخدام التصحيح بحكمة: مستوى التصحيح مفصل - قم بتصفية المصدر المحدد لتقليل الضوضاء
  • المسح اللوني: المسح السريع للحدود اليسرى - الحدود الحمراء تشير إلى المشكلات
  • شارات المصدر: شارات زرقاء (Backend) للمنطق التطبيقي، شارات بنفسجية (Call Processing) للمكالمات
  • دقة الطابع الزمني: تساعد الطوابع الزمنية بالميلي ثانية في مطابقة الأحداث عبر الأنظمة
  • مراجع الملفات: انقر/لاحظ مراجع الملف:السطر للقفز إلى الشيفرة المصدرية
  • مسح بانتظام: امسح السجلات عند تغيير سياقات التحقيق من أجل الوضوح
  • البحث عن UUIDs: ابحث عن Call-ID/UUID لمتابعة مكالمة ��عينة عبر النظام بأكمله
  • البحث الطارئ: ابحث عن "911" أو "طارئ" للعثور بسرعة على معالجة مكالمات الطوارئ

التفاصيل الفنية​

  • حد السجل: الحد الأقصى لعرض 500 سجل (يتم التخلص من الأقدم عند الوصول إلى الحد)
  • معدل التحديث: تحديث تلقائي كل 1000 مللي ثانية (1 ثانية)
  • البحث: مطابقة فرعية غير حساسة لحالة الأحرف على حقل الرسالة فقط
  • تصفية فارغة: يتم تلقائيًا تصفية رسائل السجل الفارغة/النموذجية
  • كشف المصدر: يتم وضع علامات على السجلات بـ :elixir أو :freeswitch كمصدر
  • الفرز: يتم فرز السجلات حسب الطابع الزمني تنازليًا (الأحدث أولاً)
  • PubSub: يتم تسليم سجلات Elixir عبر Phoenix PubSub للتحديثات في الوقت الحقيقي
  • سجلات FreeSWITCH: يتم جمعها عبر واجهة مقبس الحدث (ESI) لمستمع سجل السجل

قاعدة بيانات أبراج الهاتف المحمول​

إدارة واستعلام قاعدة بيانات مواقع أبراج الها��ف المحمول OpenCellID لخدمات الطوارئ والميزات المعتمدة على الموقع.

الوصول: انتقل إلى /cell_towers في لوحة التحكم

قاعدة بيانات أبراج الهاتف المحمول

الميزات​

  • إحصائيات قاعدة البيانات: عرض إجمالي السجلات، التغطية حسب البلد/الشبكة
  • البحث والاستعلام:
    • البحث حسب MCC (رمز البلد المحمول)
    • البحث حسب MNC (رمز الشبكة المحمولة)
    • البحث حسب نوع الراديو (GSM، UMTS، LTE)
    • البحث حسب سلسلة الموقع
  • إدارة قاعدة البيانات:
    • استيراد بيانات أبراج الهاتف المحمول
    • إعادة تنزيل أحدث مجموعة بيانات من OpenCellID
    • عرض حالة الاستيراد والتقدم
  • حل الموقع: حل معرفات الأبراج إلى إحداثيات جغرافية

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

  • تحديد موقع مكالمات الطوارئ
  • تتبع موقع المشتركين (بموافقتهم)
  • تحليل تغطية الشبكة
  • استكشاف مشكلات الموقع أثناء التجوال
  • صيانة قاعدة بيانات أبراج الهاتف المحمول

مصدر البيانات​

تستمد بيانات أبراج الهاتف المحمول من OpenCellID (https://opencellid.org/)، وهو مشروع مجتمعي تعاوني لإنشاء قاعدة بيانات مجانية لمواقع أبراج الهاتف المحمول في جميع أنحاء العالم.

محاكي المكالمات​

أداة محاكاة المكالمات التفاعلية لاختبار منطق خطة الاتصال دون إجراء مكالمات حقيقية.

الوصول: انتقل إلى /simulator في لوحة التحكم

وثائق مفصلة: انظر دليل HLR ومحاكي المكالمات

الميزات​

  • محاكاة أنواع المكالمات: اختبار المكالمات MO، MT، والطوارئ
  • معلمات قابلة للتكوين:
    • أرقام المصدر والوجهة
    • عنوان IP المصدر (لتمثيل SBC/CSCF)
    • فرض تصرف مكالمة محدد
    • تخطي تفويض OCS للاختبار الأسرع
  • نتائج شاملة:
    • مخرجات متغيرات خطة الاتصال الكاملة
    • نتائج بحث Sh/HLR
    • نتيجة تفويض OCS
    • نتائج استعلام SS7 MAP (إذا كان ذلك مناسبًا)
    • XML خطة الاتصال المولدة
  • معالجة خطوة بخطوة: عرض كل مرحلة من مراحل معالجة المكالمة

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

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

اختبار HLR/MAP​

اختبار عمليات SS7 MAP بما في ذلك استعلام إرسال معلومات التوجيه (SRI) واستعلام توفير رقم التجوال (PRN).

الوصول: انتقل إلى /hlr في لوحة التحكم

وثائق مفصلة: انظر دليل HLR ومحاكي المكالمات

الميزات​

  • استعلام SRI: اختبار إرسال معلومات التوجيه لتوجيه المكالمات
  • استعلام PRN: اختبار توفير رقم التجوال للمشتركين المتجولين
  • نتائج حقيقية: استعلامات فعلية إلى بوابة MAP المكونة
  • عرض الاستجابة: عرض MSRN، عنوان MSC، وحالة التوجيه
  • معالجة الأخطاء: عرض واضح لأخطاء MAP ووقت الانتظار

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

  • التحقق من اتصال HLR
  • اختبار تخصيص رقم التجوال
  • استكشاف توجيه المكالمات إلى المشتركين المتجولين
  • التحقق من تكوين بوابة MAP
  • استكشاف مشكلات تحويل المكالمات

اختبار OCS​

اختبار عمليات CCR (طلب التحكم في الائتمان) Diameter Ro (الشحن عبر الإنترنت) مباشرة ضد OCS الخاص بك.

الوصول: انتقل إلى /ocs_test في لوحة التحكم

عرض اختبار OCS

الميزات​

  • أنواع CCR مرنة: إرسال طلبات INITIAL، UPDATE، TERMINATION، أو EVENT
  • محاكاة الجلسة: إعادة استخدام نفس Call ID لمحاكاة دورة حياة جلسة كاملة
  • اختيار نوع الحدث: اختبار كل من الشحن SMS (المعتمد على الحدث) والمكالمات (المعتمدة على الجلسة)
  • التحكم في الاتجاه: اختبار كل من السيناريوهات الصادرة (MO) والواردة (MT)
  • معلمات اختيارية: تحديد Destination-Host واسم المستخدم للاختبار المتقدم
  • نتائج في الوقت الحقيقي: عرض استجابات CCA (إجابة التحكم في الائتمان) الكاملة

كيفية الاستخدام​

  1. إدخال معلمات الاختبار:

    • MSISDN المدعو: رقم الوجهة (مثل 61400123456)
    • MSISDN المتصل: الرقم الأصلي (مثل 61400987654)
    • نوع الحدث: اختر sms أو call
      • SMS افتراضيًا إلى EVENT_REQUEST (النوع 4)
      • المكالمة افتراضيًا إلى INITIAL_REQUEST (النوع 1)
    • الاتجاه: out لـ MO أو in لـ MT

  2. تكوين نوع CCR:

    • Request-Type: حدد نوع CCR:
      • 1 — INITIAL_REQUEST - بدء جلسة جديدة
      • 2 — UPDATE_REQUEST - إعادة تفويض منتصف الجلسة
      • 3 — TERMINATION_REQUEST - إنهاء الجلسة والإبلاغ عن الاستخدام
      • 4 — EVENT_REQUEST - حدث لمرة واحدة (SMS، حدث فوري)
    • Request-Number: يبدأ من 1، يزيد مع كل طلب في نفس الجلسة

  3. اختبار الجلسة:

    • Call ID: معرف فريد يتم إنشاؤه تلقائيًا للربط
    • انقر على "معرف جديد" لإنشاء Call ID جديد للاختبار الجديد
    • احتفظ بنفس Call ID لمحاكاة جلسة كاملة:
      • الطلب الأول: INITIAL_REQUEST (النوع 1، الرقم 1)
      • منتصف الجلسة: UPDATE_REQUEST (النوع 2، الرقم 2، 3، 4...)
      • الطلب النهائي: TERMINATION_REQUEST (النوع 3، الرقم N+1)

  4. خيارات متقدمة:

    • Destination-Host: استهداف عقدة OCS معينة (اختياري)
    • اسم المستخدم: تجاوز معرف المشترك (اختياري)

  5. تشغيل ومراجعة:

    • انقر على "تشغيل CCR" لإرسال الطلب
    • عرض الاستجابة الكاملة لـ CCA مع جميع AVPs
    • تحقق من رمز النتيجة، الوحدات الممنوحة، ووقت الصلاحية
    • يظهر الطابع الزمني لآخر تشغيل في الزاوية العلوية اليمنى

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

  • اختبار اتصال OCS: التحقق من الاتصال Diameter Ro والمصادقة
  • منطق التحكم في الائتمان: اختبار تخصيص الائتمان، الاستهلاك، وسيناريوهات الاستنفاد
  • اختبار تدفق الجلس��: محاكاة دورة حياة المكالمة الكاملة (INITIAL → UPDATE → TERMINATION)
  • التحقق من التصنيف: التحقق من معدلات الشحن الصحيحة لمجموعات الأرقام المختلفة
  • اختبار الفشل: اختبار تكرار OCS من خلال استهداف Destination-Host معين
  • استكشاف تكامل: استكشاف مشكلات تكامل OCS مع فحص AVP مفصل
  • التحضير لاختبار التحميل: التحقق من سلوك OCS قبل اختبار التحميل
  • تجاوز رقم الطوارئ: التحقق من أن أرقام الطوارئ تتجاوز الشحن بشكل صحيح

نصائح​

  • استخدم نفس Call ID مع زيادة Request-Numbers لاختبار استمرارية الجلسة
  • راقب سجلات OCS في الوقت نفسه لمطابقة طلبات الاختبار
  • اختبر طلبات UPDATE للتحقق من منطق إعادة التفويض في منتصف الجلسة
  • تحقق من أن طلبات TERMINATION تغلق الجلسات بشكل صحيح وتمنع التسريبات
  • اختبر استنفاد الائتمان عن طريق إرسال طلبات UPDATE بعد استهلاك الوحدات الممنوحة

اختبار واجهة Sh​

اخ��بار عمليات User-Data-Request (UDR) Diameter Sh لاسترداد بيانات ملف تعريف المشترك من HSS.

الوصول: انتقل إلى /sh_test في لوحة التحكم

عرض اختبار Sh

الميزات​

  • مراجع بيانات متعددة: استعلام عن أكثر من 20 نوعًا مختلفًا من بيانات المشتركين
  • استعلامات HSS حقيقية: طلبات Diameter Sh حية إلى HSS المكونة
  • عرض الاستجابة الكاملة: عرض بيانات المشترك الكاملة XML وAVPs
  • تتبع الجلسة: يظهر اسم مضيف HSS، النطاق، ومعرف الجلسة
  • معالجة الأخطاء: عرض واضح لرموز نتائج Diameter وظروف الخطأ

كيفية الاستخدام​

  1. إدخال الهوية العامة:

    • الهوية العامة: هوية المشترك IMS العامة
    • التنسيق: sip:61400123456@ims.mncXXX.mccXXX.3gppnetwork.org
    • يمكن أيضًا استخدام التنسيق tel:+61400123456

  2. اختيار مرجع البيانات: اختر نوع بيانات المشترك لاستردادها:

    • RepositoryData (0): ملف تعريف المشترك الكامل
    • IMSPublicIdentity (10): قائمة الهويات العامة
    • IMSUserState (11): حالة التسجيل
    • S-CSCFName (12): S-CSCF المعين
    • InitialFilterCriteria (13): مشغلات iFC لخوادم التطبيقات
    • LocationInformation (14): الموقع الحالي
    • ChargingInformation (16): عناوين P-Charging
    • MSISDN (17): رقم الهاتف
    • IMSI (32): هوية المشترك الدولي المحمول
    • IMSPrivateUserIdentity (33): الهوية الخاصة بالمستخدم
    • والعديد غيرها...

  3. تشغيل ومراجعة:

    • انقر على "Fetch SH Data" لإرسال طلب UDR
    • عرض الاستجابة الكاملة لـ User-Data-Answer (UDA)
    • تحقق من XML ملف تعريف المشترك، بيانات الخدمة، وقواعد iFC
    • تظهر بيانات الجلسة أي HSS استجاب

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

  • التحقق من المشترك: تأكيد أن المشترك موجود في HSS
  • استكشاف iFC: مراجعة معايير التصفية الأولية ونقاط التحفيز
  • استكشاف التسجيل: تحقق من حالة المستخدم وتعيين S-CSCF
  • تكوين الشحن: التحقق من عناوين P-Charging-Function
  • اختبار اتصال HSS: التحقق من الاتصال Diameter Sh
  • التحقق من الملف الشخصي: التأكد من تعيين ملف الخدمة الصحيح
  • اختبار التكامل: اختبار تكامل HSS بعد تغييرات التوفير
  • تحليل التجوال: تحقق من معلومات الموقع والشبكة الخدمية

نصائح​

  • استخدم IMSPublicIdentity (10) لرؤية جميع الأسماء المستعارة لمشترك
  • استخدم RepositoryData (0) للحصول على ملف تعريف المشترك الكامل في استعلام واحد
  • تحقق من IMSUserState (11) للتحقق مما إذا كان المشترك مسجلاً
  • InitialFilterCriteria (13) تظهر أي خوادم تطبيقات سيتم تحفيزها
  • يمكن استخدام معرف الجلسة لمطابقة الاستعلامات في سجلات HSS
  • تتضمن استجابات الأخطاء رموز نتائج Diameter (مثل، 5001 = المستخدم غير معروف)

اختبار ترجمة الأرقام​

اختبار قواعد ترجمة الأرقام والتنسيق دون إجراء مكالمات فعلية.

الوصول: انتقل إلى /translate في لوحة التحكم

عرض ترجمة الأرقام

الميزات​

  • ترجمة في الوقت الحقيقي: الترجمة التلقائية أثناء الكتابة
  • دعم رمز البلد: اختبار سياقات رمز البلد المختلفة
  • مدرك للتصرف: تطبيق قواعد مختلفة بناءً على تصرف المكالمة
  • نتائج حية: ردود فورية مع الرقم المترجم
  • معلومات تصحيح: عرض القيم العائدة الخام لاستكشاف الأخطاء

كيفية الاستخدام​

  1. تكوين المعلمات:

    • رمز البلد: سياق الاتصال (مثل AU، US، NZ)
      • الافتراضي هو رمز البلد المكون في config/runtime.exs
      • يقبل التنسيقات: AU، :AU، au
    • رقم الهاتف: الرقم المراد ترجمته
      • أمثلة: +61400111222، 0400111222، 61400111222
    • التصرف: (اختياري) سياق المكالمة لقواعد شرطية
      • أمثلة: originate، route، emergency

  2. اختبار الترجمة:

    • أدخل القيم في النموذج
    • تعمل الترجمة تلقائيًا أثناء الكتابة
    • أو انقر على "ترجمة" لتحفيزها يدويًا
    • عرض النتيجة المترجمة على الفور

  3. مراجعة النتائج:

    • المترجم: يظهر الرقم الناتج المنسق
    • خطأ: يعرض الأخطاء في التحقق أو فشل الترجمة
    • القيمة العائدة الخام (تصحيح): تظهر الزوج الكامل لـ Elixir للتصحيح

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

  • تطوير خطة الاتصال: اختبار قواعد تنسيق الأرقام قبل النشر
  • التحقق من التنسيق: التأكد من أن تحويل E.164 يعمل بشكل صحيح
  • اختبار رمز البلد: التأكد من التعامل الصحيح مع البادئات الدولية
  • كشف رقم الطوارئ: التحقق من أن أرقام الطوارئ تم التعرف عليها بشكل صحيح
  • التعامل مع الرموز القصيرة: اختبار الرموز الخاصة بالخدمات (البريد الصوتي، إلخ.)
  • تحضير الخط: تنسيق الأرقام بشكل صحيح لمتطلبات SIP trunk
  • منطق التصرف: اختبار قواعد مختلفة لسيناريوهات MO مقابل MT
  • استكشاف مشكلات الترجمة: استكشاف الأسباب وراء فشل أرقام معينة في التوجيه

نصائح​

  • اختبر كل من التنسيق المحلي (0400111222) والدولي (+61400111222)
  • تحقق من أن أرقام الطوارئ (000، 112) تم التعرف عليها بشكل صحيح
  • استخدم حقل التصرف لاختبار سيناريوهات المكالمات المختلفة (MO، MT، الطوارئ)
  • تحقق من أن الرموز القصيرة والأرقام الداخلية يتم التعامل معها بشكل مناسب
  • تعرض المخرجات التصحيحية القيمة العائدة الخام - مفيدة للتحقيق في المشكلات
  • اختبار الحالات الحدودية مثل الأصفار الرائدة، والبادئات الدولية، والأحرف الخاصة

إدارة البريد الصوتي​

إدارة والاستماع إلى رسائل البريد الصوتي المخزنة في النظام.

الوصول: انتقل إلى /voicemail في لوحة التحكم

عرض البريد الصوتي

الميزات​

  • قائمة البريد الصوتي الكاملة: عرض جميع رسائل البريد الصوتي عبر جميع صناديق البريد
  • تشغيل في المتصفح: الاستماع إلى تسجيلات البريد الصوتي مباشرة في واجهة الويب
  • تفاصيل الرسالة: عرض اسم المستخدم، UUID، الطوابع الزمنية، مسارات الملفات، والبيانات الوصفية
  • وظيفة الحذف: إزالة رسائل البريد الصوتي الفردية
  • تحديث تلقائي: زر التحديث لإعادة تحميل أحدث بيانات البريد الصوتي
  • أعمدة ديناميكية: تعرض تلقائيًا جميع حقول قاعدة البيانات المتاحة

كيفية الاستخدام​

  1. عرض قائمة البريد الصوتي:

    • يتم تحميل الصفحة تلقائيًا مع جميع سجلات البريد الصوتي
    • تظهر الجدول جميع الحقول من قاعدة بيانات البريد الصوتي
    • يتم تنسيق الطوابع الزمنية تلقائيًا من قيم epoch
    • يتم تقصير مسارات الملفات لسهولة القراءة

  2. الاستماع إلى الرسائل:

    • انقر على زر "▶ تشغيل" بجانب أي بريد صوتي
    • يظهر مشغل الصوت مع عناصر التحكم (تشغيل، إيقاف، تقدم، حجم)
    • يدعم تنسيقات WAV، MP3، وOGG
    • انقر على "إيقاف" لإغلاق مشغل الصوت

  3. حذف الرسائل:

    • انقر على زر "حذف" لإزالة بريد صوتي
    • يمنع موجه التأكيد الحذف العرضي
    • يتم تحديث الصفحة تلقائيًا بعد الحذف الناجح

  4. تحديث البيانات:

    • انقر على زر "تحديث" في الزاوية العلوية اليمنى لإعادة تحميل قائمة البريد الصوتي
    • مفيد بعد ترك رسائل بريد صوتي جديدة

تفاصيل الرسالة المعروضة​

يعرض الجدول ديناميكيًا جميع الحقول المتاحة، والتي تشمل عادةً:

  • اسم المستخدم: مالك صندوق البريد
  • UUID: معرف الرسالة الفريد
  • Epoch الإنشاء: متى تم ترك الرسالة (يتم تنسيقه تلقائيًا إلى تاريخ/وقت قابل للقراءة)
  • Epoch القراءة: متى تم الوصول إلى الرسالة (إذا كان ذلك مناسبًا)
  • مسار الملف: موقع ملف الصوت
  • بيانات وصفية إضافية من قاعدة بيانات البريد الصوتي

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

  • دعم المشتركين: الاستماع إلى رسائل البريد الصوتي لاستكشاف الأخطاء
  • اختبار تسليم البريد الصوتي: التحقق من أن رسائل البريد الصوتي يتم تخزينها بشكل صحيح
  • إدارة الرسائل: تنظيف الرسائل القديمة أو رسائل البريد الصوتي التجريبية
  • استكشاف مشكلات التسجيل: التحقق من مسارات الملفات والتحقق من وجود ملفات الصوت
  • صيانة صندوق البريد: مراقبة تخزين البريد الصوتي والاستخدام
  • ضمان الجودة: مراجعة الرسائل المسجلة لجودة الصوت

نصائح​

  • يتم تقصير مسارات الملفات تلقائيًا لعرض الجزء ذي الصلة فقط
  • يتم تحويل الطوابع الزمنية epoch تلقائيًا إلى تنسيق قابل للقراءة البشرية
  • تظهر قاعدة بيانات البريد الصوتي الفارغة "لم يتم العثور على سجلات بريد صوتي"
  • يستخدم تشغيل الصوت عنصر الصوت HTML5 - مدعوم في جميع المتصفحات الحديثة
  • يمنع تأكيد الحذف إزالة الرسائل المهمة عن طريق الخطأ

إدارة مطالبات TTS​

إدارة المطالبات الصوتية المولدة بواسطة Text-to-Speech (TTS) المستخدمة في جميع أنحاء النظام.

الوصول: انتقل إلى /prompts في لوحة التحكم

عرض المطالبات

الميزات​

  • عرض إعدادات المطالبات: عرض الصوت الحالي لـ TTS، تنسيق الاستجابة، والتعليمات
  • حالة التسجيل: رؤية أي المطالبات موجودة وأيها مفقودة
  • تفاصيل الملف: عرض حجم الملف، وقت التعديل، والمسار لكل مطالبة
  • تشغيل في المتصفح: الاستماع إلى المطالبات مباشرة في واجهة الويب
  • إنشاء المفقود: إنشاء تلقائي لجميع ملفات المطالبات المفقودة
  • إعادة تسجيل فردية: إعادة توليد مطالبة معينة مع إعدادات محدثة
  • إعادة تسجيل الكل: إعادة توليد جميع المطالبات (مفيد بعد تغيير الصوت أو الإعدادات)

كيفية الاستخدام​

  1. مراجعة إعدادات المطالبات:

    • الصوت: صوت TTS المستخدم (مثل alloy، nova، shimmer)
    • تنسيق الاستجابة: تنسيق الصوت (مثل wav، mp3، opus)
    • التعليمات: تعليمات خاصة تمرر إلى محرك TTS

  2. التحقق من حالة التسجيل:

    • النص: نص المطالبة الذي سيتم التحدث به
    • المسار النسبي: حيث يتم تخزين ملف الصوت
    • يوجد: "نعم" باللون الأخضر إذا كان الملف موجودًا، "لا" باللون الأصفر إذا كان مفقودًا
    • الحجم: حجم الملف بالبايت/KiB/MiB
    • تعديل: الطابع الزمني لآخر تعديل

  3. إنشاء المطالبات:

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

  4. إدارة المطالبات الفردية:

    • ▶ تشغيل: الاستماع إلى المطالبة (مفعل فقط إذا كان الملف موجودًا)
    • 🔄 إعادة تسجيل: إعادة توليد هذه المطالبة فقط
      • مفيد إذا كانت إحدى المطالبات تبدو غير صحيحة
      • يستخدم الصوت والإعدادات الحالية

  5. الاستماع إلى المطالبات:

    • انقر على "▶ تشغيل" لسماع المطالبة
    • يظهر مشغل الصوت في الأسفل مع جميع عناصر التحكم
    • انقر على "إيقاف" لإغلاق المشغل

تكوين المطالبات​

يتم تكوين المطالبات في تكوين تطبيقك:

config :tas, :prompts,
  voice: "nova",
  response_format: "wav",
  instructions: "Speak clearly and professionally.",
  recordings: [
    %{path: "/sounds/en/us/callie/voicemail/vm-enter_id.wav",
      text: "Please enter your mailbox ID followed by pound"},
    # ... المزيد من المطالبات
  ]

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

  • الإعداد الأولي: إنشاء جميع المطالبات بعد تثبيت النظام
  • تغييرات الصوت: إعادة تسجيل جميع المطالبات بصوت TTS مختلف
  • تحسين الجودة: إصلاح المطالبات الفردية التي لا تبدو صحيحة
  • تحديث التنسيق: إعادة توليد المطالبات بتنسيق صوتي مختلف (wav → mp3)
  • تحديث النص: إعادة التسجيل بعد تغيير نص المطالبة في التكوين
  • اختبار TTS: معاينة كيف ستبدو المطالبات قبل النشر
  • استكشاف مشكلات التشغيل: التحقق من وجود ملفات المطالبات والوصول إليها
  • إدارة التخزين: التحقق من أحجام الملفات وإدارة استخدام القرص

نصائح​

  • استخدم "إنشاء المفقود" للإعداد الأولي - لن يكتب فوق المطالبات الموجودة
  • استخدم "إعادة تسجيل الكل" بعد تغيير الصوت أو التنسيق في التكوين
  • إعادة تسجيل فردية مفيدة للتكرار على المطالبات المحددة
  • استمع إلى المطالبات قبل النشر لضمان الجودة
  • التنسيقات الأكبر (wav) ذات جودة أفضل ولكن تستخدم المزيد من مساحة القرص
  • يمكن أن توجه حقل التعليمات محرك TTS بشأن النغمة والإيقاع
  • قد تستغرق إعادة التسجيل وقتًا إذا كان لديك العديد من المطالبات - كن صبورًا
  • يتم تخزين المطالبات في دليل أصوات FreeSWITCH لسهولة الوصول

قوالب XML لخطة الاتصال​

عرض وفحص قوالب XML لخطة الاتصال في FreeSWITCH المستخدمة لتوجيه المكالمات.

الوصول: انتقل إلى /routing في لوحة التحكم

قوالب خطة الاتصال

الميزات​

  • قائمة القوالب: عرض جميع قوالب XML من دليل priv/templates/
  • تفاصيل الملف: رؤية اسم الملف والطابع الزمني لآخر تعديل لكل قالب
  • تمييز بناء الجملة: عرض XML ملون لسهولة القراءة
    • العلامات باللون الأزرق
    • الخصائص باللون الأزرق الفاتح
    • القيم باللون البرتقالي/البيج
    • التعليقات باللون الأخضر
  • عرض قابل للتوسع: انقر على أي قالب لعرض محتواه الكامل XML
  • عرض للقراءة فقط: فحص آمن دون خطر التعديل العرضي
  • محتوى قابل للتمرير: ملفات كبيرة تمر داخل حاوية ثابتة الارتفاع (حد أقصى 600 بكسل)

كيفية الاستخدام​

  1. عرض قائمة القوالب:

    • يتم تحميل الصفحة مع جميع ملفات .xml من دليل القوالب
    • مرتبة أبجديًا حسب اسم الملف
    • يظهر الطابع الزمني للتعديل لكل ملف

  2. فحص القالب:

    • انقر على أي صف للتوسع وعرض محتوى XML
    • يظهر القالب مع تميي�� بناء الجملة
    • انقر مرة أخرى للانهيار

  3. قراءة محتوى XML:

    • العلامات (بالأزرق): أسماء عناصر XML مثل <extension>، <condition>
    • الخصائص (بالأزرق الفاتح): أسماء الخصائص مثل name=، field=
    • القيم (بالبرتقالي): قيم الخصائص مثل "public"، "destination_number"
    • التعليقات (بالأخضر): تعليقات XML <!-- ... -->

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

  • مراجعة منطق خطة الاتصال: فحص قواعد التوجيه وقوالب المكالمات
  • استكشاف توجيه المكالمات: فهم القوالب المستخدمة لأنواع المكالمات المختلفة
  • التحقق من بناء جملة القالب: التحقق من هيكل XML قبل النشر
  • التدريب والتوثيق: مشاركة محتويات القوالب مع أعضاء الفريق
  • تدقيق التغييرات: مقارنة الطوابع الزمنية للتعديل لتتبع التحديثات
  • تطوير القوالب: الإشارة إلى القوالب الحالية عند إنشاء قوالب جديدة

نصائح​

  • يتم تحميل القوالب من priv/templates/ داخل تطبيق TAS
  • يتم عرض ملفات .xml فقط
  • القوالب للعرض فقط من خلال واجهة الويب
  • تساعد الطوابع الزمنية للتعديل في تحديد التغييرات الأخيرة
  • استخدم هذا العرض للتحقق من تطابق القوالب مع توقعات خطة الاتصال الخاصة بك
  • يجعل تمييز بناء الجملة XML المعقد أسهل في الفهم بصريًا
  • اجمع مع عرض /logs لمطابقة سلوك التوجيه مع القوالب

التفاصيل الفنية​

  • الموقع: يتم تخزين القوالب في دليل priv/templates/
  • التنسيق: تنسيق خطة الاتصال XML لـ FreeSWITCH
  • امتداد الملف: يتم عرض ملفات .xml فقط
  • الفرز: أبجدي حسب اسم الملف
  • تمييز بناء الجملة: تلوين جانب العميل باستخدام أنماط regex
  • الارتفاع الأقصى للعرض: 600 بكسل مع تمرير للملفات الكبيرة

مشغل أوامر ESL​

تنفيذ أوامر FreeSWITCH Event Socket Layer (ESL) مباشرة من واجهة الويب.

الوصول: انتقل إلى /command في لوحة التحكم

مشغل أوامر ESL

الميزات​

  • تنفيذ الأوامر: تشغيل أي أمر ESL/FreeSWITCH API
  • مخرجات حية: رؤية نتائج الأوامر في الوقت الحقيقي
  • تاريخ الأوامر: قائمة منسدلة بالأوامر الأخيرة (آخر 10 أوامر)
  • جاهز للإكمال التلقائي: إدخال بتنسيق أحادي المسافة لدقة إدخال الأوامر
  • معالجة الأخطاء: عرض واضح لأخطاء الأوامر والاستثناءات
  • لا تنفيذ تلقائي: اختيار التاريخ يملأ الإدخال ولكن يتطلب نقرة "تشغيل" صريحة

كيفية الاستخدام​

  1. إدخال الأمر:

    • اكتب أمر ESL في مربع الإدخال
    • أمثلة:
      • status - عرض حالة FreeSWITCH
      • show channels - قائمة المكالمات النشطة
      • uuid_dump <uuid> - تفريغ جميع المتغيرات لمكالمة
      • sofia status - عرض حالة ملف SIP
      • reloadxml - إعادة تحميل XML خطة الاتصال
      • version - عرض إصدار FreeSWITCH

  2. تشغيل الأمر:

    • انقر على زر "تشغيل" لتنفيذ
    • يظهر الزر "جارٍ التشغيل..." أثناء التنفيذ
    • لا يمكن تشغيل أوامر متعددة في وقت واحد

  3. عرض المخرجات:

    • تظهر النتائج في قسم "المخرجات" أدناه
    • تظهر الأوامر الناجحة الاستجابة الخام
    • الأخطاء مسبوقة بـ "خطأ:"
    • المخرجات قابلة للتمرير مع ارتفاع أقصى 600 بكسل
    • خط مميز لمحاذاة البيانات

  4. استخدام تاريخ الأوامر:

    • تظهر الأوامر الأخيرة في القائمة المنسدلة بعد أول تنفيذ
    • اختر من القائمة "الأخيرة:" لملء حقل الإدخال
    • يحتفظ التاريخ بآخر 10 أوامر فريدة
    • الأمر الأكثر حداثة في الأعلى
    • اختيار التاريخ لا ينفذ تلقائيًا (ميزة أمان)

الأوامر الشائعة​

الأمرالوصفمخرجات المثال
statusحالة النظام ووقت التشغيلمعلومات تشغيل FreeSWITCH
show channelsقائمة بجميع المكالمات النشطةقائمة القنوات أو "0 إجمالي"
show callsملخص المكالمات النشطةملخص عدد المكالمات
uuid_dump <uuid>جميع المتغيرات لمكالمةتفريغ المتغيرات الكاملة
uuid_kill <uuid>إنهاء مكالمة معينة"+OK" أو خطأ
sofia statusحالة ملف SIPقائمة الملفات الشخصية والدول
sofia status profile <name>تفاصيل ملف شخصي محددعدد التسجيلات، إلخ
reloadxmlإعادة تحميل XML خطة الاتصالتأكيد "+OK"
versionمعلومات إصدار FreeSWITCHسلسلة الإصدار
global_getvar <var>الحصول على متغير عالميقيمة المتغير
api helpقائمة الأوامر المتاحةمرجع الأوامر

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

  • استكشاف المكالمات: الحصول على معلومات مفصلة حول المكالمة النشطة باستخدام uuid_dump
  • حالة النظام: التحقق من صحة FreeSWITCH باستخدام status وshow calls
  • استكشاف SIP: فحص ملفات SIP باستخدام sofia status
  • إعادة تحميل خطة الاتصال: تطبيق تغييرات التكوين باستخدام reloadxml
  • إجراءات الطوارئ: إنهاء المكالمات العالقة باستخدام uuid_kill
  • فحص المتغيرات: تحقق من المتغيرات العالمية أو متغيرات القناة

استكشاف الأخطاء​

عدم ظهور المشتركين​

  • تحقق من تشغيل OmniTAS
  • تحقق من أن ملف تعريف Sofia نشط: sofia status profile internal
  • تحقق من أن مسار قاعدة البيانات في التكوين يتطابق مع موقع قاعدة البيانات الفعلي

عدم ظهور سجلات CDR​

  • تأكد من تحميل وحدة CDR الخاصة بـ OmniTAS
  • تحقق من وجود قاعدة بيانات CDR في المسار المكون
  • تحقق من تكوين وحدة CDR في OmniTAS

اعتبارات الأداء​

  • قد تتطلب قواعد بيانات CDR الكبيرة (>1M سجلات) فهرسة إضافية لأداء مثالي
  • ضع في اعتبارك أرشفة سجلات CDR القديمة بشكل دوري
  • عادةً ما تكون استعلامات تسجيل المشتركين سريعة حيث أن قاعدة بيانات التسجيل صغيرة

التكوين​

التحكم في الوصول​

يجب نشر لوحة التحكم خلف ضوابط وصول مناسبة (جدار ناري، VPN، مصادقة) لأنها توفر رؤية في نشاط المشتركين وسجلات المكالمات.