Mengaktifkan rotasi log untuk edge-message-processor.log

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

Rotasi log—proses merotasi 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 otomatis.

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

Sebelum memulai

Mengaktifkan rotasi log

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

Rotasi log adalah mekanisme yang dirancang untuk memudahkan administrasi sistem yang menghasilkan sejumlah besar file log. Mekanisme ini memungkinkan rotasi, kompresi, penghapusan, dan pengiriman file log otomatis.

Secara default, beberapa file log utama pada setiap komponen apigee dikonfigurasi dengan mekanisme rotasi default. Misalnya, pada komponen Pemroses Pesan, file berikut dikonfigurasi dengan default 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 lainnya di komponen apigee tidak dikonfigurasi dengan rotasi default. Misalnya, rotasi log tidak dikonfigurasi secara default pada file Pemroses Pesan 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 /opt/apigee/var/log/edge-message-processor/edge-message-processor.log file menggunakan logrotate dan crontab.

Mengaktifkan rotasi log untuk edge-message-processor.log di Pemroses Pesan

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

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

  1. Buka file /opt/apigee/edge-message-processor/logrotate/logrotate.conf di mesin Pemroses Pesan 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 cron job berjalan berikutnya.

Memverifikasi rotasi log untuk edge-message-processor.log di Pemroses Pesan

  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 merotasi file edge-message- processor.log.
  2. Buka direktori /opt/apigee/var/log/edge-message-processor/ dan verifikasi bahwa file edge-message-processor.log 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 dirotasi, verifikasi bahwa Anda telah mengikuti semua langkah yang diuraikan dalam Mengaktifkan rotasi log untuk edge-message-processor.log di Pemroses Pesan dengan benar. Jika Anda melewatkan langkah apa pun, ulangi semua langkah dengan benar.
  4. Jika Anda masih tidak dapat membuat rotasi log berfungsi, hubungi Dukungan Apigee Edge.