第三方扩展支持：LogDNA 集成

MagicTradeBot 原生支持与 LogDNA 集成 —— 这是一款云原生日志管理平台，可实现实时日志流和集中式监控。通过此集成，每个 机器人实例 生成的所有事件和日志都可以即时推送至 LogDNA。

无论您是运行 单个机器人实例，还是在多个交易所、账户、交易对或分布式服务器上管理 数百个实例，LogDNA 都能帮助您 集中可观测性和诊断能力。在如此规模下，人工跟踪已不现实 —— LogDNA 通过直观的仪表板和高性能索引功能解决这一问题。

🚀 概览

MagicTradeBot 可通过 LogDNA 的日志收集 API 或日志代理发送所有日志和交易事件。通过该配置，您可以：

  • 按交易对、交易所或实例搜索、筛选和可视化日志
  • 关联错误、交易执行失败和 API 问题
  • 集中监控所有账户和交易所上的机器人活动

🔧 核心功能

  • 📡 通过 HTTPS 或 LogDNA 代理实时传输日志
  • 🌍 支持多实例和多服务器部署
  • 🧠 日志可通过自定义标签和元数据进行搜索
  • 📊 集中式仪表板可视化交易活动、错误和事件
  • 🚨 与 Slack、PagerDuty、Webhooks 等集成以实现警报通知

🛠️ 前提条件

  • 一个有效的 LogDNA 账户
  • 您的日志接入 LogDNA Ingest Key（API 密钥）
  • 可选：在机器人主机环境中安装 LogDNA 代理

⚙️ 配置步骤

1. 获取 LogDNA Ingest Key

登录您的 LogDNA 账户，前往 设置 → API 密钥 以创建或复制接入密钥。

2. 更新机器人配置

在配置文件（如 config.yaml）中启用 LogDNA 日志功能：

logging:
  logdna:
    enabled: true
    ingest_key: "YOUR_LOGDNA_API_KEY"
    app_name: "magictradebot"
    environment: "production"
    hostname: "bot-eu-1"
    tags:
      - exchange:binance
      - region:eu

3. （可选）安装 LogDNA 代理

如有需要，可在服务器（Linux / Windows / macOS）上安装 LogDNA 代理：

curl -sSL https://assets.logdna.com/logdna-agent.sh | sudo bash -s -- -k YOUR_LOGDNA_API_KEY

或手动配置 /etc/logdna.conf 并启动代理。

4. 部署并验证

运行机器人并验证日志是否实时显示在 LogDNA 仪表板中，是否正确显示标签、主机名和实例 ID。

🧪 LogDNA JSON 日志示例

{
  "timestamp": "2025-06-20T12:12:11Z",
  "level": "info",
  "message": "Executed short trade",
  "exchange": "binance",
  "symbol": "DOGE/USDT",
  "strategy": "ScalpShort",
  "profit": 1.05,
  "bot_instance": "bot-apac-02"
}

✅ LogDNA 集成优势

  • 📍 跨多个交易所的所有机器人实例的统一日志访问
  • 🧩 全面了解策略表现和运行时行为
  • 📈 借助高级筛选快速调试和错误追踪
  • 🚨 可与警报工具集成，实现实时事件响应
  • 💾 可搜索的持久日志历史，便于合规与审计

📎 Related Topics