دعم الامتدادات الخارجية: تكامل Datadog

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

🚀 نظرة عامة

يدعم محرك MagicTradeBot الأساسي إرسال السجلات والأحداث التجارية المُهيكلة مباشرةً إلى Datadog في الوقت الفعلي. هذا التكامل مثالي لـ:

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

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

📡 تدفق السجلات في الوقت الفعلي من جميع مثيلات البوت النشطة
🧠 تقرير الأحداث المهيكل مع بيانات وصفية (مثل الرمز، الاستراتيجية، النتيجة، إلخ)
🖥️ تجميع متعدد المثيلات من عدة بورصات وحسابات
☁️ دعم عمليات النشر الموزعة (سحابية أو مستضافة ذاتيًا)
📊 لوحات معلومات وتنبيهات مركزية ضمن منصة Datadog

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

قبل تفعيل دعم Datadog، تأكد من الآتي:

أن لديك حساب Datadog صالح ومفعل به الوصول إلى واجهة API
أن لديك مفتاح API من Datadog
أن مكتبة @datadog/datadog-api-client (أو عميل HTTP مكافئ) متوفرة في بيئتك (للتوسعات المخصصة)

⚙️ خطوات الإعداد

1. تفعيل تكامل Datadog في الإعدادات

في ملف إعدادات MagicTradeBot (مثل config.yaml أو appsettings.json)، فعّل الإعدادات التالية:

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. تحديد مستوى السجل

اختر مستوى التفصيل المناسب للسجلات:

debug: تفاصيل دقيقة (للاستخدام أثناء التطوير فقط)
info: أحداث التداول، إجراءات الاستراتيجية، العمليات العادية
warn: أحداث غير متوقعة ولكنها غير حرجة
error: الإخفاقات، الطلبات المرفوضة، المشغلات غير الصالحة

3. إعداد مثيلات البوت

تأكد من أن كل مثيل من مثيلات البوت يحتوي على instance_id فريد وعلامات مرتبطة تساعد Datadog في التمييز بينها.

4. النشر والمراقبة

بمجرد الانتهاء من الإعداد، ابدأ تشغيل البوت/البوتات. ستبدأ تدفقات السجلات في الظهور في Datadog خلال ثوانٍ. يمكنك الآن:

تصفية السجلات حسب الرمز، الاستراتيجية، أو المثيل
بناء لوحات معلومات باستخدام مؤشرات التداول
إنشاء تنبيهات للأخطاء، حدود الأرباح، أو فشل واجهة API

🧪 مثال على إخراج السجل (تنسيق JSON)

{
  "timestamp": "2025-06-20T09:15:32Z",
  "level": "info",
  "message": "تم تنفيذ الصفقة",
  "exchange": "binance",
  "symbol": "BTC/USDT",
  "strategy": "ScalpLong",
  "amount": 0.002,
  "price": 65250,
  "profit": 3.45,
  "instance_id": "bot-eu-1"
}

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

📍 تحكم مركزي: عرض السجلات من جميع البيئات والمثيلات في مكان واحد
📈 مراقبة الأداء: تحليل كفاءة التداول، الأخطاء، ومدة التشغيل
🚨 تنبيهات استباقية: الحصول على إشعارات بالمشكلات قبل أن تؤثر على التداول
🧩 تصحيح سهل: تحديد المشكلات بسرعة في الأنظمة الموزعة