Поддержка сторонних расширений: интеграция с PagerDuty

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

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


🚀 Обзор

MagicTradeBot может передавать события логов и оповещения с каждого экземпляра бота напрямую в PagerDuty в режиме реального времени. Это полезно для:

  • Мониторинга распределённых экземпляров бота и рыночной активности
  • Автоматического реагирования на ошибки в торговле или стратегиях
  • Управления оповещениями в разных часовых поясах, командах и окружениях

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


🔧 Ключевые возможности

  • 📡 Передача событий в реальном времени через Webhooks или REST API
  • 🚨 Настраиваемые условия оповещений: ошибки, сбои торговли, недоступность API
  • 🌍 Масштабируемость от одного до множества экземпляров бота
  • 🧠 Интеллектуальные правила эскалации и маршрутизации инцидентов
  • 📊 Центральная панель для анализа истории оповещений и состояния торговли

🛠️ Необходимые условия

  • Аккаунт PagerDuty с действующим API-ключом или токеном интеграции
  • Сервис PagerDuty с определёнными правилами эскалации
  • MagicTradeBot, настроенный на отправку уведомлений через Webhook или API

⚙️ Этапы настройки

1. Создание интеграции в PagerDuty

В панели управления PagerDuty перейдите в Services → Add Service и создайте новый сервис для мониторинга MagicTradeBot. Выберите тип интеграции Events API v2 или Custom Webhook.

2. Получите ключ интеграции

Скопируйте routing key или URL Webhook для использования в конфигурации бота.

3. Обновите конфигурацию бота

Добавьте интеграцию PagerDuty в файл конфигурации MagicTradeBot (например, config.yaml):

incident_reporting:
  pagerduty:
    enabled: true
    integration_key: "YOUR_PAGERDUTY_ROUTING_KEY"
    service_name: "magictradebot"
    severity_threshold: "error"
    environment: "production"

4. Установите условия оповещений

Бот будет отправлять оповещения в PagerDuty на основе следующих ситуаций:

  • Не удалось выполнить торговую операцию
  • Недоступен API биржи
  • Высокий уровень ошибок или всплеск использования памяти
  • Сбой стратегии или неверные параметры

5. Тестирование и проверка

Запустите бота с включёнными тестовыми оповещениями и убедитесь, что события появляются в панели PagerDuty. При необходимости настройте уровни серьёзности и фильтры.


🧪 Пример события PagerDuty (payload)

{
  "routing_key": "YOUR_PAGERDUTY_ROUTING_KEY",
  "event_action": "trigger",
  "payload": {
    "summary": "MagicTradeBot не смог выполнить сделку BTC/USDT",
    "severity": "error",
    "source": "bot-eu-1",
    "component": "trade-engine",
    "custom_details": {
      "symbol": "BTC/USDT",
      "exchange": "binance",
      "reason": "Недостаточно средств на маржинальном счёте"
    }
  }
}

✅ Преимущества интеграции с PagerDuty

  • 📍 Централизованное оповещение по всем экземплярам и окружениям
  • 🚀 Быстрое реагирование на инциденты благодаря автоматической эскалации
  • 🧩 Простая интеграция с командами через SMS, email, Slack и другие инструменты
  • 📉 Минимизация простоев и потерь в условиях волатильного рынка
  • 📈 Полная видимость состояния торговли и стабильности исполнения сделок

📎 Related Topics