Гайды

Что такое ранбук — инструкция для себя в три часа ночи

Иллюстрация: карточка с готовыми шагами рядом с тревожной лампой

В SRE есть правило, которое сначала кажется избыточным: ранбук пишут не после аварии, а в тот момент, когда заводят уведомление. В книге Google это сказано прямо — когда создаётся алерт, обычно тут же создаётся и соответствующая запись в ранбуке.

Звучит как бюрократия. На деле это самый дешёвый фильтр здравого смысла из всех, что я знаю.

Ранбук — это не документация

Документация объясняет, как всё устроено. Ранбук отвечает на один вопрос: что делать прямо сейчас.

Разница как между атласом анатомии и инструкцией по остановке кровотечения. Первое читают в спокойном состоянии. Второе — руками, дрожащими от адреналина, в полтретьего ночи, когда телефон вибрирует, а ты не помнишь даже, как называется твой сервер.

В формулировке Google ранбук содержит «высокоуровневые инструкции, как реагировать на автоматические уведомления»: насколько это серьёзно, на что влияет, что проверить и что сделать, чтобы стало легче.

Момент, когда его пишут

А теперь главное. Там же сформулировано жёстче: все уведомления должны быть немедленно действенными — должно существовать действие, которое человек предпримет сразу после сигнала и которое система не может сделать сама.

Соедини две мысли, и получится проверка:

Если ты не можешь написать ранбук к своему алерту — этот алерт не нужен.

Попробуй прямо сейчас на любом своём уведомлении. «Загрузка процессора выше 80%» — и что человек должен сделать? Если ответ «посмотреть» — это не действие, это тревога без выхода. Такие уведомления через месяц перестают читать все.

А вот «очередь писем не разбирается больше 10 минут» — тут ранбук пишется за минуту: проверь, жив ли воркер, посмотри последнюю ошибку, перезапусти, если висит.

Пять блоков внутри

Ранбук на одну ситуацию помещается на экран. Больше — значит, ситуаций несколько, разнеси их.

  1. Симптом. Как это выглядит снаружи, дословно: «пользователи получают 502», «бот молчит на любую команду». Не «сервис деградировал».
  2. Насколько срочно. Одна строка: будить ночью или подождёт до утра. Без неё каждый сигнал ощущается как катастрофа.
  3. Что проверить, по порядку. Три-пять пунктов от самого частого к редкому. Куда смотреть — конкретный экран, конкретная команда, конкретное место, где живут логи.
  4. Как быстро сделать легче. Обычно это откат, перезапуск или выключение одной функции. Это не починка — это остановка кровотечения.
  5. Чего не делать. Самый недооценённый блок. «Не чисти кэш целиком — потом полчаса прогрев». «Не перезапускай базу, сначала сними дамп».

Правило копипасты

Главная ошибка новичка — писать ранбук словами.

Плохо: «Перезапустите сервис приложения на сервере».

Хорошо: точная команда, которую можно скопировать и вставить, с реальным именем сервиса — вместе с командой, которой ты проверишь, что помогло.

В момент аварии ты не переводишь описание в команду. Ты копируешь. Любой шаг, требующий вспоминания, — это шаг, на котором ты ошибёшься именно сегодня.

Тот же принцип к ссылкам: не «откройте панель хостинга», а прямая ссылка на нужный экран. Три клика в панели в три часа ночи — это три возможности кликнуть не туда.

С чего начать сегодня

Не садись писать ранбуки на всё сразу — умрёшь на третьем и бросишь. Возьми одну поломку, которая уже случалась.

Открой файл RUNBOOK.md рядом с кодом. Опиши по пяти блокам ровно этот случай. Всё.

Дальше правило простое: каждый раз, когда что-то сломалось и ты это чинил, — добавляешь абзац. Через полгода у тебя будет документ, который стоит дороже половины твоего кода, потому что он написан кровью, а не воображением.

И да, если авария была серьёзной, ранбук — не единственное, что после неё пишут. Сам разбор «почему это вообще стало возможно» — это постмортем, у него другая цель: не восстановить сервис, а убрать причину. А порядок действий в момент самой аварии — это инцидент и его роли.

Чем ранбук отличается от чек-листа?

Чек-лист — для плановых действий, которые ты делаешь регулярно: выкатка релиза, ежемесячный бэкап. Ранбук — для внезапных, которые ты делаешь редко и в стрессе. Отсюда и разница в тоне: в чек-листе можно писать кратко, в ранбуке — команды целиком.

Может ли ранбук написать ИИ?

Черновик — да, и это хороший старт: попроси модель дать структуру и типовые проверки для твоего стека. Но конкретные имена сервисов, ссылки на твои панели и раздел «чего не делать» модель не знает — это ровно та часть, ради которой ранбук и существует. Проверь каждую команду вручную, прежде чем на неё полагаться.

А если у меня один маленький проект?

Тогда ранбук тебе нужнее, чем команде. У команды есть коллега, который помнит. У тебя — только ты сам через полгода, который уже всё забыл. Одна страница на самую частую поломку окупается с первого раза.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →