هل يمكن الإعلان فورًا عن تعطل خدمة استنادًا إلى استجابة UptimeScout incidents؟ لا: تسرد نقطة النهاية الخدمات التي ظهرت لديها مؤخرًا إشارات مرتفعة إلى اضطرابات، وتنص المواصفات صراحةً على أنها ليست حوادث مؤكدة من مزوّد الخدمة. والنتيجة العملية هي قائمة قصيرة بإشارات تستحق التحقق، لا استنتاجًا جاهزًا بشأن سبب العطل.

هذا تمييز مهم للمهندس المناوب والمحلل: يمكن للتنبيه الآلي أن يقول «تحقّق من الخدمة X في المنطقة Y»، مع إبقاء تأكيد الواقعة وتفسير سببها رهينين بالحالة الرسمية لدى مزوّد الخدمة أو بالتشخيص الداخلي. وتوثّق مواصفات UptimeScout مسارات منفصلة للإشارات والحالة الحالية وسجلّ الرصد.
ما الذي تعيده قائمة الإشارات تحديدًا؟
/v1/incidents نقطة نهاية GET لفهرس الخدمات التي ظهرت لديها إشارات مرتفعة إلى اضطرابات. تتضمن معاملاتها عوامل تصفية بحسب الخدمة والمنطقة والفئة واستعلام البحث والمدة الزمنية. ويتطلب الرد ترخيصًا؛ وتصف الواجهة البرمجية المصادقة باستخدام رمز Bearer. يقبل حقل المنطقة رمزًا من حرفين، فيما يحدد hours نافذة تتراوح بين ساعة واحدة و2160 ساعة.
من السهل فهم كلمة «incident» في المسار على أنها «عطل مؤكد»، لكن التوثيق يحدد لها معنى أضيق: إشارة رصد حديثة. لذا ينبغي أن تصوغ التنبيه وفقًا لبيانات الاستجابة، مثل «وردت إشارة إلى اضطراب في الإتاحة»، وألا تنسب إلى مزوّد الخدمة إقراره بوقوع حادثة.
الحد الأدنى من التحقق قبل إرسال التنبيه
احفظ أولًا الاستجابة الأصلية مع وقت استلامها ومعاملات الطلب. ثم تحقّق من الخدمة والمنطقة اللتين ظهرتا، وقيّم حداثة البيانات باستخدام حقلي الخدمة observed_at وstale. وإذا وُسم الرصد بأنه قديم، فافصله عن الإشارة الحالية بدلًا من عرضه على أنه الحالة «الآن».
curl -sS 'https://api.uptimescout.com/v1/incidents?region=US&hours=24' \
-H "Authorization: Bearer $UPTIMESCOUT_LICENSE_KEY"
هذا مثال على طلب يغطي الولايات المتحدة خلال نافذة 24 ساعة؛ إذ تُقرأ قيمة المفتاح من متغير البيئة ولا تظهر في سطر الأوامر. بعد تلقي الاستجابة، تحقّق من أخطاء HTTP وبنية JSON، ثم عالج كل خدمة مُعادة على حدة. وتشمل قيم الحالة في المخطط operational وdegraded وoutage وunknown؛ فلا تستبدل الحقل أو القيمة المفقودين بتفسير من عندك.
بالنسبة إلى الإشارة التي تستدعي إجراءً، اطلب الحالة الحالية للخدمة المعنية عبر /v1/status وسجلها عبر /v1/history. ومن المفيد الاحتفاظ بالقيم resolution_seconds وsamples وcounts وeffective_start إلى جانب السلاسل في السجل: فهذا يوضح للمحلل مستوى الدقة الزمنية التي جُمعت بها البيانات والفترة الفعلية المتاحة. وتحذر المواصفات من أن الفترات المفقودة غير معروفة؛ لذلك لا يجوز اعتبار الفجوة تلقائيًا دليلًا على الإتاحة أو العطل.
تحويل الاستجابة إلى تقرير قابل للتحقق
أنشئ لكل سجل حقولًا تشمل معرّف الخدمة واسمها، والمنطقة المطلوبة، والحالة، ووقت الرصد، وعلامة التقادم، ووقت استلام الاستجابة، ورابطًا إلى مصدر الحالة الرسمي إذا تحقّق منه الفريق. ويملأ هذا الحقل تكاملك أو المشغّل؛ فمواصفات UptimeScout لا تضمن أن تتضمن الإشارة سببًا مؤكدًا أو تصريحًا من مزوّد الخدمة.

قسّم سير العمل إلى ثلاث حالات. تعني «استُلمت إشارة» أن السجل ظهر في نتيجة /v1/incidents. وتعني «جارٍ التحقق من الحالة» أنك طلبت الحالة الحالية والسجل. أما «مؤكد» فاحتفظ بها لاستنتاج تدعمه رسالة رسمية خارجية أو تحقق داخلي. يمنع هذا الفصل البسيط لوحة المعلومات من عرض إشارة مجمعة على أنها حقيقة ثابتة.
إذا كان الفريق يُعد تقريرًا لعدة مناطق، فنفّذ طلبات منفصلة باستخدام رموز المناطق المطلوبة، واحفظ المعامل مع النتيجة. يتعلق الحقل lang بلغة أوصاف الخدمات، ولا يغيّر منطقة الرصد. وهذا الفصل مهم عند المقارنة، مثلًا، بين فهرس مترجم وحالة إقليمية.
حدود ما يمكن استنتاجه
الناتج القابل للتحقق من هذا الإجراء هو سجل إشارات يتضمن بوضوح الوقت والمنطقة والحداثة، وتُضاف إليه مراجعة منفصلة للحالة والسجل. ويساعد هذا السجل على تحديد ما يستحق الانتباه وما أمكن تأكيده بالاستناد إلى المصادر المختارة. أما استجابة /v1/incidents نفسها فتفيد بوجود إشارة رصد مرتفعة؛ ويتطلب الإعلان عن عطل مؤكد بيانات داعمة.