# مراقبة Cron

Source: https://instatus.com/help/ar/monitoring/cron

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

مثل [المراقبات الأخرى](https://instatus.com/help/ar/monitoring)، عندما تفشل مهمة cron، يمكنك التعاون مع فريقك [لحل الحادثة](https://instatus.com/help/ar/incident-response) وتحديث [صفحة الحالة](https://instatus.com/help/ar/status-page) إن أردت.

| At a glance | Details |
| :-- | :-- |
| [كيف تعمل](https://instatus.com/help/ar/monitoring/cron#نوع-المراقبة) | ترسل مهمتك إشارة إلى رابط فريد في كل تشغيل |
| [الفترة](https://instatus.com/help/ar/monitoring/cron#يُعتبر-المراقبة-ناجحًا-إذا) | عدد مرات تشغيل المهمة المتوقع |
| [مهلة السماح](https://instatus.com/help/ar/monitoring/cron#يُعتبر-المراقبة-ناجحًا-إذا) | وقت إضافي قبل اعتبار المهمة المتأخرة متوقفة |
| [إشارة متأخرة](https://instatus.com/help/ar/monitoring/cron#يُعتبر-المراقبة-ناجحًا-إذا) | متدهورة بعد الفترة، ومتوقفة بعد مهلة السماح |
| [إشارة الفشل](https://instatus.com/help/ar/monitoring/cron#الإشارة-إلى-فشل) | اطلب الرابط مع إضافة /fail إليه |
| [زمن التنفيذ](https://instatus.com/help/ar/monitoring/cron#قياس-زمن-تنفيذ-المهمة) | أرسل إشارة إلى /start عند البدء وإلى الرابط عند الانتهاء |

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

![قائمة مراقبات cron](https://instatus.com/help/monitors/cron-list.png)

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

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

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

![تفاصيل مراقبة cron](https://instatus.com/help/monitors/cron-item.png)

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

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

![إضافة مراقبة](https://instatus.com/help/monitors/cron-add.png)

### نوع المراقبة

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

![نوع مراقبة cron](https://instatus.com/help/monitors/type-cron.png)

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

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

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

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

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

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

يمكنك إعداد [تنبيهات](https://instatus.com/help/ar/monitoring/alerts) لتصلك إشعارات عند فشل مهمة أو تدهورها أو تعافيها.

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

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

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

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

عند استلام إشارة فشل، ستُعتبر المراقبة متوقفة، وستُرسل التنبيهات فورًا وفق [إعدادات التنبيهات](https://instatus.com/help/ar/monitoring/alerts) لديك.

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

أرسل طلبين: `/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 لديك!

- [مراقبات Ping](https://instatus.com/help/ar/monitoring/ping): تعلّم كيفية مراقبة نقاط نهاية ping من حيث مدة التشغيل والأداء