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

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

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

ใน Edge สำหรับ Private Cloud ไฟล์บันทึกหลักบางไฟล์ในคอมโพเนนต์ apigee แต่ละรายการจะได้รับการกำหนดค่าด้วยกลไกการหมุนเริ่มต้น ตัวอย่างเช่น ในคอมโพเนนต์โปรแกรมประมวลผลข้อความ ไฟล์ต่อไปนี้จะได้รับการกำหนดค่าด้วยกลไกการหมุนเริ่มต้นโดยใช้ 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-* แต่ละรายการเหล่านี้จะสร้างไฟล์บันทึกเพิ่มเติม ซึ่งเป็นเอาต์พุตที่มีการเปลี่ยนเส้นทางของคอนโซลคอมโพเนนต์ที่เกี่ยวข้อง ในกรณีของคอมโพเนนต์ตัวประมวลผลข้อความ ไฟล์นี้จะเรียกว่า /opt/apigee/var/log/edge-message-processor/edge-message-processor.log คอมโพเนนต์ edge-* อื่นๆ จะสร้างไฟล์ที่คล้ายกัน ไลบรารีตัวบันทึกไม่ได้ดำเนินการหมุนเวียนไฟล์เหล่านี้ แต่ใช้ logrotate และ crontab แทน

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

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

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

ส่วนนี้จะมีผลกับ Edge สำหรับ Private Cloud เวอร์ชัน 4.50.00 และ 4.51.00

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

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

• /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 ไม่ได้กำหนดค่าด้วยการหมุนเริ่มต้น เช่น ไม่ได้กำหนดค่าการหมุนเวียนบันทึกโดยค่าเริ่มต้นในไฟล์ Message Processor edge-message-processor.log ของคอมโพเนนต์ apigee

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

เปิดใช้การหมุนเวียนบันทึกสำหรับ edge-message-processor.log บนตัวประมวลผลข้อความ

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

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

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

   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 บนตัวประมวลผลข้อความ

1. เมื่องาน cron ตามกำหนดการทำงาน ไฟล์บันทึกจะถูกหมุนเวียน จากตัวอย่างข้างต้น งาน 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 ในโปรแกรมประมวลผลข้อความอย่างถูกต้อง หากคุณพลาดขั้นตอนใด ให้ทำซ้ำขั้นตอนทั้งหมดอย่างถูกต้อง
4. หากยังคงใช้การหมุนเวียนบันทึกไม่ได้ โปรดติดต่อทีมสนับสนุนของ Apigee Edge