Tutorial Rocky Linux 10 / Mengelola journalctl dan rotasi log dengan logrotate

Untuk mengelola log Rocky Linux 10, identifikasi jalur pengumpulan jurnal dan file-log, saring peristiwa berdasarkan layanan, boot, atau waktu, dan konfigurasikan retensi untuk setiap metode penyimpanan. Jurnal dikelola oleh journald, sedangkan file log perlu diperiksa baik dengan operasi program maupun logrotate. Artikel ini menunjukkan cara melihat, memutar, mengompresi, dan hasil retensi pada jurnal dan file latihan terpisah tanpa menghapus log yang ada.

Pertama bedakan antara log jurnal dan file, serta ruang penyimpanan

systemd-journald mencatat output layanan dan peristiwa sistem dalam jurnal yang terstruktur dan dapat dilihat menggunakan journalctl. rsyslog atau aplikasi dapat mencatat file teks terpisah. Karena peristiwa yang sama dapat dikirim melalui beberapa jalur atau sebuah program mungkin mencatat di hanya satu lokasi, ketiadaan satu file tidak berarti seluruh log hilang.

rpm -q systemd logrotate rsyslog
systemctl is-active systemd-journald rsyslog
sudo journalctl --disk-usage
df -hT /var/log
sudo du -xsh /var/log

Lingkungan lab sumber adalah Rocky Linux 10.2, systemd 257, logrotate 3.22.0, rsyslog 8.2510.0. Perintah dijalankan pada guest Linux dari VM yang didedikasikan. Penggunaan jurnal dasar yang awalnya diperiksa adalah 8M, dan penggunaan direktori /var/log adalah 13M. df menunjukkan seluruh filesystem root tempat jalur tersebut berada, jadi tidak perlu sesuai dengan nilai-nilai ini.

Cara memeriksa Apa yang ditampilkan Poin-poin untuk membedakan saat menafsirkan
df -hT /var/log Kapasitas dan penggunaan filesystem tempat jalur tersebut berada Ini bukan ukuran hanya direktori /var/log.
du -xsh /var/log Penggunaan pohon direktori dalam sistem berkas yang sama Mungkin ada perbedaan dari 'df' tergantung pada izin, mount terpisah, atau file yang terbuka namun telah dihapus.
journalctl --disk-usage Penggunaan file aktif dan arsip dari jurnal yang dipilih Ini bukan nilai gabungan termasuk log teks reguler dan data aplikasi lainnya.

Jika ruang tidak cukup, pertama selidiki sistem berkas dan jalur koleksi mana yang telah bertambah. Sebelum memeriksa penyebab dan persyaratan retensi, jangan menghapus seluruh /var/log atau membersihkan batch jurnal default. Ekspor bukti kegagalan yang diperlukan ke lokasi yang aman, kemudian tinjau kebijakan retensi dan hasil rotasi aktual.

Siapkan jurnal latihan khusus yang terpisah dari log default.

Kali ini, kita akan menggunakan namespace jurnal yang disebut lf-course24. Namespace memungkinkan Anda memilih instance koleksi dan ruang penyimpanan yang terpisah, sehingga Anda dapat berlatih tanpa mengubah pengaturan jurnal default yang ada. Jika Anda mengecualikan --namespace=lf-course24, kueri, rotasi, dan target pembersihan akan berbeda, jadi tetap sertakan ini dalam perintah berikutnya.

Jika jalur khusus latihan sudah ada, jangan menimpanya; periksa status sebelumnya terlebih dahulu. Direktori cadangan dan pengaturan namespace di bawah ini hanya digunakan untuk latihan ini.

sudo bash <<'BASH'
set -eu
test ! -e /root/lf-course24
test ! -e /etc/systemd/journald@lf-course24.conf.d
mkdir -m 700 /root/lf-course24
cp -a /etc/logrotate.conf /root/lf-course24/logrotate-original.conf
cp -a /etc/logrotate.d /root/lf-course24/logrotate-original.d
systemd-analyze cat-config systemd/journald.conf > /root/lf-course24/journald-original.txt
mkdir -m 755 /etc/systemd/journald@lf-course24.conf.d
BASH
sudoedit /etc/systemd/journald@lf-course24.conf.d/10-course.conf

Isi lengkap file konfigurasi adalah sebagai berikut. Untuk jalur file yang didukung dan definisi opsi, lihat manual resmi journald.conf .

[Journal]
Storage=persistent
SystemMaxUse=16M
SystemKeepFree=16M
SystemMaxFileSize=1M
MaxRetentionSec=1day
ForwardToSyslog=no

Storage=persistent adalah pengaturan untuk memilih jalur penyimpanan permanen, dan SystemMaxUse · SystemKeepFree adalah kondisi terkait penggunaan dan sisa ruang. SystemMaxFileSize berkaitan dengan ukuran setiap file, dan MaxRetentionSec adalah pengaturan yang membatasi periode retensi. Jangan gunakan angka kecil dari latihan sebagai nilai yang disarankan untuk server produksi. Nilai tersebut harus ditentukan sesuai dengan volume pembuatan log yang sebenarnya, periode analisis, dan ruang disk yang tersedia.

Karena rotasi file, unit penghapusan, dan file aktif, penggunaan sesaat tidak dapat ditafsirkan sebagai batas atas dalam byte yang tepat. Verifikasi sumber memeriksa pemuatan pengaturan dan manajemen rotasi/jumlah file secara manual, tetapi tidak melakukan pengujian untuk proses penghapusan otomatis setelah satu hari atau pengujian beban yang mencapai batas 16M. ForwardToSyslog=no adalah pengaturan untuk menonaktifkan penerusan pesan dari jurnal latihan ini ke syslog, dan pengaturan rsyslog default dipertahankan.

Buka file dengan sudoedit /root/lf-course24/write-journal.py dan simpan contoh Python berikut. Python 3 diperlukan, dan ini menghasilkan 300 baris log yang dibedakan menurut argumen 1–4.

import sys

def main():
    batch=sys.argv[1]
    if batch not in {'1','2','3','4'}:
        raise ValueError('Use lab batch 1 to 4')
    for number in range(300):
        print(f'LF24-BATCH{batch}-{number:03d} '+ 'x'*128, flush=True)
if __name__=='__main__':
    main()

Loop berikut menjalankan empat batch sebagai layanan satu kali yang terpisah, berputar setelah tiga batch pertama. Output standar layanan dikirim ke jurnal namespace ini. Jangan gunakan perintah untuk memulai ulang daemon jurnal default.

bash <<'BASH'
set -euo pipefail
for batch in 1 2 3 4; do
  sudo systemd-run --quiet --wait --collect \
    --unit="lf-course24-batch${batch}" \
    --property=LogNamespace=lf-course24 \
    --property=StandardOutput=journal \
    /usr/bin/python3 /root/lf-course24/write-journal.py "$batch"
  sudo journalctl --namespace=lf-course24 --sync
  if test "$batch" -lt 4; then
    sudo journalctl --namespace=lf-course24 --rotate
  fi
done
BASH

Saat instance namespace baru dimulai, ia membaca pengaturan khusus. Dalam situasi di mana Anda sedang memodifikasi instance yang sedang berjalan, Anda perlu mempertimbangkan secara terpisah bagaimana pengaturan diterapkan dan layanan yang sedang menghasilkan output. Jangan sembarangan mengulang perintah ini pada nama lab yang sudah ada.

Temukan jurnal berdasarkan layanan, boot, waktu, dan prioritas.

Setelah membuat log lab, coba persempit kondisi pencarian. -b merepresentasikan boot saat ini, -u merepresentasikan unit, dan --since merepresentasikan waktu mulai. -n 3 memungkinkan melihat tiga baris terakhir, dan --no-pager memungkinkan Anda melewati program pager.

sudo journalctl --namespace=lf-course24 -b \
  -u lf-course24-batch4.service -n 3 --no-pager -o short-iso
sudo journalctl --namespace=lf-course24 -b \
  -u lf-course24-batch4.service --since '10 minutes ago' --no-pager -q -o cat
sudo journalctl --namespace=lf-course24 -b \
  -u lf-course24-batch4.service -p warning --no-pager -q -o cat

Di lab sumber, log terakhir adalah LF24-BATCH4-297 ~ 299, dan kueri rentang 10 menit segera setelah pembuatan menghasilkan 300 baris. -p warning memilih item dengan prioritas peringatan atau lebih tinggi, dan pada output tes ini, tidak ada baris (0 baris). Tidak adanya hasil pencarian berarti tidak ada item yang cocok dengan kondisi, bukan berarti layanan beroperasi normal. Periksa namespace, nama unit, boot, rentang waktu, dan izin secara bersamaan.

Saat mengekspor pesan yang diperlukan ke file, pertimbangkan juga izin pengalihan dari shell pengguna saat ini. Berikut adalah contoh menyimpan ke jalur lab yang hanya dapat diakses oleh root. Log operasional yang sebenarnya mungkin mengandung nilai sensitif seperti informasi pengguna dan token, jadi Anda harus memeriksa konten dan izin sebelum menggunakannya di posting publik atau untuk distribusi eksternal.

sudo sh -c 'journalctl --namespace=lf-course24 -b -u lf-course24-batch4.service --no-pager -q -o cat > /root/lf-course24/batch4-export.txt'
sudo wc -l /root/lf-course24/batch4-export.txt

Dalam verifikasi, dikonfirmasi bahwa pesan yang diekspor terdiri dari 300 baris. Definisi filter dan opsi output, rotasi, serta pembersihan dapat ditemukan dalam manual resmi journalctl .

Makna sebenarnya dari rotasi jurnal dan batas jumlah file

--rotate adalah operasi mengubah file yang sedang aktif menjadi file arsip dan membuka file aktif baru. Jangan bingung antara rotasi itu sendiri dengan penghapusan log sebelumnya. Di sisi lain, --vacuum-files adalah perintah pembersihan yang bisa menghapus file arsip lama. Hal berikut dijalankan hanya pada log latihan khusus yang bisa dihapus.

sudo journalctl --namespace=lf-course24 --disk-usage
sudo journalctl --namespace=lf-course24 --sync
sudo journalctl --namespace=lf-course24 --vacuum-files=1
sudo journalctl --namespace=lf-course24 --disk-usage

Dalam perilaku systemd 257 yang diuji, --vacuum-files=1 tidak berarti 'meninggalkan satu file arsip'. Batas jumlah file juga mempengaruhi file aktif, tetapi operasi penghapusan hanya berlaku untuk file arsip. Ada kasus di mana jumlahnya tidak dapat dikurangi ke angka yang ditentukan karena file aktif tidak dapat dihapus.

Praktik ini dimulai dengan satu file aktif dan tiga file arsip yang berisi tiga batch sebelumnya. Saat menerapkan batas jumlah file sebesar 1, ketiga file arsip dihapus, menyisakan hanya file aktif. Batch 1, 2, dan 3 masing-masing memiliki 0 baris, dan batch 4 di file aktif dikonfirmasi memiliki 300 baris. Penggunaan berubah dari sekitar 1,5M menjadi 1M.

--disk-usage menunjukkan penggunaan aktual dari jurnal aktif dan arsip bersama-sama. Karena ukuran file logis dalam daftar file dan ruang yang dialokasikan secara aktual di disk dapat berbeda, jumlah ukuran file mungkin berbeda. Rancang dengan kapasitas, periode, dan kriteria jumlah secara bersamaan, dan simpan secara terpisah log yang diperlukan sebelum penghapusan.

Verifikasi logrotate dengan file terpisah dan file status.

Gunakan konfigurasi logrotate terpisah untuk log file umum. Alih-alih mendaftar di /etc/logrotate.d yang sudah ada atau berbagi file status sistem, cukup putar satu file khusus. Jika direktori berikut sudah ada, periksa terlebih dahulu tanpa menimpanya.

sudo mkdir -m 750 /var/log/lf-course24
sudoedit /root/lf-course24/logrotate.conf

Isi lengkap file konfigurasi adalah sebagai berikut. size 1k menentukan saat runtime apakah file melebihi kondisi ukuran, dan rotate 2 menentukan untuk menyimpan dua file yang diputar. Termasuk file log saat ini, mungkin ada tiga file, jadi ini tidak boleh disamakan dengan opsi jumlah file pada jurnal.

/var/log/lf-course24/application.log {
    size 1k
    rotate 2
    compress
    missingok
    notifempty
    create 0640 root root
}

compress mengompresi file yang diputar, dan create mengatur izin dan kepemilikan file log saat ini yang baru. missingok memungkinkan file yang hilang, dan notifempty mencegah rotasi file kosong. Karena file latihan ditulis oleh root, gunakan kepemilikan tersebut, tetapi pengaturan ini tidak selalu diterapkan pada akun layanan operasional yang sebenarnya.

Buka file dengan sudoedit /root/lf-course24/write-file.py dan simpan seluruh contoh untuk membuat file uji di bawah ini. Log saat ini dengan konten yang ada tidak ditimpa, dan batch berikutnya dibuat di file kosong setelah rotasi.

import sys
from pathlib import Path

def main():
    batch=sys.argv[1]
    if batch not in {'1','2','3'}:
        raise ValueError('Use lab batch 1 to 3')
    path=Path('/var/log/lf-course24/application.log')
    if path.exists() and path.stat().st_size:
        raise RuntimeError('Refusing to overwrite a nonempty log')
    with path.open('w') as stream:
        for number in range(20):
            stream.write(f'FILE24-BATCH{batch}-{number:02d} '+ 'y'*128+'\n')
    path.chmod(0o640)
if __name__=='__main__':
    main()

Pertama, buat batch 1 dan kemudian periksa hanya rencana eksekusi dalam mode debug.

sudo python3 /root/lf-course24/write-file.py 1
sudo sha256sum /var/log/lf-course24/application.log
sudo logrotate --debug --state /root/lf-course24/logrotate.state /root/lf-course24/logrotate.conf
sudo sha256sum /var/log/lf-course24/application.log

Dalam verifikasi ini, hash sebelum dan sesudah mode debug sama, dan file terkompresi serta file status tidak dibuat. Bahkan jika output debug menunjukkan rencana seperti renaming atau Creating new state, itu tidak berarti perubahan sebenarnya telah diselesaikan. Opsi eksekusi aktual dan file status dibedakan dalam logrotate manual resmi .

Sekarang, sebenarnya putar batch 1, lalu buat dan putar batch 2 dan 3 secara berurutan. Karena ini adalah latihan berdasarkan ukuran, opsi eksekusi paksa tidak digunakan.

sudo logrotate --verbose --state /root/lf-course24/logrotate.state /root/lf-course24/logrotate.conf
for batch in 2 3; do
  sudo python3 /root/lf-course24/write-file.py "$batch"
  sudo logrotate --verbose --state /root/lf-course24/logrotate.state /root/lf-course24/logrotate.conf
done
sudo stat -c '%a %U:%G %s %n' /var/log/lf-course24/application.log /var/log/lf-course24/application.log.1.gz /var/log/lf-course24/application.log.2.gz
sudo gzip -cd /var/log/lf-course24/application.log.1.gz | head -n 1
sudo gzip -cd /var/log/lf-course24/application.log.2.gz | head -n 1

Hasil sebenarnya adalah bahwa file saat ini adalah 0 byte, izin 640, pemilik root, dengan 20 baris dari batch 3 yang tersisa di .1.gz dan 20 baris dari batch 2 yang tersisa di .2.gz. Batch 1 yang paling lama dihapus. Ketika dijalankan lagi pada file saat ini yang kosong, file tersebut tidak diputar.

Pengaturan ini adalah kondisi yang diperiksa logrotate saat dijalankan. Menentukan size 1k tidak selalu menjaga file tetap di bawah 1 KiB. Dalam operasi sebenarnya, Anda perlu memeriksa baik interval eksekusi jadwal maupun jumlah yang dihasilkan. Latihan ini adalah verifikasi eksekusi manual dan tidak mengubah pengatur waktu sistem atau pengaturan global.

Terapkan rotasi pada layanan yang berjalan dan bersihkan lab

Karena program uji sekali selesai menulis dan keluar, bahkan jika Anda mengganti nama file dan membuat yang baru, batch berikutnya akan menggunakan file yang baru. Daemon yang berjalan terus menerus mungkin akan terus menulis ke file yang sebelumnya dibuka. Anda perlu memeriksa metode resmi reopen/reload dari layanan operasional dan fitur seperti postrotate dalam logrotate, dan Anda tidak boleh memperluas hasil uji ini untuk memverifikasi pembukaan ulang log daemon.

copytruncate bukan solusi yang cocok untuk setiap program. Tinjau kondisi dalam manual, seperti kemungkinan kehilangan antara operasi salin dan potong. Alih-alih secara sembarangan menghapus log yang ada atau menghentikan layanan secara paksa untuk menghindari masalah, periksa metode pencatatan layanan beserta izin file, label SELinux, dan perilaku setelah rotasi.

Saat menyelesaikan latihan, hentikan hanya instance jurnal dan socket yang khusus. Tidak perlu menghentikan systemd-journald.service atau rsyslog default.

sudo journalctl --namespace=lf-course24 --sync
sudo systemctl stop systemd-journald@lf-course24.service systemd-journald@lf-course24.socket systemd-journald-varlink@lf-course24.socket
sudo cp -a /etc/systemd/journald@lf-course24.conf.d/10-course.conf /root/lf-course24/journald-namespace.conf
sudo rm -- /etc/systemd/journald@lf-course24.conf.d/10-course.conf
sudo rmdir /etc/systemd/journald@lf-course24.conf.d
systemctl is-active systemd-journald rsyslog

Log uji, ekspor, dan file status disimpan sebagai catatan latihan jika diperlukan. Dalam verifikasi sumber, jalur log dan daftar file log di namespace khusus diperiksa. Konfigurasi namespace dicadangkan dan hash dibandingkan sebelum hanya file konfigurasi khusus yang baru dibuat beserta direktorinya dihapus. Pengaturan jurnal default, pengaturan logrotate yang ada, file konfigurasi individu, dan fstab sesuai dengan yang sebelum pekerjaan, dan journald, rsyslog, SSH, serta firewall default tetap aktif.