# Cron-valvonta

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

Cron-monitorit antavat jokaiselle ajoitetulle työlle (varmuuskopiolle, eräajolle tai toistuvalle skriptille) yksilöllisen URL-osoitteen pingattavaksi ja hälyttävät, kun ping on myöhässä tai puuttuu. Työ merkitään heikentyneeksi, kun se ohittaa jaksonsa, ja alhaalla olevaksi, kun se ohittaa myös joustoajan.

Kuten [muidenkin monitorien](https://instatus.com/help/fi/monitoring) kohdalla, kun cron-työ epäonnistuu, voit tehdä yhteistyötä tiimisi kanssa [häiriön ratkaisemiseksi](https://instatus.com/help/fi/incident-response) ja halutessasi päivittää [statussivusi](https://instatus.com/help/fi/status-page).

| At a glance | Details |
| :-- | :-- |
| [Miten se toimii](https://instatus.com/help/fi/monitoring/cron#monitorin-tyyppi) | Työsi pingaa yksilöllistä URL-osoitetta joka ajolla |
| [Jakson pituus](https://instatus.com/help/fi/monitoring/cron#monitori-onnistuu-jos) | Kuinka usein työn pitäisi suorittua |
| [Joustoaika](https://instatus.com/help/fi/monitoring/cron#monitori-onnistuu-jos) | Lisäaika ennen kuin myöhäinen työ merkitään alhaalla |
| [Myöhäinen ping](https://instatus.com/help/fi/monitoring/cron#monitori-onnistuu-jos) | Heikentynyt jakson jälkeen, alhaalla joustoajan jälkeen |
| [Epäonnistumissignaali](https://instatus.com/help/fi/monitoring/cron#epäonnistumisen-ilmoittaminen) | Pyydä URL-osoitetta, jonka perässä on /fail |
| [Suoritusaika](https://instatus.com/help/fi/monitoring/cron#työn-suoritusajan-mittaaminen) | Pingaa /start työn alkaessa ja URL-osoitetta lopussa |

Tässä esimerkki siitä, miltä cron-monitorilistasi näyttää:

![Cron-monitorien lista](https://instatus.com/help/monitors/cron-list.png)

## Mitä cron-monitori tekee?

- Varmista, että cron-työsi suorittuvat ajallaan (töiden lähettämien pingien avulla).
- Saat hälytyksen, jos työ on myöhässä tai ei valmistu.
- Yhdistä hälytykset Slackiin, sähköpostiin, tekstiviesteihin, puheluihin ja muihin kanaviin.

Kun napsautat cron-monitoria, näet siitä lisätietoja:

![Cron-monitorin tiedot](https://instatus.com/help/monitors/cron-item.png)

## Miten lisään cron-monitorin?

Siirry projektiisi → Monitorit → Lisää monitori, valitse **Cron/Heartbeat**, ohjaa työsi luotuun URL-osoitteeseen ja määritä sen jakson pituus ja joustoaika.

![Lisää monitori](https://instatus.com/help/monitors/cron-add.png)

### Monitorin tyyppi

Valitse monitorin tyypiksi **Cron/Heartbeat**.

![Cron-monitorin tyyppi](https://instatus.com/help/monitors/type-cron.png)

Sinulle luodaan yksilöllinen URL. Cron-työsi tulee lähettää HTTP-pyyntö (`HEAD`, `GET` tai `POST`) tähän URL-osoitteeseen joka suorituskerralla.

### Monitori onnistuu, jos

Cron-monitori onnistuu, kun työsi pingaa luotua URL-osoitetta aikataulun mukaisesti. Voit määrittää:

- **Jakson pituus:** Kuinka usein työn pitäisi suorittua (esim. 15 minuutin välein).
- **Joustoaika:** Lisäaika, joka sallitaan ennen kuin työ katsotaan alhaalla olevaksi.

Jos jakson pituus täyttyy eikä työ pingaa, monitori merkitään heikentyneeksi.

Jos joustoaika täyttyy eikä työ pingaa, monitori merkitään alhaalla olevaksi.

Voit määrittää [hälytykset](https://instatus.com/help/fi/monitoring/alerts), jotta saat ilmoituksen, kun työ epäonnistuu, heikkenee tai palautuu.

## Epäonnistumisen ilmoittaminen

Lähetä pyyntö monitorin URL-osoitteeseen, jonka perään on lisätty `/fail`, merkitäksesi työn epäonnistuneeksi, vaikka se olisi suoritettu ja pingannut monitoria.

Tämä on hyödyllistä, jos skriptisi kohtaa virheen ja haluat Instatuksen kirjaavan työn epäonnistuneeksi heti.

- **Onnistumisping**: `https://cron.instatus.com/your-unique-url`
- **Epäonnistumisping**: `https://cron.instatus.com/your-unique-url/fail`

Kun epäonnistumissignaali vastaanotetaan, monitori merkitään alhaalla olevaksi ja hälytykset lähetetään välittömästi [hälytysasetustesi](https://instatus.com/help/fi/monitoring/alerts) mukaisesti.

## Työn suoritusajan mittaaminen

Lähetä kaksi pyyntöä, `/start` työn alkaessa ja onnistumis- tai epäonnistumisping sen päättyessä, niin Instatus kirjaa niiden välisen ajan työn suoritusajaksi:

1. **Aloitussignaali**: Lähetä pyyntö osoitteeseen `/start`, kun työsi alkaa
2. **Onnistumis-/epäonnistumissignaali**: Lähetä pyyntö perus-URL-osoitteeseen, kun työsi valmistuu tai epäonnistuu

- **Aloitusping**: `https://cron.instatus.com/your-unique-url/start`
- **Onnistumisping**: `https://cron.instatus.com/your-unique-url`
- **Epäonnistumisping**: `https://cron.instatus.com/your-unique-url/fail`

Aloitus- ja onnistumissignaalien välinen aika kirjataan työn suoritusajaksi. Tämä auttaa sinua seuraamaan suorituskykyä ja tunnistamaan työt, jotka kestävät odotettua kauemmin.

Jos työsi epäonnistuu aloitussignaalin lähettämisen jälkeen, lähetä onnistumissignaalin sijaan epäonnistumissignaali, jolloin työ merkitään epäonnistuneeksi ja suoritusaika kirjataan silti.

Onnittelut, lisäsit ensimmäisen cron-monitorisi!

- [Ping-monitorit](https://instatus.com/help/fi/monitoring/ping): Opi valvomaan ping-päätepisteidesi käyttöaikaa ja suorituskykyä