Перейти к содержанию

srekit oncall-report

Сгенерировать недельный отчёт дежурства для команды — pages-таблица, breakdown по toil, гигиена алертов. Период по умолчанию — текущая неделя (Пн–Вс).

Синопсис

srekit oncall-report --team NAME [flags]

Флаги

Флаг Обязательный Описание
--team да Имя команды
--start нет Начало периода (YYYY-MM-DD). Default: понедельник этой недели.
--end нет Конец периода. Default: воскресенье этой недели.
--author нет Имя дежурного (default: цепочка yaml/git config)
--email нет Email дежурного

Плюс общие output-флаги. Default имя файла: oncall-<slug-of-team>-<start>.md.

Примеры

Текущая неделя:

srekit oncall-report --team platform --out oncall.md

Конкретное окно:

srekit oncall-report --team platform \
  --start 2026-05-04 --end 2026-05-10 \
  --out oncall-platform-2026-W19.md

Границы недели

Период по умолчанию начинается с понедельника и кончается воскресеньем. Часы под капотом — internal/clock.Now (подменяемы в тестах; в продакшене бинарник использует time.Now()).

Если запустил отчёт в воскресенье 2026-05-10 — получишь 2026-05-04 → 2026-05-10. Регрессионный тест пинит это поведение.

Структура секций

  • Front matter: id, creation_date, type: oncall-report, team, period_start, period_end, oncaller, tags
  • TL;DR — два-три предложения: смена прошла спокойно, напряжённо или в огне
  • Пейджеры (Pages) — таблица пейджеров с колонками алерт / сервис / действие, плюс счётчик «требующих действий против ложных»
  • Инциденты (Incidents) — ссылки на инцидент-доки и постмортемы
  • Тоил (Toil) — повторяющаяся ручная работа, которую стоит автоматизировать
  • Гигиена алертов (Alert hygiene) — шумные / тихие алерты для тюнинга
  • Передать следующему дежурному (Follow-ups for next on-caller)
  • Победы (Wins)
  • Ссылки (References)

Структура данных для шаблона

oncall-report шипится как v1 YAML-артефакт (internal/tmpl/templates/oncall.yaml) — frontmatter, H1, meta_bullets, секции (tl_dr, pages, incidents, toil, alert_hygiene, follow_ups_for_next_on_caller, wins, references). Template-выражения обращаются к .Meta.<Field> для ID, Team, Start, End, Now, Author.Name, Author.Email. См. srekit postmortem для полной схемы.

См. также

  • srekit ebp — политика бюджета ошибок, влияющая на нагрузку дежурного.