เปิดใช้การหมุนบันทึกสําหรับ edge-message-processor.log

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

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

ใน Edge for Private Cloud ระบบจะกำหนดค่าไฟล์บันทึกหลักบางไฟล์ในคอมโพเนนต์ apigee แต่ละรายการด้วยกลไกการหมุนเวียนเริ่มต้น เช่น ในคอมโพเนนต์ Message Processor ระบบจะกำหนดค่าไฟล์ต่อไปนี้ด้วยกลไกการหมุนเวียนเริ่มต้น โดยใช้ logback

• /opt/apigee/var/log/edge-message-processor/logs/system.log
• /opt/apigee/var/log/edge-message-processor/logs/events.log
• /opt/apigee/var/log/edge-message-processor/logs/startupruntimeerrors.log
• /opt/apigee/var/log/edge-message-processor/logs/configurations.log
• /opt/apigee/var/log/edge-message-processor/logs/transactions.log

ไฟล์ที่คล้ายกันนี้มีอยู่ในคอมโพเนนต์ edge-* อื่นๆ (ซึ่งมีชื่อ ขึ้นต้นด้วย edge-) เช่น edge-management-server, edge-router, edge-postgres-server, และ edge-qpid-server

คอมโพเนนต์ edge-* แต่ละรายการจะสร้างไฟล์บันทึกเพิ่มเติมซึ่งเป็นเอาต์พุตที่เปลี่ยนเส้นทาง ของคอนโซลของคอมโพเนนต์นั้นๆ ด้วย ในกรณีของคอมโพเนนต์ Message Processor, ไฟล์นี้จะเรียกว่า /opt/apigee/var/log/edge-message-processor/edge-message-processor.log ส่วนคอมโพเนนต์ edge-* อื่นๆ จะสร้างไฟล์ที่คล้ายกัน การหมุนเวียนไฟล์เหล่านี้ไม่ได้ดำเนินการโดย ไลบรารี logback แต่ใช้ logrotate และ crontab แทน

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

• หากไม่คุ้นเคยกับการกำหนดค่า logrotate โปรดอ่าน คู่มือ logrotate
• หากไม่คุ้นเคยกับการกำหนดค่า crontab โปรดอ่าน คู่มือ crontab

เปิดใช้การหมุนเวียนไฟล์บันทึก

ส่วนนี้ใช้ได้กับ Edge for Private Cloud เวอร์ชัน 4.50.00 และ 4.51.00

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

โดยค่าเริ่มต้น ระบบจะกำหนดค่าไฟล์บันทึกหลักบางไฟล์ในคอมโพเนนต์ apigee แต่ละรายการด้วยกลไกการหมุนเวียนเริ่มต้น เช่น ในคอมโพเนนต์ Message Processor ระบบจะกำหนดค่าไฟล์ต่อไปนี้ด้วยกลไกการหมุนเวียนเริ่มต้น

• /opt/apigee/var/log/edge-message-processor/logs/system.log
• /opt/apigee/var/log/edge-message-processor/logs/events.log
• /opt/apigee/var/log/edge-message-processor/logs/startupruntimeerrors.log
• /opt/apigee/var/log/edge-message-processor/logs/configurations.log
• /opt/apigee/var/log/edge-message-processor/logs/transactions.log

อย่างไรก็ตาม ระบบจะไม่ได้กำหนดค่าไฟล์บันทึกอื่นๆ ในคอมโพเนนต์ apigee ด้วยการหมุนเวียนเริ่มต้น เช่น ระบบจะไม่ได้กำหนดค่าการหมุนเวียนไฟล์บันทึกไว้โดยค่าเริ่มต้นในไฟล์ edge-message-processor.log ของคอมโพเนนต์ Message Processor apigee

คุณสามารถเปิดใช้การหมุนเวียนไฟล์บันทึกได้โดยใช้ยูทิลิตี/เฟรมเวิร์กต่างๆ เช่น logrotate, logback, หรือ log4j ส่วนนี้จะอธิบายวิธีกำหนดค่า log rotation สำหรับ /opt/apigee/var/log/edge-message-processor/edge-message-processor.log file โดยใช้ logrotate และ crontab

การเปิดใช้การหมุนเวียนไฟล์บันทึกสำหรับ edge-message-processor.log ใน Message Processor

ส่วนนี้จะอธิบายวิธีเปิดใช้การหมุนเวียนไฟล์บันทึกสำหรับบันทึก /opt/apigee/var/log/edge-message- processor/edge-message-processor.log ใน Edge Message Processor

ขั้นตอนต่อไปนี้จะอธิบายวิธีเปิดใช้การหมุนเวียนไฟล์บันทึกสำหรับ edge-message-processor.log ไฟล์:

1. เปิดไฟล์ /opt/apigee/edge-message-processor/logrotate/logrotate.conf ในเครื่อง Message Processor ในเครื่องมือแก้ไข หากไม่มีไฟล์นี้ ให้สร้างขึ้น เช่น

   vi /opt/apigee/edge-message-processor/logrotate/logrotate.conf
   

2. เพิ่มข้อมูลโค้ดลงในไฟล์ที่คล้ายกับข้อมูลโค้ดที่แสดงด้านล่าง

   /opt/apigee/var/log/edge-message-processor/edge-message-processor.log {
       missingok
       copytruncate
       rotate 5
       size 10M
       compress
       delaycompress
       notifempty
       nocreate
       sharedscripts
       }

3. บันทึกการเปลี่ยนแปลง
4. เปิด crontab ของผู้ใช้ apigee โดยใช้คำสั่งต่อไปนี้

   sudo crontab -u apigee -e
   

5. เพิ่มงาน cron ต่อไปนี้ลงใน crontab ของผู้ใช้ apigee

   0 0 * * * nice -n 19 ionice -c3 /usr/sbin/logrotate -s /opt/apigee/var/run/edge-message-processor/logrotate.status -f /opt/apigee/edge-message-processor/logrotate/logrotate.conf

6. บันทึก crontab และตรวจสอบการหมุนเวียนไฟล์บันทึกระหว่างการทำงานครั้งถัดไปของงาน Cron

การยืนยันการหมุนเวียนไฟล์บันทึกสำหรับ edge-message-processor.log ใน Message Processor

1. เมื่อมีการเรียกใช้งาน cron job ตามกำหนดเวลา ระบบจะหมุนเวียนไฟล์บันทึก จากตัวอย่างด้านบน, ระบบกำหนดเวลาให้ งาน Cron ทำงานทุกวันเวลา 00:00 น. เพื่อหมุนเวียนไฟล์ edge-message- processor.log

2. ไปที่ไดเรกทอรี /opt/apigee/var/log/edge-message-processor/ และ ตรวจสอบว่าไฟล์ edge-message-processor.log ได้รับการหมุนเวียนแล้ว

   ตัวอย่างรายการไฟล์บันทึก

   ls -ltrh | grep 'edge-message-processor'
   

   -rw-r--r--. 1 apigee apigee  17K Feb  7 00:00 edge-message-processor.log.1.gz
   -rw-r--r--. 1 apigee apigee 5.3K Feb  7 09:12 edge-message-processor.log

   เอาต์พุตด้านบนระบุว่าไฟล์ edge-message-processor.log ได้รับการหมุนเวียนและบันทึกเป็นไฟล์ GZ แล้ว

3. หากไม่เห็นว่าไฟล์ edge-message-processor.log ได้รับการหมุนเวียน ให้ตรวจสอบว่าคุณได้ทำตามขั้นตอนทั้งหมดที่ระบุไว้ในหัวข้อ การเปิดใช้การหมุนเวียนบันทึกสำหรับ edge-message-processor.log ใน Message Processor อย่างถูกต้อง หากข้ามขั้นตอนใดไป ให้ทำตามขั้นตอนทั้งหมดอีกครั้งอย่างถูกต้อง
4. หากยังคงไม่สามารถทำให้การหมุนเวียนไฟล์บันทึกทำงานได้ โปรดติดต่อทีมสนับสนุนของ Apigee Edge