Catatan Lapangan

Circuit Breaker Pattern, Dijelaskan oleh Orang yang Dulu Memasang yang Asli

Penulis
Indra Sanjaya
Terbit
15 Jul 2026
Waktu Baca
4 mnt
Tag
backendsystem-designresiliencetypescript

Sebelum menulis perangkat lunak sebagai pekerjaan, aku menghabiskan delapan tahun di bidang HSE dan teknik lingkungan di lokasi migas dan industri, termasuk konstruksi LNG. Di sana, alat proteksi arus lebih bukan sesuatu yang abstrak. Ia adalah perangkat fisik yang ukurannya dihitung supaya trip sebelum gangguan berubah menjadi kebakaran. Jadi ketika pertama kali membaca tentang "circuit breaker pattern" di dokumen arsitektur backend, aku tidak menganggapnya metafora. Ia terasa seperti gagasan yang sama persis, hanya satu lapisan di atas kabel tembaga.

FIG. 01Masalah Retry Storm

Sebuah layanan downstream mulai timeout, bisa database yang kewalahan atau API pihak ketiga yang sedang bermasalah, tidak penting yang mana. Setiap pemanggil di hulunya melakukan hal yang terdengar masuk akal: menangkap timeout, lalu mencoba lagi. Kalikan dengan semua request yang sedang berjalan, lalu kalikan lagi dengan setiap retry yang dipicu request-request itu. Trafik yang menghantam layanan yang sudah kesulitan itu tidak turun saat ia mencoba pulih, justru melonjak. Retry itu sendiri menjadi alasan layanan tidak pernah punya kesempatan untuk pulih.

Inilah retry storm, padanan perangkat lunak dari seluruh peralatan di sebuah gedung yang menarik arus penuh melewati titik gangguan secara bersamaan. Logika retry secara lokal benar, tentu saja kamu mengulang request yang gagal, tetapi secara global menjadi bencana.

FIG. 02Tiga State, Dipinjam dari Teknik Elektro

Breaker sungguhan tidak punya perilaku "coba lebih keras". Tugasnya hanya satu: menghentikan aliran arus begitu mendeteksi gangguan, dan tetap terbuka sampai seseorang (atau sesuatu) memastikan aman untuk menutupnya lagi. Pola perangkat lunaknya menyalin mesin state itu hampir persis:

→ 01

Breaker yang sedang Open bukan breaker yang rusak. Ia adalah satu-satunya bagian sistem yang sedang melakukan persis apa yang dirancangkan untuknya. Kesalahannya adalah menilainya dari apakah request berhasil, bukan dari apakah ia sedang melindungi sesuatu.

FIG. 03Implementasinya

Mesin state ini cukup kecil untuk ditulis tanpa library, dan itu layak dilakukan setidaknya sekali supaya mode kegagalan di bawah benar-benar masuk akal:

LISTING 01 — circuit breaker minimal
type State = "closed" | "open" | "half-open";
 
class CircuitBreaker {
  private state: State = "closed";
  private failures = 0;
  private nextAttempt = 0;
 
  constructor(
    private readonly failureThreshold = 5,
    private readonly resetTimeoutMs = 30_000,
  ) {}
 
  async call<T>(fn: () => Promise<T>): Promise<T> {
    if (this.state === "open") {
      if (Date.now() < this.nextAttempt) {
        throw new Error("circuit open: failing fast");
      }
      this.state = "half-open";
    }
 
    try {
      const result = await fn();
      this.onSuccess();
      return result;
    } catch (err) {
      this.onFailure();
      throw err;
    }
  }
 
  private onSuccess() {
    this.failures = 0;
    this.state = "closed";
  }
 
  private onFailure() {
    this.failures += 1;
    if (this.failures >= this.failureThreshold) {
      this.state = "open";
      this.nextAttempt = Date.now() + this.resetTimeoutMs;
    }
  }
}

Bagian yang mudah terlewat saat membaca versi ringkas pola ini: cabang Open tidak mencoba memanggil lalu menelan error. Ia melempar error seketika, sebelum fn() sempat dijalankan. Gagal cepat adalah inti dari semuanya. Pemanggil yang terblokir menunggu timeout yang memang tidak akan berhasil tetap memakai satu thread, satu koneksi, satu slot di antrean hulu. Penolakan seketika mengembalikan sumber daya itu saat itu juga.

FIG. 04Di Mana Ia Tidak Cukup

Beberapa hal yang tidak ditangani versi dasar di atas, dan menjadi penting begitu ia berjalan menghadapi trafik sungguhan:

Poin terakhir itu yang paling terasa akrab dari dunia lamaku: breaker dengan rating terlalu tinggi tidak melindungi apa pun, dan sistem tanpa isolasi antarsirkuit mengubah satu gangguan menjadi pemadaman satu gedung, sebaik apa pun breakernya sendiri. Sebuah pola hanya sebaik tempat kamu menarik batas di sekelilingnya.