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

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

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

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

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

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

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

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

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

العمليات​

تغطي هذه القسم ميزات المراقبة والإدارة التشغيلية المتاحة في لوحة التحكم 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 لكل صفحة مع عناصر التحكم السابقة/التالي)
  • بحث متقدم: بحث قوي يدعم المطابقة الدقيقة، العكس/الاستبعاد، والعديد من المصطلحات
  • اختيار الأعمدة: تخصيص الحقول المعروضة
    • انقر على زر "الأعمدة" لفتح نافذة اختيار الأعمدة
    • حدد/ألغِ تحديد الأعمدة الفردية
    • إجراءات سريعة تحديد الكل / إلغاء تحديد الكل
    • يستمر الاختيار عبر الجلسات (محفوظ في localStorage للمتصفح)
    • يظهر عداد "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:
  للبحث العادي (بدون !):
    - تحقق مما إذا كان أي حقل يحتوي/يساوي المصطلح → تضمين إذا كان صحيحًا
    - SQL: field1 LIKE '%term%' OR field2 LIKE '%term%' OR ...

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

  للبحث باستخدام AND:
    - يتم تقييم كل مصطلح بشكل منفصل
    - يجب أن تكون جميع شروط المصطلح صحيحة → تضمين إذا كان صحيحًا
    - 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 التحكم في المكالمات - المؤتمرات لوكلاء المستخدم
  • 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 (بنفسجي)
    • مستوى السجل: مستوى ملون في الأقواس [ERROR]، [INFO]، إلخ.
    • الملف/السطر: موقع الشيفرة المصدرية (عند توفرها)
    • الرسالة: محتوى رسالة السجل الفعلي

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

المستوىاللونعند الاستخدامالمثال
الكونسولبنفسجيرسائل خاصة بالكونسولإخراج كونسول 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 للاختبار الأسرع
  • نتائج شاملة:
    • إخراج متغيرات خطة الاتصال الكاملة
    • نتائج استعلام HLR/SH
    • نتيجة مصادقة 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 للمكالمات الصادرة أو in للمكالمات الواردة

  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 مع أرقام الطلب المتزايدة لاختبار استمرارية الجلسة
  • راقب سجلات 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​

إدارة موجهات الصوت المولدة بواسطة النص إلى كلام (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. عرض الإخراج:

    • تظهر النتائج في قسم "الإخراج" أدناه
    • تظهر الأوامر الناجحة الاستجابة الخام
    • الأخطاء مسبوقة بـ "ERROR:"
    • الإخراج قابل للتمرير مع ارتفاع أقصى 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، مصادقة) حيث توفر رؤية في نشاط المشتركين وسجلات المكالمات.

آخر تحديث في