Перейти к содержимому

Штаб управления инцидентом

Координационная панель для участников реагирования на инцидент: координатора, дежурных инженеров, руководителя разработки и тех, кто общается с клиентами. Она показывает все активные инциденты, их серьёзность, текущий статус, ответственного за решения и затронутые сервисы, пока инцидент идёт.

Без штаба состояние инцидента разбросано по пейджингу, чату и общему документу, и каждый новый участник тратит десять минут, чтобы понять, что происходит. Координатор не назначен явно, поэтому решения зависают. Зависимости затронутого сервиса не видны, и часть последствий обнаруживают позже. Эскалации идут в личных сообщениях, нужные люди подключаются с опозданием на полчаса, а хронологию для разбора собирают неделю.

  • Показывает активные инциденты на одном экране. Серьёзность, статус, координатор, затронутые сервисы и время с начала видны в общей таблице и обновляются без перезагрузки.
  • Требует назначить координатора. Инцидент не переходит дальше статуса «Обнаружен», пока не назначен человек, принимающий решения.
  • Показывает радиус поражения. При отметке затронутого сервиса подтягиваются его зависимые сервисы из каталога, чтобы не пропустить последствия.
  • Эскалирует по правилам. Если у инцидента высокой серьёзности долго нет координатора или обновлений, панель уведомляет следующий уровень.
  • Ведёт хронологию. Смены статуса, назначения, заметки и эскалации записываются в журнал, из которого строится разбор после инцидента.
  • Это не замена пейджингу. PagerDuty, Opsgenie или Grafana OnCall будят людей, ведут расписания и доставляют алерты. Штаб на Filament принимает от них инциденты и становится слоем координации. Если команда небольшая и инциденты редки, достаточно встроенных функций пейджинга или incident.io; своя панель нужна, когда процесс, роли и связь с внутренними данными сложнее, чем умеет готовый продукт.
  • Серьёзность с критериями. Уровни определяются по влиянию на пользователей, масштабу и деньгам, а критерии видны в форме. Без критериев всё становится «P1», и эскалации теряют смысл.
  • Молчание — сигнал. Активный инцидент без обновлений дольше заданного времени, например 15 минут, подсвечивается, а координатору приходит напоминание.
  • Журнал только на добавление. Записи хронологии нельзя править или удалять задним числом: исправление — новая запись. Это делает разбор честным.
  • Низкая серьёзность — в очередь. Инциденты P3 и ниже не будят людей ночью, а ждут рабочего времени в очереди. Правила эскалации настраиваются по уровню серьёзности.
  • Автоматика ограничена. Штаб фиксирует и уведомляет, но не запускает откаты и изменения инфраструктуры. Такие действия выполняются в своих инструментах с отдельной авторизацией.
  • Связь с каталогом сервисов. Радиус поражения точен настолько, насколько актуальна карта зависимостей. Без неё поле «Затронутые сервисы» остаётся ручным списком.

Промпты рассчитаны на AI-агента (Claude Code, Cursor и аналоги) в Laravel-проекте с установленным Filament 4.x. Отправляйте их по одному: каждый шаг даёт результат, который можно проверить.

Создай модели и миграции для штаба инцидентов: Incident (заголовок,
серьёзность P1–P4, статус: обнаружен, расследуется, устраняется,
наблюдение, решён; координатор, время начала, время решения, внешний id
из пейджинга), связь «многие ко многим» с Service, IncidentEvent
(инцидент, тип: смена статуса, назначение, заметка, эскалация; текст,
автор, время). IncidentEvent только добавляется, правка и удаление
запрещены. Добавь фабрики.
Сгенерируй Filament-ресурс для Incident. В таблице покажи серьёзность,
статус, координатора, затронутые сервисы и время с последнего обновления;
по умолчанию только незакрытые, сортировка по серьёзности; обновление
таблицы каждые 15 секунд. В карточке выведи хронологию IncidentEvent
и форму быстрой заметки.
Запрети переход инцидента дальше «Обнаружен» без координатора. Каждую смену
статуса и координатора пиши в IncidentEvent. В карточке инцидента покажи
сервисы, зависящие от затронутых, на основе таблицы зависимостей сервисов.

Проверьте, что сменить статус без координатора нельзя ни из таблицы, ни из карточки.

Добавь вебхук от системы пейджинга с проверкой подписи, который создаёт
или обновляет инцидент по внешнему id без дублей. Сделай задачу, которая
раз в минуту проверяет правила эскалации из конфига: P1 без координатора
дольше 5 минут — уведомить руководителя разработки; активный инцидент
без обновлений дольше 15 минут — напомнить координатору.

Отправьте один и тот же вебхук дважды и убедитесь, что инцидент один, а в хронологии нет повторной записи.

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