Een cronjob of script monitoren

Houd een back-upscript, cronjob of geplande taak in de gaten door deze bij InfraNest te laten inchecken — dit is voor iedereen die wil weten zodra een routinetaak stilletjes stopt met draaien.

Overzicht

• Een heartbeatmonitor werkt omgekeerd ten opzichte van de meeste checks: in plaats van dat InfraNest contact opneemt met jouw dienst, meldt jouw taak zich telkens bij InfraNest zodra deze klaar is.
• Als die melding niet op tijd binnenkomt, geeft InfraNest een melding af.
• Dit is de beste manier om een taak op te sporen die stilletjes is gestopt met draaien, in plaats van een taak die alleen traag reageert.

Er een instellen

1. Ga naar Monitors en selecteer add a monitor.
2. Kies Heartbeat / Cron monitor als type.

3. Geef het een name die je herkent in een melding — “Nightly database backup” is duidelijker dan “job 1”.
4. Stel het check interval in op hoe vaak de taak hoort te draaien.
5. Stel een grace period in — extra tijd die is toegestaan voordat de taak als te laat wordt beschouwd. Een back-up die meestal vier minuten duurt maar af en toe acht minuten, heeft een respijtperiode nodig die ruim langer is dan die uitloop.
6. Selecteer create monitor.

Je voert voor dit type geen URL in — InfraNest maakt er zelf een aan zodra je opslaat.

Zorg dat jouw taak inchecked

1. Open de monitor om de ping URL te zien, plus een kant-en-klare one-liner om te plakken.
2. Voeg die regel toe aan het einde van je script of cronjob, zodat deze alleen wordt uitgevoerd wanneer de taak daadwerkelijk is geslaagd:

0 3 * * *  /usr/local/bin/backup.sh && curl -fsS -m 10 --retry 3 https://your-infranest-url/api/heartbeat/your-uuid

3. Laat de && staan — dit betekent dat de check-in alleen plaatsvindt als de back-up zelf succesvol is afgerond. Een mislukte taak blijft dan stil, en die stilte is precies wat de melding activeert.
4. Gebruik de knop Kopiëren in plaats van de URL over te typen — de identifier hierin is uniek voor deze monitor.

Wat er daarna gebeurt

• Elke check-in markeert de monitor als Actief en registreert het tijdstip als laatste ping.
• Een gloednieuwe monitor blijft in behandeling totdat het eerste tijdvenster is verstreken, zodat je de tijd hebt om de check-in te koppelen zonder dat je hierover een melding krijgt.
• Als er niets binnenkomt binnen het interval plus de respijtperiode, wordt de monitor Inactief en wordt er een incident geopend, waardoor je gebruikelijke meldingsbestemmingen worden geactiveerd.
• De volgende check-in lost het incident op en laat je weten dat alles weer werkt — je hoeft het niet handmatig te sluiten.

NoteEen heartbeatmonitor pauzeren is veilig: de ping-URL blijft normaal reageren, dus een taak die er nog steeds naartoe belt, gaat geen fouten rapporteren. InfraNest stopt gewoon met controleren totdat je hervat.

TipBehandel de ping-URL als een geheim. Iedereen die deze heeft, kan jouw taak als gezond rapporteren — waardoor een echte storing verborgen zou blijven.

Problemen oplossen

• No ping received yet op de monitor betekent dat InfraNest nog helemaal niets heeft gehoord van de taak. Voer de curl-regel handmatig uit vanaf dezelfde machine: als de monitor daardoor Actief wordt, ligt het probleem in je script, niet hier.
• Als de machine geen uitgaande internetverbinding heeft, kan de check-in niet aankomen — sta uitgaande HTTPS naar InfraNest toe.
• Een monitor die elke nacht op hetzelfde tijdstip een melding geeft, heeft meestal een respijtperiode die korter is dan de werkelijke worstcase-looptijd van de taak.