
Bayangkan pukul 10.30 pagi, klien menghantar mesej di WhatsApp memberitahu borang tempahan di laman web keluar ralat 502 Bad Gateway atau sekadar mesej umum “Something went wrong”. Pelayan tiada papan pemuka pemantauan yang canggih; yang ada cuma akses SSH ke VPS Ubuntu.
Dalam keadaan begini, ramai yang terus membuka fail kod atau menyemak konfigurasi pelayan secara rawak. Padahal, jawapan paling cepat hampir selalu sudah tercatat di dalam log Linux—asalkan kita tahu di mana mahu melihat dan bagaimana menapisnya tanpa tenggelam dalam ribuan baris teks.
Mulakan dengan masa kejadian dan zon waktu
Sebelum menaip apa-apa arahan grep, tanya dua soalan asas: pukul berapa ralat berlaku, dan halaman atau endpoint mana yang terlibat?
Satu perangkap klasik bagi pembangun di Malaysia ialah zon waktu pelayan. Klien mungkin melapor masalah berlaku pada “pukul 9.15 pagi tadi”, tetapi VPS anda mungkin masih menggunakan waktu UTC. Pukul 9.15 pagi waktu Malaysia (MYT, UTC+8) bersamaan 01:15 di dalam log pelayan. Semak dahulu dengan arahan date atau timedatectl supaya anda tidak menghabiskan dua puluh minit membaca log pada jam yang salah.
Sebaik sahaja waktu tepat dikenal pasti, periksa baris terakhir di pelayan web dahulu. Jika menggunakan Nginx, mulakan dengan:
sudo tail -n 100 /var/log/nginx/error.log
Ingat bahawa Nginx hanya memberitahu apa yang berlaku di peringkat reverse proxy—misalnya connect() failed (111: Connection refused) while connecting to upstream. Itu bermakna proses aplikasi di belakangnya yang mati atau tidak menjawab, bukan salah Nginx itu sendiri. Untuk melihat punca sebenar aplikasi ASP.NET Core, Node.js, atau PHP-FPM anda gagal, semak log perkhidmatan tersebut melalui systemd:
sudo journalctl -u myapp.service --since "30 minutes ago" --no-pager
Jika anda perlu mengulang ralat dari pelayar sambil melihat apa yang berlaku secara langsung di pelayan, jalankan tail -f /var/log/nginx/error.log atau journalctl -u myapp.service -f, kemudian tekan Ctrl+C setelah selesai. Untuk kejadian semalam yang fail lognya sudah dimampatkan oleh logrotate, tidak perlu mengekstraknya satu per satu; gunakan sahaja zgrep:
sudo zgrep "502" /var/log/nginx/access.log.2.gz | head -n 20
Cari corak dan konteks, bukan satu baris semata-mata
Satu baris perkataan warning tidak semestinya punca kerosakan. Yang anda cari ialah ralat yang berulang berhampiran waktu kejadian, atau baris sejurus sebelum sesuatu perkhidmatan terhenti. Apabila menapis dengan grep, sertakan beberapa baris konteks sebelum dan selepas padanan menggunakan bendera -C:
grep -i -C 5 "exception" /var/log/myapp/app.log
Sering kali baris ralat utama nampak kabur, tetapi tiga baris di atasnya menyebut sambungan pangkalan data tamat tempoh, port sudah digunakan, atau fail konfigurasi tidak mempunyai kebenaran baca.
Jika log aplikasi kelihatan senyap tetapi laman tetap bermasalah, buat pemeriksaan pantas terhadap kesihatan asas Linux. Dua arahan yang wajib dijalankan ketika kecemasan ialah df -h dan free -h. Cakera keras yang penuh 100% akibat fail log atau backup lama sering menyebabkan MySQL, PostgreSQL, atau sesi PHP gagal menulis fail sementara tanpa mesej yang jelas di pelayar. Begitu juga jika RAM habis; kernel Linux akan menamatkan proses yang paling banyak menggunakan memori melalui OOM killer, yang boleh dikesan dengan dmesg -T | grep -i -E "oom|killed".
Sebelum menyalin tangkap layar log ke Slack atau kumpulan WhatsApp pasukan, pastikan tiada data peribadi pengguna seperti alamat e-mel, nombor telefon, nombor kad pengenalan, atau token API terpapar di dalamnya. Padam atau kaburkan bahagian sensitif itu terlebih dahulu.
Ubah satu perkara pada satu masa
Apabila punca sudah dijumpai—sama ada had memori PHP terlalu rendah, servis Kestrel terhenti, atau kebenaran folder muat naik tersilap—elakkan menukar tiga atau empat tetapan sekali gus. Ubah satu perkara, mulakan semula perkhidmatan yang berkaitan, kemudian uji semula permintaan yang gagal tadi sambil memerhati journalctl atau tail -f.
Log bukan sihir, tetapi rakaman jujur tentang apa yang mesin lakukan pada saat itu. Apabila kita membacanya mengikut garis masa yang betul, sesi menyahpepijat yang kelihatan menakutkan boleh diselesaikan dalam beberapa minit sahaja.