
Banyak aplikasi web nampak sihat dari luar tetapi sebenarnya lumpuh di dalam. Pelayan masih memulangkan status 200 OK apabila alat pemantauan seperti UptimeRobot atau Cloudflare memanggil halaman utama, sedangkan di belakang tabir sambungan ke pangkalan data sudah terputus atau pool sambungan penuh. Dalam papan pemuka, semuanya berwarna hijau. Bagi pengguna yang cuba log masuk atau membuat bayaran, sistem sudah rosak.
Kesilapan ini berlaku apabila health check sekadar menguji sama ada proses pelayan web masih bernyawa, contohnya memulangkan Results.Ok("Healthy") tanpa memeriksa kebergantungan penting. Memang benar proses ASP.NET masih berjalan, tetapi aplikasi yang tidak dapat membaca data atau memproses kerja hakikatnya tidak berfungsi.
Bezakan semakan ‘hidup’ dan ‘bersedia’
Dalam ASP.NET Core, amalan yang lebih selamat ialah mengasingkan dua jenis semakan menggunakan middleware Health Checks rasmi: liveness dan readiness.
Liveness check (misalnya pada /health/live) hanya perlu mengesahkan bahawa proses Kestrel masih responsif dan tidak terperangkap dalam deadlock. Jangan masukkan semakan pangkalan data atau API pihak ketiga di sini. Mengapa? Kerana jika anda menjalankan aplikasi di dalam Docker, Kubernetes, atau di belakang load balancer yang dikonfigurasi untuk memulakan semula kontena apabila liveness gagal, gangguan sementara selama lima saat pada pangkalan data boleh menyebabkan kesemua instance aplikasi dimulakan semula berulang kali secara serentak.
Sebaliknya, readiness check (contohnya pada /health/ready) ialah tempat untuk menguji komponen yang wajib ada sebelum trafik pengguna dihantar ke instance tersebut—seperti SQL Server, PostgreSQL, atau Redis. Anda boleh menggunakan tag untuk memisahkan kedua-duanya dengan kemas:
builder.Services.AddHealthChecks()
.AddCheck("self", () => HealthCheckResult.Healthy(), tags: new[] { "live" })
.AddDbContextCheck<AppDbContext>("database", tags: new[] { "ready" });
// ...
app.MapHealthChecks("/health/live", new HealthCheckOptions
{
Predicate = check => check.Tags.Contains("live")
});
app.MapHealthChecks("/health/ready", new HealthCheckOptions
{
Predicate = check => check.Tags.Contains("ready")
});
Berhati-hati dengan kos dan tempoh tamat masa (timeout) setiap semakan. Jika anda mempunyai API luar seperti gerbang pembayaran atau perkhidmatan e-mel, elakkan memanggilnya setiap sepuluh saat melalui health check kerana ia boleh membebankan kuota API, mencetuskan rate limit, atau memperlahankan respons endpoint kesihatan sendiri. Untuk kebergantungan pihak ketiga yang tidak kritikal bagi laluan utama aplikasi, anda boleh memulangkan status HealthStatus.Degraded berbanding Unhealthy supaya pasukan menerima amaran tanpa terus menjatuhkan keseluruhan instance daripada load balancer.
Tetapkan juga Timeout yang munasabah pada setiap pendaftaran semakan, misalnya tiga hingga lima saat, supaya kebergantungan yang tergantung tidak menarik sekali health check ke bawah. Jika pangkalan data mengambil masa lima belas saat untuk menjawab, aplikasi sudah pun dianggap tidak bersedia oleh pengguna yang menunggu di pelayar.
Jaga maklumat sensitif dan uji kegagalan sebenar
Satu lagi perkara yang sering terlepas pandang ialah keselamatan endpoint ini. Untuk pemantauan awam, cukup sekadar memulangkan status Healthy, Degraded, atau Unhealthy bersama kod HTTP 200 atau 503. Jangan dedahkan mesej pengecualian penuh, nama pelayan pangkalan data, atau connection string kepada umum. Jika anda perlukan laporan JSON terperinci untuk pasukan kejuruteraan, hadkan laluan tersebut kepada rangkaian dalaman atau lindungi dengan header pengesahan khas.
Akhir sekali, health check yang tidak pernah diuji ketika gagal tidak memberi sebarang jaminan. Sebelum masuk ke production, cuba matikan sementara pangkalan data di persekitaran staging atau sekat port Redis. Perhatikan sama ada /health/ready bertukar kepada 503 Service Unavailable dalam masa yang dijangka, dan sama ada amaran sampai kepada pemilik yang betul.
Amaran yang berbunyi di saluran Slack tetapi tiada siapa tahu apa tindakan susulan—sama ada mahu semak log journalctl, mulakan semula servis, atau lakukan rollback—hanya akan menjadi bunyi bising yang akhirnya diabaikan. Apabila health check direka mengikut pengalaman sebenar pengguna dan dipadankan dengan langkah tindakan yang jelas, barulah warna hijau pada pemantauan itu benar-benar bermakna.