💓 تثبيت Healthchecks — مراقبة مهام Cron والنبضات الحيوية

انشر Healthchecks على Ubuntu بـ Docker — مفتاح رجل ميت ذاتي الاستضافة لمهام cron والمهام المجدولة ينبّهك فور توقف مهمة عن تسجيل حضورها، مع أكثر من 60 تكاملاً للإشعارات.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت آلي — أمر واحد ينشر Healthchecks على المنفذ 8000، جاهز لمراقبة أول مهمة cron لديك خلال دقائق.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/Monitoring/healthchecks/healthchecks-ubuntu.sh
chmod +x healthchecks-ubuntu.sh
sudo bash healthchecks-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/Monitoring/healthchecks/healthchecks-ubuntu.sh

2 منحه صلاحية التنفيذ

chmod +x healthchecks-ubuntu.sh

3 تشغيل المثبّت

يثبّت السكريبت Docker إن لزم، يسحب صورة Healthchecks، ويُشغّل الحاوية مع تخزين دائم لقاعدة بياناتها وإعداداتها.

sudo bash healthchecks-ubuntu.sh

4 الدخول إلى الواجهة

افتح المتصفح وانتقل إلى Healthchecks لإنشاء حسابك وضبط أول فحص لديك:

http://<your-server-ip>:8000

المنافذ المستخدمة

المنفذالغرض
8000HTTP Web Interface & Ping Endpoint

نظرة عامة

Healthchecks خدمة مراقبة مهام cron والنبضات الحيوية مفتوحة المصدر — "مفتاح رجل ميت" لمهامك المجدولة. بدلاً من مراقبة خدمة مباشرة، تُرسل كل مهمة cron أو سكريبت أو مهمة خلفية لديك نبضة (ping) إلى عنوان URL فريد في Healthchecks عند بدئها و/أو اكتمالها بنجاح. إذا لم تصل النبضة المتوقعة خلال فترة مضبوطة، يفترض Healthchecks أن المهمة فشلت أو تعلّقت بصمت أو أن السيرفر الذي تعمل عليه معطل، ويطلق تنبيهاً فورياً عبر أي من أكثر من 60 تكاملاً مدعوماً — بريد إلكتروني، Slack، Discord، PagerDuty، Telegram، webhooks، وغيرها.

لماذا تستخدمه

تراقب أدوات المراقبة التقليدية ما إذا كانت خدمة ما تعمل؛ يراقب Healthchecks ما إذا كانت مهامك المجدولة قد عملت فعلاً واكتملت. سكريبت نسخ احتياطي يفشل بصمت في الثالثة فجراً، أو مهمة cron تُحذف أثناء ترحيل السيرفر، أو مهمة مجدولة تبدأ بالتعلّق إلى ما لا نهاية — كل هذا غير مرئي لأدوات مراقبة التوفر، لكن Healthchecks يرصدها جميعاً لأنه ينبّه عند غياب إشارة متوقعة بدلاً من وجود خطأ. إنها أداة صغيرة ومركّزة تسدّ واحدة من أكثر النقاط العمياء شيوعاً في البنية التحتية ذاتية الاستضافة: فشل مهام cron الصامت.

متى تحتاجه

  • تُشغّل مهام cron أو سكريبتات نسخ احتياطي أو مهام مجدولة وليس لديك وسيلة لمعرفة إن توقفت عن العمل بصمت
  • فشل سكريبت مهم منذ أسابيع ولم يلاحظ أحد حتى فُقدت بيانات أو تلفت
  • تريد تنبيهاً فور عدم تشغيل مهمة مجدولة، وليس فقط عندما تتعطل خدمة
  • تدير عدة سيرفرات وتحتاج مكاناً واحداً للتأكد أن جميع مهامها المجدولة سجّلت حضورها في وقتها
  • تحتاج تكاملاً مع منظومة تنبيهاتك الحالية — Slack، PagerDuty، Discord، بريد إلكتروني، SMS — خاصة لفشل المهام
  • تريد بديلاً خفيفاً وذاتي الاستضافة لخدمات مراقبة cron السحابية المدفوعة حتى لا تغادر بيانات مهامك بنيتك التحتية
  • تحتاج تتبع مهام بجداول غير منتظمة أو معقدة وتريد فترات سماح تدرك تعبيرات cron

حالات الاستخدام الشائعة

  • مراقبة سكريبتات النسخ الاحتياطي الليلية وتلقي تنبيه فوري إذا فشل النسخ الاحتياطي بصمت
  • تتبع مهام صيانة قاعدة البيانات وتدوير السجلات وسكريبتات تجديد الشهادات عبر عدة سيرفرات
  • اكتشاف تعطل السيرفر نفسه، لأن نبضات cron المجدولة منه تتوقف عن الوصول ببساطة
  • تغليف المهام الدفعية طويلة التشغيل بنبضات بدء/نجاح/فشل لرصد الأعطال والمهام المتعلّقة إلى ما لا نهاية معاً
  • مركزة المراقبة لعشرات المهام المجدولة عبر سيرفرات مختلفة في لوحة تحكم واحدة
  • تغذية صحة مهام cron في خط أنابيب تنبيهات قائم عبر تكامل webhook مع أدوات مثل PagerDuty أو Opsgenie

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

  • عنوان نبضة فريد لكل فحص تستدعيه مهام cron أو السكريبتات عبر أمر curl أو wget بسيط
  • فترة متوقعة وفترة سماح قابلة للضبط لكل فحص، مع دعم تعبيرات cron القياسية
  • أكثر من 60 تكاملاً مدمجاً للإشعارات تشمل البريد الإلكتروني وSlack وDiscord وTelegram وPagerDuty وOpsgenie وwebhooks عامة
  • دعم إشارات بدء/نجاح/فشل للتمييز بين حالات "المهمة لم تعمل أبداً" و"المهمة لا تزال تعمل" و"المهمة فشلت"
  • شارات حالة يمكن تضمينها في لوحات التحكم أو الوثائق لعرض حالة الفحص الحية بلمحة
  • صفحات حالة عامة لمشاركة صحة المهام مع فريق أو أصحاب مصلحة دون منحهم وصولاً للوحة التحكم
  • جدولة تدرك المنطقة الزمنية بحيث تحترم فترات السماح وتعبيرات cron الجدول المحلي الفعلي للمهمة
  • واجهة REST API لإنشاء وتحديث والاستعلام عن الفحوصات برمجياً كجزء من سير عمل البنية التحتية ككود

كيفية الاستخدام بعد التثبيت

  • أنشئ حساب المشرف عند أول زيارة لواجهة الويب
  • أنشئ فحصاً جديداً من Checks → Add Check، محدداً فترة متوقعة وفترة سماح للمهمة التي تريد مراقبتها
  • انسخ عنوان النبضة المُولَّد وأضفه لنهاية سكريبت أو مهمة cron الخاصة بك — أمر بسيط مثل curl -fsS ping-url > /dev/null يكفي
  • اضبط قناة إشعار واحدة على الأقل من Integrations — البريد الإلكتروني مفعّل افتراضياً، لكن يُنصح بـ Slack أو Telegram أو webhooks لتنبيهات أسرع
  • اختبر الإعداد بتشغيل سكريبتك يدوياً مرة والتأكد أن الفحص يظهر "Up" (أخضر) في لوحة التحكم
  • استخدم متغيرات نبضة /start و/fail للمهام التي تريد تتبع مدتها أو الإشارة صراحة للفشل من داخل السكريبت
  • أعدّ صفحة حالة عامة إذا أردت مشاركة صحة المهام مع زملائك دون منحهم وصولاً كاملاً للوحة التحكم

أفضل ممارسات الأمان

  • غيّر SECRET_KEY الافتراضي وأي بيانات اعتماد مؤقتة تولّدت أثناء الإعداد قبل كشف النسخة
  • ضع Healthchecks خلف وكيل عكسي مع HTTPS/TLS لأن عناوين النبضات وبيانات تسجيل الدخول يجب ألا تنتقل عبر HTTP عادي أبداً
  • قيّد الوصول للوحة التحكم على شبكات موثوقة أو VPN إذا لم تكن بحاجة لصفحات حالة عامة
  • عامل عناوين النبضات كشبه حساسة — أي شخص يملك عنوان نبضة يمكنه وضع علامة "سليم" على ذلك الفحص، مما يُخفي فشلاً حقيقياً
  • استخدم كلمات مرور قوية وفريدة لحساب المشرف وفعّل المصادقة الثنائية إذا كانت نسختك تدعمها
  • حافظ على تحديث صورة Healthchecks من Docker لتحصل على تصحيحات الأمان
  • قيّد بيانات اعتماد SMTP أو webhooks الصادرة المستخدمة للإشعارات على الحد الأدنى من الصلاحيات المطلوبة

المنافذ وإعدادات جدار الحماية

يكشف هذا النشر واجهة ويب Healthchecks ونقطة نهاية النبضات على المنفذ 8000، الذي يخدم كلاً من لوحة التحكم للبشر والنبضات HTTP الواردة من مهام cron لديك. إذا كانت سيرفراتك المراقَبة بعيدة، يحتاج المنفذ 8000 أن يكون قابلاً للوصول منها لاستقبال النبضات، ما يعني عادة وضعه خلف وكيل عكسي باسم نطاق وTLS بدلاً من كشف المنفذ الخام مباشرة. إذا كانت جميع المهام المراقَبة تعمل على نفس المضيف أو شبكة داخلية، يمكنك إبقاء المنفذ 8000 مقيداً على تلك الشبكة الداخلية أو VPN وتجنّب كشفه علناً تماماً. في كلتا الحالتين، ضع Healthchecks خلف Nginx Proxy Manager أو وكيل عكسي مماثل مع HTTPS إذا كانت أي نبضات ستعبر الإنترنت العام.

النسخ الاحتياطي والصيانة

  • انسخ قاعدة بيانات Healthchecks احتياطياً (ملف SQLite أو قاعدة بيانات PostgreSQL/MySQL حسب إعداداتك) التي تحتفظ بكل الفحوصات وسجل نبضاتها
  • صدّر إعدادات فحوصك (الأسماء والجداول وفترات السماح والتكاملات) دورياً، لأن إعادة إنشاء عشرات الفحوصات يدوياً بعد فقدان البيانات مملة
  • انسخ متغيرات البيئة وSECRET_KEY احتياطياً بشكل منفصل في مدير أسرار، لا في نص عادي بجانب بيانات التطبيق
  • احتفظ بنسخة من docker-compose.yml أو أمر التشغيل لإعادة إنشاء الحاوية بنفس الإعدادات على مضيف جديد
  • اختبر استعادة قاعدة بياناتك على نسخة تجريبية دورياً للتأكد من عودة الفحوصات وسجل النبضات والتكاملات سليمة
  • وثّق أي مهام cron عبر بنيتك التحتية تشير لأي فحص في Healthchecks، لأن عناوين النبضات وحدها لا توثّق ما تراقبه

الأخطاء الشائعة

  • إنشاء فحوصات دون ضبط قناة إشعار فعلية، فتُسجَّل الأعطال بصمت دون تنبيه أحد
  • ضبط فترة سماح قصيرة جداً لمهام ذات زمن تشغيل متغير، مما يسبب إنذارات كاذبة تُدرّبك على تجاهل التنبيهات الحقيقية
  • نسيان تحديث عنوان النبضة في سكريبت بعد إعادة إنشاء فحص، مما يُعطّل المراقبة لتلك المهمة بصمت
  • عدم التمييز بين نبضة بسيطة وإشارة /fail، مما يُفوّت فرصة التنبيه الفوري عند فشل سكريبت بدلاً من انتظار التشغيل المتوقع التالي
  • كشف لوحة التحكم بدون HTTPS، مما يرسل بيانات تسجيل الدخول وتفاصيل الفحوصات بنص عادي
  • مراقبة بدء المهمة فقط دون اكتمالها بنجاح، فمهمة تبدأ ثم تتعلّق لن تُطلق تنبيهاً أبداً
  • الاعتماد على تشغيل Healthchecks نفسه على نفس السيرفر الذي تعمل عليه كل المهام التي يراقبها، فانقطاع السيرفر بالكامل يُعطّل المراقبة أيضاً بصمت

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

  • الفحص يظهر "Down" رغم تشغيل المهمة — تحقق أن عنوان النبضة الدقيق في السكريبت يطابق المعروض في لوحة التحكم، بما في ذلك أي شرطة مائلة زائدة
  • عدم استلام تنبيهات رغم تعطل فحص — تأكد أن تكامل إشعار مضبوط فعلاً واختبره يدوياً من صفحة Integrations
  • فشل طلبات النبضة من مهمة cron — تحقق من اتصال السيرفر الصادر وتأكد أن curl/wget غير محظور بقاعدة جدار ناري صادرة
  • الفحص يتذبذب بين Up وDown — زد فترة السماح قليلاً لاستيعاب التباين الطبيعي في زمن تشغيل المهمة
  • رسائل البريد الإلكتروني لا تصل — تحقق من إعدادات SMTP ضمن إعدادات البيئة وراجع مجلد البريد المزعج قبل افتراض عطل في Healthchecks
  • لوحة التحكم غير قابلة للوصول بعد إعادة التشغيل — راجع سجلات الحاوية بـ docker logs healthchecks بحثاً عن أخطاء بدء التشغيل أو الاتصال بقاعدة البيانات
  • صفحة الحالة لا تُحدَّث — تأكد أن الفحوصات مُخصصة بشكل صحيح لتلك الصفحة ضمن إعداداتها

البدائل

healthchecks.io هي النسخة السحابية المستضافة من نفس هذا المشروع مفتوح المصدر بالضبط، تقدّم نفس الميزات دون عبء صيانة الاستضافة الذاتية، مقابل اشتراك ووجود بيانات مهامك على سيرفر طرف ثالث. Cronitor وDead Man's Snitch بدائل تجارية بلوحات تحكم مصقولة وتكاملات مدمجة أكثر جاهزة، لكن لا يمكن استضافة أي منهما ذاتياً. Uptime Kuma يراقب أساساً ما إذا كانت الخدمات قابلة للوصول وليس ما إذا كانت المهام المجدولة قد اكتملت، فهو يحل مشكلة ذات صلة لكن مختلفة — بعض المستضيفين الذاتيين يُشغّلون الأداتين معاً. كأداة ذاتية الاستضافة ومفتوحة المصدر مصممة خصيصاً لمراقبة cron والنبضات الحيوية، يبقى Healthchecks الخيار الأكثر رسوخاً.

متى لا تستخدمه

Healthchecks ليس مراقب توفر أو خدمة عام — لا يتحقق مما إذا كان موقعك أو واجهتك البرمجية قابلة للوصول، بل فقط ما إذا وصلت إشارة متوقعة في وقتها. لذلك، اقرنه بأداة مثل Uptime Kuma أو Netdata بدلاً من محاولة جعل Healthchecks يقوم بكلتا المهمتين. إذا كان لديك مهمة أو مهمتا cron فقط ولا تريد تشغيل وصيانة حاوية إضافية، فقد تكون الخطة المجانية المستضافة من healthchecks.io أبسط من الاستضافة الذاتية. الفرق التي تحتاج مراقبة أداء تطبيقات عميقة جداً أو تتبعاً موزعاً بجانب مراقبة المهام ستجد Healthchecks ضيقاً عمداً — فهو يقوم بشيء واحد بإتقان لكنه ليس منصة مراقبة شاملة.

هل تحتاج مساعدة احترافية؟

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

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

ما هو Healthchecks وكيف يعمل؟

Healthchecks أداة ذاتية الاستضافة لمراقبة مهام cron والنبضات الحيوية. تُنشئ فحصاً لكل مهمة مجدولة وتضيف عنوان نبضتها الفريد لنهاية المهمة — مثلاً بإضافة curl -fsS https://your-server/ping/your-uuid لأمر cron. إذا لم يستلم Healthchecks تلك النبضة خلال الإطار الزمني المتوقع، ينبّهك بأن المهمة على الأرجح فشلت أو لم تعمل أبداً.

ما المنفذ الذي يستخدمه هذا النشر؟

يقدّم هذا النشر لوحة التحكم ونقطة نهاية النبضات معاً على المنفذ 8000. إذا كانت مهامك المراقَبة تعمل على سيرفرات بعيدة، يحتاج ذلك المنفذ أن يكون قابلاً للوصول منها، عادة عبر وكيل عكسي مع HTTPS بدلاً من كشفه مباشرة.

كم عدد تكاملات الإشعارات التي يدعمها Healthchecks؟

يدعم Healthchecks أكثر من 60 تكاملاً جاهزاً، تشمل البريد الإلكتروني وSlack وDiscord وTelegram وPagerDuty وOpsgenie وMicrosoft Teams وبوابات SMS وwebhooks عامة لأي شيء غير مدعوم أصلاً.

هل يستطيع Healthchecks التمييز بين مهمة فشلت وأخرى لم تعمل أبداً؟

نعم، إذا استخدمت متغير النبضة /fail. النبضة العادية تؤكد فقط أن المهمة سجّلت حضورها؛ إرسال طلب لعنوان /fail يُعلّم صراحة أن هذا التشغيل فشل، مما يُطلق تنبيهاً فورياً بدلاً من انتظار النبضة الفائتة التالية.

هل النسخة ذاتية الاستضافة مطابقة لـ healthchecks.io؟

نعم. healthchecks.io هي النسخة الرسمية المستضافة من نفس قاعدة الكود مفتوحة المصدر التي تنشرها بنفسك. الاستضافة الذاتية تمنحك تحكماً كاملاً في بياناتك وبدون تكلفة اشتراك، مقابل إدارة السيرفر بنفسك.