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

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

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

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

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

نظرة عامة

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

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

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

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

مرجع موارد T8

MonitoringEventSubscription

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

الحقل	النوع	مطلوب	الوصف
notificationDestination	سلسلة (URI)	نعم	رد الاتصال الذي يتلقى خادم التطبيق تقارير المراقبة عليه.
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	الإبلاغ عن قدرة دعم API.

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

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

نوع الوصول

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

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

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