jsonscraper
الأسواق
العودة إلى المجلة

UptimeScout: كيفية التحقق من وقوع عطل في الخدمة بمنطقة المستخدم

دراسة حالة عملية: جمع سجلّ الملاحظات حسب المنطقة والتمييز بين الإشارة الحديثة والفترة المجهولة

السياسة التحريرية الإبلاغ عن خطأ

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

مقال: UptimeScout: كيفية التحقق من وقوع عطل في الخدمة بمنطقة المستخدم
الملخص: يمكن للتحقق من الإتاحة حسب المنطقة أن يجيب عن سؤال ما إذا كان عطل المستخدم متزامنًا مع ملاحظات UptimeScout. نعرض طريقة قابلة للتكرار: اختيار الخدمة والمنطقة، وطلب السجل، والتحقق من حداثة البيانات ودقتها الزمنية، ثم حفظ النتيجة مع الاستجابة الأصلية.
دور الصورة: غلاف — الفكرة المحورية
القسم: 
الموضوع المرئي: صورة تحريرية لمنطقة إقليمية مطوية لانقطاع الخدمة
تحدّد المنطقة والنافذة الزمنية نطاق التحقق من الإتاحة.© jsonscraper · أُنشئت بالذكاء الاصطناعي

السيناريو العملي هنا هو تشخيص عطل إقليمي محتمل. بيانات الإدخال هي معرّف الخدمة من دليل UptimeScout، ورمز منطقة مثل US أو GB، ونافذة السجل. تساعد النتيجة على مقارنة وقت بلاغ المستخدم بملاحظات الخدمة. وتصف واجهة API البيانات بأنها إشارات إلى الإتاحة المرصودة؛ لذا يفيد فحص الخدمة في تضييق نطاق المسألة، لكنه لا يحل محل فحوصات التطبيق الخاصة بكم.

تحقّق أولًا من الخدمة والمنطقة

ابدأ بالدليل: ابحث عن الخدمة المطلوبة بالاسم أو باستخدام حقل البحث، ثم سجّل معرّفها الدقيق. وتصف مواصفات UptimeScout OpenAPI البحث عبر GET /v1/services والمعلمات q وservice وregion وlimit وoffset. من الأفضل حفظ المعرّف في التقرير التشخيصي بدلًا من الاسم الظاهر وحده، لكي يوجّه الطلب المتكرر إلى العنصر نفسه في الدليل.

تُحدَّد المنطقة برمز مستقل من حرفين. من المهم حفظه إلى جانب النتيجة: فالاستجابة الخاصة بـ US والاستجابة من دون مرشح إقليمي تجيبان عن سؤالين مختلفين. إذا أردت عرض الوصف باللغة الروسية، تتحكم المعلمة lang=ru في توطين الوصف، بينما تختار المعلمة region الملاحظات. وتفصل الوثائق صراحةً بين هذين الغرضين.

اطلب السجل بدلًا من حالة واحدة

لمراجعة العطل، استخدم /v1/history مع المعلمة الإلزامية service والمنطقة المختارة region. تحدد المعلمة hours نافذة السجل؛ وتسمح المواصفات بقيم من ساعة واحدة إلى 2160 ساعة. ويتضمن الطلب أيضًا lang. وفقًا لمواصفات OpenAPI، يُمرَّر الترخيص للمصادقة باستخدام مخطط Bearer. عند التشغيل عمليًا، احتفظ بالمفتاح في متغير بيئة ولا تسجّله في سجل الطلبات.

import os
import requests

response = requests.get(
    "https://api.uptimescout.com/v1/history",
    headers={"Authorization": f"Bearer {os.environ['UPTIMESCOUT_LICENSE_KEY']}"},
    params={"service": "github", "region": "GB", "hours": 24, "lang": "ru"},
    timeout=30,
)
response.raise_for_status()
data = response.json()
print(data)

هذا مثال بسيط على الطلب، وليس نتيجة منشورة لتحقيق واقعي. أُدرج المعرّف github والمنطقة GB كقيم توضيحية للمعلمات؛ لذا اختر الخدمة والمنطقة المناسبتين لمهمتك قبل الاستخدام. من المفيد حفظ الاستجابة كاملةً بصيغة JSON، وإضافة وقت الحصول عليها ووصف الطلب في حقول منفصلة ضمن نظام التدقيق لديك. يتيح ذلك تكرار المراجعة ومعرفة لقطة البيانات التي استُخدمت تحديدًا.

الدقة الزمنية والفجوات جزء من النتيجة

في مصفوفة history، انتبه إلى الحقول observed_at وresolution_seconds وaggregated وsamples وcounts. تشير الدقة إلى طول الفترة الزمنية؛ وتبيّن samples عدد الملاحظات الداخلة في التجميع، بينما يتضمن counts توزيع الإشارات. قارن هذه القيم معًا: فالسطر الذي يحتوي على عدد قليل من العينات لا يحمل الوزن التحليلي نفسه الذي يحمله تجميع يستند إلى عدد أكبر من الملاحظات.

مقال: UptimeScout: كيفية التحقق من وقوع عطل في الخدمة بمنطقة المستخدم
الملخص: يمكن للتحقق من الإتاحة حسب المنطقة أن يجيب عن سؤال ما إذا كان عطل المستخدم متزامنًا مع ملاحظات UptimeScout. نعرض طريقة قابلة للتكرار: اختيار الخدمة والمنطقة، وطلب السجل، والتحقق من حداثة البيانات ودقتها الزمنية، ثم حفظ النتيجة مع الاستجابة الأصلية.
دور الصورة: رسم توضيحي مساند 2 — جانب محدد مختلف
القسم: الدقة الزمنية والفجوات جزء من النتيجة
الموضوع المرئي: مخطط ترتيب قراءة السجل
ترتيب قراءة السجل: المنطقة، والفترات الزمنية، والدقة، والفجوات.© jsonscraper · رسم توضيحي مُنشأ بالذكاء الاصطناعي

تصف UptimeScout السجل بأنه فترات زمنية تتغير مدتها بحسب النافذة المختارة: فترات بالدقائق وبخمس دقائق للفترات القصيرة، وفترات ساعية لبيانات اليوم، وفترات يومية للفترات الطويلة. وقد تكون التجميعات القديمة المحفوظة أقل دقة. لذلك لا تستنتج أن «العطل بدأ في هذه الدقيقة بالضبط» إذا كان السطر يمثل تجميعًا ساعيًا أو يوميًا. استخدم القيمة الفعلية في resolution_seconds والحقلين effective_start وhistory_resolution في الاستجابة لتحديد حدود ما يمكن استنتاجه.

تعامل مع الفترة الغائبة على أنها مجهولة. وتطلب المواصفات صراحةً التعامل مع الفجوات باعتبارها فترات مجهولة: فالفراغ في السجل لا يعني بحد ذاته أن الخدمة كانت تعمل طبيعيًا أو أنها تعطلت. تمنع هذه القاعدة البسيطة ملء الفجوات خطأً بحالة «خضراء» أو بأصفار عند إعداد التقرير.

قارن السجل بالإشارة الحالية

للتحقق من الحالة وقت البلاغ، اطلب /v1/status للخدمة service والمنطقة region نفسيهما. وفي كائن الخدمة، افحص status وobserved_at وstale معًا؛ إذ تعرض الوثائق هذه الحقول لتوضيح الحالة وحداثة الإشارة. تشير الحالة في المستوى الأعلى إلى نتيجة طلب API، بينما يصف service.status إشارة إتاحة الخدمة المحددة. ويكتسب هذا الفرق أهمية خاصة في التقارير الآلية: فالاستجابة الناجحة عبر HTTP وحالة الخدمة الخارجية أمران مختلفان.

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

كيف تصوغ النتيجة من دون تخمين

احفظ في سجل التقرير معرّف service، والمنطقة region، وفترة الطلب، وobserved_at، وresolution_seconds، وsamples، وcounts، وملاحظة عن الفجوات. وأضف رابط البلاغ أو الحادث الداخلي في موضع منفصل عن حقول API. بعد ذلك، قارن النطاق الزمني بسجلات التطبيق، ومسارات التتبّع الإقليمية، وبلاغ المستخدم. وإذا كانت الحدود الزمنية للتجميع أوسع من مدة العطل، فصغ النتيجة بما يتناسب مع ذلك: تتضمن ملاحظات المنطقة المختارة خلال النافذة المحددة الإشارات التالية، بدقة زمنية وعدد عينات محددين.

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

الناس

لم يتم إدراج أي أشخاص لهذه المقالة حتى الآن.

استمر في القراءةكيفية قراءة إشارات UptimeScout incidents: إشارة العطل ليست حادثة مؤكدة
إقرأ المقال التالي

حوّل ما تقرأه إلى تكامل عملي

استكشف واجهات API للبيانات الاجتماعية من jsonscraper واختبر الطلبات وأنشئ سير عملك التالي.

استكشف واجهات API