Runbook'lar

Mar 07 2023

Bir Çağrı Üzerine kişinin en iyi arkadaşı

Giriş Runbook'lar yeni bir şey değil, aksine uzun yıllardır var. Runbook, bir uyarı durumunda olay müdahalesi için kullanılabilecek bir görevi tamamlamak için nasıl yapılır kılavuzu olarak düşünülebilir.

giriiş

Runbook'lar yeni bir şey değil, aksine uzun yıllardır var. Runbook, bir uyarı durumunda olay müdahalesi için kullanılabilecek bir görevi tamamlamak için nasıl yapılır kılavuzu olarak düşünülebilir.

Bu nasıl yapılır kılavuzu, metinleri, kontrol listelerini, diyagramları, iş akışlarını ve bir olay sırasında nöbetçi kişinin işini kolaylaştıracak hemen hemen her şeyi içerebilir.

Runbook'lar, sık karşılaşılan olaylara müdahaleyi hızlandırmak için kullanılabilir

Bu , Prometheus hedefleri düştüğünde ne yapılacağına ilişkin bir Runbook örneğidir.

neden önemli

Bir olaya yanıt vermek veya belirli bir eylemi gerçekleştirmek veya adımları başlatmak için gereken adımların bir listesini içeren bir runbook'a sahip olmak, sabahın 2'sinde aranan bir kişi için paha biçilmezdir. Bu adımlar, çağrı yapan kişinin her bir sorunu çözmesine ve hizmetin nasıl çalıştığını anlamasına gerek kalmadan sorunları ayıklamasına, azaltmasına ve çözmesine yardımcı olur.

Bu, aksama süresini azaltacak ve nöbetçi kişiye uyuması için fazladan birkaç saat verecektir :)

Google SRE Workbook'a göre, Runbook'lar "stresi, ortalama onarım süresini (MTTR) ve insan hatası riskini azaltmalıdır."

Bir Runbook'ta neler olmalıdır?

Bir Runbook tek bir göreve odaklanmalı ve bir sorunu çözmek için gereken adımları içermelidir .
Runbook'taki adımlar net olmalıdır, böylece herkes yarı uykulu bir arama yapan kişi için de sorunu hızlı bir şekilde çözebilir.
Her sorun , uyarının adını ve açıklamasını içermelidir .
Sorunun ciddiyetinin ne olduğunu açıklamalıdır .
Diğer hizmetlere olan bağımlılıkları tanımlamalıdır .
İş etkisinin ne olduğunu içermelidir .
Paydaşlarla, müşteriyle ve kuruluşla nasıl iletişim kurulacağına ilişkin bilgileri içermelidir .
İletişim ve arama bilgilerini içermelidir .
SSS bölümü (sıkça sorulan sorular)

Runbook Oluşturma

Kulağa harika geliyor, ama böyle bir şeyi nasıl yaratırsınız? Nereden başlıyorsun?

Önceki bir olayı temel alan bir görev için yönergeler yazarak runbook oluşturmaya başlayabilirsiniz . En yaygın olayların neler olduğunu düşünün. Bu bilgi postmortemlerden elde edilebilir .

Bir uyarı oluşturulduğunda, karşılık gelen bir runbook girişi oluşturulmalıdır.

Başlamak için GitLab Runbooks koleksiyonuna göz atmanızı tavsiye ederim . Bu havuz, başlamak için çok sayıda runbook sağlar ve ekibiniz/kuruluşunuz için çalışan bir runbook'u nasıl oluşturacağınız konusunda ilham almak için iyi bir başlangıçtır.

İlk adım , ekip için uyarılara nasıl yanıt verileceğine ilişkin talimatlar içeren bir çağrı üzerine runbook yazmak olabilir . Örnek olarak, bu On-Call runbook, bir çağrı üzerine vardiya başlatan kişiler için bir şablon sağlar.

Runbook'ları kim yazmalı?

Sahiplik ve sorumluluk ekiplere ait olmalıdır. Runbook'ların güncel ve doğru olmasından sorumludurlar. SRE ekibi, ekipler için bir şablon sağlayabilir , ancak bundan onlar sorumludur ve bunun üzerinde yapılan her değişiklik, ekibin ortak çabasıdır.

Runbook'lar nerede saklanmalı?

Runbook'lar bir GitHub deposunda (otomasyon için iyi) veya bir izdiham sayfasında, wiki sayfasında vb. tutulabilir. Burada önemli olan, bir olay sırasında kolayca bulunabilmeleri ve aranabilmeleridir.

Runbook'ları ne sıklıkla güncellemeliyim?

Runbook'larla ilgili yaygın bir sorun, güncelliğini yitirmeleridir. Runbook sürekli olarak güncellenmeli ve en güncel bilgileri içermelidir. Yeni bir bağımlılık eklenirse, bu bağımlılıkla ilgili bilgiler belgelere eklenmelidir.