Tidak dikategorikan

LOGROTATE- (8) Halaman Manual

LOGROTATE- (8) Halaman Manual

Nama

Logrotate - Rotates, Compresses, and Mails System Logs

Ringkasan

Logrotate [-dv] [-F|-memaksa] [-S|-negara Statefile] config_file..

Keterangan

Logrotate dirancang untuk memudahkan administrasi sistem yang menghasilkan sejumlah besar file log. Ini memungkinkan rotasi otomatis, kompresi, penghapusan, dan pengiriman file log. Setiap file log dapat ditangani setiap hari, mingguan, bulanan, atau saat tumbuh terlalu besar.

Biasanya, Logrotate dijalankan sebagai pekerjaan cron harian. Itu tidak akan memodifikasi log lebih dari sekali dalam satu hari kecuali kriteria untuk log tersebut didasarkan pada ukuran log dan Logrotate dijalankan lebih dari sekali setiap hari, atau kecuali -F atau -memaksa opsi digunakan.

Sejumlah file konfigurasi dapat diberikan pada baris perintah. File konfigurasi kemudian dapat mengganti opsi yang diberikan pada file sebelumnya, sehingga urutan di mana Logrotate File konfigurasi terdaftar penting. Biasanya, satu file konfigurasi yang mencakup file konfigurasi lain yang diperlukan harus digunakan. Lihat di bawah untuk informasi lebih lanjut tentang cara menggunakan termasuk Petunjuk untuk mencapai ini. Jika direktori diberikan pada baris perintah, setiap file dalam direktori itu digunakan sebagai file konfigurasi.

Jika tidak ada argumen baris perintah yang diberikan, Logrotate akan mencetak informasi versi dan hak cipta, bersama dengan ringkasan penggunaan singkat. Jika terjadi kesalahan saat memutar log, Logrotate akan keluar dengan status bukan nol.

Pilihan

-D
Menyalakan mode debug dan menyiratkan -v. Dalam mode debug, tidak ada perubahan yang akan dilakukan pada log atau ke Logrotate file negara.
-F, -memaksa
Memberi tahu Logrotate Untuk memaksa rotasi, bahkan jika tidak berpikir ini perlu. Terkadang ini berguna setelah menambahkan entri baru ke a Logrotate file konfigurasi, atau jika file log lama telah dihapus dengan tangan, karena file baru akan dibuat, dan logging akan berlanjut dengan benar.
-M, -surat
Memberi tahu Logrotate Perintah mana yang akan digunakan saat mengirimkan log. Perintah ini harus menerima dua argumen: 1) subjek pesan, dan 2) penerima. Perintah kemudian harus membaca pesan tentang input standar dan mengirimkannya ke penerima. Perintah surat default adalah /usr/bin/mail -s.
-S, -negara
Memberi tahu Logrotate untuk menggunakan file negara alternatif. Ini berguna jika Logrotate dijalankan sebagai pengguna yang berbeda untuk berbagai set file log. File status default adalah /var/lib/logrotate/status.
-penggunaan
Mencetak pesan penggunaan singkat.
-v, -verbose
Menampilkan pesan selama rotasi.

File konfigurasi

Logrotate Membaca segalanya tentang file log yang harus ditangani dari serangkaian file konfigurasi yang ditentukan pada baris perintah. Setiap file konfigurasi dapat mengatur opsi global (definisi lokal mengganti yang global, dan definisi kemudian mengganti yang sebelumnya) dan menentukan logfile untuk berputar. File konfigurasi sederhana terlihat seperti ini:

 # Contoh Compress File Konfigurasi Logrotate/Var/Log/Message Rotate 5 Weekly Postrotate/usr/bin/killall -hup syslogd endscript "/var/log/httpd/access.log "/var/log/httpd/error.log putar 5 mail [email protected] org 100k SharedScripts Postrotate/usr/bin/killall -hup httpd endscript/var/log/news/* bulanan rotate 2 olddir/var/log/news/old hilang postrotate kill -hup 'cat/var/run/inn.pid 'endscript nocompress ~/log/*.catatan

Beberapa baris pertama menetapkan opsi global; Dalam contoh, log dikompres setelah diputar. Perhatikan bahwa komentar mungkin muncul di mana saja di file konfigurasi selama karakter non-whitespace pertama di baris adalah a #.

Bagian selanjutnya dari file config mendefinisikan cara menangani file log /var/log/pesan. Log akan melewati lima rotasi mingguan sebelum dilepas. Setelah file log diputar (tetapi sebelum versi lama log telah dikompresi), perintah /SBIN/KILLALL -HUP SYSLOGD akan dieksekusi.

Bagian selanjutnya mendefinisikan parameter untuk keduanya /var/log/httpd/akses.catatan Dan /var/log/httpd/error.catatan. Masing -masing diputar setiap kali tumbuh lebih dari 100 ribu, dan file log lama dikirimkan (tidak terkompresi) ke [email protected] setelah melalui 5 rotasi, daripada dilepas. Itu SharedScripts berarti itu postrotate skrip hanya akan dijalankan sekali (setelah log lama dikompresi), tidak sekali untuk setiap log yang diputar. Perhatikan bahwa nama file log dapat terlampir dalam kutipan (dan kutipan itu diperlukan jika namanya berisi spasi). Aturan penawaran shell normal berlaku, dengan ', “, Dan \ karakter didukung.

Bagian terakhir mendefinisikan parameter untuk semua file di /var/log/berita. Setiap file diputar setiap bulan. Ini dianggap sebagai arahan rotasi tunggal dan jika kesalahan terjadi untuk lebih dari satu file, file log tidak dikompresi.

Silakan gunakan wildcard dengan hati -hati. Jika Anda menentukan *, Logrotate akan memutar semua file, termasuk yang diputar sebelumnya. Jalannya adalah dengan menggunakan Olddir arahan atau wildcard yang lebih tepat (seperti *.catatan).

Jika direktori /var/log/berita tidak ada, ini akan menyebabkan Logrotate untuk melaporkan kesalahan. Kesalahan ini tidak dapat dihentikan dengan Hilang pengarahan.

Berikut adalah informasi lebih lanjut tentang arahan yang mungkin termasuk dalam a Logrotate File Konfigurasi:

kompres
Versi lama file log terkompresi Gzip(1) secara default. Lihat juga nocompress.
Compresscmd
Menentukan perintah mana yang akan digunakan untuk mengompres file log. Standarnya adalah Gzip(1) . Lihat juga kompres.
Uncompresscmd
Menentukan perintah mana yang akan digunakan untuk membuka file log. Standarnya adalah Gunzip(1) .
Compressext
Menentukan ekstensi mana yang akan digunakan pada file log terkompresi, jika kompresi diaktifkan. Default mengikuti perintah kompresi default (.GZ).
CompressOptions
Opsi baris perintah dapat diteruskan ke program kompresi, jika seseorang sedang digunakan. Default, untuk Gzip, adalah "-9" (kompresi maksimum).
menyalin
Buat salinan file log, tetapi jangan mengubah yang asli sama sekali. Opsi ini dapat digunakan, misalnya, untuk membuat snapshot dari file log saat ini, atau ketika beberapa utilitas lain perlu memotong atau menguraikan file. Saat opsi ini digunakan, membuat Opsi tidak akan berpengaruh, karena file log lama tetap di tempatnya.
copytruncate
Potong file log asli ke ukuran nol di tempat setelah membuat salinan, alih -alih memindahkan file log lama dan secara opsional membuat yang baru. Ini dapat digunakan ketika beberapa program tidak dapat diberitahu untuk menutup logfile dan dengan demikian dapat terus menulis (menambahkan) ke file log sebelumnya selamanya. Perhatikan bahwa ada irisan waktu yang sangat kecil antara menyalin file dan memotongnya, jadi beberapa data logging mungkin hilang. Saat opsi ini digunakan, membuat Opsi tidak akan berpengaruh, karena file log lama tetap di tempatnya.
membuat mode pemilik kelompok
Segera setelah rotasi (sebelum postrotate skrip dijalankan) File log dibuat (dengan nama yang sama dengan file log yang baru saja diputar). mode menentukan mode untuk file log di octal (sama seperti Chmod(2)), pemilik Menentukan nama pengguna yang akan memiliki file log, dan kelompok Menentukan grup file log akan menjadi milik. Atribut file log mana pun dapat dihilangkan, dalam hal ini atribut tersebut untuk file baru akan menggunakan nilai yang sama dengan file log asli untuk atribut yang dihilangkan. Opsi ini dapat dinonaktifkan menggunakan nocreate pilihan.
sehari-hari
File log diputar setiap hari.
datext
Arsipkan versi lama file log yang menambahkan ekstensi harian seperti yyyymmdd alih -alih hanya menambahkan angka.
format tanggal
Tentukan ekstensi untuk datext menggunakan notasi yang mirip dengan strftime (3) fungsi. Hanya %y %m dan %d spesifikasi yang diizinkan. Nilai defaultnya adalah -%y%m%d. Perhatikan bahwa juga nama log yang memisahkan karakter dari ekstensi adalah bagian dari string DateFormat.
Delaycompress
Tunda kompresi file log sebelumnya ke siklus rotasi berikutnya. Ini hanya memiliki efek saat digunakan dalam kombinasi dengan kompres. Ini dapat digunakan ketika beberapa program tidak dapat diberitahu untuk menutup logfile dan dengan demikian dapat terus menulis ke file log sebelumnya untuk beberapa waktu.
perpanjangan ext
File log dengan ext Ekstensi dapat menyimpannya setelah rotasi. Jika kompresi digunakan, ekstensi kompresi (biasanya .GZ) muncul setelahnya ext. Misalnya Anda memiliki logfile bernama Mylog.foo dan ingin memutarnya ke mylog.1.foo.GZ bukan mylog.foo.1.GZ.
ifempty
Putar file log bahkan jika kosong, mengesampingkan Notifmempty pilihan (ifempty adalah default).
termasuk file_or_directory
Membaca file yang diberikan sebagai argumen seolah -olah dimasukkan sebaliknya di mana termasuk Petunjuk muncul. Jika direktori diberikan, sebagian besar file dalam direktori itu dibaca dalam urutan alfabet sebelum pemrosesan file termasuk berlanjut. Satu -satunya file yang diabaikan adalah file yang bukan file biasa (seperti direktori dan pipa bernama) dan file yang namanya berakhir dengan salah satu ekstensi tabu, sebagaimana ditentukan oleh tabooext pengarahan. Itu termasuk Petunjuk mungkin tidak muncul di dalam definisi file log.
surat alamat
Saat log diputar keluar dari keberadaan, itu dikirim ke alamat. Jika tidak ada surat yang dihasilkan oleh log tertentu, nomail Petunjuk dapat digunakan.
MailFirst
Saat menggunakan surat Perintah, kirimkan file yang baru saja diputar, alih-alih file yang akan datang.
Maillast
Saat menggunakan surat Perintah, kirimkan file yang harus dihidupkan, alih-alih file yang baru saja diputar (ini adalah default).
Maxage menghitung
Lepaskan log yang diputar lebih tua dari hari. Usia hanya diperiksa jika logfile akan diputar. File dikirim ke alamat yang dikonfigurasi jika Maillast Dan surat dikonfigurasi.
Minsize ukuran
File log diputar saat tumbuh lebih besar dari ukuran byte, tetapi tidak sebelum interval waktu yang ditentukan tambahan (sehari-hari, mingguan, bulanan, atau tahunan). Terkait ukuran Opsi serupa kecuali bahwa itu saling eksklusif dengan opsi interval waktu, dan menyebabkan file log diputar tanpa memperhatikan waktu rotasi terakhir. Kapan Minsize digunakan, baik ukuran dan cap waktu dari file log dipertimbangkan.
Hilang
Jika file log tidak ada, lanjutkan ke yang berikutnya tanpa mengeluarkan pesan kesalahan. Lihat juga Nomissingok.
bulanan
File log diputar pertama kali Logrotate dijalankan dalam sebulan (ini biasanya pada hari pertama bulan itu).
nocompress
Versi lama file log tidak terkompresi. Lihat juga kompres.
nocopy
Jangan menyalin file log asli dan membiarkannya di tempatnya. (ini mengesampingkan menyalin pilihan).
nocopytruncate
Jangan memotong file log asli di tempat setelah membuat salinan (ini menimpa copytruncate pilihan).
nocreate
File log baru tidak dibuat (ini menimpa membuat pilihan).
NodelayCompress
Jangan menunda kompresi file log sebelumnya ke siklus rotasi berikutnya (ini menimpa Delaycompress pilihan).
nodateext
Jangan arsipkan versi lama file log dengan ekstensi tanggal (ini mengesampingkan datext pilihan).
nomail
Jangan mengirimkan file log lama ke alamat apa pun.
Nomissingok
Jika file log tidak ada, keluarkan kesalahan. Ini adalah default.
NOOLDDIR
Log diputar di direktori yang biasanya mereka tinggal di (ini menimpa Olddir pilihan).
nosharedscripts
Berlari prerotate Dan postrotate skrip untuk setiap file log yang diputar (ini adalah default, dan menimpa SharedScripts pilihan). Jika skrip keluar dengan kesalahan, tindakan yang tersisa tidak akan dieksekusi hanya untuk log yang terpengaruh.
noshred
Jangan gunakan sobekan Saat menghapus file log lama. Lihat juga sobekan.
Notifmempty
Jangan memutar log jika kosong (ini menimpa ifempty pilihan).
Olddir direktori
Log dipindahkan ke direktori untuk rotasi. Itu direktori Harus berada di perangkat fisik yang sama dengan file log yang diputar, dan diasumsikan relatif terhadap direktori yang memegang file log kecuali nama jalur absolut ditentukan. Saat opsi ini digunakan semua versi lama dari log berakhir direktori. Opsi ini mungkin ditimpa oleh NOOLDDIR pilihan.
postrotate/endscript
Garis antara postrotate Dan endscript (keduanya harus muncul pada baris sendiri) dieksekusi setelah file log diputar. Arahan ini hanya dapat muncul di dalam definisi file log. Lihat juga prerotate. Melihat SharedScripts Dan nosharedscripts untuk penanganan kesalahan.
prerotate/endscript
Garis antara prerotate Dan endscript (keduanya harus muncul pada baris sendiri) dieksekusi sebelum file log diputar dan hanya jika log akan benar -benar diputar. Arahan ini hanya dapat muncul di dalam definisi file log. Lihat juga postrotate. Melihat SharedScripts Dan nosharedscripts untuk penanganan kesalahan.
firstaction/endscript
Garis antara firstaction Dan endscript (keduanya harus muncul pada baris sendiri) dieksekusi sekali sebelum semua file log yang cocok dengan pola wildcarded diputar, sebelum skrip prerotate dijalankan dan hanya jika setidaknya satu log benar -benar akan diputar. Arahan ini mungkin hanya muncul di dalam definisi file log. Jika skrip keluar dengan kesalahan, tidak ada pemrosesan lebih lanjut yang dilakukan. Melihat Lastaction demikian juga.
Lastaction/endscript
Garis antara Lastaction Dan endscript (keduanya harus muncul pada baris sendiri) dieksekusi setelah semua file log yang cocok dengan pola wildcarded diputar, setelah skrip postrotate dijalankan dan hanya jika setidaknya satu log diputar. Arahan ini hanya dapat muncul di dalam definisi file log. Jika skrip keluar dengan kesalahan, hanya pesan kesalahan yang ditampilkan (karena ini adalah tindakan terakhir).

Lihat juga firstaction.

memutar menghitung
File log diputar menghitung kali sebelum dihapus atau dikirim ke alamat yang ditentukan dalam a surat pengarahan. Jika menghitung adalah 0, versi lama dihapus daripada diputar.
ukuran ukuran
File log diputar saat tumbuh lebih besar dari ukuran byte. Jika ukuran diikuti oleh M, Ukuran jika diasumsikan dalam megabytes. Jika G Sufiks digunakan, ukurannya di gigabytes. Jika k digunakan, ukurannya dalam kilobytes. Jadi Ukuran 100, Ukuran 100K, Dan Ukuran 100m semuanya valid.
SharedScripts
Biasanya, prerotate Dan postrotate Script dijalankan untuk setiap log yang diputar, artinya skrip tunggal dapat dijalankan beberapa kali untuk entri file log yang cocok dengan beberapa file (seperti /var/log/news/* contoh). Jika SharedScript ditentukan, skrip hanya dijalankan sekali, tidak peduli berapa banyak log yang cocok dengan pola wildcarded. Namun, jika tidak ada log dalam pola yang memerlukan rotasi, skrip tidak akan dijalankan sama sekali. Jika skrip keluar dengan kesalahan, tindakan yang tersisa tidak akan dieksekusi untuk log apa pun. Opsi ini mengesampingkan nosharedscripts opsi dan menyiratkan membuat pilihan.
sobekan
Hapus file log menggunakan sobekan -u bukannya unslink (). Ini harus memastikan bahwa log tidak dapat dibaca setelah penghapusan yang dijadwalkan; ini tidak aktif secara default. Lihat juga noshred.
Shredcycles menghitung
Tanya GNU sobekan untuk menguasai file log menghitung kali sebelum dihapus. Tanpa opsi ini, sobekanDefault akan digunakan.
awal menghitung
Ini adalah nomor yang digunakan sebagai dasar untuk rotasi. Misalnya, jika Anda menentukan 0, log akan dibuat dengan a .0 ekstensi saat diputar dari file log asli. Jika Anda menentukan 9, file log akan dibuat dengan a .9, melewatkan 0-8. File akan diputar berapa kali ditentukan dengan memutar pengarahan.
tabooext [+] daftar
Daftar ekstensi tabu saat ini diubah (lihat termasuk Petunjuk untuk informasi tentang ekstensi tabu). Jika A + mendahului daftar ekstensi, daftar ekstensi tabu saat ini ditambah, jika tidak ada diganti. Saat startup, daftar ekstensi tabu berisi .RPMorig, .rpmsave ,, v, .swp, .rpmnew, ~, .CFSAVED, .rhn-cfg-tmp-*, .DPKG-DIST, .dpkg-old, .dpkg-new, .dengan disabilitas.
mingguan
File log diputar jika hari kerja saat ini kurang dari hari kerja rotasi terakhir atau jika lebih dari seminggu telah berlalu sejak rotasi terakhir. Ini biasanya sama dengan rotasi log pada hari pertama dalam seminggu, tetapi jika Logrotate tidak dijalankan setiap malam, rotasi log akan terjadi pada kesempatan yang valid pertama.
tahunan
File log diputar jika tahun berjalan tidak sama dengan rotasi terakhir.

File

/var/lib/logrotate.status
File Negara Default.
/etc/logrotate.conf
Opsi Konfigurasi.

Lihat juga

Gzip(1)

Catatan

Itu Bunuh semua(1) Program di Debian ditemukan di psmisc kemasan.

Penulis

Erik Troan Preston Brown Koreksi dan Perubahan untuk Debian Bypaul Martin

Tutorial Linux Terkait:

  • Cara membuat pekerjaan cron di kubernetes
  • Pengantar Otomatisasi Linux, Alat dan Teknik
  • Cara menjalankan perintah secara berkala dengan anacron di linux
  • Pencatatan dan audit lanjutan di Linux
  • Menguasai loop skrip bash
  • Hal -hal yang harus diinstal pada ubuntu 20.04
  • Mint 20: Lebih baik dari Ubuntu dan Microsoft Windows?
  • Cara mengelola dan memecahkan masalah log Kubernetes
  • Hal -hal yang harus dilakukan setelah menginstal ubuntu 20.04 FOSSA FOSSA Linux
  • Alat Kompresi Terbaik di Linux