التحقّق من حالة التحميل والأخطاء

يمكنك التحقّق من حالة عمليات تحميل البيانات الوصفية وبيانات وقت التشغيل في أي وقت من خلال طلب البحث من Apigee API Hub عن نقطة نهاية الحالة المحلية لموصل Private Cloud.

التحقّق من حالة التحميل

استخدِم أمر curl التالي على الجهاز الافتراضي الذي يشغّل موصِّل Apigee API Hub for Private Cloud:

curl localhost:8080/v1/uapim/status

    {
      "APIMetadata": [
        {
          "organization": "test",
          "environment": "dev",
          "stage": "BULK_TRANSFER",
          "totalDeployments": 100,
          "completed": 10,
          "lastUpdated": "04-16-2025 00:56:45",
          "errors": 0
        },
        {
          "organization": "test",
          "environment": "prod",
          "stage": "STREAMING",
          "pendingUploads": 10,
          "errors": 1,
          "lastUpdated": "04-16-2025 00:56:45"
        },
        {
          "organization": "test1",
          "environment": "staging",
          "stage": "Yet to Start",
          "lastUpdated": "04-16-2025 00:56:45"
        }
      ],
      "RuntimeData": [
        {
          "organization": "test",
          "environment": "dev",
          "errorCount": 2,
          "lastUpdated": "04-16-2025 00:56:45"
        },
        {
          "organization": "test",
          "environment": "prod",
          "errorCount": 4,
          "lastUpdated": "04-16-2025 00:56:45"
        },
        {
          "organization": "test1",
          "environment": "staging",
          "errorCount": 0,
          "lastUpdated": "04-16-2025 00:56:45"
        }
      ]
    }

تقدّم النتيجة إحصاءات حول ما يلي:

• البيانات الوصفية لواجهة برمجة التطبيقات: حالة عمليات تحميل البيانات الوصفية لواجهة برمجة التطبيقات، بما في ذلك المؤسسة والبيئة والمرحلة الحالية (مثل "النقل المجمّع" و"البث" و"لم يبدأ بعد") وإجمالي عمليات التحميل/المكتملة/في انتظار المراجعة وعدد الأخطاء ووقت آخر تعديل.
• البيانات الوصفية لوقت التشغيل: حالة عمليات تحميل بيانات وقت التشغيل، مع عرض المؤسسة والبيئة وعدد الأخطاء ووقت آخر تعديل

المشاكل الشائعة وخطوات تحديد المشاكل وحلّها

في حال مواجهة مشاكل، يُرجى الرجوع إلى سجلّات الموصل ونقطة نهاية الحالة. يقع ملف السجلّ الرئيسي لموصل مركز Apigee في /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log

1. لا يبدأ موصّل Apigee API Hub لـ Private Cloud:
   • التحقّق من السجلّات: افحص /opt/apigee/var/log/edge-uapim-connector/edge-uapim-connector.log بحثًا عن رسائل الخطأ المتعلّقة بالإعداد.
   • التحقّق من الإعدادات: تحقَّق مرة أخرى من جميع الإعدادات التي تم ضبطها في uapim-connector.properties ومتغيّرات البيئة.
   • إذن الوصول إلى Pub/Sub: تحقَّق في السجلّات مما إذا كان opdk-connector قادرًا على الوصول إلى مواضيع Pub/Sub المقدَّمة.
   • الوصول إلى خادم الإدارة: تحقَّق من السجلّات لمعرفة ما إذا كان opdk-connector يمكنه إرسال طلب بنجاح إلى خادم إدارة Apigee باستخدام عنوان URL وبيانات الاعتماد المحدّدة.
   • وقت بدء التشغيل: إذا كان هناك الآلاف من عمليات النشر في بيئة Apigee، قد يستغرق موصّل Apigee Hub حوالي 20 إلى 30 دقيقة لبدء التشغيل.
2. لا تظهر البيانات الوصفية لواجهة برمجة التطبيقات في "مركز واجهات برمجة التطبيقات":
   • سجلات الموصل: راجِع سجلات opdk-connector لمعرفة ما إذا كان بإمكانها الوصول إلى موضوع Pub/Sub الخاص بالبيانات الوصفية لواجهة برمجة التطبيقات واستدعاء خادم الإدارة.
   • حالة التحميل: اطّلِع على الناتج curl localhost:8080/v1/uapim/status. ابحث عن القسم APIMetadata.
     • هل lastUpdated حديث؟
     • هل يزداد عدد الأخطاء باستمرار؟
     • ما هي المرحلة التي يمرّ بها؟
   • الاستثناءات/الأخطاء: ابحث في السجلّات عن أي استثناءات أو أخطاء تم رصدها في ما يتعلق بمعالجة البيانات الوصفية.
3. عدم ظهور بيانات وقت التشغيل في "مركز واجهات برمجة التطبيقات":
   • سجلّات الموصل: تحقَّق مما إذا كان بإمكان opdk-connector الوصول إلى موضوع Pub/Sub في وقت التشغيل واستدعاء خادم الإدارة.
   • حالة التحميل: استخدِم الأمر curl localhost:8080/v1/uapim/status. ركِّز على القسم RuntimeData.
     • هل lastUpdated حديث؟
     • هل يزداد عدد الأخطاء باستمرار؟
   • الاستثناءات/الأخطاء: ابحث عن أي استثناءات أو أخطاء في السجلات ذات الصلة بمعالجة بيانات وقت التشغيل.
   • إعداد معالج الرسائل: تأكَّد من ضبط message-processor-communication.properties بشكلٍ صحيح على جميع معالجات الرسائل لعملية الكتابة المزدوجة، ومن إعادة تشغيل معالجات الرسائل.
   • تركيب نظام ملفات الشبكة (NFS): تأكَّد من إعداد تركيب نظام ملفات الشبكة بشكلٍ صحيح وإمكانية الوصول إليه من خلال كلّ من "المعالجات" وموصّل UAPIM.
4. تم نشر الخادم الوكيل، ولكن المعلومات في "مركز واجهات برمجة التطبيقات" غير دقيقة:
   • مدة الانتظار: اسمح بمرور بضع دقائق حتى يتم نشر البيانات.
   • السجلات: راجِع سجلّات opdk-connector للحصول على معلومات حول الخوادم الوكيلة التي تم تحميلها. يمكن أن يساعد ذلك في تحديد ما إذا كان الموصّل يعالج أحداث النشر.