Merilis, dan Bekerja Sebagai Developer · 3/8

Log, error, dan monitoring

Mengetahui ada yang rusak sebelum pengguna mengadu ke managermu.

Baca 25 menit

Setelah pelajaran ini kamu bisa

Menulis baris log yang tetap berguna enam bulan kemudian
Memilih level yang tepat untuk sebuah pesan
Tidak pernah mencatat rahasia atau data pribadi
Menjelaskan apa yang perlu dijadikan alert dan apa yang cukup dicatat

Di production kamu tidak bisa menyambungkan debugger atau menambah console.log lalu memuat ulang. Log adalah satu-satunya jendelamu ke apa yang terjadi, dan ia hanya berguna kalau kamu menulisnya sebelum kamu membutuhkannya.

Logging terstruktur

Baris log yang dibangun dengan menggabungkan string bisa dibaca manusia dan tidak oleh apa pun lagi. Log terstruktur berupa JSON, yang berarti kamu bisa mencari, memfilter, dan menghitungnya.

Coba sendiri

Logger terstruktur dengan level dan penyensoran rahasia. Penyensorannya adalah bagian yang layak dibangun dengan hati-hati.

const LEVELS = { debug: 10, info: 20, warn: 30, error: 40 };

// Field names that must never appear in a log, at any depth.
const SECRET_KEYS = [
  "password", "passwordhash", "token", "secret", "authorization",
  "cookie", "sessionsecret", "apikey", "creditcard", "cvv",
];

function redact(value, depth = 0) {
  if (depth > 4) return "[deep]";
  if (value === null || typeof value !== "object") return value;
  if (Array.isArray(value)) return value.map((v) => redact(v, depth + 1));

const out = {};
  for (const [key, v] of Object.entries(value)) {
    // Normalise the key so password_hash, passwordHash and PASSWORD all match.
    const normalised = key.toLowerCase().replace(/[^a-z]/g, "");
    out[key] = SECRET_KEYS.some((s) => normalised.includes(s))
      ? "[REDACTED]"
      : redact(v, depth + 1);
  }
  return out;
}

const log = createLogger("info", "booking-api");

console.log("--- unstructured, the way most people start ---");
console.log("Booking failed for user 7: invalid nights");
console.log("   Searchable? Only by substring. Countable? No. Parseable? No.");
console.log("");

console.log("--- structured ---");
log("info", "booking created", { requestId: "req-9f2", userId: 7, venueId: 42, nights: 3 });
log("warn", "booking rejected", { requestId: "req-9f3", userId: 7, reason: "nights_out_of_range", nights: 99 });
log("error", "payment gateway timeout", { requestId: "req-9f4", venueId: 42, elapsedMs: 5031 });
log("debug", "cache hit", { key: "venues" });
console.log("   (the debug line was filtered out by the info threshold)");

console.log("");
console.log("--- redaction ---");
log("info", "sign-in attempt", {
  requestId: "req-9f5",
  name: "Ana",
  password: "hunter2",
  password_hash: "scrypt$16384$8$1$aa$bb",
  headers: { authorization: "Bearer abc123", "accept-language": "id" },
  card: { number: "4242424242424242", cvv: "123" },
});
console.log("   Note password, password_hash, authorization and cvv are gone,");
console.log("   but accept-language survived. Redact by key, at every depth.");

Hasil

Tekan Jalankan untuk melihat hasilnya.

Ini jalan di browser kamu, di dalam sandbox. Apa pun yang kamu tulis di sini tidak bisa merusak situs.

Level	Artinya	Seseorang sebaiknya
`debug`	Detail untuk diagnosis	Tidak ada. Dimatikan di production.
`info`	Sesuatu yang normal terjadi	Tidak ada. Berguna secara agregat.
`warn`	Berhasil pulih, tapi mencurigakan	Lihat minggu ini
`error`	Sebuah request gagal	Lihat hari ini
`fatal`	Proses tidak bisa lanjut	Dibangunkan dari tidur

Monitoring dan alerting

Log memberitahumu apa yang terjadi setelah kamu mencarinya. Monitoring memberitahumu ada yang salah sebelum penggunanya memberitahu. Perbedaan yang penting adalah antara apa yang kamu catat dan apa yang membangunkan seseorang.

Beri alert untuk gejala yang dirasakan pengguna — tingkat error, latensi, kegagalan checkout. Bukan CPU 80%, yang bisa jadi sepenuhnya normal.
Beri alert pada laju, bukan pada satu kejadian. Satu error 500 itu derau; lima puluh dalam satu menit itu insiden.
Setiap alert harus bisa ditindaklanjuti. Kalau satu-satunya respons adalah "lihat lalu abaikan", hapus — alert yang berisik melatih orang untuk mengabaikan alert yang sungguhan.
**Lacak *tingkat* error, bukan jumlah error.** Seratus error dari sejuta itu wajar; seratus dari dua ratus itu gangguan layanan.

Tugas praktik

Tambahkan logger terstruktur kecil ke proyek ini — sebuah function yang menerima level, pesan, dan object konteks, lalu mencetak JSON — dan pakai di signInAction untuk mencatat login yang gagal beserta nama yang dicoba tapi jangan pernah password-nya. Lalu picu sebuah kegagalan dan baca barisnya. Pastikan password-nya tidak muncul di mana pun.

Hasil yang diharapkan

Satu baris JSON berisi nama dan kode alasan, tanpa kredensial di mana pun.