Log, metrik & alarm

Yang menentukan berapa lama sebuah insiden berlangsung bukan seberapa cepat kamu memperbaiki, melainkan seberapa cepat kamu tahu apa yang rusak.

Log terstruktur

// src/lib/log.ts
type Tingkat = "debug" | "info" | "warn" | "error";

export function log(tingkat: Tingkat, pesan: string, data: Record<string, unknown> = {}) {
  // Satu baris JSON. CloudWatch mem-parsing field-nya otomatis.
  console.log(JSON.stringify({
    t: new Date().toISOString(),
    level: tingkat,
    msg: pesan,
    ...data,
  }));
}

// src/middleware/log.ts
export const catatAkses = defineMiddleware(async (ctx, next) => {
  const t0 = performance.now();
  const res = await next();
  const ms = Math.round(performance.now() - t0);

  // Jangan catat aset — jumlahnya mendominasi tanpa memberi informasi.
  if (!ctx.url.pathname.startsWith("/_astro/")) {
    log(res.status >= 500 ? "error" : "info", "request", {
      idRequest: ctx.locals.idRequest,
      metode: ctx.request.method,
      jalur: ctx.url.pathname,
      status: res.status,
      ms,
      cache: res.headers.get("cache-control")?.slice(0, 40),
      ua: ctx.request.headers.get("user-agent")?.slice(0, 80),
      // IP di-hash: cukup untuk mengelompokkan, tidak menyimpan data pribadi
      ip: hashIp(ctx.locals.ipPembaca),
    });
  }
  return res;
});

Menghubungkan satu perjalanan request

// Sertakan idRequest di setiap log yang terjadi selama request itu
export async function ambilArtikelPublik(slug: string, idRequest: string) {
  const t0 = performance.now();
  try {
    return await dbBaca.selectFrom("artikel")./* … */executeTakeFirst();
  } finally {
    const ms = performance.now() - t0;
    if (ms > 100) log("warn", "kueri lambat", { idRequest, kueri: "artikel.bySlug", ms });
  }
}

Di Cloudflare, header cf-ray adalah ID request yang sama yang
terlihat di log Cloudflare. Memakainya sebagai idRequest berarti
kamu bisa menelusuri satu request dari edge sampai kueri database.

Mengueri dengan Logs Insights

# Jalur paling lambat
fields jalur, ms
| filter ispresent(ms)
| stats count() as n, avg(ms) as rata, pct(ms, 95) as p95, max(ms) as maks by jalur
| sort p95 desc | limit 20

# Semua log untuk satu request
fields @timestamp, level, msg, ms, kueri
| filter idRequest = "8f2a1b3c-..."
| sort @timestamp asc

# Error per jenis
fields msg
| filter level = "error"
| stats count() as n by msg
| sort n desc

# Kueri lambat, dikelompokkan
fields kueri, ms
| filter msg = "kueri lambat"
| stats count() as n, avg(ms) as rata, max(ms) as maks by kueri
| sort n desc

# Webhook pembayaran yang gagal
fields @timestamp, order_id, status
| filter msg like /webhook/ and level = "error"
| sort @timestamp desc | limit 50

Yang tidak boleh masuk log

const SENSITIF = new Set([
  "sandi", "password", "signature_key", "saved_token", "token",
  "authorization", "cookie", "secret", "apiKey",
]);

export function bersihkanLog(o: Record<string, unknown>): Record<string, unknown> {
  const hasil: Record<string, unknown> = {};
  for (const [k, v] of Object.entries(o)) {
    hasil[k] = SENSITIF.has(k.toLowerCase()) ? "[disunting]" : v;
  }
  return hasil;
}

Metrik dari log

aws logs put-metric-filter \
  --log-group-name /ecs/portal-web \
  --filter-name error-5xx \
  --filter-pattern '{ $.status >= 500 }' \
  --metric-transformations \
    metricName=Error5xx,metricNamespace=Portal,metricValue=1,defaultValue=0

aws logs put-metric-filter \
  --log-group-name /ecs/portal-web \
  --filter-name webhook-gagal \
  --filter-pattern '{ $.msg = "webhook" && $.level = "error" }' \
  --metric-transformations \
    metricName=WebhookGagal,metricNamespace=Portal,metricValue=1,defaultValue=0

Alarm: hanya yang butuh tindakan

Retensi

aws logs put-retention-policy \
  --log-group-name /ecs/portal-web --retention-in-days 30

aws logs put-retention-policy \
  --log-group-name /ecs/portal-pembayaran --retention-in-days 365

Log CloudWatch ditagih per GB yang diserap dan per GB yang disimpan. Untuk portal dengan trafikmu, mencatat setiap aset akan menghasilkan tagihan yang tidak sepadan — karena itu filter _astro di middleware. Log pembayaran dipisahkan ke grup sendiri dengan retensi panjang, karena pertanyaan tentang transaksi bisa datang berbulan-bulan kemudian.

Dashboard

Dua panel terakhir yang paling sering dilihat orang non-teknis. Menaruhnya di dashboard yang sama dengan metrik infrastruktur membuat percakapan tentang gangguan jauh lebih cepat: "apakah ini memengaruhi pendapatan" bisa dijawab dalam lima detik.