Runbook’lar: işletim için adım adım kılavuzlar

Kısaca: Bilinen bir sorunun nasıl tanınıp giderileceğini veya bir rutin görevin nasıl yürütüleceğini anlatan kısa, sınanmış kılavuzlar.

Biraz daha ayrıntılı: Bir runbook, sabahın üçünde “Şimdi ne yapmalıyım?” sorusunu yanıtlar. Bir kişinin hafızasına güvenmek yerine yöntem yazılıdır ve hazırdır. İyi runbook’lar çözüm süresini kısaltır ve nöbet görevini daha adil kılar, çünkü yeni ekip üyeleri de yardım edebilir.

Ayrıntılı

İyi bir runbook’un yapısı

• Tetikleyici: hangi uyarıya veya belirtiye aittir?
• Etki: kimler etkilenir, ne kadar acil?
• Tanı: hangi komutlar veya panolar nedeni gösterir?
• Eylemler: numaralı, kopyalanabilir adımlar; ideal olarak beklenen sonuçla.
• Geri alma: bir adım nasıl geri alınır?
• Yükseltme (escalation): işe yaramazsa kime başvurulur?
• Durum: son incelemenin tarihi.

Örnek (alıntı)

Belirti: web-01'de "disk dolu" uyarısı
1. Kullanımı göster:        df -h
2. En büyük klasörler:      du -sh /var/* | sort -h
3. Eski günlükleri sil:     sudo journalctl --vacuum-time=7d
4. Sonucu denetle:          df -h   (%80'in altı beklenir)
Yükseltme: %90'ın altına inmezse altyapı nöbetçisi

Bakım

Eskimiş bir runbook tehlikelidir. Her olaydan sonra doğru olup olmadığını denetleyin ve uyarlayın. Doğrudan uyarıya bağlayın. Daha da iyisi, yinelenen adımları otomatikleştirmektir (betikler, “runbook otomasyonu”); böylece insan yalnızca onaylar.

Ayrım

Bir playbook genellikle daha üst düzey bir yöntemi (örneğin bir güvenlik olayına yaklaşımı), bir runbook ise somut teknik adımları tarif eder. Pratikte sınır bulanıktır.

Ayrıca bak: Olay yönetimi ve postmortem’ler, Günlük kaydı (logging), SLA ve bilet sistemi