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

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلىمستندات Apigee X. info

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

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

قبل البدء

• إذا لم تكن على دراية بسجلّات أخطاء 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.