دعم الإضافات الخارجية: تكامل Sentry

يدعم MagicTradeBot التكامل الأصلي مع Sentry — وهي منصة قوية لتتبع الأخطاء والمراقبة في الوقت الفعلي. يتيح هذا للمطورين والمشغلين إرسال سجلات الأحداث والبيانات المنظمة من كل مثيل بوت إلى Sentry، مما يمكّن من تصحيح الأخطاء بسرعة، والتنبيه المركزي، ورؤية كاملة لصحة النظام.

سواء كنت تُشغّل مثيل بوت واحد أو مئات البوتات عبر عدة بورصات، حسابات، رموز، أو خوادم، فإن Sentry يساعدك على توحيد المراقبة وتتبع المشكلات بفعالية. الرقابة اليدوية غير ممكنة على هذا النطاق — وSentry يملأ هذه الفجوة من خلال الأتمتة القوية والرؤى العميقة.

🚀 نظرة عامة

مع تكامل Sentry، يمكن لـ MagicTradeBot التقاط ما يلي تلقائيًا:

  • استثناءات وقت التشغيل والأخطاء غير المعالجة
  • فشل تنفيذ الصفقات
  • مشاكل الاتصال بالبورصة
  • السجلات المخصصة وأحداث التشخيص

يتم إرسال جميع السجلات والأخطاء إلى Sentry في الوقت الفعلي، مما يتيح لك:

  • تتبع المشكلات حسب مثيل البوت أو الرمز أو البورصة
  • تحليل تتبعات الأخطاء، اختناقات الأداء، وتكرار الأخطاء
  • إعداد التنبيهات عبر البريد الإلكتروني، Slack، أو Webhooks عند حدوث أعطال حرجة

🔧 الميزات الرئيسية

  • 📡 تقارير استثناءات وأخطاء في الوقت الفعلي
  • 🧠 التقاط تتبع الأخطاء تلقائيًا مع بيانات وصفية سياقية
  • 🌍 دعم بيئات متعددة المثيلات والموزعة
  • 🕵️ تصنيف المشكلات، تحديد درجة الخطورة، وتتبع الإصدارات
  • 📊 لوحة تحكم مركزية مع قواعد التنبيه والتكاملات

🛠️ المتطلبات الأساسية

  • حساب Sentry صالح وDSN (اسم مصدر البيانات)
  • تثبيت Sentry SDK في بيئة تشغيل MagicTradeBot
  • تهيئة البوت بمعرف instance_id أو tags فريدة لتحسين التتبع

⚙️ خطوات التهيئة

1. تثبيت Sentry SDK

قم بتثبيت Sentry حسب بيئة التشغيل (مثل Python أو Go أو Node.js):

pip install --upgrade sentry-sdk

2. تهيئة Sentry في كود بدء تشغيل البوت

أضف الكود التالي لتهيئة 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. تفعيل Sentry في ملف التهيئة

في config.yaml أو appsettings.json، فعّل تكامل 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. إضافة سجلات وأخطاء مخصصة (اختياري)

يمكنك الإبلاغ يدويًا عن الأخطاء الحرجة بهذا الشكل:

from sentry_sdk import capture_exception

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

🧪 مثال على حمولة حدث 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": [...]
  }
}

✅ فوائد تكامل Sentry

  • 📍 تتبع مركزي للسجلات والأخطاء لجميع أنشطة البوت
  • ⚠️ رؤية فورية للأعطال، أو الإعدادات الخاطئة، أو الانقطاعات
  • 📈 لوحات معلومات مرئية لتكرار المشكلات والاتجاهات
  • 🚨 تكامل تنبيهات مع Slack، Teams، البريد الإلكتروني، وWebhooks
  • 🔍 تسريع حل الحوادث باستخدام تتبعات الأخطاء ومسارات الأحداث

📎 Related Topics