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 и система тикетов