1. Home
  2. Docs
  3. Self-hosted Server
  4. Docker
  5. Cara Membatasi Ukuran dan Rotation Log Container Docker

Cara Membatasi Ukuran dan Rotation Log Container Docker

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 perintah docker 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 menggunakan k (Kilobyte), m (Megabyte), atau g (Gigabyte).
  • "max-file": "3": Membatasi jumlah maksimal file log yang disimpan untuk setiap container sebanyak 3 file. Dengan kombinasi max-size: 10m dan max-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 pesan configuration 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" dan max-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 logging langsung pada file docker-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.json hanya 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.json saat Restart: Terjadi karena format JSON tidak valid (biasanya kelebihan atau kekurangan tanda koma ,). Periksa kembali isi file menggunakan cat /etc/docker/daemon.json dan uji ulang dengan sudo 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.

FAQ (Frequently Asked Questions)

Tags ,
guest

0 Comments
Oldest
Newest Most Voted