تنبيهات

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

على سبيل المثال، العملية التالية هي طريقة نموذجية لاستخدام التنبيهات لالتقاط التراجع في الأداء:

1. إنشاء تنبيه - إعداد تنبيه لـ "معدل تعطل العميل يتجاوز 5%" مع مدة 5 دقائق وشدة حرجة.
2. إضافة ويب هوك - الاتصال بويب هوك فريقك على PagerDuty أو Discord.
3. دفع التحديث الخاص بك - نشر الإصدار الجديد الخاص بك.
4. استلام التنبيه - إذا ارتفع معدل التعطل إلى أكثر من 5% لمدة 5 دقائق متتالية، سيتم إخطار فريقك على الفور مع قيمة المقياس ورابط إلى لوحة التحكم.
5. التحقيق وإصلاح - انقر على رابط لوحة التحكم في حمولة الويب هوك لعرض الرسوم البيانية للأداء وتشخيص المشكلة.

يمكنك إنشاء ما يصل إلى 20 تنبيهاً لكل تجربة. إنشاء التنبيهات يحتاج إلى إذن إنشاء وإعداد التنبيهات.

عرض صفحة التنبيهات

للوصول إلى صفحة التنبيهات، يجب أن تكون إما مالك التجربة أو لديك عرض جميع التحليلات الأذونات.

1. اختر تجربتك على Creator Hub.
2. تحت الإعداد، اختر التنبيهات.

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

الأذونات

تتطلب التنبيهات أذونات محددة لإجراءات مختلفة:

إنشاء تنبيهات

لإنشاء تنبيه، انقر على إنشاء في صفحة إعداد التنبيهات.

حقول التنبيه

كل تنبيه له خيارات تكوين التالية.

المقاييس المدعومة

تدعم التنبيهات جميع مقاييس الأداء المتاحة على لوحة الأداء، بما في ذلك:

• معدل إطارات العميل
• معدل تعطل العميل
• استخدام ذاكرة العميل (جيجابايت)
• نسبة استخدام الذاكرة للعميل
• عمليات الخروج غير المتوقعة من الذاكرة
• وقت وحدة المعالجة المركزية للخادم
• معدل إطارات الخادم
• استخدام ذاكرة الخادم (جيجابايت)
• المستخدمون المتزامنون
• وقت الجلسة

شروط التشغيل

يمكنك تعيين أحد نوعي شروط التشغيل:

• قيمة المقياس - يتم تشغيلها عندما تتجاوز القيمة حد رقمي ثابت. القيمة تستخدم نفس الوحدة مثل المقياس (نسبة مئوية، مللي ثانية، ميغابايت، إلخ).

• تغيير الفترة الزمنية - يتم تشغيلها عندما تتجاوز نسبة تغيير المقياس حداً معيناً.

  • أسبوعياً - يتحقق من النسبة المئوية للتغيير بين نفس الوقت الأسبوع الماضي (على سبيل المثال، 5:00 مساءً يوم الجمعة هذا مقابل 5:00 مساءً يوم الجمعة الماضي).
  • يومياً - يتحقق من النسبة المئوية للتغيير بين نفس الوقت البارحة (على سبيل المثال، 9:00 صباحًا اليوم مقابل 9:00 صباحًا أمس).
  • ساعة بساعة - يتحقق من النسبة المئوية للتغيير بين الساعة الأخيرة والأخيرة السابقة (على سبيل المثال، 9:05 صباحًا مقابل 8:05 صباحًا).

على سبيل المثال، يمكنك تعيين شرط قيمة مقياس مثل "معدل تعطل العميل يتجاوز 5%" أو شرط تغيير الفترة الزمنية مثل "التغيير بالساعة يتجاوز 50%".

المدة

تتحكم إعدادات المدة في كيفية استمرار تحقيق شرط التشغيل قبل أن يتم تشغيل التنبيه. يساعد ذلك على تقليل الضوضاء الناتجة عن الت fluctuations اللحظية. إذا اخترت 1، سيتم تفعيل التنبيه بمجرد تحقيق نقطة بيانات واحدة شرطك. إذا اخترت 5، يجب أن تحقق خمس نقاط بيانات متتالية الشرط. بالنسبة للتنبيهات ذات تجزئة الوقت بالدقائق، الحد الأدنى للمدة هو 5 دقائق لتقليل الضوضاء.

مستويات الشدة

كل تنبيه له مستوى شدة يتم تضمينه في رسالة التنبيه ويعرض بلون مميز.

تسليم الويب هوك

تصل التنبيهات عبر ويب هوكس على مستوى التجربة. عندما يتم تشغيل التنبيه أو تعافى، يتم إرسال طلب POST HTTP إلى عنوان URL الخاص بويب هوك الذي قمت بإعداده مع حمولة JSON. الرسالة نفسها هي أيضًا JSON، مغلفة في حقل AlertMessage كسلسلة واحدة، مثل:

{
  "NotificationId": "11111abc-111a-1a2a-ab1a-abc1a1a111a1",
  "EventType": "AnalyticsAlert",
  "EventTime": "2026-06-15T22:05:10.8590762Z",
  "EventPayload": {
    "TargetType": "Universe",
    "TargetId": "1234567890",
    "AlertMessage": "{\n  \"summary\": \"[♟️] اللعبة عادت\",\n  \"metric\": \"PeakConcurrentPlayers\",\n  \"universe_id\": \"1234567890\",\n  \"evaluation_time_utc\": \"2026-06-15T22:04:47Z\",\n  \"alert_history\": \"https://create.roblox.com/dashboard/creations/experiences/1234567890/alerts?tab=AlertConfiguration-Analytics&utm_medium=webhook&utm_campaign=alert_resolved\"\n}"
  }
}

حقل AlertMessage.summary يتضمن إما كلمة "تم التشغيل" عندما يتم تفعيل التنبيه أو كلمة "استعادت" عندما تعود القيمة إلى حالة طبيعية.

يمكنك استخدام الويب هوكس للتكامل مع أدوات خارجية مثل PagerDuty أو Slack لرؤية عامة على مستوى الفريق.

إعداد ويب هوك

1. اختر تجربتك على Creator Hub.

2. تحت الإعداد، اختر ويب هوكس وانقر على إضافة ويب هوك.

   يأتي عنوان URL الخاص بالويب هوك من موفر الخدمة الخاص بك. على سبيل المثال، قد يبدو عنوان URL الخاص بـ Slack كالتالي:

   https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

3. أدخل عنوان URL الخاص بويب هوك واسمًا.

4. (اختياري) قم بتضمين سر، مما يساعد على التأكد من أن الطلبات التي تتلقاها جاءت من روبلوكس.

5. (اختياري) استخدم زر اختبار الاستجابة للتحقق مما إذا كانت خدمتك تستطيع استلام طلب عينة.

6. انقر على حفظ التغييرات.

7. عند إنشاء أو تعديل تنبيه، اختر ويب هوك الخاص بك تحت حقل قناة التسليم.

إنشاء ويب هوكس على مستوى التجربة يتطلب إذن سرد، إنشاء، تحديث، وحذف الويب هوكس الأذن.

مراقبة التنبيهات

تقدم علامة التحليلات على صفحة التنبيهات عرضًا مركزيًا لتاريخ التنبيهات والحالة الحالية:

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

التعليقات التوضيحية للرسم البياني

عندما يكون التنبيه فعالاً، تظهر تعليقات توضيحية موسعة على الرسم البياني المقابل للمقياس في لوحة الأداء. تظهر التعليقات اسم التنبيه وتغطي مدة فترة التشغيل.

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

نظرة عامة على التجربة

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

أفضل الممارسات لتنبيهات

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

• منع الإنذارات الكاذبة باستخدام المدة - تجنب تعيين المدة إلى 1 للمقاييس المتقلبة مثل وقت الجلسة. قد يتسبب دخول مفاجئ للاعبين أو تحميل الأصول في نفس الوقت في حدوث قفزات مؤقتة. يسمح تعيين مدة 5 بأن يتم تشغيل التنبيه فقط إذا استمرت المشكلة.
• استخدام تقسيمات فعالة - بدلاً من إنشاء عدة تنبيهات فردية لنظام Android وiOS وPC، يمكنك إنشاء تنبيه واحد فقط واستخدام ميزة الانقسام. ستقوم التنبيه بتقييم كل منصة بشكل منفصل وتحديد مكان حدوث المشكلة في حمولة الويب هوك.
• إنشاء خط أساس أولاً - قبل تعيين حدودك، راجع رسومك التحليلية الحالية على مدى الأيام 7 إلى 14 الماضية. إذا كانت نسبة التعطل الطبيعية لديك تدور حول 1.2%، فكر في تعيين حد التنبيه إلى 2.5% أو 3%. يمنح إعطاء مقاييسك مساحة للاختلافات الطبيعية لتجنب الإنذارات الكاذبة.
• استخدام أسماء وصفية ومنظمة - لأن أسماء التنبيهات تُحقن مباشرة في حمولة الويب هوك والتعليقات التوضيحية، فإن استخدام صيغة واضحة مثل metric - context (على سبيل المثال، ارتفاع معدل تعطل العميل - الهاتف المحمول) يسهل على فريقك معالجة القضايا بسرعة.