Что это
PagerDuty API - интерфейсы интеграции системы реагирования на сбои. REST API работает с инцидентами, пользователями и настройками. Events API принимает сигналы от мониторинга. Эти задачи используют разные учетные данные; один ключ нельзя считать универсальным.
Для AI-помощника полезно начать с чтения уже существующего учебного инцидента. Программа получает его данные, а отдельная модель или шаблон составляет сводку. API сам не определяет причину сбоя и не проверяет правильность объяснения.
Не начинайте тест с отправки trigger в рабочий сервис: такой сигнал может вызвать дежурного. Автоматическое закрытие инцидента тоже требует отдельного правила и разрешения. Безопасный первый результат - проверенный черновик для инженера, не изменение состояния системы.
Ключевые параметры
- Категория: Оценка, мониторинг и evals
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- REST API позволяет получать данные инцидентов без ручного копирования из интерфейса.
- Read-only ключ запрещает операции записи при первом знакомстве.
- Scoped OAuth позволяет ограничивать доступ приложения точнее широкого ключа аккаунта.
- Events API и webhooks помогают отделить прием сигналов от реакции внешнего приложения.
Ограничения
- Read-only account key может читать данные всего аккаунта, а не только одного выбранного сервиса.
- REST и Events имеют разные назначения, ключи и ограничения частоты запросов.
- Большие списки требуют правильной пагинации; первая страница не является полным отчетом.
- API не включает автоматически AI-анализ, а рабочие операции могут изменить инцидент или отправить реальные уведомления.
Как использовать
1. Подготовка. Выберите уже существующий учебный инцидент и скопируйте его ID. Согласуйте доступ, не создавайте тестовое оповещение на рабочей эскалации.
2. Настройка. Попросите администратора создать read-only REST key и сохраните его вне кода. Учтите широкий доступ account key; для рабочего приложения рассмотрите scoped OAuth.
3. Первый результат. Выполните GET https://api.pagerduty.com/incidents/{id}, подставив ID, с Authorization: Token token=ВАШ_КЛЮЧ и Accept: application/vnd.pagerduty+json;version=2. Из ответа подготовьте черновик с названием, статусом и сервисом, без предположений о причине.
4. Проверка. Сверьте инцидент в интерфейсе PagerDuty. Проверьте отсутствие секретов в журнале клиента и обработку 401/403. Для списка используйте пагинацию конкретного метода; при 429 учитывайте заголовки лимитов. PUT и Events trigger не нужны для этого результата.
Доступ и оплата
- Модель оплаты: Бесплатный тариф + платные возможности
- Бесплатный тариф: Да
- Пробный доступ: Да
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
Текущая страница цен включает API в Free Incident Management; у бесплатного плана есть ограничения команды и расписаний. Это не безлимитные AIOps или AI-функции. Российская оплата и региональный доступ здесь не подтверждены.
Когда не подходит
- Тестировать оповещение на рабочем дежурстве
- Автоматически закрывать сбой по выводу модели
- Использовать REST-токен как Events integration key
Альтернативы
Jira Service Management API подходит для заявок и процессов своей системы. Grafana HTTP API управляет ресурсами Grafana; Prometheus API читает данные мониторинга. Они дополняют процесс реагирования, но не заменяют все функции PagerDuty.