إنتقل إلى المحتوى الرئيسي
الإصدار: 0.4 · الحالي

إعداد صفحة الحالة العامة

دليل إرشاديتمت المراجعة في 11 أكتوبر 2026
ينطبق على:Excubius 0.4الأدوار: مسؤول الكيان
الخططFree · Core · Pro · Enterpriseالنشراستضافة ذاتية

يستطيع كل كيان نشر صفحة حالة واحدة لأشخاص ليس لديهم حساب: عملاء عميل، أو موظفو فرع، أو شريك. وهي تجيب عن سؤال واحد، هل الخدمة التي أستخدمها تعمل؟، باسم الكيان وشعاره وألوانه. يوضح هذا الدليل كيفية إنشاء الصفحة، وبناء مكوّناتها، ونشر الحوادث، ونشر الصفحة.

قبل البدء​

  • تحتاج إلى دور Entity admin (مسؤول الكيان) على الكيان الذي تمثله الصفحة.
  • يجب تفعيل الميزة ui.public_status_page. وما دامت معطلة، لا يمكن فتح الصفحة وتذكر الشاشة ذلك؛ ويفعّلها المسؤول الأعلى في Settings › Instance.
  • حدّد ما ينبغي أن يتعرف عليه الزوار: خدمات مثل بوابة العملاء أو مدفوعات البطاقات، لا أسماء الخوادم.

ما يراه الزوار، وما لا يرونه أبدًا​

تُبنى الصفحة حقلًا حقلًا من قائمة سماح (allow-list)، لا بترشيح البيانات الداخلية.

على الصفحةلا يظهر على الصفحة أبدًا
العنوان والمقدمة والشعار والسمة ولون التمييزأسماء الموارد وأسماء المضيفات وأنواعها وعلاماتها ومعرّفاتها
المكوّنات بالأسماء التي تعطيها لها، في مجموعات وبالترتيب الذي تحددهالفحوصات والمقاييس والقيم والحدود
حالة كل مكوّن وشريط توفره لمدة 90 يومًاالتنبيهات وعناوينها وخطورتها وأعدادها
الحوادث التي تنشرها، مع كل تحديث ووقتهمن نشر، ومن عُيّن، وأي شيء من صندوق وارد التنبيهات
الصيانة التي تختار الإعلان عنها، بعنوانها ووصفها العامينالسبب الداخلي لنافذة الصيانة
روابط RSS وAtom وJSON Feed، ورابط Sign in غير بارزمسارات الكيانات، أو الكيانات الأخرى، أو اسم المنتج وشعاره

إنشاء الصفحة​

  1. افتح Settings › Status page واختر الكيان في أداة الاختيار، مثل شركة خان الخليلي.

  2. حدد Create a status page for شركة خان الخليلي. تُنشأ الصفحة غير منشورة.

  3. ضمن Page، املأ الإعدادات:

    الإعدادملاحظات
    Titleيسمّي أيضًا علامة تبويب المتصفح والموجزات
    Introductionنص قصير تحت العنوان
    Logo addresshttps://… أو مسار على هذا الخادم، مثل /logos/ciguapa.svg. وعند تركه فارغًا يُستخدم شعار الفرع إن كان له شعار؛ ولا يُستخدم شعار المنتج أبدًا
    Themeأي من سمات وحدة التحكم؛ وDaylight افتراضيًا
    Accent colourلون للروابط وحلقات التركيز، أو Use the theme's
    Time zone of the daily barsحيث يبدأ كل يوم في أشرطة التوفر وينتهي. وتُعرض أوقات الحوادث والصيانة بالمنطقة الزمنية الخاصة بكل زائر
    Own domainاختياري، مثل status.ciguapa.example؛ انظر أدناه
  4. حدد Save.

Public address هو https://<server>/status/<entity short name>. يفتحها Open the public page؛ ويعرضها Show preview هنا، منشورة كانت أم لا.

إضافة المكوّنات​

المكوّن هو شيء يتعرف عليه الزوار. وهو يتتبع موارد كيان الصفحة أو الكيانات التي تحته: مورد كاملًا، أو فحصًا واحدًا لمورد عندما يهم ذلك الفحص وحده الخدمة.

  1. ضمن Components، حدد Add a component.
  2. أدخل Name، مثل مدفوعات البطاقات، واختياريًا Description وGroup. تُعرض المكوّنات ذات المجموعة نفسها معًا.
  3. ضمن Follows، اختر Resource ثم إما The whole resource أو Check واحدًا، ثم حدد Follow. كرّر ذلك لكل مورد تعتمد عليه الخدمة.
  4. أبقِ Show the 90-day availability bar محددًا ما لم تكن للنسبة المئوية دلالة ضئيلة لهذا المكوّن.
  5. اترك Status shown على From what it follows.
  6. حدد Save component.

استخدم الأسهم لتغيير الترتيب. وتعرض الشاشة بجانب كل مكوّن ما تقوله الموارد التي يتتبعها، فيسهل اكتشاف حالة يدوية قديمة.

ما تقوله الموارد المتتبَّعةحالة المكوّن
كل مورد متتبَّع سليم؛ ويُحتسب الفحص عند مستوى الخطورة معلومات سليمًاOperational (يعمل بشكل طبيعي)
أحدها عند مستوى التحذيرDegraded performance (أداء متدهور)
بعضها حرج أو يتعذر الوصول إليهPartial outage (انقطاع جزئي)
كل ما يبلغ منها حرجMajor outage (انقطاع كبير)
كلها داخل نافذة صيانةUnder maintenance (قيد الصيانة)
لم يبلغ شيء بعدOperational على الصفحة، وNo data في الأشرطة

لا تُحتسب الموارد قيد الصيانة لصالح الحالة ولا ضدها: فعقدة قاعدة بيانات واحدة قيد الصيانة والأخرى سليمة تعني Operational. ويُحتسب المورد المكتوم بحسب الحالة الفعلية لفحوصاته، لأن الكتم يغيّر الإشعارات لا الخدمة.

لتجاوز الحالة يدويًا، مثل Major outage بينما تعرف أكثر مما تعرفه الفحوصات، اخترها في Status shown. ثم أعدها إلى From what it follows بعد ذلك.

نشر الصفحة​

  1. راجع الصفحة بـ Show preview.
  2. ضمن Page، حدد Published، ثم Save.

وما دامت الصفحة غير منشورة، يجيب عنوانها بـ not found؛ وتظل المعاينة تعمل.

الإبلاغ عن حادث​

  1. ضمن Incidents، حدد Report an incident.
  2. أدخل Title وImpact (No impact أو Minor impact أو Major impact أو Critical impact) وAffected components وStatus وأول Message.
  3. حدد Report. يظهر الحادث وأول تحديث له في الصفحة وفي الموجزات مع وقتهما.
  4. كلما عرفت أكثر، انشر تحديثات بـ Post update، لكل منها حالة (Investigating أو Identified أو Monitoring أو Resolved) ورسالة.

يرفع الحادث المفتوح حالة المكوّنات التي يؤثر فيها إلى مستوى تأثيره على الأقل: الطفيف إلى Degraded performance، والكبير إلى Partial outage، والحرج إلى Major outage. ونشر Resolved يغلقه؛ ويبقى ضمن Past incidents لمدة 30 يومًا.

عبر API يمكنك أيضًا تصحيح نص تحديث سابق، دون وقته أو حالته، والإبلاغ عن حادث بعد وقوعه مع وقت بدايته.

الإعلان عن الصيانة​

عند إنشاء نافذة صيانة، حدد Announce on the status page وأعطها Public title واختياريًا Public description؛ راجع تخطيط نافذة صيانة. تظهر النافذة في صفحة كل كيان تتتبع مكوّناته موارد تغطيها: ضمن Maintenance أثناء سريانها، وإلا فتكرارها التالي خلال 30 يومًا. وتذكر النافذة الأسبوعية أنها تتكرر بدلًا من سرد كل أسبوع. ولا يُعرض سوى العنوان العام والوصف العام، ولا يُعرض السبب الداخلي أبدًا.

تقديم الصفحة على نطاق خاص​

لنشر الصفحة على https://status.ciguapa.example/status/ciguapa:

  1. وجّه DNS الاسم إلى الخادم، بسجل CNAME أو A.
  2. اطلب من المسؤول الأعلى إضافة الاسم بوصفه اسمًا مستعارًا في Settings › Server and certificates، وإبقاءه ضمن الأسماء في الشهادة، سواء كانت من Let's Encrypt أو شهادة خاصة. راجع إعداد الأسماء وTLS.
  3. أدخل الاسم في Own domain الخاص بالصفحة وحدد Save.

تستخدم الروابط في الصفحة وموجزاتها عندئذ ذلك الاسم عندما تُفتح الصفحة من خلاله. ويظل جذر ذلك الاسم، https://status.ciguapa.example/، يفتح صفحة تسجيل الدخول إلى وحدة التحكم، لذا شارك العنوان الكامل مع /status/<short name>.

ضبط مظهر الفرع​

يضبط Settings › Branch appearance قيمتي Default theme وLogo address على كيان؛ ويرثهما كل كيان تحته إلى أن يضبط قيمه الخاصة. ويعرض In effect النتيجة ومصدرها. وتستخدم صفحة الحالة التي لا شعار خاصًا بها شعار كيانها. وفي هذا الإصدار لا تطبّق وحدة التحكم نفسها سمة الفرع بعد؛ وكان اختيار الشخص لسمته سيتغلب عليها في أي حال.

التوفر​

يسجل كل مكوّن المدة التي قضاها في كل حالة، لكل يوم بحسب المنطقة الزمنية للصفحة. والأيام التي يحدث فيها تغيير للتوقيت الصيفي تكون ساعاتها 23 أو 25 ساعة. ويعرض الشريط خلية لكل يوم، 90 على الحاسوب و60 على الجهاز اللوحي و30 على الهاتف، ملوّنة بأسوأ حالة استمرت دقيقة أو أكثر في ذلك اليوم، مع تفاصيل عند التمرير أو النقر أو التركيز بلوحة المفاتيح.

  • وقت التشغيل اليومي (daily uptime) = 1 − (major outage + 0.3 × partial outage) ÷ known time. ويُحتسب الأداء المتدهور (degraded performance) وقتَ تشغيل. ويُستبعد وقت الصيانة وNo data من الوقت المعروف (known time)، لذا لا تخفض الأعمال المخطط لها الرقم أبدًا.
  • تستخدم النسبة المئوية الرئيسية الصيغة نفسها على مدى 90 يومًا. ويعرض المكوّن المُنشأ حديثًا uptime since أول يوم له.
  • الفترة التي فيها أي توقف تعرض 99.99% كحد أقصى، ولا تعرض 100% أبدًا.
  • يُحتفظ بالسجل التاريخي 400 يوم. وتُطبَّق المنطقة الزمنية الجديدة على الأيام الجديدة؛ وتحتفظ الأيام المسجلة بحدودها.

الموجزات والتخزين المؤقت​

ترتبط الصفحة بثلاثة موجزات لتحديثات حوادثها والصيانة المعلن عنها: RSS 2.0 وAtom 1.0 وJSON Feed 1.1، على /api/v1/status/<short name>/feed.rss وfeed.atom وfeed.json. أضف ?lang=es لتسميات بالإسبانية. والاشتراكات عبر البريد الإلكتروني غير متاحة بعد.

لا تتطلب العناوين العامة تسجيل الدخول وتكلفة تقديمها قليلة. تجيب الصفحة بالترويسة Cache-Control: public, max-age=30 وETag، وتجيب الموجزات بـ max-age=300، فيستطيع CDN أو الوكيل الأمامي تخزينها مؤقتًا كما هي. وتحمل الاستجابات Access-Control-Allow-Origin: *، فتستطيع مواقع أخرى قراءة JSON.

إيقاف الصفحة​

  • لإخفائها لبعض الوقت، ألغِ تحديد Published واحفظ. يجيب عنوانها بـ not found فورًا.
  • ويؤدي تعطيل الميزة ui.public_status_page إلى الأمر نفسه لكل الصفحات.
  • يزيل Delete the page الصفحة مع مكوّناتها وحوادثها وسجل توفرها. ولا يمكن التراجع عن ذلك.