Gotcha

Окна обслуживания

Окно обслуживания — заранее объявленный интервал плановых работ проекта. Пока оно активно, инциденты, открывшиеся у мониторов этого проекта, помечаются как «в обслуживании» и не отправляют уведомления через оповещения — так плановая перезагрузка или деплой не заваливает канал ложными тревогами. Сам инцидент при этом всё равно фиксируется (виден в истории), просто без рассылки.

Страница — /projects/{id}/maintenance, доступна участнику команды, привязанной к проекту (оператору — см. Роли и права), а также owner и admin организации.

Создание окна

  1. На странице «Обслуживание» нажмите «Новое окно» — откроется модальная форма.
  2. Укажите Название — короткое описание работ (например, «Обновление БД»).
  3. Выберите тип — Разовое или Еженедельное (пара радиокнопок, по умолчанию выбрано разовое):
    • Разовое — разовое окно: задайте Начало и Конец (дата и время, поля datetime-local);
    • Еженедельное — еженедельно повторяющееся окно: задайте День недели (день недели) и время Начало/Конец в формате ЧЧ:ММ, которое будет повторяться каждую неделю в этот день.
  4. Укажите Часовой пояс — выберите из списка (UTC, Europe/Moscow, Europe/Berlin, Asia/Yekaterinburg) или, если нужного часового пояса нет в списке, выберите «Другой» и впишите IANA-имя вручную в соседнее поле (например, Asia/Novosibirsk).
  5. Сохраните — «Создать окно».

Созданные окна видны списком (имя, тип, расписание) с кнопками «Изменить» и «Удалить» у каждой строки.

Изменение окна

«Изменить» открывает ту же форму, уже заполненную значениями окна: название, тип, расписание и часовой пояс. Меняется всё, включая тип — разовое окно можно перевести в еженедельное и обратно; поля прежнего расписания при этом очищаются. Разовое окно показывается в его собственном часовом поясе, а не в UTC, поэтому сдвинуть его на час — правка одного поля.

Как это влияет на мониторы и оповещения

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

На странице монитора и в списке инцидентов такие инциденты помечены отдельной колонкой «Обслуживание» (да/нет), поэтому вы всегда можете отличить реальную тревогу от ожидаемого простоя во время работ.

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

Частые вопросы

Останавливаются ли проверки во время окна обслуживания?

Нет. Мониторинг работает в обычном режиме: проверки выполняются, инциденты открываются и попадают в историю. Окно влияет только на уведомления — инциденты, открывшиеся внутри окна, получают флаг «в обслуживании» и не рассылаются по каналам оповещений.

Портят ли плановые работы статистику аптайма?

Нет. Интервалы окон обслуживания вычитаются из расчёта процента доступности — и на странице монитора, и на публичной статус-странице. Простой во время объявленного окна не уменьшает аптайм.

Что будет с инцидентом, который начался до окна?

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

Можно ли задать окно для одного монитора, а не для всего проекта?

Нет, окно действует на весь проект. Если работы затрагивают один сервис, а остальные мониторы проекта должны продолжать тревожить, — поставьте этот монитор на паузу на время работ или вынесите сервис в отдельный проект со своими окнами.

Узнают ли пользователи о плановых работах заранее?

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

Как окно переживает перевод часов?

Расписание хранится вместе с часовым поясом окна (IANA-имя, например Europe/Moscow), и попадание в интервал вычисляется в этом поясе. Еженедельное окно «каждую субботу в 03:00» продолжит срабатывать в местные 03:00 и после перевода часов в этом поясе.

Что дальше