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

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

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

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

คุณสามารถเปิดใช้การหมุนเวียนบันทึกโดยใช้ยูทิลิตี/เฟรมเวิร์กต่างๆ เช่น 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