تحديد المشاكل المتعلقة بالدمج وحلّها

في ما يلي بعض المشاكل الشائعة وخطوات تحديدها وحلّها عند دمج موصّل "مركز واجهات برمجة التطبيقات".

لا تظهر البيانات الوصفية لواجهة برمجة التطبيقات في "مركز واجهات برمجة التطبيقات"

• وقت المزامنة الأوّلية: قد يستغرق بدء المزامنة الأوّلية وظهور بيانات واجهة برمجة التطبيقات في API Hub بضع ساعات. ننصحك بالانتظار بضع ساعات.
• حالة مثيل الإضافة: تأكَّد من أنّه لم يتم حذف مثيل الإضافة في "مركز واجهات برمجة التطبيقات" أو تغييره.
• معرّف البوابة: تأكَّد من ضبط معرّف البوابة الصحيح بشكلٍ سليم في إعدادات موصّل مركز واجهات برمجة التطبيقات في Apigee Edge for Private Cloud.
• التحقّق من السجلات: تحقَّق مما إذا كان هناك أي خطأ مسجَّل في سجلات خدمة موصّل مركز واجهات برمجة التطبيقات في Edge for Private Cloud /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log.

تم نشر الخادم الوكيل ولكن المعلومات في "مركز واجهات برمجة التطبيقات" غير دقيقة

• تأخير الانتشار: اسمح ببضع دقائق لانتشار معلومات الخادم الوكيل التي تم نشرها وظهورها في "مركز واجهات برمجة التطبيقات".
• التحقّق من السجلّات: راجِع سجلّات موصّل Edge for Private Cloud API hub للحصول على تفاصيل حول الخوادم الوكيلة التي تم تحميلها. يمكن أن يساعد ذلك في تحديد ما إذا تمت معالجة تحديث الوكيل بنجاح للمزامنة.

توقّفت مزامنة مؤسسة المستخدم بدون تغيير أي شيء في موصِّل "مركز واجهات برمجة التطبيقات"

• حالة مثيل المكوّن الإضافي (من جهة "مركز واجهات برمجة التطبيقات"): تحقَّق مما إذا كان قد تم إيقاف مثيل المكوّن الإضافي المرتبط في "مركز واجهات برمجة التطبيقات" أو حذفه أو تعديله. يمكن أن تؤثّر أي تغييرات على جهة مركز واجهات برمجة التطبيقات بشكل مباشر في المزامنة من أداة ربط مركز واجهات برمجة التطبيقات.
• التحقّق من السجلّات: راجِع سجلّات موصّل مركز واجهات برمجة التطبيقات في Edge for Private Cloud بحثًا عن أي أخطاء أو تحذيرات أو مشاكل قد تشير إلى حدوث انقطاع في عملية المزامنة. يمكن أن يشمل ذلك مشاكل في الاتصال أو المصادقة باستخدام "مركز واجهات برمجة التطبيقات".

استخدام واجهة برمجة التطبيقات الخاصة بالحالة (يُنصح بها للمؤسسات التي فعّلت هذه الميزة):

توفّر واجهة برمجة التطبيقات الخاصة بالحالة طريقة مباشرة لمعرفة المؤسسات التي وافقت على المزامنة وتجريها بنشاط.

تحديد المشاكل وحلّها استنادًا إلى السجلات

أين يتم تخزين سجلات موصّل "مركز واجهات برمجة التطبيقات"؟

/opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

كيف يمكنني الحصول على معلومات حول المؤسسات التي تم تفعيلها؟

لتحديد المؤسسات التي يتم تفعيلها ومزامنتها حاليًا، يمكنك الاستفادة من واجهة برمجة التطبيقات الخاصة بالحالة وفحص سجلّات النظام.

• الإجراء: اطلب بيانات من نقطة نهاية واجهة برمجة التطبيقات الخاصة بالحالة.
• الناتج المتوقّع: سيتم إدراج المؤسسات التي وافقت على المشاركة ضمن القسمَين apiSyncStatus وanalyticsSyncStatus في ردّ واجهة برمجة التطبيقات. ستظهر المؤسسات التي تم تفعيل مزامنة البيانات الوصفية فيها ضمن apiSyncStatus، وستظهر المؤسسات التي تم تفعيل المزامنة في وقت التشغيل فيها ضمن analyticsSyncStatus.

  {
   "apiSyncStatus": [
     {
       "organization": "foo",
       "phase": "Preparing", // ColdTransfer => Preparing
       "components": [
         "proxy": {
           "lastUpdated": "2025-04-16T00:56:45Z",
           "progress": {
             "totalItems": 100, // total proxies known to uapim connector
             "pendingItems": 90,  // pending proxies to upload
             "completedItems": 6, // completed proxies to upload
             "failedItems": 4 // proxies failed to upload
           }
         },
         "environment": { //environment upload status
           "lastUpdated": "2025-04-16T00:56:45Z",
           "progress": {
             "totalItems": 5, // total number of environments
             "pendingItems": 1, // pending environments to process
             "completedItems": 3, // completed environment processing
             "failedItems": 1 // failed environment processing
           }
         }]
     },
     {
       "organization": "bar",
       "phase": "Processing", // "Streaming" -> "Processing"
       "components": [
         "proxy": {
           "lastUpdated": "2025-04-16T00:56:45Z",
           "progress": {
             "totalItems": 110, // total proxies known to uapim connector
             "pendingItems": 16, // pending proxies to upload
             "completedItems": 3, // completed proxies to upload
             "failedItems": 1 // proxies failed to upload
           }
         },
         "environment": {
           "lastUpdated": "2025-04-16T00:56:45Z",
           "progress": {
             "totalItems": 5, // total number of environments
             "pendingItems": 3, // pending environments to process
             "completedItems": 1, // completed environment processing
             "failedItems": 1 // failed environment processing
           }
         }]
     },
     {
       "organization": "test",
       "phase": "Queued", // "Yet to start" -> "Queued"
       "lastUpdated": "2025-04-16T00:56:45Z"
     }
   ],
   "analyticsSyncStatus": [
     {
       "organization": "test",
       "environment": "dev",
       "failedItems": 2,
       "lastUpdated": "2025-04-16T00:56:45Z"
     },
     {
       "organization": "test",
       "environment": "prod",
       "failedItems": 4,
       "lastUpdated": "2025-04-16T00:56:45Z"
     }
   ]
  }
  

• فحص سجلّات النظام: للحصول على عرض أكثر تفصيلاً ولتأكيد إعداد المزامنة لمؤسسات فردية، يمكنك فحص سجلّات النظام بحثًا عن إدخالات معيّنة.
  • مراجعة السجلات:

    /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

  • أوامر البحث: استخدِم grep أو أدوات مشابهة للبحث في السجلّات للعثور على أسطر السجلّ التالية:
    • لمزامنة البيانات الوصفية للمؤسسة:

      grep "Setup metadata sync for organization: metadata-org"  /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

    • مثال على مقتطف من السجلّ:

      2025-07-10 08:47:09,901  main INFO  c.a.u.c.UAPIMConnectorServiceImpl - UAPIMConnectorServiceImpl.setupMetadataSync() : Setup metadata sync for organization: metadata-org

    • ابحث عن النص إعداد مزامنة البيانات الوصفية للمؤسسة: متبوعًا باسم المؤسسة.
    • لمزامنة بيانات وقت التشغيل في وقت التشغيل في المؤسسة:

      grep "Setup runtime data sync for organization: runtime-org" /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

    • مثال على مقتطف من السجلّ:

      2025-07-10 08:47:09,902  main INFO  c.a.u.c.UAPIMConnectorServiceImpl - UAPIMConnectorServiceImpl.setupRuntimeSyncData() : Setup runtime data sync for organization: runtime-org

    • ابحث عن النص إعداد مزامنة بيانات وقت التشغيل للمؤسسة: متبوعًا باسم المؤسسة.

كيف يمكنني الحصول على معلومات عن جميع (المؤسسات والبيئات) التي تعذّر تفعيلها من السجلات؟

للحصول على معلومات حول المؤسسات التي تعذّر تفعيلها، يمكنك فحص سجلّات النظام بحثًا عن إدخالات أخطاء معيّنة.

• مراجعة السجلات: /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log
• أوامر البحث: استخدِم grep أو أدوات مشابهة للبحث في السجلّات للعثور على أسطر السجلّ التي تشير إلى حدوث خطأ أثناء تعديل حالة مزامنة البيانات الوصفية.
  • بالنسبة إلى إشعارات الحالة التي تعذّر فيها مزامنة البيانات الوصفية للمؤسسة/البيئة، تكون القيمة failed-org/failed-env:

    grep "Error while updating metadata sync status for org: failed-org" /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

  • مثال على مقتطف من السجلّ:

    2025-07-15 10:30:15,123 main ERROR c.a.u.c.UAPIMConnectorServiceImpl - UAPIMConnectorServiceImpl.updateMetadataSyncStatus() : Error while updating metadata sync status for org: failed-org

  • ابحث عن النص Error while updating metadata sync status for org/env: متبوعًا بالمؤسسة والبيئة (على سبيل المثال، failed-org/failed-env).

كيف يمكنني الحصول على ملخّص لتغيير حالة نقل المؤسسة من السجلات؟

للحصول على ملخّص عن وقت تعديل حالة نقل المزامنة (المؤسسة، البيئة)، يمكنك الاطّلاع على سجلات النظام بحثًا عن إدخالات معيّنة.

• مراجعة السجلات: /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log
• أوامر البحث استخدِم grep أو أدوات مشابهة للبحث في السجلّات للعثور على أسطر السجلّ التي تشير إلى تعديل حالة النقل لمؤسسة وبيئة.
  • لمعرفة آخر الأخبار حول حالة النقل:

    grep "Transfer status is updated for org" /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

  • مثال على مقتطف من السجلّ:

    2025-07-15 18:35:01,789 main INFO c.a.u.c.UAPIMConnectorServiceImpl - UAPIMConnectorServiceImpl.updateTransferStatus() : Transfer status is updated for org: org1 to BULK_TRANSFER
    2025-07-10 08:47:11,364  main INFO  c.a.u.m.UAPIMMetadataServiceImpl - UAPIMMetadataServiceImpl.updateEnvironmentStatus() : Transfer status is updated for org: org1 to STREAMING

  • ابحث عن النص "تم تعديل حالة النقل للمؤسسة/البيئة" متبوعًا بالمؤسسة والبيئة المحدّدتين (مثل org1/prod) والحالة.