Mengaktifkan rotasi log untuk edge-message-processor.log

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

Rotasi log—proses merotasi beberapa file log yang tidak digunakan dan tidak digunakan— menyederhanakan administrasi sistem yang menghasilkan file log dalam jumlah besar. Rotasi log memungkinkan rotasi otomatis, kompresi, penghapusan, dan milis file log.

Di Edge untuk Private Cloud, beberapa file log utama di setiap apigee komponen dikonfigurasi dengan mekanisme rotasi {i>default<i}. Misalnya, pada Komponen Pemroses Pesan, file berikut dikonfigurasi dengan rotasi default mekanisme ini 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

Ada file yang mirip 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 dialihkan dari konsol komponen masing-masing. Dalam kasus komponen {i>Message Processor<i}, file ini bernama /opt/apigee/var/log/edge-message-processor/edge-message-processor.log. Komponen edge-* lainnya menghasilkan file yang serupa. File-file ini rotasi tidak dilakukan oleh library logback, tetapi menggunakan logrotate dan crontab.

Sebelum memulai

Aktifkan 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 file log dalam jumlah besar. Alat ini memungkinkan rotasi, kompresi, penghapusan, dan pengiriman secara otomatis file log.

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

  • /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 dalam komponen apigee tidak dikonfigurasi dengan rotasi default. Misalnya, rotasi log tidak dikonfigurasi secara default pada Pesan komponen apigee File pemroses edge-message-processor.log.

Rotasi log dapat diaktifkan menggunakan berbagai utilitas/framework seperti logrotate, logback, atau log4j. Bagian ini menjelaskan cara mengonfigurasi log rotasi untuk /opt/apigee/var/log/edge-message-processor/edge-message-processor.log 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 pada Pemroses 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 komputer {i>Message Processor<i} 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 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 proses cron job berikutnya.

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

  1. Setelah cron job terjadwal berjalan, file log akan dirotasi. Dari contoh di atas, cron job dijadwalkan 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 memverifikasi bahwa 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 edge-message-processor.log file dirotasi dan disimpan sebagai file GZ.

  3. Jika Anda tidak melihat file edge-message-processor.log sedang dirotasi, kemudian 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 bisa mendapatkan agar rotasi log berfungsi, hubungi Dukungan Apigee Edge.