Mengaktifkan rotasi log untuk edge-message-processor.log

Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X.
info

Rotasi log—proses memutar beberapa file log yang digunakan dan tidak digunakan— menyederhanakan administrasi sistem yang menghasilkan sejumlah besar file log. Rotasi log memungkinkan rotasi, kompresi, penghapusan, dan pengiriman file log secara otomatis.

Di Edge untuk Private Cloud, beberapa file log utama di setiap komponen apigee dikonfigurasi dengan mekanisme rotasi default. Misalnya, pada komponen Message Processor, file berikut dikonfigurasi dengan mekanisme rotasi default menggunakan 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

File serupa ada untuk komponen edge-* lainnya (yang namanya dimulai dengan edge-), seperti edge-management-server, edge-router, edge-postgres-server, dan edge-qpid-server.

Setiap komponen edge-* ini juga menghasilkan file log tambahan yang merupakan output yang dialihkan dari konsol komponen masing-masing. Untuk komponen Message Processor, file ini disebut /opt/apigee/var/log/edge-message-processor/edge-message-processor.log. Komponen edge-* lainnya menghasilkan file yang serupa. Rotasi file ini tidak dilakukan oleh library logback, tetapi menggunakan logrotate dan crontab.

Sebelum memulai

Mengaktifkan rotasi log

Bagian ini berlaku untuk Edge untuk Private Cloud versi 4.50.00 dan 4.51.00.

Rotasi log adalah mekanisme yang dirancang untuk memudahkan administrasi sistem yang menghasilkan file log dalam jumlah besar. Fitur ini memungkinkan rotasi, kompresi, penghapusan, dan pengiriman file log secara otomatis.

Secara default, beberapa file log utama di setiap komponen apigee dikonfigurasi dengan mekanisme rotasi default. Misalnya, pada komponen Message Processor, file berikut dikonfigurasi dengan mekanisme rotasi default:

  • /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

Namun, file log lain di komponen apigee tidak dikonfigurasi dengan rotasi default. Misalnya, rotasi log tidak dikonfigurasi secara default pada file Message Processor komponen apigee edge-message-processor.log.

Rotasi log dapat diaktifkan menggunakan berbagai utilitas/framework seperti logrotate, logback, atau log4j. Bagian ini menjelaskan cara mengonfigurasi rotasi log untuk file /opt/apigee/var/log/edge-message-processor/edge-message-processor.log menggunakan logrotate dan crontab.

Mengaktifkan rotasi log untuk edge-message-processor.log di Message Processor

Bagian ini menjelaskan cara mengaktifkan rotasi log untuk log /opt/apigee/var/log/edge-message- processor/edge-message-processor.log di Edge Message Processor.

Langkah-langkah berikut menjelaskan cara mengaktifkan rotasi log untuk file edge-message-processor.log:

  1. Buka file /opt/apigee/edge-message-processor/logrotate/logrotate.conf di komputer Message Processor di editor. Jika file tidak ada, buat file tersebut. Contoh:
    vi /opt/apigee/edge-message-processor/logrotate/logrotate.conf
    
  2. Tambahkan cuplikan ke file yang mirip dengan yang ditampilkan di bawah ini:
    /opt/apigee/var/log/edge-message-processor/edge-message-processor.log {
        missingok
        copytruncate
        rotate 5
        size 10M
        compress
        delaycompress
        notifempty
        nocreate
        sharedscripts
        }
  3. Simpan perubahan.
  4. Buka crontab pengguna apigee menggunakan perintah berikut:
    sudo crontab -u apigee -e
    
  5. Tambahkan tugas cron berikut ke crontab pengguna 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. Simpan crontab dan pantau rotasi log selama tugas cron berikutnya dijalankan.

Memverifikasi rotasi log untuk edge-message-processor.log di Message Processor

  1. Setelah tugas cron terjadwal berjalan, file log akan dirotasi. Dari contoh di atas, cron job dijadwalkan untuk berjalan setiap hari pukul 00.00 untuk merotasi file edge-message- processor.log.
  2. Buka direktori /opt/apigee/var/log/edge-message-processor/ dan pastikan file edge-message-processor.log diputar.

    Contoh listingan file 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

    Output di atas menunjukkan bahwa file edge-message-processor.log diputar dan disimpan sebagai file GZ.

  3. Jika Anda tidak melihat file edge-message-processor.log dirotasi, pastikan Anda telah mengikuti semua langkah yang diuraikan dalam Mengaktifkan rotasi log untuk edge-message-processor.log di Message Processor dengan benar. Jika Anda melewatkan langkah apa pun, ulangi semua langkah lagi dengan benar.
  4. Jika Anda masih tidak dapat membuat rotasi log berfungsi, hubungi Dukungan Apigee Edge.