cpra — CPRA هو نظام مراقبة بنية تحتية عالي الأداء مصمم لفرق المنصات التي تدير بنى الخدمات المصغرة واسعة النطاق. مبني على بنية الكيان-المكوّن-النظام (Entity-Component-System — ECS) ومبادئ نظرية الطوابير، يتعامل CPRA مع أكثر من 1,000,000 فحص صحة متزامن مع توسيع تلقائي لتجمع العمال (worker pool) لتحقيق أهداف SLO. | Kitploit

المقياس	القيمة
أقصى عدد من المراقبين المتزامنين	1,000,000+
الإنتاجية	10,000+ فحص/ثانية/خط أنابيب
زمن الاستجابة (P95)	< 100 مللي ثانية (قابل للتكوين عبر SLO)
الذاكرة لكل مراقب	~100 بايت
إجمالي الذاكرة (1 مليون مراقب)	~100 ميجابايت + تحميل مجموعة العاملين
توسع العاملين	ديناميكي (يعتمد على M/M/c)

# المتطلبات الأساسية: Go 1.25 أو أحدث
go version  # يجب أن يظهر go1.25 أو أعلى

# البناء من المصدر
git clone https://github.com/ziad/cpra.git
cd cpra
go build .

# التشغيل مع إعدادات مثال
./cpra --yaml mock-servers/test_10k.yaml

Starting CPRA Optimized Controller for 1M Monitors
Profiling server listening at http://localhost:6060/debug/pprof/
Loading monitors from mock-servers/test_10k.yaml...
Monitor loading completed in 1.2s
[INFO] Controller started successfully
[INFO] Pulse pipeline processing 10,000 monitors
[INFO] Worker pool scaled to 143 workers (target SLO: 100ms)

استنساخ المستودع:

git clone https://github.com/ziad/cpra.git
cd cpra

تنزيل التبعيات:
```
go mod download
```
بناء التطبيق:
```
go build .
```
التحقق من التثبيت:
```
./cpra --help
```

بناء صورة Docker:

docker build -f docker/Dockerfile -t cpra:latest .

تشغيل الحاوية:

docker run -it --rm \
  -v $(pwd)/my-monitors.yaml:/app/monitors.yaml \
  cpra:latest \
  ./cpra --yaml monitors.yaml

monitors:
  - name: "my-service-health-check"
    pulse_check:
      type: http
      interval: 30s
      timeout: 5s
      max_failures: 3
      config:
        method: GET
        url: http://my-service.example.com/health
        retries: 2
    intervention:
      action: docker
      config:
        container: my-service-container
        action: restart
    codes:
      red:
        dispatch: true
        notify: pagerduty
        config:
          url: https://events.pagerduty.com/v2/enqueue
      yellow:
        dispatch: true
        notify: log
        config:
          file: /var/log/cpra-alerts.log

package main

import (
    "cpra/internal/controller"
)

func main() {
    config := controller.DefaultConfig()

    // وضع التصحيح
    config.Debug = true

    // إعدادات مجموعة العاملين (تنطبق على خطوط الأنابيب الثلاثة)
    config.WorkerConfig.MinWorkers = 10
    config.WorkerConfig.MaxWorkers = 500

    // إعدادات الطابور
    config.QueueCapacity = 131072  // يجب أن يكون قوة 2

    // ضبط الأداء
    config.BatchSize = 2000
    config.SizingServiceTime = 20 * time.Millisecond  // متوسط مدة المهمة
    config.SizingSLO = 100 * time.Millisecond         // زمن الاستجابة المستهدف
    config.SizingHeadroomPct = 0.15                   // 15% حماية أمان

    ctrl := controller.NewController(config)
    // ... باقي التهيئة
}

الخيار	النوع	الافتراضي	الوصف
`--yaml`	string	`internal/loader/replicated_test.yaml`	مسار ملف YAML للمراقبين
`--config`	string	-	مسار ملف الإعدادات (اختياري)
`--debug`	bool	`false`	تفعيل التسجيل على مستوى التصحيح
`--pprof`	bool	`true`	تفعيل خادم ملف تعريف pprof
`--pprof.addr`	string	`localhost:6060`	عنوان استماع خادم pprof

# التشغيل مع تسجيل التصحيح
./cpra --yaml monitors.yaml --debug

# التشغيل مع منفذ pprof مخصص
./cpra --yaml monitors.yaml --pprof.addr localhost:8080

# تعطيل ملف التعريف
./cpra --yaml monitors.yaml --pprof=false

config.SizingServiceTime = 50 * time.Millisecond  // زده إذا استغرقت المهام وقتًا أطول
config.SizingSLO = 200 * time.Millisecond         // خفف SLO إذا لزم الأمر

cpra

الأكثر شعبية

حول

لماذا CPRA؟

الميزات الرئيسية

🚀 قابلية التوسع الهائلة

⚡ أداء عالٍ

🔄 التصحيح التلقائي

🧠 التوسع الذكي

🏗️ بنية موجهة للبيانات

🔧 جاهز للإنتاج

خصائص الأداء

البنية

ثلاثة خطوط أنابيب معالجة مستقلة

بنية الطابور ومجموعة العاملين

البدء السريع

الخيار 1: البناء والتشغيل محليًا

التثبيت

المتطلبات الأساسية

البناء من المصدر

النشر باستخدام Docker

الإعدادات

إعدادات المراقب (YAML)

إعدادات التطبيق

خيارات سطر الأوامر

التوثيق

أدلة شاملة

موارد إضافية

استكشاف الأخطاء وإصلاحها

المشكلات الشائعة

الحصول على المساعدة

المساهمة

الترخيص

الإقرارات