PagerDuty
Управление инцидентами и графиками дежурств с помощью PagerDuty
PagerDuty — это ведущая платформа управления инцидентами, которая помогает инженерным и операционным командам обнаруживать, классифицировать и устранять проблемы инфраструктуры и приложений в реальном времени. PagerDuty интегрируется с инструментами мониторинга, управляет графиками дежурств и гарантирует, что нужные люди получают оповещения при возникновении инцидентов.
Интеграция PagerDuty в AACFlow подключается к REST API PagerDuty v2 с использованием аутентификации по API-ключу, позволяя вашим агентам программно управлять полным жизненным циклом инцидентов и запрашивать информацию о дежурствах.
С помощью интеграции PagerDuty ваши агенты могут:
- Перечислять и фильтровать инциденты: Получать инциденты, отфильтрованные по статусу (сработавшие, подтвержденные, решенные), сервису, диапазону дат и порядку сортировки для мониторинга операционного состояния
- Создавать инциденты: Инициировать новые инциденты на конкретных сервисах с пользовательскими заголовками, описаниями, уровнями срочности и назначенными лицами непосредственно из ваших рабочих процессов
- Обновлять инциденты: Подтверждать или решать инциденты, изменять срочность и добавлять заметки о решении для синхронизации управления инцидентами с автоматизированными процессами
- Добавлять заметки к инцидентам: Прикреплять контекстную информацию, результаты расследования или автоматизированную диагностику в виде заметок к существующим инцидентам
- Перечислять сервисы: Запрашивать каталог сервисов PagerDuty для обнаружения ID сервисов и метаданных для использования в других операциях
- Проверять графики дежурств: Получать текущие записи о дежурствах, отфильтрованные по политике эскалации или расписанию, чтобы определить ответственных лиц в любое время
В AACFlow интеграция PagerDuty позволяет реализовать мощные сценарии автоматизации инцидентов. Ваши агенты могут автоматически создавать инциденты на основе оповещений мониторинга, обогащать инциденты диагностическими данными из других инструментов, решать инциденты при успешном автоматическом исправлении или создавать рабочие процессы эскалации, которые проверяют графики дежурств и соответствующим образом направляют уведомления. Подключая AACFlow к PagerDuty, вы можете создавать интеллектуальных агентов, которые устраняют разрыв между обнаружением и реагированием, сокращая среднее время устранения и обеспечивая последовательную обработку инцидентов во всей вашей организации.
Интегрируйте PagerDuty в ваш рабочий процесс для перечисления, создания и обновления инцидентов, добавления заметок, перечисления сервисов и проверки графиков дежурств.
Перечисление инцидентов из PagerDuty с опциональными фильтрами.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | REST API-ключ PagerDuty |
statuses | string | Нет | Статусы для фильтрации через запятую (triggered, acknowledged, resolved) |
serviceIds | string | Нет | ID сервисов для фильтрации через запятую |
since | string | Нет | Фильтр начальной даты (формат ISO 8601) |
until | string | Нет | Фильтр конечной даты (формат ISO 8601) |
sortBy | string | Нет | Поле сортировки (например, created_at:desc) |
limit | string | Нет | Максимальное количество результатов (максимум 100) |
| Параметр | Тип | Описание |
|---|
incidents | array | Массив инцидентов |
↳ id | string | ID инцидента |
↳ incidentNumber | number | Номер инцидента |
↳ title | string | Заголовок инцидента |
↳ status | string | Статус инцидента |
↳ urgency | string | Срочность инцидента |
↳ createdAt | string | Временная метка создания |
↳ updatedAt | string | Временная метка последнего обновления |
↳ serviceName | string | Название сервиса |
↳ serviceId | string | ID сервиса |
↳ assigneeName | string | Имя назначенного лица |
↳ assigneeId | string | ID назначенного лица |
↳ escalationPolicyName | string | Название политики эскалации |
↳ htmlUrl | string | Веб-URL PagerDuty |
total | number | Общее количество соответствующих инцидентов |
more | boolean | Доступны ли дополнительные результаты |
Создание нового инцидента в PagerDuty.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | REST API-ключ PagerDuty |
fromEmail | string | Да | Адрес электронной почты действительного пользователя PagerDuty |
title | string | Да | Заголовок/краткое описание инцидента |
serviceId | string | Да | ID сервиса PagerDuty |
urgency | string | Нет | Уровень срочности (high или low) |
body | string | Нет | Подробное описание инцидента |
escalationPolicyId | string | Нет | ID политики эскалации для назначения |
assigneeId | string | Нет | ID пользователя для назначения инцидента |
| Параметр | Тип | Описание |
|---|
id | string | ID созданного инцидента |
incidentNumber | number | Номер инцидента |
title | string | Заголовок инцидента |
status | string | Статус инцидента |
urgency | string | Срочность инцидента |
createdAt | string | Временная метка создания |
serviceName | string | Название сервиса |
serviceId | string | ID сервиса |
htmlUrl | string | Веб-URL PagerDuty |
Обновление инцидента в PagerDuty (подтверждение, решение, изменение срочности и т.д.).
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | REST API-ключ PagerDuty |
fromEmail | string | Да | Адрес электронной почты действительного пользователя PagerDuty |
incidentId | string | Да | ID инцидента для обновления |
status | string | Нет | Новый статус (acknowledged или resolved) |
title | string | Нет | Новый заголовок инцидента |
urgency | string | Нет | Новая срочность (high или low) |
escalationLevel | string | Нет | Уровень эскалации для повышения |
| Параметр | Тип | Описание |
|---|
id | string | ID инцидента |
incidentNumber | number | Номер инцидента |
title | string | Заголовок инцидента |
status | string | Обновленный статус |
urgency | string | Обновленная срочность |
updatedAt | string | Временная метка последнего обновления |
htmlUrl | string | Веб-URL PagerDuty |
Добавление заметки к существующему инциденту PagerDuty.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | REST API-ключ PagerDuty |
fromEmail | string | Да | Адрес электронной почты действительного пользователя PagerDuty |
incidentId | string | Да | ID инцидента для добавления заметки |
content | string | Да | Текст содержимого заметки |
| Параметр | Тип | Описание |
|---|
id | string | ID заметки |
content | string | Содержимое заметки |
createdAt | string | Временная метка создания |
userName | string | Имя пользователя, создавшего заметку |
Перечисление сервисов из PagerDuty с опциональным фильтром по имени.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | REST API-ключ PagerDuty |
query | string | Нет | Фильтр сервисов по имени |
limit | string | Нет | Максимальное количество результатов (максимум 100) |
| Параметр | Тип | Описание |
|---|
services | array | Массив сервисов |
↳ id | string | ID сервиса |
↳ name | string | Название сервиса |
↳ description | string | Описание сервиса |
↳ status | string | Статус сервиса |
↳ escalationPolicyName | string | Название политики эскалации |
↳ escalationPolicyId | string | ID политики эскалации |
↳ createdAt | string | Временная метка создания |
↳ htmlUrl | string | Веб-URL PagerDuty |
total | number | Общее количество соответствующих сервисов |
more | boolean | Доступны ли дополнительные результаты |
Перечисление текущих записей о дежурствах из PagerDuty.
| Параметр | Тип | Обязательный | Описание |
|---|
apiKey | string | Да | REST API-ключ PagerDuty |
escalationPolicyIds | string | Нет | ID политик эскалации для фильтрации через запятую |
scheduleIds | string | Нет | ID расписаний для фильтрации через запятую |
since | string | Нет | Фильтр начального времени (формат ISO 8601) |
until | string | Нет | Фильтр конечного времени (формат ISO 8601) |
limit | string | Нет | Максимальное количество результатов (максимум 100) |
| Параметр | Тип | Описание |
|---|
oncalls | array | Массив записей о дежурствах |
↳ userName | string | Имя дежурного пользователя |
↳ userId | string | ID дежурного пользователя |
↳ escalationLevel | number | Уровень эскалации |
↳ escalationPolicyName | string | Название политики эскалации |
↳ escalationPolicyId | string | ID политики эскалации |
↳ scheduleName | string | Название расписания |
↳ scheduleId | string | ID расписания |
↳ start | string | Время начала дежурства |
↳ end | string | Время окончания дежурства |
total | number | Общее количество соответствующих записей о дежурствах |
more | boolean | Доступны ли дополнительные результаты |
