Docker Container Logları Nasıl Görüntülenir? VPS Üzerinde Uygulama Loglarına Erişim
VPS üzerinde Docker ile çalıştırılan bir uygulama beklenmedik şekilde durduğunda ya da hata döndüğünde ilk bakılacak yer her zaman loglardır. Sorun şu ki container içindeki süreç klasik anlamda bir dosyaya yazmıyor olabilir; loglar Docker'ın kendi mekanizması üzerinden toplanıyor. Bu rehberde VPS sunucunuzda çalışan container'ların loglarını görüntülemenin tüm pratik yollarını, sık karşılaşılan sorunları ve log yönetimi için önerileri bulacaksınız.
Docker Loglarının Temeli: stdout ve stderr
Docker'da her şey basit bir prensibe dayanır: container içinde çalışan uygulamanın stdout (standart çıktı) ve stderr (hata çıktısı) akışlarını Docker yakalar ve bir log sürücüsü (logging driver) üzerinden diskte saklar. Varsayılan sürücü json-file olduğu için loglar genellikle /var/lib/docker/containers/<container-id>/<container-id>-json.log dosyasında birikir.
Bu mimarinin avantajı, uygulamanın nereye log yazdığını düşünmenize gerek olmamasıdır. Uygulama çıktısını terminale basıyorsa (Nginx, Redis, çoğu resmi imaj bu şekilde davranır), log doğrudan docker logs komutuyla okunabilir.
Sık yapılan hata: Uygulamanın logu görünmüyor diye hemen paniklemeyin. Önce uygulamanın logu bir dosyaya yönlendirip yönlendirmediğini kontrol edin. Örneğinapp.logdosyasına yazan bir uygulamanın çıktısıdocker logsiçinde asla görünmez — çünkü stdout'a hiç yazmamıştır.
docker logs Komutu: Temel Kullanım
Container'ın tüm logunu görüntülemek için:
- Önce container ID'sini veya adını öğrenin:
docker ps - Logları görüntüleyin:
docker logs web-app - Canlı takip için:
docker logs -f web-app
-f parametresi tail -f gibi çalışır; yeni satırlar ekrana anında düşer. Çıkmak için Ctrl+C kullanın. Container durmuşsa bile loglar kaybolmaz, docker logs çalışmaya devam eder.
Sık Kullanılan Parametreler
--tail 100: Son 100 satırı gösterir. Uzun süre çalışan container'larda tüm logu basmak yerine bunu kullanın.--since 30m: Son 30 dakikanın loglarını gösterir.--since 2024-05-01T10:00:00gibi tarih de verilebilir.--until 1h: Belirtilen zamana kadar olan kayıtları gösterir.-tveya--timestamps: Her satırın başına zaman damgası ekler. Hata ayıklarken olmazsa olmazdır.--details: Container'a tanımlanan ortam değişkenleri ve etiketleri log satırlarına ekler.
Pratik bir örnek:
docker logs --since 1h -t --tail 500 web-app 2>&1 | grep -i error
Bu komut son bir saatteki, hata içeren satırları zaman damgalarıyla listeler. 2>&1 kısmı önemli: Docker stdout ve stderr'i ayrı akışlarda saklar, birleştirmezseniz bazı hata satırlarını kaçırabilirsiniz.
docker compose ile Log Görüntüleme
Uygulamanız Docker Compose ile çalışıyorsa işiniz daha da kolay. Proje dizininde:
docker compose logs -f
Bu komut projedeki tüm servislerin loglarını birlikte gösterir. Tek bir servis için: docker compose logs -f nginx. -f yerine --tail=200 ekleyerek çıktıyı kısaltabilirsiniz. Birden fazla servisi aynı anda hata ayıklarken servis adlarını ön ek olarak görmek işinizi hayli kolaylaştırır.
Container İçindeki Dosya Loglarına Erişim
Bazı uygulamalar (özellikle eski Java, PHP veya .NET uygulamaları) loglarını container içinde bir dosyaya yazar. Bu durumda birkaç seçeneğiniz var:
1. exec ile içeri girin:
docker exec -it web-app sh
Ardından tail -f /var/log/app/error.log gibi komutlarla dosyayı takip edin. İmajda bash yoksa sh kullanın — Alpine tabanlı imajların çoğunda bash bulunmaz.
2. Komutu direkt çalıştırın:
docker exec web-app tail -n 100 /var/log/app/error.log
Container'a girmeden çıktıyı alır, hızlı kontroller için idealdir.
3. Volume'a yazdırın: Log dizinini host'a bağlayın (-v /var/log/webapp:/var/log/app). Böylece VPS üzerinden tail -f /var/log/webapp/error.log ile doğrudan okuyabilirsiniz.
Log Dosyalarının Büyümesi: Rotation Ayarları
json-file sürücüsü varsayılan olarak sınırsızdır. Yoğun trafikli bir VPS'te birkaç hafta içinde log dosyasının onlarca gigabayte büyüdüğünü ve diski doldurduğunu sık görürüz. Bu, container'ın değil tüm sunucunun durmasına yol açabilir.
Çözüm, daemon genelinde ya da container bazında rotation tanımlamaktır. /etc/docker/daemon.json dosyasına:
{
"log-driver": "json-file",
"log-opts": { "max-size": "10m", "max-file": "3" }
}
Ardından systemctl restart docker ile servisi yeniden başlatın. Böylece her container'ın logu en fazla 10 MB × 3 dosya ile sınırlanır. Tek bir container için docker run sırasında --log-opt max-size=10m parametresini kullanabilirsiniz.
Dikkat: daemon.json değişikliği yalnızca yeni oluşturulan container'ları etkiler. Mevcut container'ların log ayarını değiştirmek için onları silip yeniden oluşturmanız gerekir — bu yüzden bu ayarı kurulum sırasında yapmak en kolayıdır.
Docker Log Sürücüleri ve Merkezi Toplama
Tek sunucu için docker logs yeterli olsa da birden fazla VPS yönetiyorsanız logları tek noktada toplamak işinizi ciddi biçimde kolaylaştırır. Docker bunun için hazır sürücüler sunar:
syslog: Logları sistem syslog'una iletir.fluentdvegelf: Fluentd veya Graylog gibi merkezi sistemlere gönderim için.loki: Grafana Loki ile hafif ve modern bir log toplama çözümü.none: Log toplamayı tamamen kapatır. Yalnızca loglarınızı zaten başka yere yönlendiriyorsanız kullanın.
Örnek: docker run --log-driver=loki --log-opt loki-url=http://loki:3100/loki/api/v1/push web-app
Sık Karşılaşılan Sorunlar ve Kontrol Listesi
- docker logs boş dönüyor: Uygulama stdout'a yazmıyor olabilir. İmajın CMD/ENTRYPOINT tanımını ve uygulamanın log yapılandırmasını kontrol edin.
- Loglar yarım/bulunkuy: Uygulama buffer'lı yazıyor olabilir. Python'da
-ubayrağı ya daPYTHONUNBUFFERED=1ortam değişkeni çoğu zaman bu sorunu çözer. - Disk doluyor:
du -sh /var/lib/docker/containers/*/*-json.logile en büyük log dosyalarını tespit edin, rotation ayarlayın. - Loglar sıfırlanıyor: Container her yeniden oluşturulduğunda eski json log dosyası silinir. Kalıcı log istiyorsanız merkezi toplama ya da volume kullanın.
- Servis adı bilinmiyor:
docker ps -aile çalışan ve durmuş tüm container'ları listeleyin.
Kurulumunuzu yaptıktan sonra kısaca şu kontrolü yapın: bir container başlatın, docker logs -f ile takip edin, diskin durumunu df -h ile gözlemleyin ve rotation ayarının docker inspect <container> --format '{{.HostConfig.LogConfig}}' çıktısında göründüğünü teyit edin. Bu dört adım sağlıklı çalıştığını doğrular. Log yönetimini kurulum aşamasında doğru yapılandırmak, ileride geçilir gece uyanmalarının çoğunu önler.