Digital Transformation
Runbook (Buku Panduan Operasional)
TL;DR: Runbook adalah dokumen operasional berisi prosedur konkret untuk skenario tertentu, misal "checkout error 500" atau "domain expired". Tujuannya: orang baru bisa menjalankan respons sebaik orang berpengalaman, dan organisasi tidak lumpuh saat satu orang kunci tidak ada.
Apa itu Runbook?
Runbook adalah dokumentasi yang berisi instruksi konkret langkah demi langkah untuk menangani satu situasi spesifik. Berbeda dengan dokumentasi arsitektur yang menjelaskan "kenapa", runbook menjelaskan "apa yang harus diketik dan diklik" agar masalah selesai.
Bentuk paling umum: satu file markdown per skenario, dengan struktur seragam (gejala, dampak bisnis, langkah diagnosa, langkah perbaikan, langkah verifikasi, eskalasi). Runbook hidup dekat dengan kode atau di alat seperti Notion, Confluence, atau GitBook, dan terhubung ke alert dari sistem observability.
Kapan Runbook Dipakai?
| Skenario | Contoh Runbook |
|---|---|
| Insiden produksi | "Halaman utama 503", "Webhook payment gagal 5 menit berturut-turut" |
| Operasi rutin | "Rotasi API key", "Backup database mingguan", "Renew SSL" |
| Onboarding | "Akses awal developer baru", "Setup environment lokal" |
| Disaster recovery | "Restore dari backup terakhir", "Failover ke region cadangan" |
Runbook berbeda dengan playbook. Playbook mencakup keputusan bisnis dan komunikasi (siapa kabari pelanggan, siapa lapor regulator), sementara runbook fokus pada eksekusi teknis. Kombinasi keduanya membuat respons insiden lebih cepat tanpa mengandalkan ingatan satu orang.
Kenapa Penting bagi Bisnis Indonesia?
Banyak bisnis kecil dan menengah di Indonesia bergantung pada satu atau dua orang teknis yang tahu segalanya. Saat orang itu cuti, sakit, atau resign, sistem ikut rentan. Runbook adalah investasi murah yang memindahkan pengetahuan tacit menjadi aset perusahaan. Untuk tim yang pakai feature flag, runbook juga mendokumentasikan flag mana yang aman dimatikan saat insiden, sehingga eskalasi tidak salah arah.
Pertanyaan Umum
Berapa banyak runbook yang dibutuhkan tim kecil?
Mulailah dari 5-10 skenario yang paling sering terjadi atau paling tinggi dampaknya. Tambahkan satu runbook baru setiap kali ada insiden yang belum pernah terdokumentasi. Hindari menulis runbook untuk skenario yang tidak pernah muncul.
Apakah runbook harus selalu manual?
Tidak. Banyak langkah runbook yang sudah matang bisa diotomasi jadi script atau workflow di GitHub Actions, n8n, atau alat otomasi lain. Praktik ini disebut "runbook automation".
Istilah Terkait