Log Rotation: nasıl çalışır, döndürme stratejileri ve mobil projeler için yapılandırma

Log Rotation Nedir

Log Rotation, aktif log dosyasının periyodik olarak yenisiyle değiştirilmesi ve aynı anda eskisinin arşivlenmesi, sıkıştırılması veya silinmesi sürecidir. Döndürme olmadan, tek bir log dosyası tüm disk bölümünü doldurana kadar süresiz olarak büyür ve uygulama hatasına ve veri kaybına yol açar.

Tipik senaryo: bir uygulama app.log dosyasına log yazar. app.log 100 MB'a ulaştığında, sistem onu app.log.1 olarak yeniden adlandırır, app.log.1.gz olarak sıkıştırır ve yeni boş bir app.log oluşturur. Bir sonraki dolumda, app.log.1 app.log.2 olur, app.log.1.gz app.log.2.gz olur ve eski app.log.2.gz silinir. Bu mekanizmaya keep count ile döndürme denir — arşiv kopya sayısı sabittir.

Splunk'a (2023) göre, yanlış döndürme yapılandırması, uygulama sunucularında disk alanı tükenmesiyle ilgili olayların %40'ının nedenidir. Mobil cihazlar için döndürme daha da kritiktir çünkü kullanıcı logları manuel olarak yönetemez ve yönetmemelidir.

Log Döndürme Stratejileri

Log Rotation birleştirilebilen üç temel stratejiyi destekler. Strateji seçimi uygulama türüne bağlıdır: sunucu sistemleri daha çok zaman tabanlı döndürme kullanır, mobil — boyut tabanlı, gömülü sistemler — dosya sayısı tabanlı.

Boyut tabanlı döndürme — en yaygın

Boyut tabanlı döndürme, hiçbir log dosyasının belirlenen sınırı aşmamasını sağlar. Sınır, mevcut disk alanı ve loglama sıklığına göre seçilir. Bir sunucu için tipik sınır dosya başına 100–500 MB, mobil cihaz için — 1–10 MB'dir. Uygulama agresif bir şekilde log tutuyorsa, sınır düşürülmelidir, aksi halde döndürme her birkaç dakikada bir gerçekleşir.

Zaman tabanlı döndürme — uyumluluk için

Zaman tabanlı döndürme log hacminden bağımsızdır — dosya kesinlikle bir programa göre değiştirilir. Logların sabit sayıda gün saklanması gereken sistemler için uygundur: keep count = 30 ile günlük döndürme, 30 günlük depolama anlamına gelir. Dezavantajı — yoğun yük altında tek bir dosya günde bir gigabayta kadar büyüyebilir.

Linux'ta logrotate: Yapılandırma ve Örnekler

logrotate, otomatik log döndürme için standart Linux yardımcı programıdır. Cron aracılığıyla çalışır ve /etc/logrotate.d/ dizinindeki yapılandırma dosyalarını işler. Her hizmet (nginx, postgresql, uygulama), log yollarını, döndürme stratejisini ve döndürme sonrası eylemleri belirten kendi yapılandırmasını oluşturur.

# /etc/logrotate.d/myapp — uygulama log döndürme
/var/log/myapp/*.log {
    daily
    rotate 7
    compress
    delaycompress
    missingok
    notifempty
    create 0640 www-data www-data
    postrotate
        kill -HUP $(cat /var/run/myapp.pid)
    endscript
}

Bu yapılandırma logları günlük olarak döndürür, 7 arşiv kopyası tutar, eski dosyaları gzip ile sıkıştırır (sonuncusu hariç — delaycompress), loglar eksikse hata vermez (missingok), boş dosyaları döndürmez (notifempty) ve dosyayı 0640 izinleriyle yeniden oluşturur. Döndürmeden sonra, bir postrotate betiği aracılığıyla uygulama sürecine HUP sinyali gönderir.

logrotate Parametreleri

size — bir boyuta ulaşıldığında döndürme (size 100M). rotate — arşiv kopyası sayısı (rotate 7). compress — gzip sıkıştırma. dateext — sıra numarası yerine dosya adına tarih ekler. sharedscripts — postrotate'i her dosya için ayrı ayrı değil, tüm dosyalar için bir kez çalıştırır. maxage — N günden daha eski arşivleri siler.

Mobil Uygulamalarda Log Rotation

Mobil cihazlarda, Log Rotation kritiktir çünkü kullanıcı dosya sistemini yönetmez ve uygulamanın loglarla gigabayt kaplamasını beklemez. iOS ve Android'de yerleşik mekanizmalar vardır: iOS'ta os_log sabit boyutlu bir halka tampon kullanır (üzerine yazma ile döndürme), Android Logcat çekirdekte sınırlı bir tampona sahiptir.

iOS'ta özel dosya logları için, boyut ve zaman tabanlı döndürmeyi destekleyen DDFileLogger sınıfıyla CocoaLumberjack kullanılır. Android'de — Logback veya RollingFileAppender aracılığıyla özel uygulamalar. Her iki araç da maksimum dosya boyutu ve arşiv sayısını ayarlamaya izin verir.

// CocoaLumberjack — iOS'ta dosya döndürme
import CocoaLumberjack

let fileLogger = DDFileLogger()
fileLogger.maximumFileSize = 1024 * 1024 // 1 MB
fileLogger.logFileManager.maximumNumberOfLogFiles = 5
DDLog.add(fileLogger)

iOS: os_log döndürme gerektirmez — mesajlar halka tamponda üzerine yazılır. Ancak uygulama özel dosya logları yazıyorsa (hata ayıklama veya sunucuya gönderme için), döndürme manuel olarak yapılandırılmalıdır. CocoaLumberjack, iOS ekipleri için standart seçimdir — arşivleri otomatik olarak .gz'ye sıkıştırır ve sınır aşıldığında eski dosyaları siler.

Android'de Döndürme Neden Önemlidir

Android, uygulamaların kendi dizinlerine log yazmasını kısıtlamaz. Bir geliştirici döndürme olmadan bir dosyaya hata ayıklama logları yazarsa, aktif kullanımın bir ayı içinde 500 MB ile 1 GB arasında yer kaplayabilir. Kullanıcı, sistem yetersiz depolama uyarısı gösterdiğinde sorunu keşfedecek ve uygulamayı silecektir. RollingFileAppender ile Logback bu sorunu çözer: 3 arşivle 5 MB sınırı, logların asla 20 MB'ı aşmamasını garanti eder.

iOS ve Android'de Döndürme Uygulama Örnekleri

Aşağıda her iki platformda log döndürme yapılandırması örnekleri verilmiştir. iOS'ta CocoaLumberjack, Android'de — XML yapılandırmasıyla Logback kullanılır.

// Android'de Logback — logback.xml'de döndürme yapılandırması
// Dosya boyutu 5MB, 3 arşiv kopyası
@file:Suppress("unused")

// logback.xml içinde:
// <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
//   <file>${DATA_DIR}/logs/app.log</file>
//   <rollingPolicy class="ch.qos.logback.core.rolling.FixedWindowRollingPolicy">
//     <fileNamePattern>app.%i.log.gz</fileNamePattern>
//     <minIndex>1</minIndex>
//     <maxIndex>3</maxIndex>
//   </rollingPolicy>
//   <triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
//     <maxFileSize>5MB</maxFileSize>
//   </triggeringPolicy>
// </appender>

iOS'ta CocoaLumberjack yalnızca boyut tabanlı döndürmeyi değil, aynı zamanda logFileManager.maximumLogFiles kullanarak tarihe göre eski logların silinmesini de destekler. maximumLogFiles = 0 olarak ayarlanırsa sınır kaldırılır — loglar süresiz olarak birikir ve bu üretim için tehlikelidir.

// Toplam hacim kontrolü ile özel döndürme
class SizeAwareLogger {
    let maxTotalSize: Int64 = 20 * 1024 * 1024

    func enforceQuota(at logDirectory: URL) {
        let files = (try? FileManager.default
            .contentsOfDirectory(
                at: logDirectory,
                includingPropertiesForKeys: [.fileSize]
            )) ?? []
        let total = files.reduce(0) {
            $0 + (try? $1.resourceValues(forKeys: [.fileSize])
                .fileSize).map(Int64.init) ?? 0
        }
        if total > maxTotalSize {
            // En eski dosyayı sil
            files.sorted { $0.path < $1.path }.first.map {
                try? FileManager.default.removeItem(at: $0)
            }
        }
    }
}

Döndürmede İzleme ve Uyarılar

Log Rotation yalnızca otomatik arşivleme değil, aynı zamanda sistem sağlığının bir göstergesidir. Loglar çok sık döndürülüyorsa (her birkaç dakikada bir), bu aşırı loglama veya hata log döngüsü sinyalidir. Döndürme sıklığına uyarılar ayarlayın: saatte 10'dan fazla döndürme inceleme nedenidir.

İzleme sistemleri (Prometheus, Grafana, Datadog), dosya sistemi dışa aktarıcıları aracılığıyla döndürme metriklerini izleyebilir. Prometheus node_exporter, dosya boyutu ve değişiklik zamanı metriklerini sağlar. Mobil cihazlarda, döndürme izlemesi genellikle SDK'ya yerleşiktir: CocoaLumberjack döndürme olayını DDLog aracılığıyla kaydeder ve Logback bir appender aracılığıyla durum gönderir.

Uyarılar: beklenenden daha fazla arşiv varsa (döndürme sayısı sınırı aştı) veya toplam log hacmi kotayı aştıysa — sistem yöneticiyi bilgilendirmelidir. Sunucular için standart eşik bölüm boyutunun %80'idir; mobil cihazlar için — uygulama başına 50 MB aşıldığında uyarı.