الصحة والمقاييس

تعرض خدمات Asset Core نقاط نهاية الصحة للمراقبة ومقاييس Prometheus للرصد.

نظرة عامة

توفر كل من عمليات الكتابة والقراءة للدايمون:

• نقطة النهاية الصحية: حالة JSON لموازني الأحمال والمراقبة
• نقطة نهاية القياسات: قياسات بتنسيق Prometheus للوحة المعلومات والتنبيهات

الهيكل

إرشادات إضافية:

النبرة: رسمية
السجل: تقني

السياق:

• المجال: بنية تحتية للبلوكشين
• الجمهور: مهندسو الأمن وقادة البنية التحتية
• الغرض: وثائق تقنية
• اللغة: ar
• الاتجاه: RTL

القيود:

• استخدام لغة محايدة للجنس
• الحفاظ على أسماء العلامات التجارية
• الحفاظ على الدقة التقنية
• ضمان أن تظل علامات الترقيم والترقيم مناسبة للاتجاه RTL
• الحفاظ على أسماء العلامات التجارية والمصطلحات في القاموس دون ترجمة

الحفاظ على دون ترجمة:

• code_blocks
• inline_code
• الروابط
• glossary_terms
• الملاحظات الرياضية

إرشادات القاموس:

الحفاظ على هذه المصطلحات بالضبط (لا تترجم): Asset Core، Asset‑Core، CSP، API، Docker، ECS، daemon، L1، L2، L3، OpenGraph، GitHub، Astro، TypeScript، JavaScript، ℤ، ℤ²، ℤ³، ℝ²، ℝ³، 0D، 1D، 2D، 3D

نقاط النهاية الصحية

Daemon	Endpoint	Description
Write	GET /v1/health	حالة سجل الالتزام والتأخير
Read	GET /v1/health	حداثة العرض

نقاط نهاية القياسات

دايمون	نقطة النهاية	التنسيق
كتابة	GET /v1/metrics	نص بروميثيوس
قراءة	GET /v1/metrics	نص بروميثيوس

الحقول

كتابة صحة الـ Daemon

{
  "status": "healthy",
  "commit_log": {
    "end_seq": 1000,
    "checkpoint_seq": 1000,
    "lag": 0,
    "driver": {
      "name": "file",
      "path": "/var/lib/assetcore/commit_log.log"
    }
  }
}

الحقل	الوصف
status	صحي أو متدهور
commit_log.end_seq	أحدث تسلسل تم الالتزام به
commit_log.checkpoint_seq	أحدث تسلسل تم التحقق منه
commit_log.lag	الفرق (يجب أن يكون 0 أو قريبًا من 0)

قراءة صحة الـ Daemon

{
  "status": "healthy",
  "freshness": {
    "checkpoint_seq": 998,
    "commit_log_seq": 1000,
    "lag": 2
  }
}

الحقل	الوصف
freshness.checkpoint_seq	التسلسلات المطبقة على الإسقاط
freshness.commit_log_seq	الأحدث في سجل الالتزام
freshness.lag	مدى تأخر عملية القراءة عن الخدمة

المقاييس الرئيسية

كتابة Daemon

المقياس	النوع	الوصف
assetcore_write_requests_total	عداد	إجمالي الطلبات حسب المسار والحالة
assetcore_write_request_duration_seconds	هيستوجرام	زمن استجابة الطلب
assetcore_write_commit_duration_seconds	هيستوجرام	زمن الاستجابة المحدد للالتزام
assetcore_write_ingress_queue_depth	مقياس	العناصر المنتظرة في الطابور
assetcore_write_ingress_inflight	مقياس	الطلبات التي يتم معالجتها
assetcore_write_commit_log_end_seq	مقياس	أحدث تسلسل تم الالتزام به
assetcore_write_commit_log_lag	مقياس	تأخير نقطة التحقق

قراءة Daemon

المقياس	النوع	الوصف
assetcore_read_requests_total	عداد	إجمالي الطلبات حسب المسار
assetcore_read_request_duration_seconds	هيستوجرام	زمن استجابة الطلب
assetcore_read_checkpoint_seq	مقياس	التسلسل المطبق
assetcore_read_freshness_lag	مقياس	الأحداث المتأخرة عن سجل الالتزام
assetcore_read_snapshot_publish_duration_seconds	هيستوجرام	زمن نشر اللقطة

أمثلة

إرشادات إضافية:

النبرة: رسمية السجل: تقني

السياق:

• المجال: بنية تحتية للبلوك تشين
• الجمهور: مهندسو الأمان وقادة البنية التحتية
• الغرض: وثائق تقنية
• اللغة: ar
• الاتجاه: من اليمين إلى اليسار

القيود:

• استخدام لغة محايدة للجنس
• الحفاظ على أسماء العلامات التجارية
• الحفاظ على الدقة التقنية
• ضمان أن تظل علامات الترقيم والترقيم مناسبة من حيث الاتجاه
• الحفاظ على أسماء العلامات التجارية والمصطلحات غير مترجمة

الحفاظ على دون ترجمة:

• code_blocks
• inline_code
• links
• glossary_terms
• mathematical_notation

إرشادات المصطلحات:

الحفاظ على هذه المصطلحات بالضبط (لا تترجم): Asset Core, Asset‑Core, CSP, API, Docker, ECS, daemon, L1, L2, L3, OpenGraph, GitHub, Astro, TypeScript, JavaScript, ℤ, ℤ², ℤ³, ℝ², ℝ³, 0D, 1D, 2D, 3D

تحقق من صحة الكتابة

curl http://localhost:8080/v1/health | jq .

تحقق من حداثة القراءة

curl http://localhost:8081/v1/read/freshness | jq .

مقاييس السحب

أضف إلى تكوين Prometheus الخاص بك:

إرشادات إضافية:

scrape_configs:
  - job_name: 'assetcore-write'
    static_configs:
      - targets: ['localhost:8080']
    metrics_path: '/v1/metrics'

  - job_name: 'assetcore-read'
    static_configs:
      - targets: ['localhost:8081']
    metrics_path: '/v1/metrics'

استعلامات مثال بروميثيوس

Additional guidance:

معدل الطلب:

rate(assetcore_write_requests_total[5m])

زمن الاستجابة P99:

histogram_quantile(0.99, rate(assetcore_write_request_duration_seconds_bucket[5m]))

قراءة تأخير الـ daemon:

assetcore_read_freshness_lag

معدل الخطأ:

rate(assetcore_write_requests_total{status!="200"}[5m])

تنبيهات المثال

groups:
  - name: assetcore
    rules:
      - alert: HighReadLag
        expr: assetcore_read_freshness_lag > 100
        for: 5m
        labels:
          severity: warning
        annotations:
          summary: "Read daemon is behind commit log"

      - alert: WriteQueueFull
        expr: assetcore_write_ingress_queue_depth > 900
        for: 1m
        labels:
          severity: critical
        annotations:
          summary: "Write queue approaching capacity"

المراجع ذات الصلة

• أساسيات النشر - تشغيل العمليات الخلفية
• الانتعاش وإعادة التشغيل - فهم التأخير
• HTTP API - مرجع نقطة النهاية