502 مدخل غير صالح - الاستجابة 405 بدون عنوان السماح

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

لتشخيص الخطأ باستخدام مراقبة واجهة برمجة التطبيقات:

1. سجِّل الدخول إلى واجهة مستخدم Edge كمستخدم باستخدام الدور المناسب.

2. انتقِل إلى المؤسسة التي تريد التحقيق في المشكلة فيها.

   
3. انتقل إلى تحليل > مراقبة واجهة برمجة التطبيقات > التحقيق في الصفحة.
4. اختَر الفترة الزمنية المحدّدة التي لاحظت فيها الأخطاء.

5. ارسم رمز الخطأ مقابل الوقت.

6. اختَر خلية تحتوي على رمز الخطأ. protocol.http.Response405WithoutAllowHeader كما هو موضّح أدناه:

   

7. معلومات عن رمز الخطأ protocol.http.Response405WithoutAllowHeader كما هو موضح أدناه:

   

8. انقر على عرض السجلات ووسِّع أحد الطلبات التي تعذّر تنفيذها لعرض المزيد من المعلومات.

   
9. من نافذة السجلات، يُرجى ملاحظة التفاصيل التالية:
   • رمز الحالة: 502
   • مصدر الخطأ: target
   • رمز الخطأ: protocol.http.Response405WithoutAllowHeader.
10. إذا كان مصدر الخطأ هو target وكان رمز الخطأ هو protocol.http.Response405WithoutAllowHeader، فهذا يشير إلى أن الواجهة الخلفية استجاب الخادم برمز الحالة 405 Method Not Allowed بدون عنوان Allow

أداة التتبُّع

لتشخيص الخطأ باستخدام أداة التتبُّع:

1. تمكين جلسة تتبع
   • انتظِر إلى أن يحدث الخطأ 502 Bad Gateway.
   • إذا كان بإمكانك إعادة إنتاج المشكلة، يُرجى طلب بيانات من واجهة برمجة التطبيقات لإعادة إنتاج المشكلة. خطأ واحد (502 Bad Gateway)

2. تأكَّد من تفعيل عرض كل FlowInfos:

   
3. اختَر أحد الطلبات التي تعذّر تنفيذها وافحص عملية التتبُّع.
4. يمكنك التنقّل خلال مراحل عملية التتبُّع المختلفة وتحديد مكان حدوث الفشل.

5. سيظهر الخطأ عادةً في مسار بعد النقر على تم إرسال الطلب إلى الخادم الهدف. كما هو موضح أدناه:

   

6. سجِّل قيمة الخطأ من عملية التتبُّع.

   يعرض نموذج التتبّع أعلاه الخطأ كـ Received 405 Response without Allow Header. لأنّ الخطأ يظهر في Apigee بعد إرسال الطلب إلى الخلفية فإنه يشير إلى أن خادم الخلفية أرسل رمز حالة الاستجابة 405 بدون عنوان Allow.

7. انتقِل إلى مرحلة AX (البيانات المسجَّلة في "إحصاءات Google") في عملية التتبُّع وانقر عليها.

8. مرِّر للأسفل حتى تصل إلى قسم عناوين الخطأ / عناوين الاستجابة في تفاصيل المرحلة. اللوحة وتحديد قيمتي X-Apigee-fault-code وX-Apigee-fault-code كما هو موضح أدناه:

   
9. وستظهر لك قيم X-Apigee-fault-code وX-Apigee-fault-code على النحو التالي: protocol.http.Response405WithoutAllowHeader وtargetعلى التوالي، إلى أن هذا الخطأ ناتج عن إرسال الخلفية رمز حالة الاستجابة 405 بدون العنوان Allow.

   عناوين الردود	القيمة
   X-Apigee-fault-code	protocol.http.Response405WithoutAllowHeader
   X-Apigee-fault-source	target

NGINX

لتشخيص الخطأ باستخدام سجلات وصول NGINX:

1. إذا كنت مستخدمًا للسحابة الإلكترونية الخاص، يمكنك استخدام سجلات وصول NGINX لتحديد المعلومات الأساسية حول أخطاء HTTP 502.

2. تحقق من سجلات وصول NGINX:

   /opt/apigee/var/log/edge-router/nginx/ORG~ORG.PORT#_access_log
   

   المكان: يتم استبدال ORG وORG وPORT# بقيم فعلية.

3. البحث لمعرفة ما إذا كان هناك أي أخطاء 502 مع رمز الخطأ protocol.http.Response405WithoutAllowHeader خلال مدة محدّدة (إذا كانت حدثت مشكلة في الماضي) أو إذا كانت هناك أي طلبات لا تزال تخفق مع 502

4. إذا عثرت على أي أخطاء 502 مع X-Apigee-fault-code الذي يتطابق مع بقيمة protocol.http.Response405WithoutAllowHeader، ثم حدِّد قيمة X-Apigee-fault-source..

   نموذج الخطأ 502 من سجلّ وصول NGINX:

   

   يتضمن إدخال النموذج أعلاه من سجل وصول NGINX القيم التالية الخاصة بـ X-Apigee- رمز الخطأ وX-Apigee-error-source:

   عناوين الردود	القيمة
   X-Apigee-fault-code	protocol.http.Response405WithoutAllowHeader
   X-Apigee-fault-source	target

خادم الخلفية

الخيار 1: إصلاح خادم الخلفية لإرسال رمز الحالة 405 باستخدام العنوان "السماح":

1. التأكد من أن خادم الخلفية يلتزم دائمًا بالمواصفات RFC 7231، القسم 6.5.5: 405 الطريقة غير مسموح بها ويُرسل الحالة 405 عن طريق تضمين قائمة بالطرق المسموح بها كجزء من عنوان Allow كما هو موضح أدناه:

   Allow: HTTP_METHODS
   

2. على سبيل المثال، إذا كان خادم الخلفية يسمح بالنطاقات GET وPOST HEAD، فحينئذٍ يجب التأكد من أن الرأس Allow يحتوي على على النحو التالي:

   Allow: GET, POST, HEAD
   

التعامل مع الأخطاء

الخيار #2: استخدام "معالجة الأخطاء" لإرسال رمز الحالة 405 باستخدام العنوان "السماح" من واجهة برمجة التطبيقات الخادم الوكيل:

إذا عرض خادم الخلفية رمز الحالة 405 بدون Allow يمكنك استخدام معالجة الأخطاء للرد باستخدام رمز الحالة 405 Allow من الخادم الوكيل لواجهة برمجة التطبيقات على النحو التالي:

1. يمكنك إنشاء سياسة مثل سياسة assignMessage أو سياسة riseFault واضبط رمز الحالة على 405 مع عنوان Allow وعنوان URL مخصّص .

   نموذج سياسة AssignMessage لإرسال رسالة 405 مع تضمين العنوان "Allow" (السماح):

   <AssignMessage async="false" continueOnError="false" enabled="true" name="AM-405WithAllowHeader">
       <DisplayName>AM-405WithAllowHeader</DisplayName>
       <Set>
           <Payload contentType="application/json">{"Specified method is not allowed. Please use one of the methods mentioned in the Allow header."}</Payload>
           <StatusCode>405</StatusCode>
           <ReasonPhrase>Method Not Allowed</ReasonPhrase>
       </Set>
       <Add>
           <Headers>
               <Header name="Allow">GET, POST, HEAD</Header>
           </Headers>
       </Add>
       <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
       <AssignTo createNew="false" transport="http" type="request"/>
   </AssignMessage>
   

2. إنشاء FaultRule في TargetEndpoint، لتطبيق السياسة عند ظهور الخطأ 502 مع رمز الخطأ protocol.http.Response405WithoutAllowHeader

   نموذج من إعدادات TargetEndpoint التي تعرض الخطأ FaultRule:

   <TargetEndpoint name="default">
   ...
       <FaultRules>
          <FaultRule name="405WithoutAllowHeader">
               <Step>
                   <Name>AM-405WithAllowHeader</Name>
               </Step>
               <Condition>(fault.name = "Response405WithoutAllowHeader")</Condition>
           </FaultRule>
       </FaultRules>
   

3. احفظ هذه التغييرات في نسخة جديدة من الخادم الوكيل لواجهة برمجة التطبيقات وانشر النسخة السابقة.
4. يمكنك إجراء طلبات البيانات من واجهة برمجة التطبيقات والتأكّد من تلقّي رمز الحالة 405 من خلال عنوان Allow

إعداد الموقع

الخيار رقم 3: إعداد الموقع في معالج الرسائل لمنع Apigee Edge من عرض الخطأ 502

1. إذا كنت من مستخدمي Private Cloud، يمكنك تعديل الموقع. من HTTP.ignore.allow_header.for.405 إلى true لمنع Apigee Edge من عرض خطأ 502 حتى إذا استجاب خادم الخلفية باستخدام 405 رمز الحالة بدون العنوان Allow باستخدام الدليل الإرشادي: تهيئة رأس السماح بالتجاهل لخاصية 405 في معالِجات معالجة الرسائل.
2. إذا كنت من مستخدمي Public Cloud، يُرجى التواصل مع فريق دعم Apigee Edge.