# Cron monitoring

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

Cron monitory dají každé plánované úloze (záloze, dávkovému procesu nebo opakovanému skriptu) unikátní URL, na kterou úloha pinguje, a upozorní vás, když ping přijde pozdě nebo vůbec. Když úloha zmešká svou periodu, označí se jako zhoršená, a když zmešká i toleranci, jako nedostupná.

Stejně jako u [ostatních monitorů](https://instatus.com/help/cs/monitoring) platí, že když cron úloha selže, můžete [incident vyřešit](https://instatus.com/help/cs/incident-response) společně s týmem a volitelně aktualizovat svou [stavovou stránku](https://instatus.com/help/cs/status-page).

| At a glance | Details |
| :-- | :-- |
| [Jak to funguje](https://instatus.com/help/cs/monitoring/cron#typ-monitoru) | Úloha při každém běhu pingne unikátní URL |
| [Perioda](https://instatus.com/help/cs/monitoring/cron#monitor-je-úspěšný-když) | Jak často má úloha běžet |
| [Tolerance](https://instatus.com/help/cs/monitoring/cron#monitor-je-úspěšný-když) | Čas navíc, než se opožděná úloha označí za nedostupnou |
| [Opožděný ping](https://instatus.com/help/cs/monitoring/cron#monitor-je-úspěšný-když) | Zhoršený po periodě, nedostupný po toleranci |
| [Signál selhání](https://instatus.com/help/cs/monitoring/cron#signalizace-selhání) | Zavolejte URL s připojeným /fail |
| [Doba běhu](https://instatus.com/help/cs/monitoring/cron#měření-doby-běhu-úlohy) | Pingněte /start na začátku úlohy a URL na konci |

Takhle vypadá seznam cron monitorů:

![Seznam cron monitorů](https://instatus.com/help/monitors/cron-list.png)

## Co dělá cron monitor?

- Ověření, že vaše cron úlohy běží včas (podle pingů z úloh).
- Upozornění, když má úloha zpoždění nebo se nedokončí.
- Upozornění přes Slack, e-mail, SMS, telefonát a další kanály.

Když na cron monitor kliknete, uvidíte víc podrobností:

![Podrobnosti cron monitoru](https://instatus.com/help/monitors/cron-item.png)

## Jak přidám cron monitor?

Přejděte do svého projektu → Monitory → Přidat monitor, zvolte **Cron/Heartbeat**, nasměrujte úlohu na vygenerovanou URL a nastavte její periodu a toleranci.

![Přidat monitor](https://instatus.com/help/monitors/cron-add.png)

### Typ monitoru

Jako typ monitoru vyberte **Cron/Heartbeat**.

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

Vygeneruje se pro vás jedinečná URL. Vaše cron úloha by na ni měla při každém běhu poslat HTTP požadavek (`HEAD`, `GET` nebo `POST`).

### Monitor je úspěšný, když

Cron monitor je úspěšný, když vaše úloha pingne vygenerovanou URL podle rozvrhu. Nastavit můžete:

- **Perioda:** jak často má úloha běžet (např. každých 15 minut).
- **Tolerance:** kolik času navíc je povoleno, než se úloha považuje za nedostupnou.

Když uplyne perioda a úloha nepingne, monitor se označí jako zhoršený.

Když uplyne tolerance a úloha nepingne, monitor se označí jako nedostupný.

Můžete si nastavit [upozornění](https://instatus.com/help/cs/monitoring/alerts), která vám dají vědět, když úloha selže, zhorší se nebo se obnoví.

## Signalizace selhání

Pošlete požadavek na URL monitoru s připojeným `/fail` a úloha se označí jako neúspěšná, i když proběhla a monitor pingla.

Hodí se to, když váš skript narazí na chybu a chcete, aby Instatus úlohu hned zaznamenal jako neúspěšnou.

- **Ping úspěchu**: `https://cron.instatus.com/your-unique-url`
- **Ping selhání**: `https://cron.instatus.com/your-unique-url/fail`

Po přijetí signálu o selhání se monitor označí jako nedostupný a okamžitě se rozešlou upozornění podle vašeho [nastavení upozornění](https://instatus.com/help/cs/monitoring/alerts).

## Měření doby běhu úlohy

Pošlete dva požadavky: `/start`, když úloha začíná, a ping úspěchu nebo selhání, když končí. Instatus čas mezi nimi zaznamená jako dobu běhu úlohy:

1. **Signál startu**: pošlete požadavek na `/start`, když úloha začne
2. **Signál úspěchu/selhání**: pošlete požadavek na základní URL, když úloha skončí nebo selže

- **Ping startu**: `https://cron.instatus.com/your-unique-url/start`
- **Ping úspěchu**: `https://cron.instatus.com/your-unique-url`
- **Ping selhání**: `https://cron.instatus.com/your-unique-url/fail`

Čas mezi signálem startu a signálem úspěchu se zaznamená jako doba běhu úlohy. Díky tomu můžete sledovat výkon a odhalit úlohy, které trvají déle, než se čekalo.

Pokud úloha po odeslání signálu startu selže, pošlete místo signálu úspěchu signál selhání — úloha se označí jako neúspěšná a doba běhu se přesto zaznamená.

Gratulujeme, přidali jste svůj první cron monitor!

- [Ping monitory](https://instatus.com/help/cs/monitoring/ping): Naučte se sledovat dostupnost a výkon svých ping endpointů