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

يوفر MagicTradeBot تكاملًا أصليًا مع LogDNA — وهي منصة لإدارة السجلات قائمة على السحابة تتيح تدفق السجلات في الوقت الحقيقي والمراقبة المركزية. يسمح هذا التكامل بإرسال جميع الأحداث والسجلات الناتجة عن كل مثيل للروبوت إلى LogDNA فورًا.

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

🚀 نظرة عامة

يمكن لـ MagicTradeBot إرسال جميع السجلات والأحداث التداولية إلى LogDNA من خلال واجهة إدخال البيانات (Ingestion API) أو وكلاء التسجيل (logging agents). باستخدام هذا الإعداد، يمكنك:

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

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

  • 📡 تدفق السجلات في الوقت الحقيقي عبر HTTPS أو وكيل LogDNA
  • 🌍 دعم التوزيع على عدة مثيلات وخوادم
  • 🧠 سجلات قابلة للبحث مع علامات (Tags) وبيانات وصفية مخصصة
  • 📊 لوحة معلومات مركزية لتصور النشاط التداولي والأخطاء والأحداث
  • 🚨 تكامل مع أدوات التنبيه مثل Slack وPagerDuty وWebhooks وغيرهم

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

  • حساب LogDNA صالح
  • مفتاح إدخال LogDNA (API Key)
  • اختياري: تثبيت وكيل LogDNA في بيئة استضافة الروبوت

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

1. الحصول على مفتاح الإدخال من LogDNA

سجل الدخول إلى حسابك في LogDNA واذهب إلى الإعدادات → مفاتيح API لإنشاء أو نسخ مفتاح الإدخال الخاص بك.

2. تحديث إعدادات الروبوت

قم بتمكين تسجيل LogDNA في ملف إعدادات الروبوت (مثل config.yaml):

logging:
  logdna:
    enabled: true
    ingest_key: "YOUR_LOGDNA_API_KEY"
    app_name: "magictradebot"
    environment: "production"
    hostname: "bot-eu-1"
    tags:
      - exchange:binance
      - region:eu

3. (اختياري) تثبيت وكيل LogDNA

إذا رغبت، يمكنك تثبيت وكيل LogDNA على الخادم (Linux/Windows/macOS):

curl -sSL https://assets.logdna.com/logdna-agent.sh | sudo bash -s -- -k YOUR_LOGDNA_API_KEY

أو قم بتكوين الملف /etc/logdna.conf يدويًا وابدأ تشغيل الوكيل.

4. النشر والتحقق

قم بتشغيل الروبوت الخاص بك وتحقق من ظهور السجلات في لوحة تحكم LogDNA في الوقت الفعلي، مع العلامات، وأسماء المضيف، ومعرفات المثيل الصحيحة.

🧪 مثال على سجل LogDNA بصيغة JSON

{
  "timestamp": "2025-06-20T12:12:11Z",
  "level": "info",
  "message": "Executed short trade",
  "exchange": "binance",
  "symbol": "DOGE/USDT",
  "strategy": "ScalpShort",
  "profit": 1.05,
  "bot_instance": "bot-apac-02"
}

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

  • 📍 وصول موحد للسجلات من جميع مثيلات الروبوت عبر بورصات متعددة
  • 🧩 رؤية كاملة لأداء الإستراتيجية وسلوك التنفيذ
  • 📈 تسريع عمليات تصحيح الأخطاء وتتبعها باستخدام عوامل تصفية متقدمة
  • 🚨 تكامل مع أدوات التنبيه للاستجابة الفورية للحوادث
  • 💾 سجل تاريخي دائم وقابل للبحث لأغراض الامتثال والمراجعة

📎 Related Topics