مراقبة Cron

تمنح مراقبات cron كل مهمة مجدولة (نسخة احتياطية أو معالجة دفعية أو سكربت متكرر) رابطًا فريدًا ترسل إليه إشارة، وتنبّهك عندما تتأخر الإشارة أو تغيب. تُعتبر المهمة متدهورة عندما تفوّت فترتها، ومتوقفة عندما تفوّت مهلة السماح أيضًا.

مثل المراقبات الأخرى، عندما تفشل مهمة cron، يمكنك التعاون مع فريقك لحل الحادثة وتحديث صفحة الحالة إن أردت.

إليك مثالًا على شكل قائمة مراقبات cron لديك:

قائمة مراقبات cron

ما الذي تفعله مراقبة cron؟

  • التحقق من أن مهام cron لديك تعمل في موعدها (عبر إشارات ترسلها مهامك).
  • تلقي تنبيه إذا تأخرت مهمة أو لم تكتمل.
  • التكامل مع Slack والبريد الإلكتروني والرسائل القصيرة والمكالمات الهاتفية وغيرها لتلقي التنبيهات.

عند النقر على مراقبة cron، يمكنك رؤية مزيد من التفاصيل:

تفاصيل مراقبة cron

كيف أضيف مراقبة cron؟

انتقل إلى مشروعك ← المراقبات ← إضافة مراقبة، واختر Cron/نبض، ثم وجّه مهمتك إلى الرابط المُنشأ واضبط فترتها ومهلة السماح.

إضافة مراقبة

نوع المراقبة

اختر Cron/نبض كنوع للمراقبة.

نوع مراقبة cron

سيُنشأ لك رابط فريد. ينبغي أن ترسل مهمة cron لديك طلب HTTP (‏HEAD أو GET أو POST) إلى هذا الرابط في كل مرة تعمل فيها.

يُعتبر المراقبة ناجحًا إذا

تنجح مراقبة cron عندما ترسل مهمتك إشارة إلى الرابط المُنشأ في موعدها. يمكنك ضبط:

  • الفترة: عدد مرات تشغيل المهمة (مثلًا كل ١٥ دقيقة).
  • مهلة السماح: وقت إضافي مسموح به قبل اعتبار المهمة متوقفة.

إذا انقضت الفترة ولم ترسل المهمة إشارة، ستُعتبر المراقبة متدهورة.

وإذا انقضت مهلة السماح ولم ترسل المهمة إشارة، ستُعتبر المراقبة متوقفة.

يمكنك إعداد تنبيهات لتصلك إشعارات عند فشل مهمة أو تدهورها أو تعافيها.

الإشارة إلى فشل

أرسل طلبًا إلى رابط المراقبة مع إضافة /fail إليه لتعليم المهمة كفاشلة، حتى لو كانت قد عملت وأرسلت إشارة إلى المراقبة.

هذا مفيد إذا واجه برنامجك النصي خطأً وأردت أن يسجّل Instatus المهمة كفاشلة فورًا.

  • إشارة النجاح: https://cron.instatus.com/your-unique-url
  • إشارة الفشل: https://cron.instatus.com/your-unique-url/fail

عند استلام إشارة فشل، ستُعتبر المراقبة متوقفة، وستُرسل التنبيهات فورًا وفق إعدادات التنبيهات لديك.

قياس زمن تنفيذ المهمة

أرسل طلبين: /start عند بدء مهمتك، وإشارة النجاح أو الفشل عند انتهائها، وسيسجل Instatus الوقت بينهما كزمن تنفيذ المهمة:

  1. إشارة البدء: أرسل طلبًا إلى /start عند بدء مهمتك
  2. إشارة النجاح/الفشل: أرسل طلبًا إلى الرابط الأساسي عند اكتمال مهمتك أو فشلها
  • إشارة البدء: https://cron.instatus.com/your-unique-url/start
  • إشارة النجاح: https://cron.instatus.com/your-unique-url
  • إشارة الفشل: https://cron.instatus.com/your-unique-url/fail

سيُسجَّل الوقت بين إشارتي البدء والنجاح كزمن تنفيذ المهمة. يساعدك هذا على تتبع الأداء وتحديد المهام التي تستغرق وقتًا أطول من المتوقع.

إذا فشلت مهمتك بعد إرسال إشارة البدء، أرسل إشارة فشل بدلًا من إشارة النجاح لتعليمها كفاشلة مع تسجيل زمن التنفيذ.

تهانينا، لقد أضفت أول مراقبة cron لديك!