503 الخدمة غير متوفرة - NoActiveTargets

أنت تعرض مستندات Apigee Edge.
انتقل إلى مستندات Apigee X. معلومات

الفيديوهات

يمكنك الاطّلاع على الفيديوهات التالية للحصول على مزيد من المعلومات حول أخطاء 503:

المشكلة

يتلقّى تطبيق العميل رمز حالة استجابة HTTP 503 مع الرسالة الخدمة غير متوفرة ورمز الخطأ NoActiveTargets لطلبات الخادم الوكيل لواجهة برمجة التطبيقات.

رسالة الخطأ

سترى استجابة الخطأ التالية:

HTTP/1.1 503 Service Unavailable
  

ستظهر لك رسالة الخطأ التالية في استجابة HTTP:

{
   "fault": {
      "faultstring": "The Service is temporarily unavailable",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.NoActiveTargets"
       }
    }
}
  

الأسباب المحتملة

تتم عادةً ملاحظة رسالة استجابة HTTP 503 Service Unavailable ورمز الخطأ NoActiveTargets عند استخدام خادم مستهدف واحد أو أكثر في إعداد نقطة النهاية المستهدفة في الخادم الوكيل لواجهة برمجة التطبيقات.

يسرد الجدول التالي الأسباب المحتملة للاستجابة 503 Service Unavailable مع رمز الخطأ NoActiveTargets:

السبب: تم إيقاف الخادم الهدف

وإذا تم إيقاف جميع الخوادم المستهدفة المحددة في إعداد نقطة النهاية المستهدفة، فحينئذٍ الحصول على استجابة 503 Service Unavailable مع رمز الخطأ NoActiveTargets.

التشخيص

1. يمكنك تحديد اسم الخادم الهدف المُستخدَم في نقطة النهاية المستهدَفة المحدّدة. ضبط خادم وكيل واجهة برمجة التطبيقات الذي أخفق باستخدام إحدى الطرق التالية:
1. إذا كانت هناك نقطة نهاية هدف واحدة، تحقَّق من نقطة النهاية المستهدَفة المحدّدة هذه.
2. في حال وجود نقاط نهاية مستهدفة متعددة وإذا لم تكن متأكدًا من الخادم الذي أوقف الخادم الهدف، يُرجى اتّباع الخطوات التالية:
1. تفعيل جلسة التتبع، وإجراء طلب بيانات من واجهة برمجة التطبيقات وإعادة إظهار المشكلة - خدمة 503 غير متوفرة.
2. من التتبع، انتقِل إلى تدفق الطلب المستهدف الذي تم بدءه وحدِّد اسم نقطة النهاية الهدف كما هو موضّح أدناه:



2. بعد تحديد نقطة النهاية المستهدفة، احصل على اسم الخادم الهدف المستخدم من إعدادات نقطة النهاية المستهدفة كما هو موضح في المثال أدناه:

   <TargetEndpoint name="default">>
     <HTTPTargetConnection>
       <LoadBalancer>
         <Server name="demo-target" />
       </LoadBalancer>
       <Path>/test</Path>
     </HTTPTargetConnection>
   </TargetEndpoint>
         

   في المثال أعلاه، يتوفّر خادم مستهدَف واحد باسم demo-target.

3. احصل على تعريف لكل خادم من الخوادم المستهدفة المستخدمة في نقطة النهاية المستهدفة باستخدام واجهة مستخدم Edge أو طلب بيانات من واجهة برمجة التطبيقات Edge.

   واجهة مستخدم Edge

   للحصول على التعريف باستخدام واجهة مستخدم Edge:

   1. انتقِل إلى المشرف >. البيئات > الخوادم المستهدفة.
   2. اختَر البيئة المحدّدة التي يظهر فيها الخطأ.
   3. ابحث عن اسم الخادم الهدف المحدّد للحصول على تعريف الخادم الهدف.

      على سبيل المثال، اكتب اسم الخادم الهدف demo-target وسيظهر تعريفه على النحو الموضّح أدناه:

      

      لاحظ هنا أنّ الخادم المستهدف demo-target له اسم مستعار للمضيف، وهو المنفذ رقم وتم تفعيل طبقة المقابس الآمنة (SSL). ومع ذلك، يكون الخادم الهدف نفسه غير مفعَّل ، ويُشار إليه من خلال العنصر enabled الذي يكون غير مفعّل.

   واجهة برمجة تطبيقات Edge

   للحصول على التعريف باستخدام واجهة برمجة تطبيقات Edge:

   استخدم الحصول على TargetServer API للحصول على تعريف الخادم الهدف.

   مخرجات تعريف الخادم المستهدَف

   <TargetServer name="demo-target">
     <Host>demo-target.apigee.net</Host>
     <Port>443</Port>
     <IsEnabled>false</IsEnabled>
     <SSLInfo>
         <Enabled>true</Enabled>
     </SSLInfo>
   </TargetServer>
             

   تُظهِر نتائج واجهة برمجة التطبيقات في Apigee أنّ الاستهداف التجريبي للخادم المستهدَف تم إيقافه. حيث تم تعيين العنصر IsEnabled على "خطأ".

   نظرًا لإيقاف الخادم الهدف، سيرسل معالج الرسائل خدمة 503. غير متاح مع ظهور رمز الخطأ NoActiveTargets على الفور والاستجابة للعميل.

الدقة

يُرجى التأكّد من أنّ الخوادم المستهدفة المحددة المستخدمة في إعدادات نقطة النهاية المستهدفة في واجهة برمجة التطبيقات. يتم تفعيل الخادم الوكيل دائمًا.

<TargetServer name="demo-target">
  <Host>demo-target.apigee.net</Host>
  <Port>443</Port>
  <IsEnabled>true</IsEnabled>
  <SSLInfo>
      <Enabled>true</Enabled>
  </SSLInfo>
</TargetServer>
        

في حال استمرار المشكلة، انتقِل إلى يجب جمع معلومات التشخيص.

تشخيص المشاكل باستخدام ميزة "مراقبة واجهة برمجة التطبيقات"

تتيح لك مراقبة واجهة برمجة التطبيقات عزل المشاكل بسرعة لتشخيص مشكلات الخطأ والأداء ووقت الاستجابة ومصدرها، مثل مشكلات حساب التطبيقات أو الخوادم الوكيلة لواجهة برمجة التطبيقات أو الأهداف الخلفية أو النظام الأساسي لواجهة برمجة التطبيقات.

الاطّلاع على نموذج سيناريو يشرح كيفية تحديد مشاكل 5xx وحلّها في واجهات برمجة التطبيقات باستخدام "مراقبة واجهة برمجة التطبيقات". على سبيل المثال: يمكنك إعداد تنبيه ليتم إعلامك عند بلوغ عدد messaging.adaptors.http.flow.NoActiveTargets تتجاوز الأخطاء حدًّا معيّنًا.

يجب جمع معلومات التشخيص

في حال استمرار المشكلة حتى بعد اتّباع التعليمات أعلاه، يُرجى جمع ما يلي البيانات التشخيصية. يمكنك التواصل مع فريق Apigee Support ومشاركته مع:

1. إذا كنت من مستخدمي Public Cloud، يُرجى تقديم المعلومات التالية:
1. اسم المؤسسة
2. اسم البيئة
3. اسم الخادم الوكيل لواجهة برمجة التطبيقات
4. أكمِل أمر curl لإعادة إنتاج الخطأ.
5. ملف تتبُّع يحتوي على الطلبات ذات الحالة 503 Service غير متوفرة مع رمز الخطأ NoActiveTargets
2. إذا كنت من مستخدمي سحابة خاصة، قدِّم المعلومات التالية:
   1. تم ملاحظة رسالة خطأ كاملة
   2. اسم البيئة
   3. حزمة الخادم الوكيل لواجهة برمجة التطبيقات
   4. ملف تتبُّع يحتوي على الطلبات ذات الحالة 503 Service غير متوفرة مع رمز الخطأ NoActiveTargets
   5. سجلات وصول NGINX

      (/opt/apigee/var/log/edge-router/nginx/<org>~<env>.<port#>_access_log)

   6. سجلات معالج الرسائل

      (/opt/apigee/var/log/edge-message-processor/logs/system.log)