Запланированные работы

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

Что такое запланированные работы?

Запланированные работы — это особый тип инцидента, который позволяет вам:

• Заблаговременно уведомлять пользователей о предстоящих технических работах
• Автоматизировать изменение статусов компонентов в зависимости от стадии выполнения работ
• Отправлять напоминания подписчикам за определенное время до начала работ
• Управлять жизненным циклом работ от планирования до завершения

Зачем это нужно?

Проактивное информирование о плановых работах дает несколько важных преимуществ:

• Снижение нагрузки на поддержку: Пользователи заранее знают о предстоящих работах и не обращаются с вопросами "почему не работает"
• Повышение доверия: Прозрачная коммуникация показывает профессионализм и заботу о пользователях
• Управление ожиданиями: Пользователи могут спланировать свою работу с учетом недоступности сервиса
• Уменьшение негатива: Запланированные работы воспринимаются гораздо спокойнее, чем внезапные сбои
• Сохранение показателей аптайма: Время запланированных работ не учитывается при расчете аптайма компонентов и не влияет на статистику доступности сервиса

---

Создание запланированных работ

Чтобы создать запланированные работы:

1. Выберите вашу Статус Страницу
2. Перейдите в раздел "Запланированные работы"

Основные параметры

При создании запланированных работ необходимо указать:

• Название работ: Краткое описание того, что будет выполняться (например, "Обновление базы данных", "Миграция серверов")
• Описание: Детальная информация о работах, которая будет отображаться на странице
• Дата и время начала: Когда работы начнутся
• Дата и время окончания: Ожидаемое время завершения работ
• Затронутые компоненты: Какие сервисы будут недоступны или работать в ограниченном режиме

---

Уведомления и напоминания

Система уведомлений для запланированных работ позволяет автоматизировать информирование пользователей на разных этапах.

Предварительные уведомления (напоминания)

Вы можете настроить отправку напоминаний подписчикам за определенное время до начала работ. Например:

• За 48 часов — первое уведомление о предстоящих работах
• За 24 часа — напоминание
• За 1 час — последнее предупреждение перед началом

Интервалы указываются в формате: 48h,24h,1h где:

• h — часы
• d — дни
• m — минуты

Уведомление о начале работ

Когда наступает запланированное время начала работ, система может автоматически:

• Отправить уведомление подписчикам о том, что работы начались
• Изменить статус затронутых компонентов
• Создать обновление инцидента с соответствующим статусом

Уведомление о завершении работ

По завершении работ система может автоматически:

• Уведомить подписчиков о том, что работы завершены
• Восстановить статус компонентов в "Работает штатно"
• Закрыть инцидент

---

Автоматизация

Раздел "Автоматизация" позволяет настроить поведение системы на разных этапах выполнения работ.

Управление статусами компонентов

• Автоматически переводить компоненты в статус 'Запланированные работы' при начале работ — когда наступает время начала, компоненты автоматически получат статус "Запланированные работы"

• Автоматически восстанавливать компоненты в статус 'Работает штатно' при завершении работ — когда наступает время окончания, компоненты автоматически вернутся в статус "Работает штатно"

Управление уведомлениями

• Отправлять уведомления при начале работ (автоматически или вручную) — подписчики получат уведомление, когда работы начнутся

• Отправлять уведомления при завершении работ (автоматически или вручную) — подписчики получат уведомление о завершении работ

Управление жизненным циклом

• Автоматически менять статус с 'Запланировано' на 'В процессе' в запланированное время начала — система автоматически обновит статус инцидента

• Автоматически завершать работы в запланированное время окончания — система автоматически закроет инцидент по окончании работ

---

Жизненный цикл запланированных работ

Запланированные работы проходят через несколько стадий:

1. Запланировано

• Начальное состояние при создании
• Время начала работ еще не наступило
• Компоненты находятся в обычном состоянии
• Отправляются напоминания согласно настроенным интервалам

2. В процессе

• Работы начались в запланированное время
• Статус компонентов изменен на "Запланированные работы" (если включена автоматизация)
• Отправлено уведомление о начале работ (если включена автоматизация)

3. Проверка

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

4. Завершено

• Работы завершены в запланированное время или вручную
• Статусы компонентов восстановлены в "Работает штатно" (если включена автоматизация)
• Отправлено уведомление о завершении (если включена автоматизация)

---

Ручное управление

В любой момент вы можете вручную управлять запланированными работами:

• Изменить время начала или окончания — если работы переносятся
• Обновить описание — добавить дополнительную информацию
• Изменить статус — если работы начались раньше или завершились позже запланированного
• Добавить обновления — информировать о ходе выполнения работ

Рекомендации по использованию

1. Планируйте заранее: Создавайте запланированные работы минимум за 24-48 часов до начала
2. Будьте точны: Указывайте реалистичные временные рамки с небольшим запасом
3. Информируйте о прогрессе: Если работы затягиваются, обновляйте информацию
4. Используйте напоминания: Настройте несколько напоминаний, чтобы пользователи не пропустили важную информацию
5. Тестируйте автоматизацию: Убедитесь, что автоматические переходы работают корректно

---

API

Для автоматизированного управления запланированными работами используйте наше API.

Получение запланированных работ

Используйте специальный endpoint для получения запланированных работ:

GET /v1/pages/{page_id}/incidents/maintenance

Вы можете фильтровать работы по статусу:

# Получить запланированные работы (по умолчанию)
GET /v1/pages/{page_id}/incidents/maintenance

# Получить работы в процессе выполнения
GET /v1/pages/{page_id}/incidents/maintenance?status=in_progress

# Получить завершенные работы
GET /v1/pages/{page_id}/incidents/maintenance?status=completed

Создание запланированных работ

Для создания запланированных работ используйте стандартный endpoint создания инцидента с дополнительными полями:

POST /v1/pages/{page_id}/incidents

Пример тела запроса:

{
  "name": "Обновление базы данных",
  "body": "Мы обновим базу данных до последней версии",
  "status": "scheduled",
  "scheduled_for": "2025-06-01T02:00:00Z",
  "scheduled_until": "2025-06-01T04:00:00Z",
  "scheduled_remind_prior": true,
  "reminder_intervals": "24h,1h",
  "auto_transition_to_maintenance_state": true,
  "auto_transition_to_operational_state": true,
  "auto_transition_deliver_notifications_at_start": true,
  "auto_transition_deliver_notifications_at_end": true,
  "scheduled_auto_in_progress": true,
  "scheduled_auto_completed": true,
  "components": {
    "component_id_1": "under_maintenance",
    "component_id_2": "under_maintenance"
  }
}

Важные поля для запланированных работ

Поле	Описание
scheduled_for	Время начала работ (обязательно)
scheduled_until	Время окончания работ (обязательно)
scheduled_remind_prior	Включить напоминания
reminder_intervals	Интервалы напоминаний (например, "24h,1h")
scheduled_auto_in_progress	Автоматически начать работы в scheduled_for
scheduled_auto_completed	Автоматически завершить работы в scheduled_until
auto_transition_to_maintenance_state	Переводить компоненты в статус "Запланированные работы"
auto_transition_to_operational_state	Восстанавливать компоненты в "Работает штатно"
auto_transition_deliver_notifications_at_start	Отправлять уведомления при начале
auto_transition_deliver_notifications_at_end	Отправлять уведомления при завершении

Детальное описание всех полей и методов доступно в документации API.