Docker Logları Diski Doldurdu, Log Boyutu Nasıl Sınırlanır

Son gözden geçirme: Kasım 2026 · Docker Engine resmî günlük sürücüsü belgelerine göre

Hızlı çözüm

Docker log boyutu sınırlama yapılmazsa varsayılan json-file sürücüsü günlükleri hiç döndürmez ve /var/lib/docker/containers/ altındaki dosyalar diski doldurur. Kalıcı çözüm, sürücüye boyut sınırı vermektir:

  1. /etc/docker/daemon.json dosyasına "max-size": "10m" ve "max-file": "3" seçeneklerini ekleyin.
  2. sudo systemctl restart docker ile Docker’ı yeniden başlatın.
  3. Mevcut konteynerleri yeniden oluşturun; ayar yalnız yeni oluşturulan konteynerlere uygulanır.
  4. docker inspect ile konteynerin yeni günlük ayarını doğrulayın.
Panel SSH (komut satırı)
Sistem Ubuntu 24.04 ve 22.04, Docker Engine
Yetki root ya da sudo
Narhost ürünü VPS Sunucu, VDS Sunucu

Başlamadan önce

  • Docker’ı yeniden başlatmak çalışan konteynerleri kısa süreliğine durdurur; işlemi trafiğin az olduğu saatte yapın.
  • Konteynerleri Docker Compose ile yönetiyorsanız compose dosyalarınızın yerini bilin.
  • Günlüklere hukuki ya da hata ayıklama için ihtiyacınız varsa sınırlamadan önce gerekenleri dışarı alın.

Docker log boyutu sınırlama neden gerekir

Docker, konteynerin standart çıktısına yazdığı her satırı bir günlük sürücüsüyle saklar. Docker’ın günlük yapılandırma belgesine göre varsayılan sürücü json-file’dır ve geriye dönük uyumluluk için günlük döndürme yapmadan gelir. Çok konuşan bir uygulama, aylar içinde tek bir konteyner için onlarca gigabaytlık günlük dosyası üretebilir; sonuç “No space left on device” hatası ve duran servislerdir.

Belge, Kubernetes dışındaki kullanımlarda local sürücüsünü önerir: bu sürücü varsayılan olarak döndürme yapar ve daha verimli bir dosya biçimi kullanır. local sürücüsü belgesine göre konteyner başına varsayılan olarak 20 MB’lık 5 dosya, yani 100 MB günlük tutulur ve sıkıştırılır.

docker log boyutu sınırlama şeması — büyük günlükleri bul, daemon.json, yeniden başlat ve konteyneri yeniden oluştur
Ayar yalnız yeni oluşturulan konteynerlere uygulanır.

Adım adım günlük sınırını ayarlama

  1. En büyük günlükleri bulun.
    sudo du -h /var/lib/docker/containers/*/*-json.log | sort -h | tail -5

    Beklenen sonuç: en büyük beş günlük dosyası boyutlarıyla listelenir; dosya adındaki uzun kimlik konteynerin kimliğidir.

  2. daemon.json dosyasını düzenleyin. Dosya yoksa oluşturun; varsa içindeki diğer ayarları koruyarak log-driver ve log-opts anahtarlarını ekleyin.
    sudo nano /etc/docker/daemon.json
    {
      "log-driver": "json-file",
      "log-opts": {
        "max-size": "10m",
        "max-file": "3"
      }
    }

    Değerler tırnak içinde yazılır; Docker belgesi sayısal değerlerin de dize olarak verilmesini ister. Bu ayarla her konteyner en fazla 3 × 10 MB günlük tutar.

  3. Docker’ı yeniden başlatın.
    sudo systemctl restart docker
  4. Konteynerleri yeniden oluşturun. Yeni ayar yalnız yeniden oluşturulan konteynerlere uygulanır. Compose kullanıyorsanız proje klasöründe:
    docker compose up -d --force-recreate

    Beklenen sonuç: konteynerler yeniden oluşturulur; eski konteynerle birlikte büyük günlük dosyası da silinir.

  5. Ayarı doğrulayın.
    docker inspect --format '{{.HostConfig.LogConfig}}' konteyner_adi

    Beklenen sonuç: {json-file map[max-file:3 max-size:10m]} benzeri bir çıktı.

Dikkat

Docker belgesi, günlük dosyalarının yalnız Docker tarafından kullanılmak üzere tasarlandığını ve dış araçlarla müdahalenin beklenmeyen davranışa yol açabileceğini belirtir. Disk tamamen dolduysa ve hemen yer açmanız gerekiyorsa en güvenli yol konteyneri yeniden oluşturmaktır. rm ile günlük dosyasını silmeyin; dosya açık kaldığı için yer boşalmaz.

Tek bir konteynere sınır vermek

Bütün sunucuyu değiştirmek istemiyorsanız sınırı yalnız bir servise verebilirsiniz. Docker Compose dosyasında ilgili servisin altına logging bloğu eklenir: driver: json-file ve options altında max-size ile max-file. Compose kullanımı Docker Compose ile çoklu container yönetimi kartında anlatılıyor.

Doğrulama

Sonuç

docker inspect yeni sınırları gösteriyor, df -h disk kullanımının düştüğünü gösteriyor ve birkaç gün sonra du komutu günlük dosyalarının 30 MB’ı geçmediğini doğruluyorsa Docker log boyutu sınırlama işlemi tamamdır.

Hâlâ çözülmediyse

  • Disk yine doluyor. Yeri günlük değil imajlar ya da birimler kaplıyor olabilir; docker system df ile bakın, genel arama için No space left on device kartını uygulayın.
  • Docker yeniden başlamıyor. daemon.json’da JSON sözdizimi hatası vardır; virgül ve tırnakları kontrol edin, sudo journalctl -u docker ile hatayı okuyun.
  • Docker henüz kurulu değil. Kurulum Ubuntu’da Docker kurulumu kartında.

Narhost desteği

VPS ve VDS sunucular yönetimsizdir; Docker ve günlük ayarları sizin sorumluluğunuzdadır. Disk dolduğu için sunucuya bağlanamıyorsanız talebe sunucu adını ve konsolda gördüğünüz hatayı ekleyin.

Destek talebi aç

Sıkça sorulan sorular

Docker log boyutu sınırlama mevcut konteynerlere uygulanır mı?

Hayır. Docker belgesine göre daemon.json’daki günlük ayarı yeniden başlatmadan sonra oluşturulan konteynerler için geçerlidir. Mevcut konteynerleri yeniden oluşturmanız gerekir; Compose’da –force-recreate bunu yapar.

json-file mı local sürücüsü mü kullanmalıyım?

Docker, Kubernetes dışındaki kullanımda local sürücüsünü önerir; varsayılan olarak döndürme yapar ve sıkıştırır. Günlükleri docker logs dışındaki araçlarla dosyadan okuyorsanız json-file’ı sınırlarla kullanmak daha uyumludur.

Günlükleri tamamen kapatabilir miyim?

none sürücüsüyle bir konteynerin günlükleri kapatılabilir, ama hata ayıklama imkânını kaybedersiniz. Genellikle küçük bir boyut sınırı koymak daha doğrudur.

Bu makale sorununuzu çözdü mü?

Çözemediniz mi?

Teknik ekibimiz sunucu tarafındaki ayarları sizin için kontrol edebilir. Destek talebinizde alan adınızı ve aldığınız hata metnini paylaşmanız süreci hızlandırır.

Etiketler: dockerlog

İlgili çözümler