همه مقالات تخصصی

مبانی logrotate: جلوی پرشدن دیسک با لاگ‌ها را امن بگیرید

برای یک برنامه قاعدهٔ logrotate بنویسید، با حالت debug تست کنید، reload بعد از چرخش را تنظیم کنید و وضعیت را بسنجید تا لاگ دیسک را پر نکند.

مبانی logrotate: جلوی پرشدن دیسک با لاگ‌ها را امن بگیرید

پرشدن دیسک یکی از رایج‌ترین دلیل‌های ناگهان از کار افتادن سرور است و لاگ‌های چرخانده‌نشده علت همیشگی آن. logrotate لاگ‌های قدیمی را بر اساس زمان‌بندی تغییر نام می‌دهد، فشرده و حذف می‌کند. این راهنما قاعده‌ای امن برای برنامهٔ خودتان نشان می‌دهد، چطور بدون تغییر چیزی تستش کنید و کدام اشتباه‌ها برنامه را در حال نوشتن روی فایل تغییرنام‌یافته نگه می‌دارند. دستورها از راهنمای logrotate آمده‌اند؛ روی سرور شما اجرایشان نکرده‌ام و مسیرها بین توزیع‌ها فرق می‌کنند.

۱. قاعده را در /etc/logrotate.d بنویسید

برای هر برنامه یک فایل در /etc/logrotate.d/ بگذارید. این مثال چهارده لاگ روزانه نگه می‌دارد، فشرده می‌کند و به برنامه می‌گوید فایل لاگ را دوباره باز کند:

# /etc/logrotate.d/myapp
/var/log/myapp/*.log {
    daily
    rotate 14
    compress
    delaycompress
    missingok
    notifempty
    create 0640 myapp adm
    sharedscripts
    postrotate
        systemctl reload myapp >/dev/null 2>&1 || true
    endscript
}

delaycompress لاگ دیروز را فشرده نمی‌کند که برای برنامه‌هایی که هنوز بازش نگه داشته‌اند مفید است. missingok و notifempty از خطا و چرخش خالی جلوگیری می‌کنند.

۲. پیش از اعتماد تست کنید

حالت debug چاپ می‌کند logrotate چه می‌کرد و چیزی را تغییر نمی‌دهد. فقط وقتی درست به نظر رسید یک چرخش واقعی را اجباری کنید:

sudo logrotate -d /etc/logrotate.d/myapp     # debug: shows what it would do, changes nothing
sudo logrotate -f /etc/logrotate.d/myapp     # force one rotation now
ls -lh /var/log/myapp/

اشتباه نحو در یک فایل می‌تواند چرخش بقیه را متوقف کند، پس بعد از هر ویرایش تست کنید.

۳. برنامه را وادار کنید لاگ را دوباره باز کند

بعد از تغییر نام، برنامهٔ در حال اجرا ممکن است روی همان file descriptor قدیمی بنویسد. از postrotate برای reload یا ارسال سیگنال به سرویس استفاده کنید، یا وقتی برنامه نمی‌تواند لاگ را دوباره باز کند به عنوان آخرین چاره copytruncate. copytruncate ممکن است چند خط را از دست بدهد، پس در صورت امکان reload را ترجیح دهید. reload سرویس در راهنمای سرویس systemd آمده است.

۴. بررسی کنید واقعاً اجرا می‌شود

در بیشتر سیستم‌ها logrotate از تایمر یا کران روزانه اجرا می‌شود. آخرین اجرا را تأیید کنید و مصرف دیسک را ببینید تا بدانید نگهداری مناسب است:

cat /var/lib/logrotate/status | grep myapp
systemctl list-timers | grep logrotate
journalctl -u logrotate -n 20 --no-pager
df -h /var/log
du -sh /var/log/* | sort -h | tail -n 5

اگر از لاگ‌ها بکاپ هم می‌گیرید نگهداری را با برنامهٔ بکاپ هماهنگ کنید؛ راهنمای بکاپ rsync را ببینید.

۵. نگهداری را حساب‌شده انتخاب کنید

آنچه برای عیب‌یابی و الزامات لازم دارید نگه دارید، نه همه‌چیز را برای همیشه. نگهداری خیلی طولانی و نبود hook مربوط به reload اشتباه‌های کلاسیک‌اند:

/var/log/myapp/*.log {
    rotate 3650        # keeps ten years of logs on disk
    # no postrotate: the app keeps writing to the old, renamed file
}

محدودیت اندازه‌ای مثل maxsize وقتی لاگ بین اجراهای روزانه سریع بزرگ می‌شود کمک می‌کند.

۶. مثال توضیحی، نه اندازه‌گیری واقعی

فرض کنید دیسک سروری (ساختگی) یک شب به ۱۰۰٪ می‌رسد. du یک لاگ برنامه با چند گیگابایت و بدون قاعدهٔ چرخش نشان می‌دهد. بعد از افزودن قاعدهٔ روزانه با فشرده‌سازی و hook مربوط به reload، logrotate -d اقدام‌های برنامه‌ریزی‌شده را نشان می‌دهد، اجرای اجباری آرشیو فشرده می‌سازد و برنامه روی فایل تازه می‌نویسد.

۷. اشتباه‌های رایج

  • تست‌نکردن با logrotate -d.
  • فراموشی hook مربوط به reload.
  • نگه‌داشتن لاگ‌ها برای همیشه.
  • چرخاندن لاگی که برنامه هرگز دوباره باز نمی‌کند.
  • استفاده از copytruncate در همه‌جا.
  • هرگز بررسی‌نکردن مصرف دیسک.

۸. پرسش‌های متداول

قاعده‌های logrotate کجاست؟ تنظیمات اصلی در /etc/logrotate.conf و فایل هر برنامه در /etc/logrotate.d/ است.

delaycompress چه می‌کند؟ فشرده‌سازی لاگ را یک چرخش به تأخیر می‌اندازد که برای برنامه‌ای که هنوز می‌نویسد امن‌تر است.

copytruncate امن است؟ ممکن است خطوط نوشته‌شده هنگام کپی از بین بروند. در صورت امکان از hook مربوط به reload استفاده کنید.

چطور بر اساس اندازه بچرخانم؟ از size یا maxsize در قاعده استفاده کنید.

۹. چک‌لیست سریع

  1. فایل /etc/logrotate.d/app را بسازید.
  2. تعداد چرخش و فشرده‌سازی را انتخاب کنید.
  3. hook مربوط به reload بیفزایید.
  4. logrotate -d اجرا کنید.
  5. با -f یک اجرا را اجباری کنید.
  6. وضعیت و تایمرها را ببینید.
  7. مصرف دیسک را پایش کنید.

اگر برای بررسی عملکرد یا نگهداری سرور به همکاری نیاز دارید، محدودهٔ خدمات مدیریت سرور را ببینید.

راهنماهای بیشتر سرور و وردپرس در آرشیو مقالات جمع شده‌اند.

منابع رسمی

logrotate(8) manual · Debian: logrotate(8) · journalctl manual · du(1) manual