第三方扩展支持：Datadog 集成

Datadog

MagicTradeBot 原生支持与 Datadog 集成，这是一款强大的可观测性平台，可实现实时集中式日志管理和事件监控。无论您是运行单个 bot 实例，还是在多个交易所、账户和服务器中部署多个 bot，Datadog 都能帮助您全面掌控您的交易基础设施。

🚀 概览

MagicTradeBot 核心引擎支持将结构化日志和交易事件实时发送到 Datadog。该集成特别适合：

  • 监控所有实例上的 bot 行为和交易执行情况
  • 集中调试和问题追踪
  • 跟踪性能、错误率和触发条件
  • 通过仪表盘和告警可视化交易活动

🔧 核心功能

  • 📡 从所有活动 bot 实例中实时流式日志
  • 🧠 附带元数据（如交易对、策略、结果等）的结构化事件上报
  • 🖥️ 多实例聚合，支持来自多个交易所和账户的数据
  • ☁️ 支持分布式部署（无论是云原生还是自托管）
  • 📊 在 Datadog 平台中集中查看仪表盘和告警

🛠️ 先决条件

在启用 Datadog 支持前，请确保：

  • 您拥有一个启用了 API 访问权限的有效 Datadog 账户
  • 您已经获取了Datadog API 密钥
  • 您的运行环境中已安装 @datadog/datadog-api-client（或等效的 HTTP 客户端，用于自定义扩展）

⚙️ 配置步骤

1. 在配置文件中启用 Datadog 集成

在您的 MagicTradeBot 配置文件中（例如 config.yaml 或 appsettings.json），启用以下设置：

logging:
  datadog:
    enabled: true
    api_key: "YOUR_DATADOG_API_KEY"
    log_level: "info"
    service_name: "magictradebot"
    environment: "production"
    tags:
      - bot-instance:<instance_id>
      - exchange:<exchange_name>

2. 设置日志级别

根据需要选择合适的日志详细级别：

  • debug：详细日志（仅用于开发）
  • info：交易事件、策略行为、常规操作
  • warn：非致命但异常的行为
  • error：失败、被拒的订单、无效触发器

3. 配置 bot 实例

确保每个 bot 实例有唯一的 instance_id 和相应标签，便于 Datadog 区分。

4. 部署并开始监控

配置完成后启动您的 bot。日志将在几秒钟内出现在 Datadog 的日志浏览器中。您可以：

  • 按交易对、策略或实例过滤日志
  • 使用交易指标创建仪表盘
  • 设置错误、利润阈值或 API 故障告警

🧪 日志输出示例（JSON 格式）

{
  "timestamp": "2025-06-20T09:15:32Z",
  "level": "info",
  "message": "交易已执行",
  "exchange": "binance",
  "symbol": "BTC/USDT",
  "strategy": "ScalpLong",
  "amount": 0.002,
  "price": 65250,
  "profit": 3.45,
  "instance_id": "bot-eu-1"
}

✅ Datadog 集成的优势