مراقبة الأحداث

تتيح خدمة مراقبة الأحداث لخادم التطبيق الاشتراك في أحداث الشبكة حول جهاز أو مجموعة — إمكانية الوصول، فقدان الاتصال، الموقع، حالة التجوال، والمزيد. يقوم خادم التطبيق بالاشتراك عبر T8؛ يقوم OmniSCEF بتجهيز الحدث في الشبكة عبر T6a ويقوم بتسليم كل تقرير مرة أخرى إلى رد الاتصال الخاص بالاشتراك.

تُعرف أحداث المراقبة في 3GPP TS 23.682 §5.6، وواجهة برمجة التطبيقات T8 في TS 29.122 §5.3، وإجراءات Diameter في TS 29.128 / TS 29.336.

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

• نظرة عامة
• تدفق الاشتراك والتقارير
• مرجع موارد T8
• أنواع المراقبة
• القيم المرجعية

نظرة عامة

يتم تعيين SCEF-Reference-ID لكل اشتراك — وهو معرف فريد يضعه OmniSCEF في التكوين الجنوبي ويقوم الشبكة بإعادته في كل تقرير. يستخدم OmniSCEF هذا لتوجيه تقرير وارد إلى الاشتراك الصحيح ورد الاتصال الخاص بخادم التطبيق.

تدفق الاشتراك والتقارير

التجهيز اختياري في SCEF. إذا تم تكوين وجهة المراقبة، يقوم OmniSCEF بإرسال CIR لتجهيز الحدث. إذا لم يتم تكوينها، لا يزال الاشتراك يتم إنشاؤه ولا يزال OmniSCEF يقوم بتسليم أي تقارير واردة — إنه ببساطة لا يرسل CIR بشكل استباقي (على سبيل المثال، عندما يتم تجهيز الحدث عبر HSS عبر مسار آخر).

يتم الاعتراف بتقرير لا يتطابق فيه SCEF-Reference-ID مع أي اشتراك بواسطة RIA ولكن لا يتم توجيهه.

مرجع موارد T8

MonitoringEventSubscription

تم إنشاؤه بواسطة POST /api/3gpp-monitoring-event/v1/{scsAsId}/subscriptions.

الحقل	النوع	مطلوب	الوصف
notificationDestination	سلسلة (URI)	نعم	رد الاتصال الذي يتلقى عليه AS تقارير المراقبة.
monitoringType	سلسلة (enum)	نعم	الحدث الذي سيتم مراقبته — انظر أنواع المراقبة.
externalId	سلسلة	شرطي	معرف الجهاز الخارجي. واحد من externalId، msisdn، أو externalGroupId.
msisdn	سلسلة	شرطي	MSISDN للجهاز.
externalGroupId	سلسلة	شرطي	معرف المجموعة لمراقبة المجموعة.
maximumNumberOfReports	عدد صحيح	لا	التوقف بعد هذا العدد من التقارير.
monitoringDuration	سلسلة (تاريخ-وقت)	لا	التوقف عن المراقبة في هذا الوقت.
reachabilityType	سلسلة (enum)	لا	لـ UE_REACHABILITY: SMS أو DATA.
maximumDetectionTime	عدد صحيح	لا	لـ LOSS_OF_CONNECTIVITY: وقت الكشف بالثواني.
mtcProviderId	سلسلة	لا	معرف مزود خدمة MTC.
self	سلسلة (URI)	للقراءة فقط	URI الخاص بالاشتراك.

مثال على طلب الاشتراك:

{
  "monitoringType": "UE_REACHABILITY",
  "notificationDestination": "https://as.example.org/monitoring/callback",
  "externalId": "device01@iot.example.org",
  "reachabilityType": "DATA",
  "maximumNumberOfReports": 10
}

MonitoringNotification

يقوم OmniSCEF بإرسال MonitoringNotification إلى notificationDestination للاشتراك لكل تقرير. يشير إلى الاشتراك الأصلي ويحمل تقرير أو أكثر من تقارير الأحداث المفككة.

مثال على الإشعار:

{
  "subscription": "/3gpp-monitoring-event/v1/as01/subscriptions/XyZ...",
  "monitoringEventReports": [
    {
      "monitoringType": "UE_REACHABILITY",
      "reachabilityType": "DATA"
    }
  ]
}

يقر خادم التطبيق بـ 204 No Content.

أنواع المراقبة

يدعم OmniSCEF مجموعة أنواع المراقبة الكاملة لـ TS 29.122. كل منها يتطابق مع القيمة المقابلة لـ Monitoring-Type على واجهة Diameter (TS 29.336 §5.3.9).

monitoringType (T8)	قيمة Diameter	الوصف
LOSS_OF_CONNECTIVITY	0	لم يعد UE قابلاً للوصول للبيانات.
UE_REACHABILITY	1	أصبح UE قابلاً للوصول لـ SMS أو البيان��ت.
LOCATION_REPORTING	2	يتم الإبلاغ عن موقع UE (أو تغيير فيه).
CHANGE_OF_IMSI_IMEI_ASSOCIATION	3	تغير IMEI المرتبط بـ IMSI.
ROAMING_STATUS	4	يتم الإبلاغ عن حالة تجوال UE (أو تغيير).
COMMUNICATION_FAILURE	5	حدث فشل في الاتصال.
AVAILABILITY_AFTER_DDN_FAILURE	6	أصبح UE متاحًا بعد فشل إشعار بيانات التنزيل.
NUMBER_OF_UES_IN_AN_AREA	7	عدد UEs الموجودة في منطقة معينة.
PDN_CONNECTIVITY_STATUS	8	تم إنشاء/إصدار اتصال PDN.
DOWNLINK_DATA_DELIVERY_STATUS	9	حالة تسليم بيانات التنزيل.
API_SUPPORT_CAPABILITY	10	الإبلاغ عن قدرة دعم واجهة برمجة التطبيقات.

يتم رفض الاشتراك الذي يحتوي على monitoringType غير المدعوم بـ 400 INVALID_MONITORING_TYPE.

القيم المرجعية

نوع الوصول

القيمة	المعنى
SMS	UE قابل للوصول لـ SMS.
DATA	UE قابل للوصول للبيانات.

أوامر Diameter ذات الصلة

انظر جداول مرجع دليل العمليات لأكواد الأوامر والنتائج CIR/CIA و RIR/RIA.