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 ke dalam dan ke luar penggunaan—menyederhanakan administrasi sistem yang menghasilkan file log dalam jumlah besar. Rotasi log memungkinkan rotasi, kompresi, penghapusan, dan pengiriman file log otomatis.

Di Edge untuk Private Cloud, beberapa file log utama pada setiap komponen apigee dikonfigurasi dengan mekanisme rotasi default. Misalnya, pada komponen Pemroses Pesan, 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 diawali 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 Pemroses Pesan, file ini diberi nama /opt/apigee/var/log/edge-message-processor/edge-message-processor.log. Komponen edge-* lainnya akan menghasilkan file yang serupa. Rotasi file ini tidak dilakukan oleh library logback, melainkan menggunakan logrotate dan crontab.

Sebelum memulai

Aktifkan rotasi log

Bagian ini berlaku pada 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 otomatis.

Secara default, beberapa file log utama di setiap komponen apigee dikonfigurasi dengan mekanisme rotasi default. Misalnya, pada komponen Pemroses Pesan, 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 dalam komponen apigee tidak dikonfigurasi dengan rotasi default. Misalnya, rotasi log tidak dikonfigurasi secara default pada file edge-message-processor.log Prosesor Pesan komponen apigee.

Rotasi log dapat diaktifkan menggunakan utilitas/framework yang berbeda 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 Prosesor Pesan

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

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 mesin 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 ditunjukkan 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 cron job 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 menjalankan cron job berikutnya.

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

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

    Contoh daftar 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 dirotasi dan disimpan sebagai file GZ.

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