Belajar C# - Observability & Monitoring

#Pendahuluan

Aplikasi di production akan gagal — pertanyaannya hanya kapan. Saat itu terjadi, kalian harus bisa menjawab tiga pertanyaan dengan cepat: apa yang salah, di mana terjadinya, dan seberapa parah dampaknya. Inilah definisi observability.

Observability bukan sekadar menulis log. Dia adalah disiplin menerbitkan tiga sinyal — log, metrics, dan traces — secara konsisten dari seluruh layanan.

Episode 20 ini membangun sistem observability yang lengkap: logging dengan Serilog, telemetri dengan OpenTelemetry, health checks, dan cara menangani insiden di production.

#Logging dengan Serilog

#Log Terstruktur ke Konsol dan File

Di episode 6 kalian berkenalan dengan ILogger. Serilog memperkuatnya dengan log terstruktur dan sink yang beragam — file, console, hingga platform observability:

dotnet add src/Toko.Api package Serilog.AspNetCore

Log.Logger = new LoggerConfiguration()
    .WriteTo.Console()
    .WriteTo.File("logs/toko-.log", rollingInterval: RollingInterval.Day)
    .Enrich.FromLogContext()
    .CreateLogger();
 
var builder = WebApplication.CreateBuilder(args);
builder.Host.UseSerilog();

WriteTo.File dengan rollingInterval: RollingInterval.Day membuat satu file log per hari, mencegah file membengkak. Serilog mengirim log terstruktur JSON, bukan sekadar teks, sehingga mudah di-query di platform observability.

#Placeholder Terstruktur

Selalu gunakan placeholder bernama, bukan concatenation:

logger.LogInformation(
    "Order {OrderId} diproses oleh {UserId} sebesar {Total:C}",
    orderId, userId, total);

Placeholder {OrderId}, {UserId}, dan {Total} menjadi field terpisah di log terstruktur — memungkinkan pencarian seperti "semua order dengan ID X".

#Metrics, Tracing, dan OpenTelemetry

#Instrumentasi dengan OpenTelemetry

OpenTelemetry adalah standar industri untuk telemetri. Library ini menangkap metrics dan traces secara otomatis dari ASP.NET Core dan HttpClient:

dotnet add src/Toko.Api package OpenTelemetry.Extensions.Hosting
dotnet add src/Toko.Api package OpenTelemetry.Instrumentation.AspNetCore

builder.Services.AddOpenTelemetry()
    .WithTracing(tracing =>
    {
        tracing.AddAspNetCoreInstrumentation();
        tracing.AddHttpClientInstrumentation();
    })
    .WithMetrics(metrics =>
    {
        metrics.AddAspNetCoreInstrumentation();
    });

AddAspNetCoreInstrumentation otomatis merekam durasi tiap request sebagai trace, dan metrik seperti jumlah request per endpoint. Traces dari layanan yang berbeda bisa disatukan untuk melihat perjalanan satu request melintasi microservices.

#Activity untuk Traces Manual

Untuk instrumentasi manual, gunakan ActivitySource:

ActivitySource Sumber = new("Toko.Orders");
 
using var activity = Sumber.StartActivity("ProsesOrder");
activity?.SetTag("order.id", orderId);
activity?.SetTag("order.total", total);

StartActivity memulai segmen trace dengan tag yang berisi konteks. Ini yang menciptakan correlation ID yang kalian lihat di episode 17.

#Health Checks dan Monitoring Endpoints

#Endpoint Kesehatan

Platform orkestrasi perlu tahu apakah aplikasi hidup dan siap menerima traffic. ASP.NET Core menyediakan health checks bawaan:

builder.Services.AddHealthChecks()
    .AddDbContextCheck<TokoContext>();
 
var app = builder.Build();
app.MapHealthChecks("/health", new HealthCheckOptions
{
    ResponseWriter = async (ctx, report) =>
    {
        ctx.Response.ContentType = "application/json";
        await ctx.Response.WriteAsJsonAsync(report);
    }
});

MapHealthChecks("/health") menyediakan endpoint /health yang melaporkan status aplikasi dan database. Kubernetes memakai endpoint ini sebagai liveness dan readiness probe untuk memutuskan kapan pod layak menerima traffic.

#Memantau dengan curl

curl -s http://localhost:8080/health

Perintah curl -s http://localhost:8080/health mengembalikan status Healthy atau Unhealthy beserta detail pemeriksaan. Rutin polling ke endpoint ini adalah fondasi alerting.

#Incident Response dan Troubleshooting

#Alur Menangani Insiden

Saat insiden terjadi, ikuti alur yang terstruktur:

• Deteksi: alert dari metrik atau health checks yang gagal.
• Triase: cek dashboard metrik, trace terbaru, dan log error untuk menentukan layanan mana yang bermasalah.
• Mitigasi: cepat pulihkan — rollback deployment atau skala horizontal, daripada langsung mencari akar masalah.
• Post-mortem: setelah stabil, analisis akar masalah dan tulis tindak lanjut.

#Troubleshooting di Container

Log tersebar di banyak pod; kumpulkan dengan kubectl:

kubectl logs deployment/toko-api --tail=200

Perintah kubectl logs menampilkan log pod terbaru. Untuk log terpusat, arahkan sink Serilog ke platform seperti Loki atau CloudWatch agar semua log tersedia dalam satu tempat pencarian.

#Penutup

Inti yang harus dibawa pulang:

• Serilog memberikan log terstruktur dengan sink yang fleksibel.
• Placeholder bernama membuat log bisa di-query, bukan sekadar dibaca.
• OpenTelemetry menangkap metrics dan traces secara otomatis.
• Health checks menjadi sumber kebenaran untuk probe dan alerting.
• Insiden diatasi dengan deteksi, triase, mitigasi, lalu post-mortem.

Di episode 21 selanjutnya kita berpindah ke sisi klien: desktop dan cross-platform apps — .NET MAUI untuk aplikasi lintas platform, dasar WPF dan WinForms, interoperabilitas dengan native libraries, serta packaging dan distribusi aplikasi desktop.