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

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

🚀 Обзор

Ядро MagicTradeBot поддерживает отправку структурированных логов и событий торговли непосредственно в Datadog в режиме реального времени. Эта интеграция идеально подходит для:

Мониторинга поведения бота и исполнения сделок на всех инстансах
Централизованного отладки и отслеживания проблем
Отслеживания производительности, уровня ошибок и условий срабатывания стратегий
Визуализации торговой активности через панели и оповещения

🔧 Основные возможности

📡 Потоковая передача логов в реальном времени со всех активных экземпляров бота
🧠 Структурированная отправка событий с метаданными (символ, стратегия, результат и др.)
🖥️ Агрегация логов с нескольких бирж и аккаунтов
☁️ Поддержка распределённого развёртывания (облачного или на собственных серверах)
📊 Централизованные панели мониторинга и оповещения в Datadog

🛠️ Предварительные требования

Перед активацией интеграции с Datadog убедитесь в следующем:

У вас есть действующий аккаунт в Datadog с включённым доступом к API
У вас есть API-ключ Datadog
В вашей среде доступен @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. Настройте экземпляры бота

Убедитесь, что каждый экземпляр бота имеет уникальный instance_id и соответствующие теги для их различения в Datadog.

4. Разверните и начните мониторинг

После настройки запустите ваш(и) бот(ы). Потоки логов появятся в Datadog Log Explorer через несколько секунд. Вы можете:

Фильтровать логи по символу, стратегии или экземпляру
Создавать панели мониторинга на основе торговых метрик
Настраивать оповещения об ошибках, порогах прибыли или сбоях 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

📍 Централизованное управление: Просмотр логов со всех сред и инстансов в одном месте
📈 Мониторинг производительности: Анализ эффективности торговли, ошибок и времени безотказной работы
🚨 Проактивные оповещения: Получение уведомлений до того, как ошибки повлияют на торговлю
🧩 Упрощённая отладка: Быстрое выявление проблем в распределённых системах