🖥️

صحة النظام والمراقبة

مراقبة مقاييس النظام واستخدام التخزين والمهام الخلفية وتهيئة التقارير المجدولة

4 دقائق قراءة

نظرة عامة

قسم صحة النظام يوفر لمديري المنصة رؤية للصحة التقنية للبنية التحتية لسحافايل. مراقبة أوقات استجابة API، أداء قاعدة البيانات، استهلاك التخزين، حالات المهام الخلفية، وتوفر النظام الإجمالي. هذا القسم يشمل أيضاً إدارة التقارير المجدولة، مما يسمح لك بأتمتة تسليم التقارير الدورية. يتطلب صلاحية settings.view للعرض وreports.manage لإدارة التقارير المجدولة.

لوحة صحة النظام تعرض حالة الخدمات والمقاييس ومؤشرات التخزين

نظرة عامة على صحة النظام

  1. انتقل إلى النظام > الصحة من القائمة الجانبية.
  2. لوحة حالة الخدمات — تعرض الحالة التشغيلية لكل مكون:
    • خادم API — حالة خدمة الخلفية (صحي/متدهور/متوقف)
    • قاعدة البيانات (PostgreSQL) — حالة مجموعة الاتصالات، زمن الاستعلام
    • Redis Cache — معدل إصابة الذاكرة المؤقتة، استخدام الذاكرة
    • تخزين الكائنات (MinIO/GCS) — التوفر ووقت الاستجابة
    • خدمة البريد — حالة اتصال SMTP
    • مزود SMS — حالة تسليم OTP
  3. مؤشرات الحالة — دائرة خضراء (صحي)، صفراء (أداء متدهور)، حمراء (خدمة متوقفة أو غير قابلة للوصول).

مقاييس النظام

  1. انتقل إلى النظام > المقاييس لبيانات أداء تفصيلية.
  2. المقاييس الرئيسية المعروضة:
    • وقت استجابة API — المتوسط، P95، وP99 للزمن خلال الساعة الماضية
    • حجم الطلبات — إجمالي طلبات API في الدقيقة/الساعة مع رسم اتجاه
    • معدل الأخطاء — نسبة استجابات 4xx و5xx
    • استعلامات قاعدة البيانات — متوسط وقت تنفيذ الاستعلام، عدد الاستعلامات البطيئة
    • الاتصالات النشطة — أعداد اتصالات قاعدة البيانات وRedis الحالية
    • استخدام الذاكرة — استهلاك ذاكرة التطبيق
  3. محدد النطاق الزمني — عرض المقاييس لآخر ساعة، 6 ساعات، 24 ساعة، أو 7 أيام.

استخدام التخزين

  1. انتقل إلى النظام > التخزين لعرض استهلاك التخزين على مستوى المنصة.
  2. تقسيم التخزين:
    • إجمالي التخزين المستخدم — التجميع عبر جميع العيادات
    • حسب العيادة — أعلى 20 عيادة من حيث استهلاك التخزين
    • حسب نوع الملف — مستندات، صور، أشعة، نتائج معامل، وصفات
    • اتجاه النمو — معدل نمو التخزين الشهري
  3. تنبيهات التخزين — النظام يحذر عندما يقترب الاستخدام الإجمالي من حدود الخطة أو عندما تتجاوز عيادات فردية تخزينها المخصص.

المهام الخلفية

  1. انتقل إلى النظام > المهام لمراقبة تنفيذ المهام الخلفية.
  2. فئات المهام:
    • فحوصات الاشتراك — كشف الانتهاء التلقائي وانتقالات فترة السماح
    • تسليم الإشعارات — معالجة الإشعارات في الطابور
    • تجميع التحليلات — تشغيلات خط التحليلات السريرية
    • توليد التقارير — تجميع التقارير المجدولة
    • فحوصات انتهاء الاعتمادات — مراقبة اعتمادات الأطباء
    • مهام النسخ الاحتياطي — حالة النسخ الاحتياطي لقاعدة البيانات
  3. مؤشرات حالة المهمة — قيد التشغيل (دوار أزرق)، مكتملة (علامة خضراء)، فشلت (X أحمر مع تفاصيل الخطأ)، مجدولة (أيقونة ساعة مع وقت التشغيل التالي).

التقارير المجدولة

  1. انتقل إلى التقارير > المجدولة لإدارة تسليم التقارير الآلية.
  2. إنشاء تقرير مجدول:
    • اضغط "تقرير مجدول جديد"
    • اختر نوع التقرير (إيرادات، نمو، صحة العيادات، خط أنابيب التنفيذ، إلخ)
    • حدد التكرار: يومي، أسبوعي (اختر اليوم)، أو شهري (اختر التاريخ)
    • حدد طريقة التسليم: بريد إلكتروني لعناوين محددة، أو قابل للتحميل من المنصة
    • حدد الصيغة: PDF أو CSV أو JSON
  3. إدارة التقارير الحالية — تعديل الجدول، إيقاف/استئناف، تشغيل يدوي، أو حذف.
  4. عرض سجل التشغيل — اضغط "السجل" على أي تقرير مجدول لرؤية التنفيذات السابقة، حالة التسليم، وتحميل المخرجات السابقة.
  5. تشغيل يدوي — اضغط "تشغيل الآن" لتوليد تقرير فوراً خارج جدوله العادي.
نصيحة: أعد تقريراً مجدولاً أسبوعياً لـ "خط أنابيب التنفيذ" ليُرسل بالبريد كل أحد مساءً. هذا يعطيك رؤية صباح الاثنين للعيادات التي تحتاج اهتمام، بدون فحص لوحة التحكم يدوياً.
تحذير: إذا أظهرت مهمة خلفية حالة "فشل" بشكل متكرر، حقق فوراً. مهام فحص الاشتراك الفاشلة قد تؤدي لعدم نقل العيادات بشكل صحيح لفترة السماح أو التعليق، مما يسبب تسرب إيرادات.

إعدادات المنصة

  1. انتقل إلى النظام > الإعدادات لعرض وتعديل تهيئة المنصة الشاملة.
  2. الإعدادات المتاحة تشمل:
    • أيام الفترة التجريبية الافتراضية
    • أيام فترة السماح الافتراضية
    • الحد الأقصى لحجم رفع الملفات
    • مدة انتهاء OTP
    • مدة انتهاء الجلسة
    • تبديل وضع الصيانة
  3. تحديث دفعة — عدّل إعدادات متعددة مرة واحدة باستخدام نموذج التحديث الدفعي. التغييرات تسري فوراً.

الأسئلة الشائعة

ماذا أفعل إذا أظهرت خدمة حالة "متدهور"؟

حالة التدهور تعني أن الخدمة تعمل لكن أداؤها أقل من العتبات الطبيعية. تحقق من صفحة المقاييس للتفاصيل عما هو بطيء (استعلامات قاعدة البيانات، استدعاءات API خارجية، إلخ). إذا استمر التدهور لأكثر من 15 دقيقة، صعّد لفريق الهندسة.

كم مرة تعمل المهام الخلفية؟

فحوصات الاشتراك تعمل كل ساعة. تجميع التحليلات يعمل كل 6 ساعات. فحوصات انتهاء الاعتمادات تعمل يومياً الساعة 2 صباحاً بتوقيت القاهرة. توليد التقارير يعمل وفقاً لجدول كل تقرير المُهيأ.

هل يمكنني استلام تنبيهات عند توقف خدمة؟

مراقبة صحة النظام مُهيأة على مستوى البنية التحتية (فحوصات صحة Cloud Run). مديرو المنصة يرون الحالة على لوحة التحكم. للتنبيه الفوري، استخدم تكامل المنصة مع خدمات المراقبة المُهيأة بواسطة فريق الهندسة.

هل كانت هذه المقالة مفيدة؟