AnabisolutionsLogging terstruktur: cara mencatat log yang benar-benar membantu saat insiden
Logging terstruktur berarti mencatat log dalam format yang bisa dibaca mesin, biasanya JSON, dengan kolom konsisten seperti waktu, level, pesan, dan ID permintaan. Format ini membuat pencarian dan penyaringan jauh lebih cepat saat terjadi insiden. Pastikan juga tidak mencatat kata sandi atau data pribadi.
Apa itu logging terstruktur?
Alih-alih menulis kalimat bebas seperti pengguna gagal login, log terstruktur menuliskan pasangan kunci dan nilai: waktu, level, pesan, ID pengguna, dan ID permintaan. Mesin pencari log bisa langsung menyaring semua galat untuk satu pengguna.
Hasilnya adalah analisis insiden yang berjalan dalam menit, bukan jam.
Contohnya, saat pelanggan melapor pembayaran gagal pukul 14.05, tim cukup mencari ID pesanan di sistem log lalu melihat seluruh rangkaian kejadian berurutan. Tanpa struktur, tim harus membuka berkas teks satu per satu dan menebak baris mana yang berkaitan.
Kolom apa yang sebaiknya selalu ada?
- Timestamp dengan zona waktu seragam, misalnya UTC.
- Level: debug, info, warn, error.
- Pesan singkat yang konsisten.
- ID permintaan atau ID korelasi yang sama di seluruh layanan.
- Nama layanan dan versi aplikasi.
ID korelasi menyatukan jejak
Teruskan satu ID lewat header ke setiap layanan sehingga satu permintaan pengguna dapat dilacak dari awal sampai akhir.
Apa yang tidak boleh dicatat?
Log sering tersimpan lama dan diakses banyak orang. Karena itu, jangan mencatat data yang memicu risiko privasi atau keamanan.
- Kata sandi, token, dan kunci API.
- Nomor kartu pembayaran.
- Data pribadi lengkap yang tidak diperlukan, sesuai prinsip minimisasi dalam UU PDP.
- Isi permintaan penuh pada endpoint sensitif.
Ringkasan dan langkah berikutnya
Mulai dengan menyeragamkan format log di satu layanan, tambahkan ID permintaan, lalu kirim ke penyimpanan terpusat.
- Format: JSON.
- Level umum: debug, info, warn, error.
- Retensi log yang wajar: 30 sampai 90 hari.
- Rujukan: OWASP Logging Cheat Sheet di cheatsheetseries.owasp.org.
Topik terkait yang bisa Anda baca berikutnya: monitoring error di produksi, audit trail catatan perubahan, monitoring dan observability aplikasi AI, dan regulasi AI dan UU PDP.
Kesalahan yang perlu dihindari
Jangan mencatat segalanya pada level error sehingga sinyal penting tenggelam. Jangan pula membiarkan log hanya tersimpan di satu server tanpa cadangan, karena log hilang bersama server saat insiden terjadi.
Pertanyaan singkat seputar topik ini
Format log apa yang paling praktis?
JSON dengan kolom konsisten: waktu, level, pesan, dan ID permintaan. Format ini mudah dicari dan disaring oleh alat log.
Data apa yang tidak boleh dicatat?
Kata sandi, token, kunci API, nomor kartu, dan data pribadi yang tidak diperlukan, sesuai prinsip minimisasi data.
Pertanyaan yang sering muncul
Ya, tanpa komitmen. Kami balas dalam 1×24 jam kerja.
Tentang Tim AnabisolutionsStudio digital dari Pekanbaru yang mengerjakan website, aplikasi, dan sistem untuk klien di Riau dan sekitarnya.
