يعرض هذا الدليل كيفية إعداد نظام مراقبة آلي يرسل رسائل خاصة إلى مجموعة المشرفين الخاصة بك عند اكتشاف إشعارات إدارية جديدة على موقع Discourse الخاص بك.
مستوى المستخدم المطلوب: مسؤول (Administrator)
نظرة عامة
تنبّه الإشعارات الإدارية المسؤولين إلى مشكلات الموقع الهامة مثل تحديثات المكونات الإضافية، أو مشكلات توافق الثيمات، أو المخاوف الأمنية. يساعدك هذا الدليل في تكوين نظام آلي لإخطار فريق الإدارة بشكل استباقي كلما ظهرت إشعارات إدارية جديدة على موقعك، مما يضمن عدم تفويت أي تحديثات حرجة.
يتكون نظام المراقبة من مكونين أساسيين:
- استعلام Data Explorer (مستكشف البيانات) يحسب عدد الإشعارات الإدارية الجديدة التي تم إنشاؤها في آخر 24 ساعة
- Discourse Automation (أتمتة Discourse) يقوم بتشغيل الاستعلام بشكل دوري ويرسل رسالة خاصة إلى مجموعة المشرفين الخاصة بك عند العثور على إشعارات
المتطلبات الأساسية
قبل أن تبدأ، تأكد من تمكين المكونات الإضافية التالية على موقعك:
- Data Explorer - متاح في خطط الأعمال (Business) والمؤسسات (Enterprise) المستضافة، أو يمكن تثبيته على المثيلات المستضافة ذاتيًا.
- Discourse Automation - مدمج مع نواة Discourse (لا يتطلب تثبيتًا منفصلاً).
مستضاف بواسطة Discourse؟
تتوفر المكونات الإضافية Automations و Data Explorer بدءًا من خطة Business وما فوقها.
مستضاف بواسطة Discourse؟إنشاء استعلام Data Explorer
الخطوة الأولى هي إنشاء استعلام يحدد الإشعارات الإدارية الجديدة.
- انتقل إلى
/admin/plugins/discourse-data-explorerفي موقع Discourse الخاص بك. - انقر على Add (إضافة) لإنشاء استعلام جديد.
- قم بتسمية الاستعلام الخاص بك “Admin Notices Count - Last 24 Hours” (عدد الإشعارات الإدارية - آخر 24 ساعة).
- أضف استعلام SQL التالي:
SELECT 'There are new admin notices on dashboard.' AS message, id, created_at
FROM admin_notices
WHERE created_at >= CURRENT_TIMESTAMP - INTERVAL '24 hours'
ORDER BY created_at DESC
يقوم هذا الاستعلام بحساب الإشعارات الإدارية التي تم إنشاؤها خلال الـ 24 ساعة الماضية.
- انقر على Save (حفظ) لتخزين الاستعلام.
- اختبر الاستعلام بالنقر على Run (تشغيل) للتأكد من أنه يعرض النتائج بشكل صحيح.
تكوين الأتمتة
بعد ذلك، ستقوم بإعداد أتمتة تقوم بتشغيل هذا الاستعلام بشكل دوري وإرسال الإشعارات.
إنشاء الأتمتة
- انتقل إلى
/admin/plugins/automation/. - انقر على Add automation (إضافة أتمتة).
- بالنسبة إلى Script (النص البرمجي)، اختر Schedule a PM with Data Explorer results (جدولة رسالة خاصة بنتائج مستكشف البيانات).
- أدخل اسمًا مثل “Alert on New Admin Notices” (تنبيه بشأن الإشعارات الإدارية الجديدة).
- بالنسبة إلى Trigger (المُشغِّل)، اختر Recurring (متكرر).
تكوين المُشغِّل (Trigger)
في قسم المُشغِّل (Trigger):
- اضبط Recurrence (التكرار) للتشغيل وفقًا للجدول الزمني المفضل لديك (على سبيل المثال، “Every 24 hours” - كل 24 ساعة).
- قم بتمكين Start date (تاريخ البدء) واختر متى تريد أن تبدأ المراقبة.
تكوين النص البرمجي (Script)
في قسم النص البرمجي (Script)، قم بتكوين الحقول التالية:
Send to User, Group or Email (الإرسال إلى مستخدم أو مجموعة أو بريد إلكتروني): أدخل اسم مجموعة المشرفين الخاصة بك (عادةً admins).
Data Explorer Query (استعلام مستكشف البيانات): اختر “Admin Notices Count - Last 24 Hours” (الاستعلام الذي أنشأته سابقًا).
Skip sending PM if there are no results (تخطي إرسال الرسالة الخاصة إذا لم تكن هناك نتائج): قم بتمكين هذا الخيار لمنع إرسال الرسائل الخاصة عندما يكون العدد 0.
الآن انقر على زر “Update automation” (تحديث الأتمتة).
تمكين الأتمتة
بعد تكوين جميع الإعدادات:
- راجع التكوين الخاص بك.
- انقر على مفتاح تبديل Enable automation (تمكين الأتمتة) في الجزء العلوي من الصفحة لتنشيط الأتمتة.
- اختياريًا، انقر على Trigger now (تشغيل الآن) لاختبار الأتمتة على الفور.
كيف يعمل
بمجرد التمكين، يعمل النظام على النحو التالي:
- كل 24 ساعة (أو الفاصل الزمني الذي قمت بتكوينه)، يتم تشغيل الأتمتة تلقائيًا.
- يتم تشغيل استعلام Data Explorer ويحسب الإشعارات الإدارية التي تم إنشاؤها في آخر 24 ساعة.
- إذا كان العدد أكبر من 0، يتم إرسال رسالة خاصة إلى مجموعة المشرفين تحتوي على عدد الإشعارات.
- إذا لم يتم العثور على إشعارات جديدة، فلن يتم إرسال أي رسالة خاصة (بسبب إعداد “تخطي إرسال الرسالة الخاصة إذا لم تكن هناك نتائج”).
يضمن هذا تلقي فريق الإدارة الخاص بك إشعارات في الوقت المناسب بشأن الإشعارات الإدارية الجديدة دون أن يغمرهم عدد كبير من الرسائل غير الضرورية.
استكشاف الأخطاء وإصلاحها
الأتمتة لا تعمل
- تحقق من تمكين الأتمتة - تحقق من المفتاح في الجزء العلوي من صفحة الأتمتة.
- تحقق من
/logsبحثًا عن أي رسائل خطأ متعلقة بالأتمتة. - تأكد من تمكين مكون Automation الإضافي نفسه في
/admin/plugins.
عدم استلام الرسائل الخاصة
- تحقق من صحة اسم المجموعة في حقل “Send to” (الإرسال إلى).
- تأكد من أن مجموعة المشرفين لديها إذن لاستلام الرسائل الخاصة.
- راجع إعدادات الإشعارات الشخصية الخاصة بك للتأكد من أنك تتلقى إشعارات عبر البريد الإلكتروني للرسائل الخاصة.
الاستعلام لا يُرجع نتائج على الرغم من وجود إشعارات
- اختبر الاستعلام يدويًا في Data Explorer.
- تحقق من أن معلمة الفترة الزمنية تتطابق مع تكرار الأتمتة لديك.
- تحقق من وجود إشعارات إدارية بالفعل عن طريق زيارة
/admin.