التوثيق

صفحات الحالة

صفحة يستطيع عملاؤك قراءتها، تُظهر ما يعمل وما لا يعمل، ونستضيفها نحن كي تستجيب حين تتوقف بنيتك التحتية عن الاستجابة.

كيف تبنيها

أنشئ الصفحة ثم أضف إليها مكوّنات. المكوّن هو مراقب اخترت نشره، تحت اسم يفهمه عملاؤك — “Checkout” بدلًا من prod-api-lb-01. اجمعها في أقسام إن بلغت عددًا يستدعي ذلك.

إضافة مكوّن هي فعل نشر ذلك المراقب. تصبح حالته وسجله وحوادثه مرئية لكل من يملك الرابط. ولا يُكشف أي شيء آخر عن المراقب — لا الـ URL، ولا الإعدادات، ولا المكان الذي جرى منه الفحص — لكن كونه يعمل أو متوقفًا يصبح علنيًا. هذا هو المقصود، ويستحق أن تختار بتأنٍّ أي المراقبات تضيف.

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

أين تقيم

تحصل كل صفحة على عنوان على نطاقنا فورًا. ابتداءً من Starter يمكنك توجيه نطاقك الخاص إليها بدلًا من ذلك — status.yourcompany.com — ونتولى نحن أمر الشهادة.

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

الحوادث على الصفحة

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

نافذة الصيانة المجدولة تُنشر على الصفحة — عنوانها ووصفها وموعدها القادم — ما دام خيار “العرض على صفحات الحالة” مفعّلًا، وتظهر كذلك في خلاصات الصفحة. ويمكن إخبار المشتركين ببدئها وبانتهائها. وهي تحجب التنبيهات ما دامت مفتوحة، لكنها لا تعيد كتابة رقم وقت التشغيل: فما لم توقف أيضًا “مواصلة الفحص”، تجري الفحوصات كالمعتاد وتُحتسب كالمعتاد.

المشتركون

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

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

الصفحات الخاصة

عيّن كلمة مرور فتطلبها الصفحة قبل أن تعرض أي شيء. مفيد لصفحة داخلية أو لصفحة تُشارَك مع عميل واحد بموجب اتفاق.

يُحفظ فتح القفل في cookie خاص بتلك الصفحة وحدها، فلا يؤدي فتح واحدة إلى فتح أخرى — والزائر الذي فتح قفل صفحة تُقدَّم له دائمًا النسخة الحية لا نسخة من الذاكرة المؤقتة.

ما لا نعرضه عمدًا

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

التغذيات

كل صفحة عامة تنشر حوادثها في صورة تغذية، بالشكلين اللذين تفهمهما القارئات: /feed.xml لـ RSS و/atom.xml لـ Atom، وكلاهما إلى جوار عنوان الصفحة نفسها. والرابطان موضوعان في الصفحة، فتجدهما معظم القارئات من عنوان الصفحة وحده.

التغذية هي طريقة من يتابعك دون أن يعطيك عنوان بريد. وهي تحمل تمامًا ما تحمله الصفحة — حوادث الثلاثين يومًا الأخيرة، والمستجدّات التي وسمتَها عامة، ونوافذ الصيانة التي اخترت نشرها — ولا شيء غير ذلك: لا ملاحظة داخلية، ولا تقرير لاحق، ولا شيء عن المكان الذي جرى منه الفحص.

الصفحة المحمية بكلمة مرور أو المقيّدة لا تقدّم أي تغذية. فقارئ التغذيات لا يمكن سؤاله كلمة مرور، ومن ثم تكون التغذية هناك طريقًا للالتفاف على الحماية لا ميزة.

السرعة والإتاحة

تُخزَّن صفحات الحالة مؤقتًا على الحافة وتُقدَّم من نسخة تصمد حتى لو توقف مصدرنا نفسه. وهذا هو كل السبب في استضافة صفحة الحالة في مكان غير الشيء الذي تُبلّغ عنه: صفحة يتعذر الوصول إليها في أثناء الانقطاع ذاته الذي يتابعها الناس من أجله قد أخفقت في مهمتها الوحيدة.