# Cron-monitoring

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

Cron-monitors geven elke geplande taak (een back-up, batchproces of terugkerend script) een unieke URL om te pingen en waarschuwen je wanneer een ping te laat is of uitblijft. De taak wordt als verslechterd gemarkeerd wanneer de periode verstrijkt zonder ping, en als down wanneer ook het respijt verstrijkt.

Net als bij [andere monitors](https://instatus.com/help/nl/monitoring) kun je, wanneer een cron-taak faalt, samen met je team [het incident oplossen](https://instatus.com/help/nl/incident-response) en eventueel je [statuspagina](https://instatus.com/help/nl/status-page) bijwerken.

| At a glance | Details |
| :-- | :-- |
| [Hoe het werkt](https://instatus.com/help/nl/monitoring/cron#type-monitor) | Je taak pingt bij elke run een unieke URL |
| [Periode](https://instatus.com/help/nl/monitoring/cron#de-monitor-slaagt-als) | Hoe vaak de taak moet draaien |
| [Respijt](https://instatus.com/help/nl/monitoring/cron#de-monitor-slaagt-als) | Extra tijd voordat een late taak als down geldt |
| [Late ping](https://instatus.com/help/nl/monitoring/cron#de-monitor-slaagt-als) | Verslechterd na de periode, down na het respijt |
| [Foutsignaal](https://instatus.com/help/nl/monitoring/cron#een-fout-doorgeven) | Vraag de URL op met /fail erachter |
| [Uitvoeringstijd](https://instatus.com/help/nl/monitoring/cron#de-uitvoeringstijd-van-een-taak-meten) | Ping /start bij de start en de URL aan het eind |

Zo ziet je lijst met cron-monitors eruit:

![Lijst met cron-monitors](https://instatus.com/help/monitors/cron-list.png)

## Wat doet een cron-monitor?

- Controleren of je cron-taken op tijd draaien (met pings vanuit je taken).
- Bericht krijgen als een taak te laat is of niet afrondt.
- Meldingen koppelen aan Slack, e-mail, sms, telefoontjes en meer.

Als je op een cron-monitor klikt, zie je meer details:

![Details van een cron-monitor](https://instatus.com/help/monitors/cron-item.png)

## Hoe voeg ik een cron-monitor toe?

Ga naar je project → Monitors → Monitor toevoegen, kies **Cron/Heartbeat**, laat je taak naar de gegenereerde URL wijzen en stel de periode en het respijt in.

![Monitor toevoegen](https://instatus.com/help/monitors/cron-add.png)

### Type monitor

Kies **Cron/Heartbeat** als type monitor.

![Type monitor: cron](https://instatus.com/help/monitors/type-cron.png)

Er wordt een unieke URL voor je aangemaakt. Je cron-taak moet bij elke uitvoering een HTTP-verzoek (`HEAD`, `GET` of `POST`) naar die URL sturen.

### De monitor slaagt als

Een cron-monitor slaagt wanneer je taak de aangemaakte URL volgens schema pingt. Je kunt instellen:

- **Periode:** hoe vaak de taak moet draaien (bijvoorbeeld elke 15 minuten).
- **Respijt:** de extra tijd voordat de taak als down geldt.

Wordt de periode bereikt zonder ping, dan wordt de monitor als verslechterd gemarkeerd.

Wordt het respijt bereikt zonder ping, dan wordt de monitor als down gemarkeerd.

Je kunt [meldingen](https://instatus.com/help/nl/monitoring/alerts) instellen om bericht te krijgen wanneer een taak faalt, verslechtert of herstelt.

## Een fout doorgeven

Stuur een verzoek naar de URL van de monitor met `/fail` erachter om de taak als mislukt te markeren, ook als hij is gedraaid en de monitor heeft gepingd.

Dat is handig wanneer je script een fout tegenkomt en je wilt dat Instatus de taak meteen als mislukt registreert.

- **Ping bij succes**: `https://cron.instatus.com/your-unique-url`
- **Ping bij fout**: `https://cron.instatus.com/your-unique-url/fail`

Zodra er een foutsignaal binnenkomt, wordt de monitor als down gemarkeerd en gaan er meteen meldingen uit volgens je [meldingsinstellingen](https://instatus.com/help/nl/monitoring/alerts).

## De uitvoeringstijd van een taak meten

Stuur twee verzoeken, `/start` wanneer je taak begint en de ping voor succes of falen wanneer hij eindigt; Instatus registreert de tijd daartussen als de uitvoeringstijd van de taak:

1. **Startsignaal**: stuur een verzoek naar `/start` wanneer je taak begint
2. **Succes-/foutsignaal**: stuur een verzoek naar de basis-URL wanneer je taak klaar is of mislukt

- **Ping bij start**: `https://cron.instatus.com/your-unique-url/start`
- **Ping bij succes**: `https://cron.instatus.com/your-unique-url`
- **Ping bij fout**: `https://cron.instatus.com/your-unique-url/fail`

De tijd tussen het start- en het successignaal wordt vastgelegd als de uitvoeringstijd van de taak. Zo houd je de prestaties bij en zie je welke taken langer duren dan verwacht.

Mislukt je taak nadat het startsignaal is verstuurd, stuur dan een foutsignaal in plaats van het successignaal, zodat de taak als mislukt wordt gemarkeerd en de uitvoeringstijd toch wordt vastgelegd.

Gefeliciteerd, je hebt je eerste cron-monitor toegevoegd!

- [Ping-monitors](https://instatus.com/help/nl/monitoring/ping): Leer hoe je je ping-endpoints monitort op uptime en prestaties