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

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

سواء كنت تقوم بتشغيل مثيل واحد للبوت أو تدير مئات البوتات عبر العديد من البورصات وحسابات التداول والخوادم، فإن PagerDuty يمكّنك من مركزية المراقبة، والاستجابة الفورية للأعطال، وضمان التوفر العالي لعمليات التداول الخاصة بك.

🚀 نظرة عامة

يمكن لـ MagicTradeBot إرسال أحداث السجلات والتنبيهات من كل مثيل بوت إلى PagerDuty في الوقت الفعلي. هذا أمر ضروري لـ:

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

تصبح المراقبة اليدوية غير عملية عندما تقوم البوتات الخاصة بك بمسح وتداول مئات أزواج العملات الرقمية. يوفر PagerDuty طريقة ذكية ومركزية لـ التحكم والمراقبة والاستجابة على نطاق واسع.

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

  • 📡 إرسال الأحداث في الوقت الفعلي إلى PagerDuty عبر Webhook أو REST API
  • 🚨 شروط تنبيه قابلة للتكوين عند حدوث أخطاء في البوت، فشل الصفقات، أو توقف النظام
  • 🌍 قابل للتوسع في بيئات بوت ذات مثيل واحد أو متعددة
  • 🧠 سياسات تصعيد ذكية وتوجيه تلقائي للحوادث
  • 📊 لوحة تحكم مركزية لتتبع سجل التنبيهات وصحة التداول

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

  • حساب PagerDuty يحتوي على مفتاح API صالح أو رمز تكامل
  • خدمة PagerDuty تم إنشاؤها مسبقًا مع سياسات تصعيد محددة
  • تكوين MagicTradeBot لإرسال الإشعارات عبر Webhook أو API خارجي

⚙️ خطوات التكوين

1. إنشاء تكامل مع PagerDuty

من لوحة تحكم PagerDuty، انتقل إلى Services → Add Service وأنشئ خدمة جديدة لمراقبة MagicTradeBot. اختر نوع التكامل Events API v2 أو Custom Webhook.

2. الحصول على مفتاح التكامل

انسخ مفتاح التكامل (Routing Key) أو رابط Webhook لاستخدامه في تكوين البوت.

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

أضف تكامل PagerDuty إلى ملف إعدادات MagicTradeBot (مثل config.yaml): 

incident_reporting:
  pagerduty:
    enabled: true
    integration_key: "YOUR_PAGERDUTY_ROUTING_KEY"
    service_name: "magictradebot"
    severity_threshold: "error"
    environment: "production"

4. تحديد شروط التنبيه

سيقوم البوت بإرسال التنبيهات إلى PagerDuty وفقًا لقواعد داخلية مثل:

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

5. الاختبار والتحقق

قم بنشر البوت مع تمكين التنبيهات التجريبية، وتحقق من ظهور الأحداث في لوحة تحكم PagerDuty. قم بضبط مستوى الخطورة أو عوامل التصفية حسب الحاجة.

🧪 مثال على حمولة حدث PagerDuty

{
  "routing_key": "YOUR_PAGERDUTY_ROUTING_KEY",
  "event_action": "trigger",
  "payload": {
    "summary": "فشل MagicTradeBot في تنفيذ صفقة BTC/USDT",
    "severity": "error",
    "source": "bot-eu-1",
    "component": "trade-engine",
    "custom_details": {
      "symbol": "BTC/USDT",
      "exchange": "binance",
      "reason": "الرصيد غير كافٍ للهامش"
    }
  }
}

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

  • 📍 تنبيهات مركزية عبر جميع مثيلات البوت والبيئات
  • 🚀 استجابة أسرع للحوادث واستعادة تلقائية من خلال التصعيد التلقائي
  • 🧩 تكامل سهل مع الفرق عبر الرسائل النصية أو البريد الإلكتروني أو Slack أو أدوات العمليات
  • 📉 تقليل فترات التوقف وخسارة الفرص في الأسواق المتقلبة
  • 📈 رؤية شاملة لحالة التداول وموثوقية التنفيذ

📎 Related Topics