تفعيل سجلات تصحيح الأخطاء في NGINX على أجهزة التوجيه

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

في Apigee، يتم ضبط أجهزة التوجيه لتسجيل رسائل الخطأ في ملفات سجلّ الأخطاء فقط من خلال الافتراضي. ومع ذلك، قد تحتاج في العديد من المواقف إلى جمع مزيد من المعلومات لتحديد سبب حدوث خطأ معين. إحدى طرق إجراء ذلك هي ضبط جهاز التوجيه على تعمل في وضع تصحيح الأخطاء كي تتمكّن من الحصول على سجلات تصحيح الأخطاء التي يمكن أن تساعدك في الحصول على مزيد من المعلومات حول الخطأ وحله بشكل أسرع.

يشرح هذا المستند كيفية تفعيل سجلات تصحيح الأخطاء على جهاز توجيه Apigee Edge للطلبات على مضيف ظاهري محدد. يمكن تفعيل تسجيل تصحيح الأخطاء لالتقاط المزيد من المعلومات عند توفّر أي المشكلات مثل الطلب المكتوب بشكل غير صحيح الخطأ 400 طلب غير صالح - خطأ في شهادة طبقة المقابس الآمنة (SSL)، على الاتجاه الشمالي (بين تطبيق العميل وجهاز التوجيه).

قبل البدء

• إذا لم تكن على دراية بسجلات أخطاء NGINX ومستويات التسجيل، يُرجى الرجوع إلى مستندات سجلّ أخطاء NGINX
• جمع أسماء المؤسسات والبيئة والمضيف الافتراضي لطلبات البيانات من واجهة برمجة التطبيقات التي تحتاج إلى جمع معلومات تصحيح الأخطاء.

تفعيل سجلات تصحيح أخطاء NGINX على أجهزة التوجيه

يوضح هذا القسم كيفية تفعيل سجلات تصحيح الأخطاء على أجهزة توجيه Edge.

تحديد ملف تهيئة المضيف الظاهري ذا الصلة

توضّح الخطوات التالية كيفية تحديد موقع ملف إعداد المضيف الظاهري ذي الصلة على جهاز التوجيه:

1. إذا كنت تعرف اسم المؤسسة واسم البيئة والمضيف الافتراضي لواجهة برمجة التطبيقات المحددة الذي تريد تصحيح أخطائه، ثم تحديد ملف إعلام المضيف الظاهري على النحو التالي:
   1. الانتقال إلى الدليل /opt/nginx/conf.d/
   2. البحث عن ملف ORG_NAME_ENV_NAME_VIRTUALHOST.conf في الدليل conf.d باستخدام الأمر التالي:

      ls -ltrh | grep "ORG_NAME_ENV_NAME_VIRTUALHOST_NAME"
      

2. إذا كنت لا تعرف اسم المؤسسة، يمكنك تحديد إعدادات المضيف الافتراضي. باستخدام الاسم المستعار للمضيف الذي يُستخدم في طلب واجهة برمجة التطبيقات على النحو التالي:

   انتقِل إلى دليل /opt/nginx/conf.d/ وابحث عن hostalias الذي تم إجراء الطلب من خلاله باستخدام الأمر التالي:

   ls -ltrh | grep -r 'HOST_ALIAS_NAME'
   

   نموذج الناتج:

   لنفترض أن اسم المضيف البديل هو opdk.cert-test.com. عند تشغيل ls -ltrh، وعندئذٍ ستظهَر لك النتيجة كما هو موضّح أدناه:

   

تمكين تسجيل تصحيح الأخطاء لمضيف افتراضي محدد على جهاز التوجيه

توضِّح الخطوات التالية كيفية تفعيل سجلّات تصحيح الأخطاء على أجهزة توجيه Apigee لجهاز توجيه المضيف الظاهري.

1. افتح الملف التالي على جهاز التوجيه في محرر: /opt/nginx/conf.d/ORG_NAME_ENV_NAME_VIRTUALHOST_NAME.conf مثل:

   vi /opt/nginx/conf.d/ORG_NAME_ENV_NAME_VIRTUALHOST_NAME.conf
   

2. غيِّر السطر التالي:

   error_log /opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log error;
   

   إلى

   error_log /opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log info;
   

3. احفظ التغييرات.
4. شغّل أمر إعادة التحميل NGINX. مثل:

   sudo /opt/nginx/scripts/apigee-nginx reload
   

5. سيلتقط الملف التالي الآن سجلات تصحيح الأخطاء:

   /opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log
   

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

يتم تسجيل التحقق من معلومات تصحيح الأخطاء في ملف سجلّ أخطاء NGINX.

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

   /opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log

2. تحقَّق من ظهور معلومات تصحيح الأخطاء لطلبات البيانات من واجهة برمجة التطبيقات كما هو موضّح في المثال التالي:

   نموذج معلومات تصحيح الأخطاء:

   2021/01/27 02:48:40 [warn] 27624#27624: *3777 a client request body is buffered to a temporary file /opt/apigee/var/log/edge-router/nginx/client_temp/0000000001, client: XX.XX.XX.XX, server: XX.XX.XX.XX, request: "POST /post-no-target HTTP/1.1", host: "XX.XX.XX.XX:443"
   

   سيتم تسجيل المعلومات المعروضة أعلاه عندما يرسِل العميل طلب POST باستخدام حمولة كبيرة. لن يظهر هذا السجلّ إلا عندما يكون تسجيل تصحيح الأخطاء مفعَّلاً.

3. في حال لم تظهر لك معلومات تصحيح الأخطاء الإضافية، تأكَّد من اتّباع جميع الخطوات الموضحة في تفعيل تسجيل تصحيح الأخطاء لمضيف افتراضي محدّد على جهاز التوجيه بشكل صحيح. إذا كان لديك أي خطوة فائتة، فقم بتكرار جميع الخطوات مرة أخرى بشكل صحيح.
4. إذا كنت لا تزال غير قادر على الحصول على معلومات تصحيح الأخطاء، يُرجى التواصل مع فريق دعم Apigee Edge.

إيقاف سجلات تصحيح الأخطاء لمضيف افتراضي مُحدَّد على جهاز التوجيه

يشرح هذا القسم كيفية إيقاف سجلات تصحيح الأخطاء في جهاز التوجيه لمضيف افتراضي محدّد.

1. افتح الملف التالي على جهاز التوجيه في محرر: /opt/nginx/conf.d/ORG_NAME_ENV_NAME_VIRTUALHOST_NAME.conf مثل:

   vi /opt/nginx/conf.d/ORG_NAME_ENV_NAME_VIRTUALHOST_NAME.conf
   

2. غيِّر السطر التالي:

   error_log /opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log info;
   

   إلى

   error_log /opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log error;
   

3. احفظ التغييرات.
4. شغّل أمر إعادة التحميل NGINX. مثل:

   /opt/nginx/scripts/apigee-nginx reload
   

5. سيلتقط الملف التالي الآن سجلات الخطأ فقط:

   /opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log
   

6. إذا أردت إيقاف سجلات تصحيح الأخطاء على أكثر من جهاز توجيه، كرِّر هذه الخطوات في كل جهاز من أجهزة التوجيه.

التحقق من معلومات الخطأ فقط مُسجلاً في ملف سجل أخطاء NGINX

1. تقديم بعض طلبات البيانات من واجهة برمجة التطبيقات على العنوان البديل للبريد الإلكتروني والمنفذ المرتبط بالمضيف الافتراضي المحدّد التهيئة أو الانتظار حتى يقوم العملاء بتقديم الطلبات.
2. تحقَّق من الملف التالي: /opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log
3. يُرجى التأكّد من ظهور معلومات الخطأ فقط وأنّ معلومات تصحيح الأخطاء لم تعُد. لتسجيل الطلبات.
4. إذا استمر تسجيل معلومات تصحيح أخطاء إضافية، تحقَّق من أنّ لديك اتبعت جميع الخطوات الموضحة في إيقاف سجلات تصحيح الأخطاء لمضيف افتراضي محدّد على جهاز التوجيه بشكل صحيح. إذا كان لديك أي خطوة فائتة، فقم بتكرار جميع الخطوات مرة أخرى بشكل صحيح.
5. إذا كنت لا تزال غير قادر على الحصول على معلومات تصحيح الأخطاء، يُرجى التواصل مع دعم Apigee Edge