Prise en charge des extensions tierces : Intégration avec Datadog

MagicTradeBot offre une prise en charge native de l'intégration avec Datadog, une plateforme d'observabilité puissante, afin de permettre une gestion centralisée des journaux en temps réel et une surveillance des événements. Que vous exécutiez une instance unique du bot ou que vous déployiez plusieurs bots sur différentes plateformes, comptes et serveurs, Datadog vous permet d’avoir une visibilité complète sur votre infrastructure de trading.

🚀 Vue d'ensemble

Le moteur principal de MagicTradeBot prend en charge l'envoi en temps réel de journaux structurés et d'événements de trading directement vers Datadog. Cette intégration est idéale pour :

Surveiller le comportement du bot et l'exécution des trades sur toutes les instances
Déboguer et suivre les problèmes de manière centralisée
Suivre les performances, les taux d'erreur et les conditions de déclenchement
Visualiser les activités de trading via des tableaux de bord et des alertes

🔧 Fonctionnalités clés

📡 Flux de journaux en temps réel depuis toutes les instances actives du bot
🧠 Rapports d'événements structurés avec métadonnées (symbole, stratégie, résultat, etc.)
🖥️ Agrégation multi-instances depuis plusieurs exchanges et comptes
☁️ Prise en charge des déploiements distribués (cloud-native ou auto-hébergé)
📊 Tableaux de bord et alertes centralisés dans la plateforme Datadog

🛠️ Prérequis

Avant d’activer la prise en charge de Datadog, assurez-vous que :

Vous disposez d’un compte Datadog valide avec l'accès API activé
Vous avez une clé API Datadog
Le module @datadog/datadog-api-client (ou un client HTTP équivalent) est disponible dans votre environnement (pour les extensions personnalisées)

⚙️ Étapes de configuration

1. Activer l'intégration Datadog dans la configuration

Dans votre fichier de configuration MagicTradeBot (ex. config.yaml ou appsettings.json), activez et définissez les paramètres suivants :

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. Définir le niveau de journalisation

Choisissez le niveau de détail souhaité pour les journaux :

debug : détails très précis (uniquement en développement)
info : événements de trading, actions des stratégies, opérations normales
warn : événements inattendus mais non critiques
error : échecs, ordres rejetés, déclencheurs invalides

3. Configurer les instances du bot

Assurez-vous que chaque instance du bot dispose d’un instance_id unique et de balises pertinentes pour permettre à Datadog de les distinguer.

4. Déployer et surveiller

Une fois configuré, lancez votre ou vos bots. Les journaux commenceront à apparaître dans l’explorateur de logs de Datadog en quelques secondes. Vous pouvez alors :

Filtrer les logs par symbole, stratégie ou instance
Créer des tableaux de bord basés sur les métriques de trading
Définir des alertes en cas d’erreurs, de seuils de profit ou d’échecs API

🧪 Exemple de sortie de journal (format JSON)

{
  "timestamp": "2025-06-20T09:15:32Z",
  "level": "info",
  "message": "Trade exécuté",
  "exchange": "binance",
  "symbol": "BTC/USDT",
  "strategy": "ScalpLong",
  "amount": 0.002,
  "price": 65250,
  "profit": 3.45,
  "instance_id": "bot-eu-1"
}

✅ Avantages de l'intégration Datadog

📍 Contrôle centralisé : Affichez les journaux de tous les environnements et instances en un seul endroit
📈 Surveillance des performances : Analysez l'efficacité des trades, les erreurs et la disponibilité
🚨 Alertes proactives : Soyez averti des problèmes avant qu’ils n’impactent vos opérations
🧩 Débogage simplifié : Identifiez rapidement les problèmes dans des systèmes distribués