دليل عمليات OmniPGW

OmniPGW - بوابة بيانات حزمة التحكم (PGW-C)

بواسطة خدمات شبكة Omnitouch

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

نظرة عامة
العمارة
واجهات الشبكة
المفاهيم الأساسية
البدء
التكوين
مراقبة العمليات في الوقت الحقيقي (OAM API)
المراقبة والقياسات
وثائق مفصلة
موارد إضافية

نظرة عامة

OmniPGW هي تنفيذ عالي الأداء لبوابة بيانات حزمة التحكم (PGW-C) لشبكات 3GPP LTE Evolved Packet Core (EPC)، تم تطويرها بواسطة خدمات شبكة Omnitouch. تدير وظائف مستوى التحكم لجلسات البيانات، بما في ذلك:

إدارة الجلسات - إنشاء وتعديل وإنهاء جلسات بيانات UE (جهاز المستخدم)
تخصيص عنوان IP - تخصيص عناوين IP للأجهزة المحمولة من برك مكونة
السياسة والتحكم في الفوترة - الواجهة مع PCRF لتطبيق السياسة والفوترة
تنسيق مستوى المستخدم - التحكم في PGW-U (مستوى المستخدم) لتوجيه الحزم

ما الذي تفعله PGW-C

تقبل طلبات الجلسة من SGW-C عبر واجهة S5/S8 (GTP-C)
تخصص عناوين IP لـ UE من برك الشبكة الفرعية المكونة
تطلب قرارات السياسة من PCRF عبر واجهة Gx (Diameter)
برمجة قواعد التوجيه في PGW-U عبر واجهة Sxb (PFCP)
تدير تطبيق QoS من خلال سياقات الحاملات وقواعد QoS
تتبع معلومات الفوترة لأنظمة الفوترة

العمارة

نظرة عامة على المكونات

العمارة العملية

PGW-C مبنية على Elixir/OTP وتستخدم هيكل عملية خاضعة لل��شراف:

مشرف التطبيق - مشرف على المستوى الأعلى يدير جميع المكونات
وسطاء البروتوكول - يتعاملون مع رسائل البروتوكول الواردة/الصادرة
عمليات الجلسة - خادم GenServer واحد لكل اتصال PDN نشط
السجلات - تتعقب الموارد المخصصة (عناوين IP، TEIDs، SEIDs، إلخ)
مدير عقدة PFCP - يحافظ على ارتباطات PFCP مع أقران PGW-U

كل مكون خاضع للإشراف وسيتم إعادة تشغيله تلقائيًا عند الفشل، مما يضمن موثوقية النظام.

واجهات الشبكة

PGW-C ينفذ ثلاث واجهات رئيسية من 3GPP:

واجهة S5/S8 (GTP-C v2)

الغرض: إشارة مستوى التحكم بين SGW-C و PGW-C

البروتوكول: GTP-C الإصدار 2 عبر UDP

الرسائل الرئيسية:

طلب/استجابة إنشاء جلسة
طلب/استجابة حذف جلسة
طلب/استجابة إنشاء حامل
طلب/استجابة حذف حامل

التكوين: انظر تكوين S5/S8

واجهة Sxb (PFCP)

الغرض: إشارة مستوى التحكم بين PGW-C و PGW-U

البروتوكول: PFCP (بروتوكول التحكم في توجيه الحزم) عبر UDP

الرسائل الرئيسية:

طلب/استجابة إعداد الارتباط
طلب/استجابة إنشاء جلسة
طلب/استجابة تعديل الجلسة
طلب/استجابة حذف الجلسة
طلب/استجابة نبض القلب

التكوين: انظر وثائق واجهة PFCP/Sxb

واجهة Gx (Diameter)

الغرض: واجهة وظيفة قواعد السياسة والفوترة (PCRF)

البروتوكول: Diameter (IETF RFC 6733)

الرسائل الرئيسية:

طلب/استجابة التحكم في الائتمان الأولي (CCR-I/CCA-I)
طلب/استجابة إنهاء التحكم في الائتمان (CCR-T/CCA-T)

التكوين: انظر وثائق واجهة Diameter Gx

المفاهيم الأساسية

جلسة PDN

تمثل جلسة PDN (شبكة بيانات الحزمة) اتصال بيانات UE بشبكة خارجية (مثل الإنترنت). تحتوي كل جلسة على:

عنوان IP لـ UE - مخصص من بركة الشبكة الفرعية المكونة
APN (اسم نقطة الوصول) - يحدد الشبكة الخارجية
سياق الحامل - يحتوي على معلمات QoS ومعلومات النفق
ID الفوترة - معرف فريد للفوترة
TEID (معرف نقطة نهاية النفق) - معرف نفق واجهة S5/S8
SEID (معرف نقطة نهاية الجلسة) - معرف جلسة واجهة Sxb

سياق الحامل

يمثل الحامل تدفق بيانات بخصائص QoS محددة:

الحامل الافتراضي - يتم إنشاؤه مع كل جلسة PDN
الحاملات المخصصة - حاملات إضافية لاحتياجات QoS محددة
EBI (معرف حامل EPS) - معرف فريد لكل حامل
معلمات QoS - QCI، ARP، معدلات البيانات (MBR، GBR)

قواعد PFCP

برمج PGW-C PGW-U بقواعد معالجة الحزم:

PDR (قاعدة كشف الحزم) - تطابق الحزم (الرفع/الخفض)
FAR (قاعدة إجراء التوجيه) - تحدد سلوك التوجيه
QER (قاعدة تطبيق QoS) - تفرض حدود معدل البيانات
BAR (قاعدة إجراء التخزين المؤقت) - تتحكم في تخزين الحزم

انظر وثائق واجهة PFCP للحصول على التفاصيل.

تخصيص عنوان IP

تخصص عناوين IP لـ UE من برك الشبكة الفرعية المكونة:

اختيار قائم على APN - يمكن أن تستخدم APNs المختلفة شبكات فرعية مختلفة
تخصيص ديناميكي - اختيار IP عشوائي من النطاق المتاح
تخصيص ثابت - دعم لعناوين IP المطلوبة من قبل UE
كشف التصادم - يضمن تخصيص IP فريد

انظر تخصيص بركة IP لـ UE للتكوين، و IPv6 / Dual-Stack لعملية PDN IPv6 وIPv4v6.

البدء

المتطلبات الأساسية

Elixir ~1.16
Erlang/OTP 26+
الاتصال بالشبكة إلى SGW-C و PGW-U و PCRF
فهم عمارة LTE EPC

بدء OmniPGW

تكوين إعدادات وقت التشغيل في config/runtime.exs
ترجمة التطبيق:
```
mix deps.get
mix compile
```
بدء التطبيق:
```
mix run --no-halt
```

التحقق من التشغيل

تحقق من السجلات لبدء التشغيل الناجح:

[info] Starting OmniPGW...
[info] Starting Metrics Exporter on 127.0.0.42:42069
[info] Starting S5/S8 Broker on 127.0.0.10
[info] Starting Sxb Broker on 127.0.0.20
[info] Starting Gx Broker
[info] Starting PFCP Node Manager
[info] OmniPGW successfully started

الوصول إلى القياسات على http://127.0.0.42:42069/metrics (العنوان المكون).

التكوين

ي��م تعريف جميع تكوينات وقت التشغيل في config/runtime.exs. يتم تقييم هذا الملف عند بدء التطبيق. يتبع مثال كامل؛ يتم وصف كل قسم في جدول المرجع أدناه وفي مرجع التكوين.

# config/runtime.exs
import Config

# تكوين السجل
config :logger, level: :info

config :pgw_c,
  # القياسات (بروميثيوس)
  metrics: %{
    enabled: true,
    ip_address: "10.0.0.20",  # شبكة الإدارة
    port: 9090,
    registry_poll_period_ms: 5_000
  },

  # Diameter/Gx (واجهة PCRF)
  diameter: %{
    listen_ip: "0.0.0.0",
    host: "omnipgw.epc.mnc001.mcc001.3gppnetwork.org",
    realm: "epc.mnc001.mcc001.3gppnetwork.org",
    peer_list: [
      %{
        host: "pcrf-primary.epc.mnc001.mcc001.3gppnetwork.org",
        realm: "epc.mnc001.mcc001.3gppnetwork.org",
        ip: "10.0.1.30",
        initiate_connection: true
      },
      %{
        host: "pcrf-backup.epc.mnc001.mcc001.3gppnetwork.org",
        realm: "epc.mnc001.mcc001.3gppnetwork.org",
        ip: "10.0.2.30",
        initiate_connection: true
      }
    ]
  },

  # S5/S8 (واجهة SGW-C)
  s5s8: %{
    local_ipv4_address: "10.0.0.20"
  },

  # Sxb/PFCP (واجهة PGW-U)
  sxb: %{
    local_ip_address: "10.0.0.20"
  },

  # اختيار UPF
  upf_selection: %{
    rules: [
      %{
        name: "Default Internet",
        priority: 1,
        match_field: :apn,
        match_regex: ~r/^internet/,
        upf_pool: [
          %{remote_ip_address: "10.0.0.21", remote_port: 8805, weight: 100},
          %{remote_ip_address: "10.0.0.22", remote_port: 8805, weight: 0}  # احتياطي
        ]
      }
    ],
    fallback_pool: [
      %{remote_ip_address: "10.0.0.21", remote_port: 8805, weight: 100}
    ]
  },

  # برك IP لـ UE
  ue: %{
    subnet_map: %{
      "internet" => [
        "100.64.0.0/18"  # 16,382 عنوان IP
      ],
      "ims" => [
        "100.64.64.0/22"  # 1,022 عنوان IP
      ],
      "enterprise.corp" => [
        "10.100.0.0/16"  # 65,534 عنوان IP
      ],
      default: [
        "100.64.127.0/24"  # 254 عنوان IP
      ]
    }
  },

  # خيارات تكوين البروتوكول
  pco: %{
    primary_dns_server_address: "8.8.8.8",
    secondary_dns_server_address: "8.8.4.4",
    p_cscf_ipv4_address_list: ["10.0.0.50", "10.0.0.51"],
    ipv4_link_mtu_size: 1400
  }

هيكل التكوين مقسم إلى عدة أقسام:

نظرة عامة على التكوين

مرجع تكوين سريع

القسم	الغرض	الوثائق
metrics	مصدّر قياسات بروميثيوس	دليل المراقبة
diameter	واجهة Gx إلى PCRF	تكوين Diameter Gx
s5s8	واجهة GTP-C إلى SGW-C	تكوين S5/S8
sxb	واجهة PFCP إلى PGW-U	تكوين PFCP
ue	برك عنوان IP لـ UE	تكوين بركة IP
pco	خيارات تكوين البروتوكول	تكوين PCO
CDR	الفوترة والتقارير عن الاستخدام غير المتصل	تنسيق CDR
charging	وضع الفوترة المتصلة/غير المتصلة، تجاوز كسر الزجاج	تجاوز الفوترة

انظر دليل التكوين الكامل للحصول على معلومات مفصلة.

مراقبة العمليات في الوقت الحقيقي (OAM API)

تقدم OmniPGW واجهة برمجة تطبيقات OAM REST لمراقبة العمليات في الوقت الحقيقي، مما يوفر رؤية فورية لحالة النظام. استعلام عن هذه النقاط النهائية للقراءة عند الطلب (أو على فترات استطلاع / من نص برمجي) للحصول على عرض تشغيلي مباشر - لا حاجة للوصول إلى سطر الأوامر للمضيف أو استعلامات القياسات الخام.

الوصول إلى واجهة OAM API

تُقدم واجهة API عبر HTTPS/TLS. يتم تقديم جميع المسارات تحت بادئة /api.

https://<omnipgw-ip>:8443/

تتوفر الوثائق التفاعلية لواجهة API (Swagger UI) على:

https://<omnipgw-ip>:8443/api/docs

مثال على فحص الصحة (استخدم -k لشهادة مختبر موقعة ذاتيًا):

curl -k https://localhost:8443/api/status
{"result":"ok"}

النقاط النهائية المتاحة:

الغرض	النقطة النهائية	تحل محل (الصفحة القديمة)
الغوص العميق في مشترك معين (IMSI/MSISDN/IP)	`POST /api/ue_search`	بحث UE
قائمة / بحث عن جلسات PDN النشطة	`GET /api/sessions[?search=<imsi\|msisdn\|ip>]`	جلسات PGW
جلسة واحدة بواسطة IMSI	`GET /api/sessions/<imsi>`	جلسات PGW (تفاصيل)
تاريخ الجلسة / أحداث التدقيق	`GET /api/session_history[?type=&search=&page=&page_size=]`	تاريخ الجلسة
نظرة عامة على بنية الشبكة	`GET /api/topology`	بنية الشبكة
استخدام بركة عنوان IP لـ UE	`GET /api/ip_pools`, `GET /api/ip_pools/<name>`	برك IP
حالة نظير UPF / PFCP	`GET /api/upf`, `GET /api/upf/<ip>`	جلسات PFCP / حالة UPF
قواعد اختيار UPF، الصحة، تكوين PCO	`GET /api/upf_selection`	اختيار UPF
اتصال نظير Diameter (Gx/Gy)	`GET /api/diameter[?status=connected\|disconnected]`, `GET /api/diameter/<origin-host>`	أقران Diameter
حالة الفوترة المتصلة (Gy) لكل جلسة	`GET /api/charging[?search=<imsi>]`, `GET /api/charging/<imsi>`	حالة Gy
كسر الزجاج: تعطيل الفوترة عبر العقدة	`PUT /api/charging/override`, `GET /api/charging/override`, `DELETE /api/charging/override`	-
حالة اكتشاف DNS لـ P-CSCF	`GET /api/pcscf_monitor`	مراقب P-CSCF
فحص الصحة	`GET /api/status`	-

للحصول على عرض بأسلوب لوحة المعلومات الحية، قم باستطلاع نقاط النهاية التجميعية على فترات، على سبيل المثال:

watch -n 2 'curl -sk https://localhost:8443/api/sessions'
watch -n 1 'curl -sk https://localhost:8443/api/diameter?status=disconnected'

ملاحظة: صفحة السجلات السابقة (بث السجلات الحية) وصفحة محاكي Gy ليس لها مكافئ لـ OAM API. قم ببث السجلات من المضيف / مجمع سجلاتك، واستخدم GET /api/charging لفحص حالة Gy/الفوترة الحية.

الميزات الرئيسية

البيانات عند الطلب والمستطلعة:

كل نقطة نهائية تعيد الحالة الحالية الحية من عمليات OmniPGW
استطلاع على فترات باستخدام watch/cron/نص برمجي للحصول على عرض متجدد تلقائيًا
يتم إرجاع حقول الحالة (مثل نظير connected/associated) بشكل صريح في JSON

البحث والتصفية:

ابحث عن الجلسات بواسطة IMSI أو IP أو MSISDN أو APN عبر GET /api/sessions?search=...
تصفية أقران Diameter بواسطة ?status=connected|disconnected
تصفية حالة الفوترة بواسطة ?search=<imsi>

سجلات التفاصيل الكاملة:

تعيد نقاط النهاية لكل كيان (/api/sessions/<imsi>, /api/upf/<ip>, /api/diameter/<origin-host>, /api/charging/<imsi>) الحالة الكاملة كـ JSON
فحص الجلسة الكاملة، تكوي�� النظير، والقدرات

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

تُقدم عبر HTTPS/TLS على المنفذ 8443
ربط فقط بعنوان IP الإداري وواجهة مع ضوابط الوصول الخاصة بك
مخصصة لفريق NOC/العمليات والاستخدام الآلي

سير العمل التشغيلي

استكشاف مشاكل الجلسة (غوص عميق):

1. المستخدم يبلغ عن مشكلة في الاتصال
2. POST /api/ue_search مع جسم JSON يحتوي على IMSI أو MSISDN أو IP
3. مراجعة تفاصيل الجلسة الشاملة في الاستجابة:
   a) الجلسات النشطة - تحقق من وجود الجلسة مع المعلمات الصحيحة
   b) الموقع الحالي - تحقق من TAC، معرف الخلية، الشبكة الخدمية
   c) معلومات الحامل - تحقق من الحاملات الافتراضية والمخصصة
      - QCI، MBR/GBR، أسماء قواعد الفوترة
      - حدود APN-AMBR
   d) معلومات الفوترة - معرف جلسة Gy، حالة الحصة (أيضًا GET /api/charging/<imsi>)
   e) معلومات السياسة - جلسة Gx، قواعد PCC المثبتة
   f) الأحداث الأخيرة - GET /api/session_history?search=<imsi>
4. إذا لم يتم العثور على الجلسة → GET /api/diameter?status=disconnected للتحقق من الاتصال بـ PCRF

بحث سريع عن الجلسة:

1. المستخدم يبلغ عن مشكلة
2. GET /api/sessions?search=<imsi|msisdn> (أو GET /api/sessions/<imsi>)
3. تحقق من وجود الجلسة مع التفاصيل الأساسية:
   - عنوان IP لـ UE المخصص
   - معلمات QoS
   - نقاط نهاية النفق التي تم إنشاؤها
4. للتحليل التفصيلي → POST /api/ue_search

فحص صحة النظام:

GET /api/upf              → تحقق من أن جميع أقران PGW-U "مرتبطون"
GET /api/diameter?status=connected → تحقق من أن جميع أقران PCRF "متصلون"
GET /api/sessions         → تحقق من عدد الجلسات النشطة مقابل السعة
GET /api/status           → فحص الصحة العامة ({"result":"ok"})

مراقبة السعة:

عد الإدخالات التي تم إرجاعها بواسطة GET /api/sessions
قارنها بالسعة المرخصة/المتوقعة
تحديد أوقات الاستخدام الذروة
مراقبة التوزيع عبر APNs؛ استخدم GET /api/ip_pools للاستخدام لكل بركة

واجهة API مقابل القياسات

استخدم واجهة OAM API لـ:

استكشاف مشترك عميق (POST /api/ue_search)
تفاصيل الجلسة الفردية وفحص الحالة (GET /api/sessions/<imsi>)
حالة النظير في الوقت الحقيقي (GET /api/upf, GET /api/diameter)
فحوصات صحة سريعة عبر جميع الواجهات (GET /api/status)
استكشاف مشاكل المستخدمين المحددين بواسطة IMSI/MSISDN/IP
تحليل QoS للحامل (MBR، GBR، QCI)
فحص قواعد السياسة والفوترة (GET /api/charging)
تاريخ الجلسات وآثار التدقيق (GET /api/session_history)
مراقبة سعة بركة IP (GET /api/ip_pools)
التحقق من التكوين والقواعد (GET /api/upf_selection)

استخدم قياسات بروميثيوس لـ:

الاتجاهات التاريخية
التنبيهات والإشعارات
الرسوم البيانية لتخطيط السعة
تحليل الأداء
المراقبة على المدى الطويل

أفضل ممارسة: استخدم كلاهما معًا - واجهة OAM API للعمليات الفورية، وبروميثيوس للاتجاهات والتنبيهات.

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

بالإضافة إلى واجهة OAM API، تعرض OmniPGW قياسات متوافقة مع بروميثيوس للمراقبة:

القياسات المتاحة

قياسات الجلسة
- teid_registry_count - جلسات S5/S8 النشطة
- seid_registry_count - جلسات PFCP النشطة
- session_id_registry_count - جلسات Gx النشطة
- address_registry_count - عناوين IP لـ UE المخصصة
- charging_id_registry_count - معرفات الفوترة النشطة
مقاييس الرسائل
- s5s8_inbound_messages_total - الرسائل المستلمة عبر GTP-C
- sxb_inbound_messages_total - الرسائل المستلمة عبر PFCP
- gx_inbound_messages_total - الرسائل المستلمة عبر Diameter
- توزيعات مدة معالجة الرسائل
مقاييس الأخطاء
- s5s8_inbound_errors_total - أخطاء بروتوكول S5/S8
- sxb_inbound_errors_total - أخطاء بروتوكول PFCP
- gx_inbound_errors_total - أخطاء Diameter
مقاييس دورة حياة الجلسة
- pgw_session_create_total{result,cause,pdn_type,rat_type} - محاولات إنشاء جلسة PDN، مقسمة حسب النتيجة (success/failure)، السبب المعاد عبر GTP، نوع PDN (ipv4/ipv6/ipv4v6) ونوع RAT
- pgw_session_delete_total{pdn_type} - عمليات حذف جلسة PDN حسب نوع PDN
- pgw_session_modify_total - طلبات تعديل الحامل المعالجة
مقاييس مجموعة عناوين IP للـ UE
- ue_pool_addresses_allocated{pool,ip_version} - عناوين UE المخصصة لكل مجموعة (نمط APN) وإصدار IP
- ue_pool_addresses_total{pool,ip_version} - السعة الإجمالية للمجموعة
- ue_pool_addresses_utilization_ratio{pool,ip_version} - النسبة المخصصة (0.0-1.0)؛ مفيدة لتنبيه استنفاد المجموعة. لاحظ أن المجموعات التي تشترك في نطاق عنوان كل منها تحسب التخصيصات المشتركة
- ue_ip_allocation_failures_total{ip_version,reason} - حالات فشل التخصيص (pool_exhausted, already_registered)
مقاييس UPF / PFCP لكل نظير
- upf_peer_associated{peer_ip} - حالة ارتباط PFCP لكل نظير (1/0)
- upf_peer_healthy{peer_ip} - الصحة لكل نظير (1/0)
- upf_peer_missed_heartbeats{peer_ip} - عدد نبضات القلب المفقودة المتتالية لكل نظير
- upf_heartbeat_rtt - توزيع زمن الرحلة ذهابًا وإيابًا لنبضات PFCP، حسب peer_ip
مقاييس الحامل وجودة الخدمة
- pgw_bearer_create_total{type,qci} - الحوامل التي تم إنشاؤها حسب النوع (default/dedicated) وQCI
- pgw_bearer_delete_total{type} - الحوامل المحذو��ة حسب النوع
مقاييس نظير Diameter
- diameter_peers_connected{application} - نظائر Diameter المتصلة حسب التطبيق (gx/gy/all)

الوصول إلى المقاييس

تُعرض المقاييس عبر HTTP عند نقطة النهاية المكونة:

curl http://127.0.0.42:42069/metrics

راجع دليل المراقبة والمقاييس لإعداد لوحة المعلومات والتنبيهات.

الوثائق التفصيلية

تقدم هذه القسم نظرة شاملة على جميع وثائق OmniPGW. يتم تنظيم الوثائق حسب الموضوع وحالة الاستخدام.

هيكل الوثائق

وثائق OmniPGW
├── OPERATIONS.md (هذا الدليل)
│
└── docs/
    ├── التكوين والإعداد
    │   ├── configuration.md          مرجع كامل لـ runtime.exs
    │   ├── ue-ip-allocation.md       تكوين مجموعة عناوين IP
    │   └── pco-configuration.md      إعدادات DNS وP-CSCF وMTU
    │
    ├── واجهات الشبكة
    │   ├── pfcp-interface.md         Sxb/PFCP (تواصل PGW-U)
    │   ├── diameter-gx.md            Gx (تواصل PCRF)
    │   ��── diameter-gy.md            Gy/Ro (تواصل OCS)
    │   └── s5s8-interface.md         S5/S8 (تواصل SGW-C)
    │
    └── العمليات
        ├── session-management.md     دورة حياة جلسة PDN
        ├── charging-override.md      تجاوز الشحن عبر الإنترنت
        └── monitoring.md             مقاييس Prometheus والتنبيهات

الوثائق حسب الموضوع

🚀 البدء

الوثيقة	الوصف	الغرض
OPERATIONS.md	دليل العمليات الرئيسي (هذه الوثيقة)	نظرة عامة وبداية سريعة

⚙️ التكوين

الوثيقة	الوصف	الأسطر
configuration.md	مرجع تكوين كامل لـ runtime.exs	1,600+
ue-ip-allocation.md	إدارة وتخصيص مجموعة عناوين IP للـ UE	943
ipv6-dual-stack.md	تشغيل PDN IPv6 / IPv4v6 عبر PGW-C وUPF	-
pco-configuration.md	خيارات تكوين البروتوكول (DNS وP-CSCF وMTU)	344

🔌 واجهات الشبكة

الوثيقة	الوصف	الأسطر
pfcp-interface.md	واجهة PFCP/Sxb إلى PGW-U	1,355
diameter-gx.md	واجهة Diameter Gx إلى PCRF (تحكم السياسة)	941
diameter-gy.md	واجهة Diameter Gy/Ro إلى OCS (الشحن عبر الإنترنت)	1,100+
charging-override.md	تجاوز الشحن عبر الإنترنت لتعطيل الشحن أثناء حادث OCS	-
s5s8-interface.md	واجهة GTP-C S5/S8 إلى SGW-C	456

📊 العمليات والمراقبة

الوثيقة	الوصف	الأسطر
session-management.md	دورة حياة جلسة PDN والعمليات	435
monitoring.md	مقاييس Prometheus، لوحات معلومات Grafana، التنبيهات	807
data-cdr-format.md	تنسيق ملف CDR، تكوين URR، الشحن غير المتصل	847
qos-bearers.md	إدارة جودة الخدمة والحامل، التحكم في السياسة	448
troubleshooting.md	إجراءات استكشاف الأخطاء الشائعة والمشكلات	687

🔧 الميزات المتقدمة

الوثيقة	الوصف	الأسطر
pcscf-monitoring.md	اكتشاف P-CSCF ومراقبة الصحة	894

ميزات الوثائق

📈 مخططات Mermaid

تتضمن جميع الوثائق مخططات Mermaid لفهم بصري:

مخططات العمارة
مخططات التسلسل (تدفقات الرسائل)
آلات الحالة
طوبولوجيا الشبكة

💡 أمثلة عملية

تتضمن كل وثيقة:

أمثلة تكوين من العالم الحقيقي
تكوينات جاهزة للنسخ واللصق
حالات استخدام شائعة

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

تتضمن كل وثيقة واجهة:

مشكلات شائعة وحلول
أوامر تصحيح
مقاييس للتشخيص

🔗 المراجع المتقاطعة

تم ربط الوثائق بشكل مكثف لتسهيل التنقل.

مسارات القراءة

لمشغلي الشبكة

OPERATIONS.md - نظرة عامة (هذه الوثيقة)
configuration.md - ��لإعداد
monitoring.md - المراقبة
session-management.md - العمليات اليومية

لمهندسي الشبكة

OPERATIONS.md - نظرة عامة على العمارة (هذه الوثيقة)
pfcp-interface.md - التحكم في مستوى المستخدم
diameter-gx.md - التحكم في السياسة
diameter-gy.md - الشحن عبر الإنترنت
s5s8-interface.md - إدارة الجلسات
ue-ip-allocation.md - إدارة IP

للتكوين والنشر

configuration.md - مرجع كامل
ue-ip-allocation.md - مجموعات IP
pco-configuration.md - معلمات الشبكة
monitoring.md - إعداد المراقبة

إحصائيات الوثائق

إجمالي الوثائق: 14
إجمالي الأسطر: ~10,900+
إجمالي الحجم: ~265 كيلوبايت
مخططات Mermaid: 75+
أمثلة الشيفرة: 150+

المفاهيم الرئيسية المغطاة

العمارة

✅ فصل التحكم/مستوى المستخدم
✅ عمارة OTP/Elixir
✅ إشراف العمليات
✅ جلسات قائمة على GenServer

البروتوكولات

✅ PFCP (بروتوكول التحكم في توجيه الحزم)
✅ GTP-C v2 (بروتوكول نفق GPRS)
✅ Diameter (RFC 6733)

واجهات 3GPP

✅ Sxb (PGW-C ↔ PGW-U)
✅ Gx (PGW-C ↔ PCRF)
✅ Gy/Ro (PGW-C ↔ OCS)
✅ S5/S8 (SGW-C ↔ PGW-C)

العمليات

✅ إدارة الجلسات
✅ استراتيجيات تخصيص IP
✅ تنفيذ جودة الخدمة
✅ تكامل الشحن
✅ المراقبة والتنبيهات

موارد إضافية

مواصفات 3GPP

المواصفة	العنوان
TS 29.274	GTP-C v2 (واجهة S5/S8)
TS 29.244	PFCP (واجهة Sxb)
TS 29.212	واجهة Diameter Gx (تحكم السياسة)
TS 32.299	تطبيقات الشحن Diameter (Gy/Ro)
TS 32.251	شحن النطاق الموجه للحزم
TS 23.401	عمارة EPC

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

مرجع التكوين: configuration.md - مرجع كامل لـ config/runtime.exs

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

نظرة عامة​

ما الذي تفعله PGW-C​

العمارة​

نظرة عامة على المكونات​

العمارة العملية​

واجهات الشبكة​

واجهة S5/S8 (GTP-C v2)​

واجهة Sxb (PFCP)​

واجهة Gx (Diameter)​

المفاهيم الأساسية​

جلسة PDN​

سياق الحامل​

قواعد PFCP​

تخصيص عنوان IP​

البدء​

المتطلبات الأساسية​

بدء OmniPGW​

التحقق من التشغيل​

التكوين​

نظرة عامة على التكوين​

مرجع تكوين سريع​

مراقبة العمليات في الوقت الحقيقي (OAM API)​

الوصول إلى واجهة OAM API​

الميزات الرئيسية​

سير العمل التشغيلي​

واجهة API مقابل القياسات​

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

القياسات المتاحة​

الوصول إلى المقاييس​

الوثائق التفصيلية​

هيكل الوثائق​

الوثائق حسب الموضوع​

🚀 البدء​

⚙️ التكوين​

🔌 واجهات الشبكة​

📊 العمليات والمراقبة​

🔧 الميزات المتقدمة​

ميزات الوثائق​

📈 مخططات Mermaid​

💡 أمثلة عملية​

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

🔗 المراجع المتقاطعة​

مسارات القراءة​

لمشغلي الشبكة​

لمهندسي الشبكة​

للتكوين والنشر​

إحصائيات الوثائق​

المفاهيم الرئيسية المغطاة​

العمارة​

البروتوكولات​

واجهات 3GPP​

العمليات​

موارد إضافية​

مواصفات 3GPP​

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

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

نظرة عامة

ما الذي تفعله PGW-C

العمارة

نظرة عامة على المكونات

العمارة العملية

واجهات الشبكة

واجهة S5/S8 (GTP-C v2)

واجهة Sxb (PFCP)

واجهة Gx (Diameter)

المفاهيم الأساسية

جلسة PDN

سياق الحامل

قواعد PFCP

تخصيص عنوان IP

البدء

المتطلبات الأساسية

بدء OmniPGW

التحقق من التشغيل

التكوين

نظرة عامة على التكوين

مرجع تكوين سريع

مراقبة العمليات في الوقت الحقيقي (OAM API)

الوصول إلى واجهة OAM API

الميزات الرئيسية

سير العمل التشغيلي

واجهة API مقابل القياسات

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

القياسات المتاحة

الوصول إلى المقاييس

الوثائق التفصيلية

هيكل الوثائق

الوثائق حسب الموضوع

🚀 البدء

⚙️ التكوين

🔌 واجهات الشبكة

📊 العمليات والمراقبة

🔧 الميزات المتقدمة

ميزات الوثائق

📈 مخططات Mermaid

💡 أمثلة عملية

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

🔗 المراجع المتقاطعة

مسارات القراءة

لمشغلي الشبكة

لمهندسي الشبكة

للتكوين والنشر

إحصائيات الوثائق

المفاهيم الرئيسية المغطاة

العمارة

البروتوكولات

واجهات 3GPP

العمليات

موارد إضافية

مواصفات 3GPP

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