
Docker Logları Diski Dolduruyor: Kalıcı Çözüm
Docker container logları büyüdüğünde disk dolabilir. Log boyutunu sınırlamak, döndürmeyi tanımlamak ve volume'ları koruyarak container'ları yeniden oluşturmak kalıcı çözümdür.
Docker logları diski dolduruyorsa sorun çoğu zaman sınırsız büyüyen json-file dosyalarıdır. Kalıcı çözüm; log boyutunu sınırlamak, döndürmeyi tanımlamak ve mevcut container'ları veri kaybetmeden yeniden oluşturmaktır. Bunları Docker uygulamaları için VDS sunucu üzerinde yönetiyorsanız önce hangi container'ın ne kadar yazdığını ölçün, sonra aynı politikayı tüm servislere uygulayın. Log dosyasını elle silmek geçici rahatlama sağlar; sınır koyulmadığı sürece dosya yeniden büyür. Aşağıdaki adımlar Docker CLI ve Compose kullanan Linux VDS için geçerlidir.
Kısa cevap:
docker system dfve log yollarıyla tüketimi ayırın.- json-file için
max-sizevemax-filetanımlayın. - Compose'da her servise log rotasyonu ekleyin.
- Volume'lara dokunmadan container'ları yeniden oluşturun.
Disk Tüketimini Log, Image ve Volume Olarak Ayırma
Disk dolduğunda ilk iş dosya silmek değil, tüketimi ayırmaktır. Docker'da alanı çoğunlukla container logları, image katmanları ve volume'lar paylaşır. df -h genel doluluğu gösterir; docker system df ise Docker'ın kendi hesabını verir. Bu iki çıktıyı birlikte okuyun.
| Bileşen | Tipik içerik | İlk kontrol |
|---|---|---|
| Container logları | json-file dosyaları | docker inspect ile LogPath |
| Image katmanları | Salt okunur katmanlar | docker system df |
| Volume'lar | Kalıcı uygulama verisi | docker volume ls |
Container logları json-file sürücüsünde genellikle /var/lib/docker/containers altında tutulur. Image katmanları salt okunurdur; çalışan container'ın yazılabilir katmanı ayrı büyür. Volume'lar ise veritabanı gibi kalıcı veriyi taşır. Log dosyalarını silmek volume'ları etkilemez; ancak çalışan uygulamanın log takibini bozabilir. Bu nedenle önce kaynağı tespit edin. Docker kurulumu ve temel container yönetimi için Docker kurulumu ve container yönetimi yazısına bakabilirsiniz.
Bind mount ile bağlanan bir dizin de diskte yer kaplar; ancak bu alan docker system df çıktısında volume gibi görünmeyebilir. Uygulama kendi içinde log yazıyorsa container logu küçük kalırken bind mount büyüyebilir. Bu yüzden df -h ve du çıktısını birlikte yorumlayın. Kaynağı ayırmadan silme işlemi yapmayın.
Büyüyen Container Günlüklerini Tespit Etme
Büyüyen günlüğü bulmak için önce hangi sürücünün kullanıldığını kontrol edin. Aşağıdaki komut çalışan container'ların adını, log sürücüsünü ve varsa log yolunu listeler:
docker ps -q | xargs docker inspect --format '{{.Name}} {{.HostConfig.LogConfig.Type}} {{.LogPath}}'
LogPath boş görünüyorsa container json-file dışında bir sürücü kullanıyor olabilir. json-file kullananlarda dosya boyutlarını görmek için:
sudo sh -c 'du -h /var/lib/docker/containers/*/*-json.log' | sort -h
Çıktıda alttaki dosyalar daha büyük olanlardır. Yalnızca boyuta bakmak yetmez; log üretim hızını da izleyin. Kısa aralıklarla iki kez ölçüm alıp farkı not edin. Sürekli hızlı büyüyen bir servis, uygulama hatası veya aşırı ayrıntılı log seviyesi nedeniyle yazıyor olabilir. docker events ile restart döngüsü olup olmadığına da bakın; sürekli yeniden başlayan servis her açılışta yeniden log üretir. Linux tarafında sistem loglarını ayırmak için Linux log yönetimi yazısı yol gösterir.
json-file İçin Boyut ve Dosya Sayısı Sınırı Koyma
json-file sürücüsü için etkili kalıcı ayar, dosya başına boyut ve dosya sayısı sınırıdır. Docker daemon ayarını /etc/docker/daemon.json içinde tanımlayabilirsiniz. Dosya yoksa oluşturun; varsa mevcut anahtarları koruyarak düzenleyin.
{
"log-driver": "json-file",
"log-opts": {
"max-size": "10m",
"max-file": "3"
}
}
Buradaki değerler örnektir; disk büyüklüğünüze ve log hacminize göre değiştirin. max-size tek dosyanın üst sınırını, max-file etkin log dosyası dahil tutulacak toplam dosya sayısını belirler; "3" değeri etkin dosya ile en fazla iki eski dosya anlamına gelir. Toplam alan kabaca bu ikisinin çarpımı kadar bir üst sınıra yaklaşır; yine de uygulamanın yoğunluğuna göre izleme yapın. Ayarı uygulamak için Docker servisini yeniden başlatın:
sudo systemctl restart docker
Docker yeniden başladığında container'lar yeniden başlatma politikalarına bağlı olarak kapalı kalabilir; bakım sonrası çalıştıklarını doğrulayın, gerekirse elle başlatın. Bu ayar yeni oluşturulan container'lar için geçerlidir. Mevcut container'lar eski log ayarıyla çalışmaya devam eder; bu yüzden beşinci bölümdeki yeniden oluşturma adımı gerekir. Dosyayı düzenlemeden önce yedek alın; JSON sözdizimi hatası Docker servisinin açılmamasına yol açabilir.
Compose Servislerinde Günlük Döndürmeyi Tanımlama
Compose kullanıyorsanız log ayarını her servisin altında tanımlayın. Böylece docker compose up ile oluşturulan container'lar sınırlı log dosyasıyla başlar.
services:
web:
logging:
driver: json-file
options:
max-size: "10m"
max-file: "3"
Her servis için ayrı logging bloğu ekleyin; yalnız bir servise eklemek diğerlerini daemon varsayılanlarına bırakır, daemon düzeyinde sınır varsa yeni servisler de sınırlı log tutar. Değerleri tüm servislerde aynı tutmak zorunda değilsiniz. Çok yazan bir servis için daha küçük dosya sınırı ve daha fazla dosya sayısı seçebilirsiniz. Compose dosyasını değiştirdikten sonra docker compose config ile sözdizimini kontrol edin. Çıktıda logging alanının göründüğünü doğrulayın. Üretimde Dockerfile ve Compose düzenini birlikte planlamak için Docker deploy rehberi yazısına bakın.
Mevcut Container'ları Veri Kaybetmeden Yeniden Oluşturma
Log ayarını mevcut container'lara uygulamak için container'ı yeniden oluşturmanız gerekir. Bu işlem volume'ları silmez; yine de önce bağlı volume ve bind mount'ları kontrol edin.
docker inspect --format='{{json .Mounts}}' <container>
<container> yerine container adını veya kimliğini yazın. Compose kullanıyorsanız önce yapılandırmayı doğrulayın, sonra servisleri yeniden oluşturun:
docker compose config
docker compose up -d --force-recreate
docker inspectile mount'ları kaydedin.- Compose dosyasında volume tanımlarını doğrulayın.
- Servisi
--force-recreateile yeniden oluşturun. docker psvedocker inspectile log ayarını kontrol edin.
docker compose down -v veya docker rm -v kullanmayın; bu komutlar volume'ları kaldırabilir. Tekil container çalıştırıyorsanız aynı volume, port ve ortam değişkenleriyle yeniden oluşturun. Yeniden oluşturma sonrası docker ps ile durumu, docker inspect ile log ayarını kontrol edin. Uygulama veritabanı kullanıyorsa önce yedek alın; doğru yeniden oluşturma komutu bile eski container'ın yazılabilir katmanındaki veriyi ve yerel loglarını kaldırır, kalıcı verinin volume veya bind mount üzerinde olduğunu doğrulayın.
Volume Silmeden Disk Kullanımını Doğrulama
Volume'ları silmeden disk kullanımını doğrulamak için önce genel görünümü alın:
df -h
docker system df
docker system df -v
docker system df image, container ve volume toplamlarını gösterir. -v seçeneği volume bazında ayrıntı verir. Log sınırı uygulandıktan sonra container loglarının yeniden oluşturulduğunu ve eski büyük dosyaların kalmadığını kontrol edin. Eski container'lar silinmiş olsa bile bazı log dosyaları diskte kalabilir; dosya yolunu bilmek elle silmeyi güvenli kılmaz, temizliği ilgili container ve log sürücüsünü doğrulayıp Docker üzerinden yapın. docker volume prune veya docker system prune --volumes çalıştırmayın; volume silinmesi veri kaybına yol açabilir. Linux disk tarafını ayrıca doğrulamak için Linux disk yönetimi yazısına bakın. Log sınırları oturduktan sonra bir sonraki adım, disk kullanımını düzenli aralıklarla izlemek ve yeni servislerde aynı Compose ayarını baştan tanımlamaktır. Disk baskısı sürüyorsa VDS sunucu paketleri sayfasından kaynakları karşılaştırabilirsiniz.
Sık Sorulan Sorular
Docker logları neden bu kadar hızlı büyür?
Uygulama her istekte ayrıntılı log yazıyorsa veya hata döngüsüne giriyorsa json-file dosyası sürekli büyür. Dosya boyutu sınırı tanımlı olmayabilir. Log seviyesini gözden geçirin, gereksiz ayrıntıyı azaltın ve json-file için max-size ile max-file sınırı koyun.
max-size ve max-file nasıl seçilir?
Disk kapasitenizi, günlük log hacmini ve log saklama ihtiyacınızı birlikte değerlendirin. Küçük sunucularda daha düşük dosya boyutu ve birkaç dosya yeterli olabilir. Kritik hata ayıklama dönemlerinde geçici olarak artırın; kalıcı üretim ayarında toplam alanı disk doluluğuna göre sınırlayın.
Ayarı değiştirdim ama eski container hâlâ büyüyor, neden?
Daemon veya Compose log ayarı yeni oluşturulan container'lara uygulanır. Çalışan container eski log yapılandırmasını kullanmaya devam eder. Volume'ları koruyarak container'ı yeniden oluşturun; Compose'da uygun komutla servisi yeniden başlatın. Yeniden oluşturma öncesi mount'ları ve yedekleri kontrol edin.
Log dosyalarını elle silmek güvenli mi?
Çalışan bir container'ın log dosyasını elle silmek anlık alan açabilir; ancak Docker dosya tanıtıcısını açık tutuyorsa alan hemen serbest kalmayabilir. Ayrıca log takibi bozulabilir. Kalıcı yöntem, log döndürmeyi yapılandırmak ve container'ı yeniden oluşturmaktır. Elle silme yerine önce sınırları uygulayın.
Volume'ları silmeden temizlik nasıl yapılır?
Önce docker system df -v ile hangi volume'un ne kadar yer kapladığını görün. Kullanılmayan image ve durmuş container'ları dikkatle temizleyin; volume prune ve down -v komutlarından kaçının. Emin olmadığınız volume'a dokunmayın. Gerekirse volume içeriğini ayrı yedekleyip öyle temizlik planlayın.
Sunucu Yönetimi İlgili Hizmetlerimiz
Bu yazıda anlatılan teknik konuyu profesyonel altyapıyla deneyimleyin
Etiketler:

