Log Dev: Kejujuran Sistem
Bina sistem yang menyatakan kebenaran.
Sesebuah sistem hanya sebaik isyaratnya. Jika pertanyaan anda menyembunyikan pembaziran, semakan kesihatan anda menipu, atau alatan anda mengulang kerja yang sama, sistem anda tidak jujur.
Saya meluangkan masa sepanjang hari mengusahakan empat utas teknikal yang berbeza. Setiap satunya mengikut satu tema tunggal: menjadikan sistem itu jujur.
- Prestasi Pangkalan Data Berhenti mengambil data yang tidak anda gunakan.
- Gunakan pengesan N+1 dalam persekitaran pembangunan anda. Ia menukarkan lazy-loads yang tersembunyi kepada senarai tugasan yang jelas.
- Buang eager loads yang tidak digunakan. Jika paparan anda tidak menggunakan sesuatu lajur, jangan ambil lajur tersebut.
- Memoize pemalar bagi setiap permintaan. Jangan kira semula nilai yang sama berulang kali dalam satu kitaran.
- Kumpulkan pertanyaan papan pemuka. Gantikan dua puluh panggilan kiraan (count) kecil dengan satu pertanyaan berkumpulan.
- Semakan Kesihatan Sebenar Semakan yang hanya mengesahkan jika sesuatu konfigurasi wujud bukanlah semakan kesihatan. Ia adalah semakan konfigurasi.
- Semakan kesihatan yang sebenar mesti membuktikan kebolehcapaian (reachability).
- Buka soket ke hos dan port sasaran.
- Gunakan kontrak atau antara muka (interface) untuk bertukar antara prob TCP, HTTP, atau TLS.
- Jalankan setiap prob pada sambungannya sendiri. Satu perkhidmatan yang perlahan tidak sepatutnya melambatkan keseluruhan alatan pemantauan anda.
- Alatan AI yang Lebih Selamat (MCP) Apabila anda memberi akses kepada ejen AI ke dalam sistem anda, anda mesti mengandaikan bahawa ia akan melakukan kesilapan.
- Gunakan kunci idempotensi (idempotency keys). Jika ejen mencuba semula sesuatu permintaan, pelayan harus mengembalikan hasil yang sama dan bukannya mencipta pendua.
- Bersihkan data peribadi semasa data keluar. Anggap laluan respons sebagai sempadan awam.
- Gunakan kod ralat bertipe. Jangan hantar rentetan (string) mentah. Ejen memerlukan kod berstruktur seperti "not_found" untuk bertindak dengan betul.
- Identiti dan Tetapan Semula Kata Laluan Urutan adalah penting apabila anda menyentuh pelbagai sistem.
- Jika tetapan semula kata laluan melibatkan pelbagai direktori, pilih satu sumber kebenaran (source of truth).
- Tulis ke direktori berautoriti terlebih dahulu.
- Dokumentasikan urutan tersebut. "Ia berfungsi semasa saya mencubanya" bukanlah jaminan kejayaan semasa berlaku kegagalan.
Matlamatnya bukan untuk membina ciri-ciri yang gah. Matlamatnya adalah untuk membina sistem yang kekal boleh dipercayai walaupun anda tidak memerhatikannya.