قابلية ملاحظة التطبيق

التوفر

واجهة API لقابلية الملاحظة منفّذة جزئيا. مصدران للبيانات مفيدان اليوم:

خط زمني للأحداث يُملأ يدويا وقابل للإلحاق فقط؛ و
تخصيص موارد VM الحالي كما يبلغه libvirt.

التالي معاينات عقد فقط:

تحليلات الطلب تعيد قائمة rollup فارغة لأن ابتلاع سجل الوصول غير شغّال؛
إعداد مسبار التوفر يُحفظ، لكن لا يوجد مجدول يجري فحوص HTTP؛
عينات الموارد فارغة لأن العيّنة غير شغّالة؛ و
بث سجلات التطبيق غير منفّذ.

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

سطح REST الحالي

تقع المسارات تحت /api/app-gateway.

Method	Path	ما تثبته اليوم
`GET`	`/analytics/{slug}?days=7`	العقد قابل للوصول؛ يُتوقع أن تكون `rollups` فارغة.
`PUT`	`/probes/{slug}`	تم التحقق من إعداد المسبار وحفظه.
`GET`	`/probes/{slug}`	يمكن قراءة الإعداد المخزن. حالة وقت التشغيل تبقى غير معيّنة.
`DELETE`	`/probes/{slug}`	أُزيل الإعداد المخزن.
`POST`	`/events/{slug}`	أُلحق حدث قدّمه المستدعي.
`GET`	`/events/{slug}?limit=100`	يمكن قراءة الأحداث المخزنة من الأحدث أولا.
`GET`	`/metrics/{slug}?vm_name={name}`	قد يُعاد التخصيص الحالي؛ `samples` فارغة.

إعداد المسبار


PUT /api/app-gateway/probes/my-app
Content-Type: application/json
 
{
  "path": "/healthz",
  "interval_s": 60,
  "expected_status": 200,
  "timeout_s": 5,
  "enabled": true
}

تبدو القراءة حاليا هكذا:


{
  "config": {
    "path": "/healthz",
    "interval_s": 60,
    "expected_status": 200,
    "timeout_s": 5,
    "enabled": true
  },
  "last_run_at": null,
  "last_status": null,
  "last_http_status": null,
  "consecutive_failures": 0
}

حقول وقت التشغيل null هي الإشارة المهمة: لم يجرِ أي فحص. استخدم مراقبا خارجيا لتنبيه التوفر حتى يُشحن المجدول.

الأحداث

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

عامل بيانات الحدث الوصفية كبيانات قدّمها المستدعي. لا تضع أسرارا فيها.

تخصيص الموارد

يمكن لمسار المقاييس الإبلاغ عن vCPU المعيّنة، والذاكرة، والأقراص عندما يتوفر VM مطابق من libvirt. لا يبلغ بعد عن سلسلة زمنية أو صحة على مستوى التطبيق. التخصيص إعداد سعة، وليس دليلا على أن التطبيق استخدم تلك السعة أو صمد أمامها.

توجيه تشغيلي

حتى تُنشر حلقات الابتلاع والعاملين:

استخدم مراقب HTTP خارجيا للتوفر؛
اجمع سجلات التطبيق بآلية يديرها المشغّل؛
استخدم قياس libvirt أو المضيف للاستخدام الفعلي؛ و
اربط طوابع زمنية وأدلة مصدر بسجلات الحوادث بدلا من الاعتماد على قائمة أحداث المعاينة وحدها.

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