第三方扩展支持：PagerDuty 集成

MagicTradeBot 原生支持与 PagerDuty 集成 —— 这是一个领先的事件响应与数字运维平台。通过该集成，可以实现对所有 Bot 实例的实时日志转发、警报通知和事件管理。

无论您是运行一个单独的 Bot 实例，还是在多个交易所、账户和服务器上管理数百个 Bot，PagerDuty 都可以帮助您集中观察系统状态，快速响应故障，并确保交易操作的高可用性。

🚀 概览

MagicTradeBot 可将每个 Bot 实例的日志事件与警报实时发送至 PagerDuty。该功能适用于：

  • 监控分布式 Bot 实例和市场行为
  • 在交易失败或策略错误时自动触发事件响应
  • 在多个时区、团队和环境中集中管理警报

当您的 Bot 正在扫描并交易数百个加密货币对时，手动监控将变得不可行。PagerDuty 提供了一个集中、智能的平台来控制、监控和响应规模化系统中的问题。

🔧 主要功能

  • 📡 通过 Webhook 或 REST API 实时发送事件至 PagerDuty
  • 🚨 可配置的警报条件，例如 Bot 错误、交易失败或系统故障
  • 🌍 适用于单实例与多实例 Bot 部署
  • 🧠 智能升级策略与自动事件分发
  • 📊 中央控制面板，用于追踪警报历史与交易健康状况

🛠️ 前提条件

  • 一个有效的 PagerDuty 帐户，并启用了 API 密钥或集成令牌
  • 一个已配置升级策略的 PagerDuty 服务
  • MagicTradeBot 已配置用于外部 Webhook 或 API 通知

⚙️ 配置步骤

1. 创建 PagerDuty 集成

在 PagerDuty 仪表板中，导航至 Services → Add Service，为 MagicTradeBot 监控创建一个新服务。选择 Events API v2 或 自定义 Webhook 作为集成类型。

2. 获取集成密钥

复制 集成密钥（routing key） 或 Webhook URL，并用于 Bot 配置中。

3. 更新 Bot 配置

在您的 MagicTradeBot 配置文件（例如 config.yaml）中添加 PagerDuty 集成： 

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

4. 定义警报条件

Bot 将根据以下规则触发 PagerDuty 警报，例如：

  • 无法执行交易
  • 交易所 API 无法访问
  • 错误率过高或内存占用激增
  • 策略执行失败或参数无效

5. 测试与验证

部署包含测试警报的 Bot，确保事件可在 PagerDuty 控制台中看到。如有需要，可调整警报等级或筛选条件。

🧪 示例 PagerDuty 事件负载

{
  "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 集成的优势

  • 📍 全部 Bot 实例与环境的集中警报管理
  • 🚀 自动升级响应机制加快事件响应与修复
  • 🧩 可通过短信、邮件、Slack 或运维工具轻松通知团队
  • 📉 在波动市场中最大程度减少停机与损失
  • 📈 实时可视化交易健康状况与执行稳定性

📎 Related Topics