Unterstützung für Erweiterungen von Drittanbietern: Sentry-Integration

MagicTradeBot unterstützt die native Integration mit Sentry – einer leistungsstarken Plattform zur Echtzeit-Fehlerverfolgung und -überwachung. Dies ermöglicht Entwicklern und Betreibern, strukturierte Protokoll- und Ereignisdaten von jeder Bot-Instanz an Sentry zu senden, um schnelle Fehlerbehebung, zentrale Benachrichtigungen und vollständige Systemtransparenz zu ermöglichen.

Egal, ob Sie eine einzelne Bot-Instanz oder Hunderte von Bots über mehrere Börsen, Konten, Symbole oder Serverknoten betreiben – Sentry hilft Ihnen, die Überwachung zu zentralisieren und Probleme effektiv nachzuverfolgen. Manuelle Kontrolle ist in diesem Maßstab nicht praktikabel – Sentry schließt diese Lücke mit robuster Automatisierung und tiefgreifenden Einblicken.

🚀 Überblick

Mit der Sentry-Integration kann MagicTradeBot automatisch Folgendes erfassen:

  • Laufzeitfehler und unbehandelte Ausnahmen
  • Fehlgeschlagene Handelsausführungen
  • Verbindungsprobleme mit Börsen
  • Benutzerdefinierte Protokolle und Diagnoseereignisse

Alle Protokolle und Fehlermeldungen werden in Echtzeit an Sentry übermittelt, sodass Sie:

  • Probleme nach Bot-Instanz, Symbol oder Börse nachverfolgen können
  • Stacktraces, Performance-Engpässe und Fehlerhäufigkeiten analysieren können
  • E-Mail-, Slack- oder Webhook-Benachrichtigungen für kritische Fehler einrichten können

🔧 Hauptfunktionen

  • 📡 Echtzeit-Fehler- und Ausnahmeberichte
  • 🧠 Automatische Erfassung von Stacktraces mit kontextbezogenen Metadaten
  • 🌍 Unterstützung für Multi-Instanz- und verteilte Umgebungen
  • 🕵️ Gruppierung von Problemen, Schweregrad-Tags und Release-Verfolgung
  • 📊 Zentrales Dashboard mit Alarmregeln und Integrationen

🛠️ Voraussetzungen

  • Ein gültiges Sentry-Konto und eine DSN (Data Source Name)
  • Das Sentry SDK muss in der MagicTradeBot-Laufzeitumgebung installiert sein
  • Der Bot sollte mit einer eindeutigen instance_id oder tags für bessere Nachverfolgbarkeit konfiguriert sein

⚙️ Konfigurationsschritte

1. Sentry SDK installieren

Installieren Sie das Sentry SDK für Ihre Laufzeitumgebung (z. B. Python, Go, Node.js):

pip install --upgrade sentry-sdk

2. Sentry im Bot-Startcode initialisieren

Fügen Sie folgenden Code zur Initialisierung von Sentry hinzu:

import sentry_sdk

sentry_sdk.init(
    dsn="YOUR_SENTRY_DSN",
    environment="production",
    release="magictradebot@2.0.0",
    traces_sample_rate=1.0,
    send_default_pii=True
)

3. Sentry in der Konfigurationsdatei aktivieren

Aktivieren Sie in config.yaml oder appsettings.json die Sentry-Integration:

monitoring:
  sentry:
    enabled: true
    dsn: "YOUR_SENTRY_DSN"
    environment: "production"
    release: "magictradebot@2.0.0"
    tags:
      instance_id: "bot-apac-01"
      exchange: "binance"

4. Benutzerdefinierte Protokoll- und Fehlererfassung (optional)

Kritische Fehler können manuell wie folgt gemeldet werden:

from sentry_sdk import capture_exception

try:
    bot.execute_trade()
except Exception as e:
    capture_exception(e)

🧪 Beispiel eines Sentry-Ereignis-Payloads

{
  "level": "error",
  "message": "Trade execution failed",
  "timestamp": "2025-06-20T11:25:41Z",
  "bot_instance": "bot-us-1",
  "symbol": "SOL/USDT",
  "exchange": "kucoin",
  "exception": {
    "type": "InsufficientBalanceError",
    "value": "Not enough USDT to place order",
    "stacktrace": [...]
  }
}

✅ Vorteile der Sentry-Integration

  • 📍 Zentrale Protokoll- und Fehlerverfolgung für alle Bot-Aktivitäten
  • ⚠️ Sofortige Sichtbarkeit bei Ausfällen, Fehlkonfigurationen oder Störungen
  • 📈 Visuelle Dashboards für Fehlerhäufigkeit und Trends
  • 🚨 Alarm-Integrationen mit Slack, Teams, E-Mail, Webhooks
  • 🔍 Schnellere Fehlerbehebung durch Stacktraces und Breadcrumbs

📎 Related Topics