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

جلوگیری از پرشدن دیسک با چرخش لاگ Docker

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

جلوگیری از پرشدن دیسک با چرخش لاگ Docker

علت اغلب لاگ json-file بدون Rotation است. در این راهنما مصرف را شناسایی و برای سرویس مشخص سقف لاگ تعیین می‌کنیم؛ حذف Volume یا فایل فعال لاگ راه‌حل اولیه نیست.

دامنه و پیش‌نیازها

قبل از تغییر، مشخص کنید سرویس با Compose، Swarm یا روش دیگر مدیریت می‌شود. این نمونه برای Compose است. اگر سامانه مرکزی جمع‌آوری لاگ دارید، سازگاری driver را بررسی کنید. نام web و تصویر در فایل فعلی را حفظ کنید؛ نمونهٔ logging را به تعریف موجود اضافه کنید.

۱. شواهد را جمع‌آوری کنید

با docker system df فضای image و volume را جدا از لاگ بررسی کنید. LogPath و LogConfig کانتینر را بخوانید و فضای filesystem میزبان را اندازه بگیرید. مسیر Docker ممکن است با /var/lib/docker متفاوت باشد. حجم لاگ تشخیصی را با retention موردنیاز مقایسه کنید.

docker system df
docker inspect --format "{{.LogPath}} {{json .HostConfig.LogConfig}}" web
df -h

۲. تغییر کنترل‌شده

Driver نوع local به‌طور پیش‌فرض Rotation دارد. نمونه زیر 3 فایل با سقف 10m انتخاب می‌کند؛ بودجه واقعی سربار دارد. تغییر daemon.json فقط برای کانتینرهای تازه ساخته‌شده اعمال می‌شود. برای کانتینر موجود باید recreate برنامه‌ریزی‌شده انجام دهید؛ restart ساده پیکربندی logging را عوض نمی‌کند.

# Merge into the existing compose service; keep other fields.
services:
  web:
    logging:
      driver: local
      options:
        max-size: "10m"
        max-file: "3"

۳. نتیجه را آزمایش کنید

پیش از recreate، وضعیت داده پایدار و آماده‌بودن Replica را بررسی کنید. compose config باید سالم باشد. پس از جایگزینی، Config مؤثر، آخرین خروجی لاگ، سلامت برنامه و نرخ رشد دیسک را بررسی کنید. docker logs در local قابل استفاده است؛ نگهداری بلندمدت به مقصد مرکزی نیاز دارد.

docker compose config -q
# Planned recreation may interrupt a single-instance service.
docker compose up -d --no-deps --force-recreate web
docker logs --tail 50 web
docker inspect --format "{{json .HostConfig.LogConfig}}" web

بازگشت و پیشگیری

برای rollback، logging قبلی را برگردانید و فقط همان سرویس را recreate کنید. docker compose down -v یا docker system prune --volumes می‌تواند داده لازم را حذف کند. علت پرحرفی برنامه را هم اصلاح کنید؛ Rotation اثر را محدود می‌کند، نه خطای retry یا debug بی‌پایان را.

برای بررسی بخش‌های مرتبط این مسیر، راهنماهای ماندگاری و نگهداری امن لاگ‌های journald در لینوکس و Healthcheck در Docker؛ تفاوت Running و Healthy را نیز ببینید.

منابع فنی