CPRA هو نظام مراقبة بنية تحتية عالي الأداء مصمم لفرق المنصات التي تدير بنى الخدمات المصغرة واسعة النطاق. مبني على بنية الكيان-المكوّن-النظام (Entity-Component-System — ECS) ومبادئ نظرية الطوابير، يتعامل CPRA مع أكثر من 1,000,000 فحص صحة متزامن مع توسيع تلقائي لتجمع العمال (worker pool) لتحقيق أهداف SLO.
Continuous Pulse and Recovery Agent
يفحص الخدمات، ويرسل التنبيهات، وينفذ إجراءات الاستعادة التي تقوم بتكوينها.
CPRa هو وكيل مراقبة واستعادة مستضاف ذاتيًا مكتوب بلغة Go. يشغّل
فحوصات الصحة على خدماتك وفق جدول زمني، ويفتح الحوادث ويغلقها
وفق عتبات قابلة للتكوين، ويرسل الإشعارات، وينفذ إجراء استعادة
— إعادة تشغيل حاوية، أو استدعاء webhook، أو إعادة تشغيل أو توسيع
حمل عمل Kubernetes، أو إعادة تشغيل نسخة EC2، أو إعادة تشغيل وحدة systemd — عندما تفشل
خدمة. يُوزَّع كملف تنفيذي خادم واحد مع لوحة تحكم مدمجة للقراءة فقط،
وواجهة HTTP API، وعميل سطر الأوامر cpractl. مرخّص بموجب MIT.
التوثيق: ziad-hsn.github.io/cpra — البدء السريع · تكوين المراقبة · المشغّلات · واجهة HTTP API · النشر · الأسئلة الشائعة
يتضمن مصدر التوثيق مراجع التطوير الحالية وأدلة مؤرخة صراحةً للمراجعات السابقة. يتم تحديث الموقع المنشور بشكل منفصل. يحدد الإصدارات والتوافر تلك الحدود:
410fbfb
وليست تأهيلًا لإصدار فرع التطوير هذا.تحكم خطة الشحن عملية النشر. لا يثبت توافر المصدر اكتمال التحقق من المزوّد أو التحمل.
يتطلب Go 1.25 أو أحدث، وMake، وPython 3 لمساحة عمل المصدر أدناه. يحتوي المستودع بالفعل على أصول لوحة التحكم المبنية.
ينشئ Make ملف bin/cpra-sdk.work متجاهلًا للتطبيق ووحدات
SDK المحلية الخاصة به، بحيث يمكن بناء مرشح SDK غير المنشور من هذا النسخة المستخرجة.
تبقى وحدة مثال التكامل اختيارية. مسار GOWORK الصريح أو
GOWORK=off له الأولوية؛ لا يغيّر Make أبدًا مساحة العمل الخارجية المحددة.
make
cp examples/monitors.yaml monitors.yaml
# Set the service address in monitors.yaml.
./bin/cpra -yaml monitors.yaml
لأوامر Go المباشرة، حدد مساحة العمل صراحةً بعد make dev-workspace:
GOWORK="$PWD/bin/cpra-sdk.work" go test ./internal/cpractl/cli
تحتفظ إصدارات الإصدار الرسمية بـ GOWORK=off وتتطلب تبعيات
وحدات مؤهلة بشكل منفصل. لا تثبت عمليات بناء مساحة العمل المحلية توافر الوحدة العامة أو جاهزية الإصدار.
الحالة دائمة افتراضيًا في دليل حالة المستخدم الخاص بالمنصة (cpractl local paths)؛ تستخدم خدمات نظام Linux صراحةً /var/lib/cpra. احتفظ بذلك الدليل عبر عمليات إعادة التشغيل. يتجاوز -data-dir الصريح تكوين وقت التشغيل والافتراضي الخاص بالمنصة. يتطلب ./cpra-data القديم مسارًا صريحًا أو ترحيلًا متوقفًا. استخدم -runtime-config examples/runtime-memory.yaml لتشغيل قابل للتخلص منه. يصف الاستمرارية والاستعادة الهويات والنتائج غير المعروفة والنسخ الاحتياطية الكاملة.
افتح http://localhost:8060 باستخدام بيانات اعتماد API المكوّنة. يمكّن
إعداد الإدارة أوامر SDK الحالية مثل
./bin/cpractl get monitors؛ تستخدم تلك الأوامر معرّفات موارد مستقرة. التكوين المفقود أو المشوّه يوقف بدء التشغيل. تتطلب التكوينات الفارغة -allow-empty.
يفحص المثال نقطة نهاية HTTP ويكتب انتقالات الحوادث إلى alerts.jsonl. يمكن لكل مراقب تحديد فاصل الفحص، والمهلة، وعتبة الفشل، وعتبة الاستعادة، ووجهات الإشعارات، وإجراء استعادة. تكبح نوافذ الصيانة التنبيهات والاستعادة بينما تستمر الفحوصات؛ وتستخدم تعبيرات cron من خمسة حقول، ومدة، ومنطقة زمنية IANA.
| الوظيفة | البناء الافتراضي | وسوم البناء الاختيارية |
|---|---|---|
| الفحوصات | HTTP، TCP، ICMP، DNS، UDP، TLS، Docker، إمكانية الوصول إلى منفذ gRPC | redis postgres mysql mongo rabbitmq kafka |
| الاستعادة | Docker، webhook HTTP | kubernetes aws systemd |
| التنبيهات | Log، Slack، PagerDuty، email، webhook، Telegram، Discord، Opsgenie، Mattermost، VictorOps، Pushover، Datadog | teams twilio |
make BUILD_TAGS='redis postgres kubernetes'
يختبر فحص grpc منفذ TCP؛ ولا يستدعي خدمة صحة gRPC. تتطلب فحوصات UDP حمولة وردًا. يتطلب PagerDuty مفتاح توجيه Events API v2. يستخدم البريد الإلكتروني مرحّل SMTP مع STARTTLS؛ ولا يتم تنفيذ مصادقة اسم المستخدم/كلمة المرور لـ SMTP.
ينتج warn_days في TLS تنبيهًا أصفر وحالة مراقب متدهورة دون بدء الاستعادة؛ ويفشل critical_days الفحص ويتبع سياسة الاستعادة العادية. تقبل أولوية الطوارئ في Pushover retry وexpire بالثواني، مع افتراضي 60 و1800. تحافظ استعادة Docker على مهلة الإيقاف اللطيف للخادم عند حذف مهلة الاستعادة.
تتطلب فحوصات MongoDB عنوان URI مباشرًا mongodb://. لا يمكن للمشغّل المحدد تقييد اكتشاف mongodb+srv:// الأولي بموعد الفحص النهائي، لذا يرفض CPRa هذا الوضع. تدعم استعادة Kubernetes بيانات اعتماد الرمز المميز والشهادة وداخل المجموعة؛ ويتم رفض إضافات بيانات اعتماد kubeconfig exec لأنها قد تتجاوز موعد الاستعادة النهائي.
يستمع الخادم على loopback افتراضيًا. تتطلب عناوين الربط الأخرى رمز مصادقة. احتفظ بالرمز في ملف قابل للقراءة من قبل حساب الخدمة:
./bin/cpra -yaml monitors.yaml -web.addr 0.0.0.0:8060 -web.auth-file /run/secrets/cpra-token
./bin/cpractl --server https://monitor.example.com --token-file /run/secrets/cpra-token get monitors
يستخدم تسجيل الدخول عبر المتصفح اسم المستخدم cpra والرمز ككلمة مرور. تقبل واجهة API رمز Bearer. يقرأ الخادم وCLI أيضًا CPRA_AUTH_TOKEN وCPRA_AUTH_TOKEN_FILE. يتطلب الوصول عن بُعد وكيلًا عكسيًا HTTPS؛ ويقدم المستمع المدمج HTTP.
تصرّح البيانات الوصفية بالفحوصات ووجهات الإشعارات وإجراءات الاستعادة بأذونات حساب العملية. استخدم تكوينًا موثوقًا. يحجب -ssrf-protect وجهات HTTP غير العامة في وقت الاتصال؛ ولا يقيّد البروتوكولات الأخرى أو الإجراءات المحلية. التنميط اختياري. احتفظ بملفات الرموز والبيانات الوصفية التي تحتوي على بيانات اعتماد خارج التحكم بالإصدارات.