Prise en charge des extensions tierces : Intégration Sentry

MagicTradeBot prend en charge l'intégration native avec Sentry — une plateforme puissante de suivi des erreurs et de surveillance en temps réel. Cela permet aux développeurs et opérateurs d’envoyer des données de journalisation et d’événements structurées depuis chaque instance du bot vers Sentry, permettant ainsi un débogage rapide, des alertes centralisées et une visibilité complète sur l’état du système.

Que vous exécutiez une seule instance de bot ou des centaines de bots répartis sur plusieurs plateformes, comptes, symboles ou nœuds serveurs, Sentry vous aide à centraliser la surveillance et à diagnostiquer les problèmes efficacement. À cette échelle, une supervision manuelle n’est pas faisable — Sentry comble cette lacune grâce à une automatisation puissante et des informations exploitables.

🚀 Aperçu

Avec l’intégration Sentry, MagicTradeBot peut automatiquement capturer :

  • Les exceptions à l’exécution et erreurs non gérées
  • Les échecs d’exécution de trades
  • Les problèmes de connectivité aux plateformes
  • Les journaux personnalisés et événements de diagnostic

Tous les journaux et événements d’erreurs sont transmis à Sentry en temps réel, vous permettant de :

  • Tracer les problèmes par instance, symbole ou plateforme
  • Analyser les traces d’appel, les goulets d’étranglement de performance, et la fréquence des erreurs
  • Configurer des alertes par e-mail, Slack ou Webhook pour les échecs critiques

🔧 Fonctionnalités clés

  • 📡 Signalement des erreurs et exceptions en temps réel
  • 🧠 Capture automatique des traces avec métadonnées contextuelles
  • 🌍 Prise en charge des environnements distribués et multi-instances
  • 🕵️ Regroupement des incidents, étiquetage par gravité et suivi des versions
  • 📊 Tableau de bord centralisé avec règles d’alerte et intégrations

🛠️ Prérequis

  • Un compte Sentry valide et un DSN (Data Source Name)
  • Le SDK Sentry installé dans l’environnement d’exécution de MagicTradeBot
  • Un bot configuré avec un instance_id ou des tags uniques pour une meilleure traçabilité

⚙️ Étapes de configuration

1. Installer le SDK Sentry

Installez le SDK Sentry pour votre environnement (par exemple, Python, Go, Node.js) :

pip install --upgrade sentry-sdk

2. Initialiser Sentry dans le code de démarrage du bot

Ajoutez ce code pour initialiser Sentry :

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. Activer Sentry dans le fichier de configuration

Dans config.yaml ou appsettings.json, activez l’intégration Sentry :

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

4. Ajouter des journaux personnalisés ou la capture d’erreurs (optionnel)

Vous pouvez signaler manuellement les erreurs critiques ainsi :

from sentry_sdk import capture_exception

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

🧪 Exemple de charge utile d’événement Sentry

{
  "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": [...]
  }
}

✅ Avantages de l’intégration Sentry

  • 📍 Suivi centralisé des journaux et erreurs pour toute l’activité du bot
  • ⚠️ Visibilité immédiate sur les échecs, les mauvaises configurations ou les pannes
  • 📈 Tableaux de bord visuels pour suivre la fréquence et les tendances des erreurs
  • 🚨 Intégrations d’alerte avec Slack, Teams, Email, Webhooks
  • 🔍 Résolution plus rapide des incidents grâce aux traces et aux historiques d’exécution

📎 Related Topics