Runbook

Mar 07 2023

Sahabat On-Call person

Pendahuluan Runbook bukanlah hal baru, sebaliknya sudah ada selama bertahun-tahun. Runbook dapat dianggap sebagai panduan cara menyelesaikan tugas yang dapat digunakan untuk respons insiden jika terjadi peringatan.

Perkenalan

Runbook bukanlah hal baru, sebaliknya sudah ada selama bertahun-tahun. Runbook dapat dianggap sebagai panduan cara menyelesaikan tugas yang dapat digunakan untuk respons insiden jika terjadi peringatan.

Panduan cara ini dapat mencakup teks, daftar periksa, diagram, alur kerja, apa saja yang akan memudahkan orang yang dihubungi selama insiden.

Runbook dapat digunakan untuk mempercepat respons terhadap insiden umum

Ini adalah contoh Runbook tentang apa yang harus dilakukan ketika target Prometheus turun

Mengapa ini penting

Memiliki runbook yang berisi daftar langkah-langkah untuk menanggapi suatu insiden, atau untuk melakukan tindakan tertentu atau langkah-langkah awal sangat berharga bagi orang yang sedang menelepon yang dipanggil pukul 2 pagi. Langkah-langkah ini membantu petugas panggilan untuk men-debug, memitigasi, dan menyelesaikan masalah, tanpa perlu mencari tahu setiap masalah dan memahami cara kerja layanan.

Ini akan mengurangi waktu henti dan memberi waktu tambahan bagi orang yang bertugas untuk tidur :)

Menurut Buku Kerja Google SRE, Runbooks harus "mengurangi stres, waktu rata-rata untuk memperbaiki (MTTR), dan risiko kesalahan manusia".

Apa yang harus ada di Runbook?

Runbook harus fokus pada satu tugas dan berisi langkah-langkah yang diperlukan untuk menyelesaikan masalah.
Langkah-langkah dalam runbook harus jelas, sehingga siapa pun dapat dengan cepat menyelesaikan masalah juga untuk orang yang sedang on-call yang setengah tertidur.
Setiap masalah harus menyertakan nama lansiran dan deskripsi .
Itu harus menggambarkan apa tingkat keparahan dari apa masalahnya.
Itu harus menjelaskan ketergantungan apa pun ke layanan lain.
Itu harus berisi apa dampak bisnisnya .
Itu harus berisi informasi tentang bagaimana berkomunikasi dengan pemangku kepentingan, pelanggan dan organisasi.
Itu harus berisi informasi kontak dan on-call .
Bagian dari FAQ (pertanyaan yang sering diajukan)

Membuat Runbook

Kedengarannya bagus, tapi bagaimana Anda membuat hal seperti itu? Di mana Anda bahkan mulai?

Anda dapat mulai membuat runbook dengan menulis instruksi untuk tugas berdasarkan kejadian sebelumnya. Pikirkan insiden apa yang paling umum. Informasi ini dapat diambil dari postmortem .

Setiap kali peringatan dibuat, entri runbook yang sesuai harus dibuat.

Untuk memulai, saya sarankan untuk memeriksa koleksi GitLab Runbooks . Repositori ini menyediakan banyak runbook untuk memulai dan ini merupakan awal yang baik untuk mendapatkan inspirasi tentang cara membuat runbook yang sesuai untuk tim/organisasi Anda.

Langkah pertama adalah menulis runbook on-call untuk tim dengan instruksi tentang cara menanggapi peringatan. Sebagai contoh, runbook On-Call ini menyediakan template untuk orang-orang yang memulai shift on-call.

Siapa yang harus menulis Runbooks?

Kepemilikan dan akuntabilitas harus diletakkan pada tim. Mereka bertanggung jawab agar runbook selalu mutakhir dan akurat. Tim SRE dapat menyediakan template untuk tim, tetapi mereka bertanggung jawab untuk itu dan setiap modifikasinya merupakan upaya bersama dari tim.

Di mana Runbook harus disimpan?

Runbook dapat disimpan di repositori GitHub (baik untuk otomatisasi) atau di halaman pertemuan, halaman wiki, dll. Yang penting di sini adalah mudah ditemukan dan dicari selama insiden.

Seberapa sering saya harus memperbarui Runbooks?

Masalah umum dengan runbook adalah bahwa mereka menjadi usang. Runbook harus terus diperbarui dan berisi informasi terbaru. Jika dependensi baru ditambahkan, maka informasi tentang dependensi tersebut harus ditambahkan ke dokumentasi.