การเปิดใช้บันทึกการแก้ไขข้อบกพร่อง NGINX ในเราเตอร์

คุณกำลังดูเอกสารประกอบ Apigee Edge
ไปที่ เอกสารประกอบเกี่ยวกับ Apigee X. ข้อมูล

ใน Apigee เราเตอร์จะได้รับการกำหนดค่าให้บันทึกเฉพาะข้อความแสดงข้อผิดพลาดในไฟล์บันทึกข้อผิดพลาดเท่านั้นโดย "ค่าเริ่มต้น" แต่อาจมีหลายๆ สถานการณ์ที่คุณอาจต้องรวบรวมข้อมูลเพิ่มเติมเพื่อ ระบุสาเหตุของข้อผิดพลาดที่เฉพาะเจาะจง วิธีหนึ่งที่ทำได้คือกำหนดค่าเราเตอร์เป็น ทำงานในโหมดแก้ไขข้อบกพร่องเพื่อให้คุณได้รับบันทึกการแก้ไขข้อบกพร่อง ซึ่งจะช่วยได้ข้อมูลเพิ่มเติม เกี่ยวกับข้อผิดพลาดและแก้ปัญหาได้เร็วขึ้น

เอกสารนี้อธิบายวิธีเปิดใช้บันทึกการแก้ไขข้อบกพร่องบนเราเตอร์ของ Apigee Edge สำหรับคำขอใน โฮสต์เสมือนเฉพาะที่ต้องการ เปิดใช้การบันทึกการแก้ไขข้อบกพร่องเพื่อบันทึกข้อมูลเพิ่มเติมได้หากมี เช่น คำขอผิดรูปแบบ 400 คำขอไม่ถูกต้อง - ข้อผิดพลาดของใบรับรอง SSL บน ไปทางเหนือ (ระหว่างแอปพลิเคชันไคลเอ็นต์และเราเตอร์)

ก่อนเริ่มต้น

• หากคุณไม่คุ้นเคยกับบันทึกข้อผิดพลาดของ NGINX และระดับการบันทึก โปรดดูที่ เอกสารประกอบเกี่ยวกับบันทึกข้อผิดพลาดของ NGINX
• รวบรวมชื่อองค์กร สภาพแวดล้อม และชื่อโฮสต์เสมือนของคำขอ API ที่ เพื่อรวบรวมข้อมูลการแก้ไขข้อบกพร่อง

การเปิดใช้บันทึกการแก้ไขข้อบกพร่อง NGINX บนเราเตอร์

ส่วนนี้จะอธิบายวิธีเปิดใช้บันทึกการแก้ไขข้อบกพร่องบน Edge Router

ระบุไฟล์การกำหนดค่าโฮสต์เสมือนที่เกี่ยวข้อง

ขั้นตอนต่อไปนี้อธิบายวิธีค้นหาไฟล์การกำหนดค่าโฮสต์เสมือนที่เกี่ยวข้องบนเราเตอร์

1. หากคุณทราบชื่อองค์กร ชื่อสภาพแวดล้อม และโฮสต์เสมือนสำหรับ API ที่ระบุ ที่คุณต้องการแก้ไขข้อบกพร่อง จากนั้น กำหนดไฟล์ conf โฮสต์เสมือน ดังนี้
   1. ไปที่ไดเรกทอรี /opt/nginx/conf.d/
   2. ค้นหาไฟล์ ORG_NAME_ENV_NAME_VIRTUALHOST.conf ในไดเรกทอรี conf.d โดยใช้คำสั่งต่อไปนี้

      ls -ltrh | grep "ORG_NAME_ENV_NAME_VIRTUALHOST_NAME"
      

2. ถ้าคุณไม่ทราบชื่อองค์กร คุณสามารถระบุการกำหนดค่าโฮสต์เสมือน โดยใช้ชื่อแทนโฮสต์ที่ใช้ในคำขอ API ดังนี้

   ไปยังไดเรกทอรี /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. ถ้าคุณต้องการเก็บบันทึกการแก้ไขข้อบกพร่องในเราเตอร์มากกว่า 1 ตัว ให้ทำขั้นตอนเหล่านี้ซ้ำในแต่ละเราเตอร์ เราเตอร์

การยืนยันข้อมูลการแก้ไขข้อบกพร่องบันทึกไว้ในไฟล์บันทึกข้อผิดพลาด NGINX

1. เมื่อลูกค้าส่งคำขอ API ในชื่อแทนของโฮสต์และพอร์ตที่เชื่อมโยงกับโฮสต์เสมือน บันทึกการแก้ไขข้อบกพร่องไว้ในไฟล์ต่อไปนี้

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

2. ยืนยันว่าคุณเห็นข้อมูลการแก้ไขข้อบกพร่องของคำขอ API ตามที่แสดงในตัวอย่างต่อไปนี้

   ตัวอย่างข้อมูลการแก้ไขข้อบกพร่อง

   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. หากคุณต้องการหยุดบันทึกการแก้ไขข้อบกพร่องในเราเตอร์มากกว่า 1 ตัว ให้ทำขั้นตอนเหล่านี้ซ้ำในแต่ละเราเตอร์ เราเตอร์

การยืนยันเฉพาะข้อมูลข้อผิดพลาดจะถูกบันทึกในไฟล์บันทึกข้อผิดพลาดของ NGINX

1. สร้างคำขอ API บางรายการในชื่อแทนของโฮสต์และพอร์ตที่เชื่อมโยงกับโฮสต์เสมือนที่ระบุ การกำหนดค่า หรือรอให้ไคลเอ็นต์ส่งคำขอ
2. ตรวจสอบไฟล์ต่อไปนี้ /opt/apigee/var/log/edge-router/nginx/ORG_NAME~ENV_NAME.PORT_error_log
3. ยืนยันว่าคุณเห็นเฉพาะข้อมูลข้อผิดพลาดและข้อมูลการแก้ไขข้อบกพร่องไม่ได้แล้ว บันทึกไว้สำหรับคำขอ
4. หากคุณยังเห็นว่าระบบบันทึกข้อมูลการแก้ไขข้อบกพร่องเพิ่มเติมอยู่ ให้ตรวจสอบว่าคุณได้ ปฏิบัติตามขั้นตอนทั้งหมดที่ระบุไว้ใน ปิดใช้บันทึกการแก้ไขข้อบกพร่องสำหรับโฮสต์เสมือนที่เฉพาะเจาะจงบนเราเตอร์อย่างถูกต้อง หากคุณมี ลืมขั้นตอนใดไป ทำขั้นตอนทั้งหมดซ้ำให้ถูกต้อง
5. หากคุณยังคงไม่ได้รับข้อมูลการแก้ไขข้อบกพร่อง โปรดติดต่อ การสนับสนุน Apigee Edge