Unterstützung von Erweiterungen von Drittanbietern: Datadog-Integration

MagicTradeBot bietet native Unterstützung für die Integration mit Datadog, einer leistungsstarken Observability-Plattform, um eine zentrale Echtzeitprotokollierung und Ereignisüberwachung zu ermöglichen. Egal, ob Sie eine einzelne Bot-Instanz oder mehrere Bots über verschiedene Börsen, Konten und Server einsetzen – Datadog hilft Ihnen, vollständige Transparenz über Ihre Handelsinfrastruktur zu gewinnen.

🚀 Überblick

Die Kern-Engine von MagicTradeBot unterstützt das Senden von strukturierten Logs und Handelsereignissen direkt an Datadog in Echtzeit. Diese Integration eignet sich hervorragend für:

Überwachung des Bot-Verhaltens und der Handelsausführung über alle Instanzen hinweg
Zentrales Debugging und Fehlerverfolgung
Nachverfolgung von Leistung, Fehlerraten und Auslösebedingungen
Visualisierung von Handelsaktivitäten über Dashboards und Alarme

🔧 Hauptfunktionen

📡 Echtzeit-Log-Streaming von allen aktiven Bot-Instanzen
🧠 Strukturierte Ereignisberichte mit Metadaten (Symbol, Strategie, Ergebnis usw.)
🖥️ Aggregation mehrerer Instanzen über verschiedene Börsen und Konten hinweg
☁️ Unterstützung für verteilte Deployments (Cloud-nativ oder selbst gehostet)
📊 Zentrale Dashboards & Alarme auf der Datadog-Plattform

🛠️ Voraussetzungen

Stellen Sie vor der Aktivierung der Datadog-Integration Folgendes sicher:

Sie besitzen ein gültiges Datadog-Konto mit aktiviertem API-Zugang
Sie haben einen Datadog API-Schlüssel
Das Paket @datadog/datadog-api-client (oder ein entsprechender HTTP-Client) ist in Ihrer Umgebung verfügbar (für benutzerdefinierte Erweiterungen)

⚙️ Konfigurationsschritte

1. Datadog-Integration in der Konfiguration aktivieren

Aktivieren Sie in Ihrer MagicTradeBot-Konfigurationsdatei (z. B. config.yaml oder appsettings.json) folgende Einstellungen:

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. Log-Level festlegen

Wählen Sie das geeignete Protokollierungsniveau:

debug: Detaillierte Ausgaben (nur für Entwicklung empfohlen)
info: Handelsereignisse, Strategieverhalten, regulärer Betrieb
warn: Unerwartete, aber nicht kritische Ereignisse
error: Fehler, abgelehnte Aufträge, ungültige Auslöser

3. Bot-Instanzen konfigurieren

Stellen Sie sicher, dass jede Bot-Instanz eine eindeutige instance_id sowie passende Tags hat, damit Datadog die Instanzen unterscheiden kann.

4. Bereitstellen und Überwachen

Sobald die Konfiguration abgeschlossen ist, starten Sie Ihren Bot. Innerhalb weniger Sekunden werden Log-Daten im Datadog Log Explorer sichtbar. Sie können jetzt:

Logs nach Symbol, Strategie oder Instanz filtern
Dashboards mit Handelsmetriken erstellen
Alarme bei Fehlern, Gewinnschwellen oder API-Ausfällen definieren

🧪 Beispielausgabe eines Logs (JSON-Format)

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

✅ Vorteile der Datadog-Integration

📍 Zentrale Steuerung: Sehen Sie alle Logs aus verschiedenen Umgebungen und Instanzen an einem Ort
📈 Leistungsüberwachung: Analysieren Sie Effizienz, Fehler und Verfügbarkeit
🚨 Proaktive Alarme: Lassen Sie sich benachrichtigen, bevor Probleme den Handel beeinträchtigen
🧩 Einfaches Debugging: Schnelle Fehleridentifikation in verteilten Systemen