Salah satu masalah klasik yang sering dihadapi System Administrator saat mengelola server berbasis Docker adalah kapasitas penyimpanan (disk space) yang tiba-tiba penuh. Padahal, jumlah image dan volume aplikasi tidak banyak bertambah. Biasanya, penyebab utamanya adalah file log container yang membesar secara signifikan, bahkan bisa mencapai puluhan gigabyte.
Secara default, Docker mencatat seluruh output aplikasi (stdout dan stderr) ke dalam file JSON tanpa batasan ukuran. Untuk mencegah insiden server down akibat disk penuh, Anda perlu mengaktifkan mekanisme log rotation secara global melalui file konfigurasi /etc/docker/daemon.json.
Kapan Seharusnya Konfigurasi Ini Diatur?
Konfigurasi log rotation global di /etc/docker/daemon.json wajib diterapkan pada kondisi berikut:
- Server & VPS Kapasitas Terbatas: Sangat krusial untuk Virtual Private Server (VPS) atau Single-Board Computer (SBC) seperti Raspberry Pi dan Armbian yang memiliki ruang storage terbatas.
- Aplikasi dengan Aktivitas Log Tinggi (Verbose): Service seperti web server (Nginx/Apache), reverse proxy, database, atau monitoring agent yang menghasilkan ribuan baris log setiap menitnya.
- Setup Server Baru (Initial Provisioning): Ideal diterapkan tepat setelah proses instalasi Docker selesai sebelum Anda mulai men-deploy container.
Langkah demi Langkah Konfigurasi Log Rotation Docker
Pastikan Anda memiliki akses root atau pengguna dengan hak akses sudo di server Linux Anda sebelum memulai.
Cek Penggunaan Disk Log Docker Saat Ini
Sebelum melakukan perubahan, periksa terlebih dahulu seberapa banyak ruang penyimpanan yang digunakan oleh file log container saat ini:
sudo du -sh /var/lib/docker/containers/*/*-json.log
Buat atau Edit File /etc/docker/daemon.json
Buka file konfigurasi utama Docker daemon menggunakan editor teks nano. Jika file belum ada, perintah ini akan secara otomatis membuatnya:
sudo nano /etc/docker/daemon.json
Copy dan Paste konfigurasi JSON berikut ke dalam editor:
{
"log-driver": "json-file",
"log-opts": {
"max-size": "10m",
"max-file": "3"
}
}
"log-driver": "json-file": Menetapkan logging driver default Docker untuk menyimpan log dalam format JSON lokal sehingga tetap dapat diakses menggunakan perintahdocker logs."max-size": "10m": Membatasi ukuran maksimal satu file log sebesar 10 Megabyte. Ketika ukuran file mencapai 10 MB, Docker akan otomatis rotate file tersebut dan membuat file baru. Anda dapat mengubah satuannya menggunakank(Kilobyte),m(Megabyte), ataug(Gigabyte)."max-file": "3": Membatasi jumlah maksimal file log yang disimpan untuk setiap container sebanyak 3 file. Dengan kombinasimax-size: 10mdanmax-file: 3, total ruang maksimal yang digunakan log satu container tidak akan pernah melebihi 30 MB (file ke-4 yang paling lama akan otomatis dihapus).
Validasi Konfigurasi JSON
Langkah ini sangat penting untuk mencegah Docker daemon gagal berjalan akibat kesalahan pada tanda koma atau kurung kurawal.
sudo dockerd --validate --config-file=/etc/docker/daemon.json
dockerd --validate: Menguji struktur sintaks file konfigurasi tanpa memengaruhi service Docker yang sedang berjalan. Pastikan output menampilkan pesanconfiguration OK.
Restart Docker
Terapkan konfigurasi baru dengan memuat ulang daemon Docker:
sudo systemctl reload docker || sudo systemctl restart docker
systemctl reload docker: Memuat ulang konfigurasi tanpa menghentikan container yang sedang berjalan (jika support), dan secara otomatis akan melakukan restart penuh jika diperlukan.
Verifikasi Logging Driver Aktif
Pastikan pengaturan logging driver sudah terbaca dengan benar oleh sistem:
docker info --format '{{.LoggingDriver}}'
--format '{{.LoggingDriver}}': Memfilter output perintah docker info menggunakan Go template agar langsung menampilkan nama driver yang aktif (json-file).
Best Practice Manajemen Log Docker
Untuk memastikan pengelolaan log server Anda tetap optimal dan menghindari potensi masalah di masa mendatang, terapkan praktik-praktik berikut:
- Sesuaikan Kuota dengan Kapasitas Storage: Pada server dengan disk besar, nilai
max-size: "50m"danmax-file: "5"(total 250 MB per container) memberikan riwayat debugging yang lebih panjang tanpa membebani penyimpanan. - Gunakan Override di Docker Compose untuk Aplikasi Kritikal: Jika ada container spesifik (seperti payment gateway atau API service) yang membutuhkan retensi log lebih besar daripada aturan global, tambahkan blok
logginglangsung pada filedocker-compose.yml:
services:
api-service:
image: my-api:latest
logging:
driver: "json-file"
options:
max-size: "50m"
max-file: "5"
Troubleshooting
- Ukuran Log Container Lama Masih Membengkak:
Konfigurasi di/etc/docker/daemon.jsonhanya berlaku untuk container yang baru dibuat setelah service Docker di-restart. Untuk menerapkan aturan rotasi pada container lama, lakukan recreate dengan menjalankan:
docker compose up -d --force-recreate
- Jika Anda perlu mengosongkan file log yang terlanjur penuh secara darurat tanpa menghapus container, gunakan perintah
truncate:
sudo truncate -s 0 /var/lib/docker/containers/<CONTAINER_ID>/<CONTAINER_ID>-json.log
- Error
unable to configure the Docker daemon with file /etc/docker/daemon.jsonsaat Restart: Terjadi karena format JSON tidak valid (biasanya kelebihan atau kekurangan tanda koma,). Periksa kembali isi file menggunakancat /etc/docker/daemon.jsondan uji ulang dengansudo dockerd --validate.
Mengatur log rotation melalui /etc/docker/daemon.json adalah langkah preventif sederhana namun sangat vital dalam administrasi server Linux. Dengan membatasi parameter max-size dan max-file menggunakan driver json-file, Anda memastikan server tetap stabil, terhindar dari risiko disk full mendadak, dan tetap memiliki riwayat log yang cukup untuk kebutuhan troubleshooting sehari-hari.