Автоматические оповещения клиентов при помощи Opsgenie и Statuspage

Шаг 1. Добавьте интеграцию в Opsgenie

В Opsgenie настройка интеграций происходит через раздел Teams (Команды). Если у вас еще не создана команда, нажмите для этого Add Team (Добавить команду) в правой верхней части экрана Teams (Команды). Введите имя команды и описание. После сохранения вы можете выбрать команду и настроить интеграцию, нажав Integrations (Интеграции) и затем — Add Integration (Добавить интеграцию).

Шаг 2. Подключите интеграцию в Statuspage

В новом окне откройте свой аккаунт Statuspage или зарегистрируйте новый. После этого откроется дашбоард. На дашбоарде перейдите в раздел Subscribers (Подписчики) и нажмите WebHook (Веб-хук) в верхней части страницы.

Шаг 4. Получите ваш ключ и идентификатор API в Statuspage

Откройте окно вашего аккаунта в Statuspage. В поле URL-адреса вы увидите набор букв и цифр после /pages/. Это идентификатор вашей страницы. Скопируйте его и вставьте в поле Page ID (Идентификатор страницы) в Opsgenie.

Он должен выглядеть примерно так: q776213b98cb.

На странице Statuspage нажмите значок профиля в левой нижней части экрана и выберите API Info (Информация об API). Скопируйте набор букв, чисел и дефисов в поле Your API user key (Ваш ключ пользователя API) и вставьте его в поле API key (Ключ API) в Opsgenie.

Идентификаторы страницы также можно найти на странице API, если вы не находите их в URL-адресе.

После ввода ключа и идентификатора в Opsgenie нажмите Save Integration (Сохранить интеграцию).

Шаг 5. Протестируйте вашу интеграцию при помощи оповещения в Opsgenie

Создайте тестовое оповещение в Opsgenie (порядок создания оповещений описан здесь).

В окне создания нового оповещения в разделе Responders (Реагирующие лица) введите имя команды, для которой назначена интеграция в Statuspage. В разделе Tags (Теги) введите ваши теги. Чтобы интеграция со Statuspage работала корректно, начинайте каждый тег с cmp_, после чего пишите имя компонента в Statuspage (например, если необходимый вам компонент называется API, ваш тег должен начинаться с cmp_API). Теги чувствительны к регистру. Регистр в вашем теге должен совпадать с регистром имени компонента. Статусы компонентов приведены в отдельном списке. Полный список см. в документации.

После имени компонента поставьте двоеточие и введите описание состояния компонента. Вносите описания только из утвержденного списка.

Например, тег, указывающий на снижение производительности вашего API, будет выглядеть следующим образом: cmp_API:degraded_performance.

Вот некоторые утвержденные описания состояния.

operational (в работе)
degraded_performance (снижена производительность)
partial_outage (частичный сбой)
major_outage (выход из строя)
under_maintenance (техническое обслуживание)

После создания тега нажмите Show advanced fields (Показать дополнительные поля) и введите описание. Текст, который вы введете в поле Incident title (Название инцидента), будет включен в сообщение об инциденте, а в поле Description (Описание) вы можете указать дополнительную информацию, которую пользователи увидят рядом с названием на вашей странице Statuspage.

Нажмите Create (Создать).

Если новое оповещение не появилось, обновите страницу Statuspage.

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

Поздравляем! Интеграция прошла успешно!

Если вы следовали всем инструкциям выше, на вашей странице Statuspage должно появиться тестовое оповещение, а когда вы закроете его в Opsgenie, статус оповещения на вашей странице Statuspage должен оперативно измениться на Resolved (Решено).

Должны ли вы автоматизировать обновление статусов?

Автоматизация в Opsgenie и Statuspage — это просто. Тем не менее, как и любое техническое решение, она должна быть оправданной. Иногда в обновлении статусов все равно должен принимать участие человек.

Нельзя с уверенностью сказать, кому подойдет автоматизация, а кому нет.

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

В других компаниях отделам коммуникаций и PR, возможно, захочется самостоятельно заниматься оповещением общественности.

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