Runbook: покрокові посібники для експлуатації

Коротко: Короткі перевірені посібники, що описують, як розпізнати й усунути відому проблему або виконати рутинне завдання.

Докладніше: Runbook відповідає на запитання «Що мені робити зараз?» о третій ночі. Замість того щоб покладатися на пам’ять однієї людини, порядок дій записаний і готовий. Хороші runbook скорочують час розв’язання й роблять чергування справедливішими, бо допомогти можуть і нові члени команди.

Подробиці

Структура хорошого runbook

• Тригер: до якого сповіщення чи симптому він належить?
• Вплив: кого це зачіпає, наскільки терміново?
• Діагностика: які команди чи дашборди показують причину?
• Дії: нумеровані, копійовані кроки, в ідеалі з очікуваним результатом.
• Відкат: як скасувати крок?
• Ескалація: до кого звернутися, якщо не допомагає?
• Статус: дата останньої перевірки.

Приклад (уривок)

Симптом: сповіщення «диск заповнено» на web-01
1. Показати використання:    df -h
2. Найбільші теки:           du -sh /var/* | sort -h
3. Видалити старі журнали:   sudo journalctl --vacuum-time=7d
4. Перевірити результат:     df -h   (очікується менше 80 %)
Ескалація: черговий з інфраструктури, якщо не нижче 90 %

Супровід

Застарілий runbook небезпечний. Після кожного інциденту перевіряйте, чи був він правильним, і коригуйте його. Прив’язуйте його просто у сповіщенні. Ще краще автоматизувати кроки, що повторюються (скрипти, «runbook automation»), щоб людина лише підтверджувала.

Розмежування

Playbook зазвичай описує процедуру вищого рівня (наприклад, підхід до інциденту безпеки), runbook — конкретні технічні кроки. На практиці межа розмита.

Див. також: Керування інцидентами та постмортеми, Журналювання (logging), SLA та система тікетів