🇳🇱

Documentatie

Alles wat je nodig hebt om je cron jobs te monitoren in minder dan 60 seconden.

1. Snel Starten

Stap 1: Maak een account aan

Meld je gratis aan — geen creditcard nodig. Je krijgt 3 monitors op het gratis plan.

Stap 2: Maak een check aan

Ga naar je Dashboard en klik op "+ Nieuwe Check". Geef het een naam (bijv. "Nachtelijke backup") en stel het verwachte interval in.

Het interval is hoe vaak je job moet draaien. Als CronPing geen ping ontvangt binnen dat interval, markeert het de check als UITGEVALLEN.

Stap 3: Voeg de ping toe aan je script

Voeg één regel toe aan het einde van je cron job of script:

# At the end of your script:
curl -s https://cronping.newlin.nl/api/ping/YOUR_CHECK_ID

Stap 4: Klaar! 🎉

Dat is alles. Als de ping niet op tijd aankomt, krijg je een melding via e-mail, Slack, Discord, of webhook.

2. Hoe Werkt Het

Je script draait en pingt CronPing

Een simpele HTTP GET request naar je unieke ping URL.

CronPing registreert de ping en reset de timer

Elke ping herstart het aftellen voor het verwachte interval.

Als de ping niet aankomt → alarm

Je krijgt een melding via je geconfigureerde kanalen (e-mail, Slack, Discord, webhook).

Wanneer de ping terugkomt → herstel notificatie

CronPing laat je weten wanneer alles weer normaal is.

3. Integratie Voorbeelden

Bash / Shell script

#!/bin/bash
# Your backup script
tar -czf /backups/db-$(date +%F).tar.gz /var/lib/mysql

# Ping CronPing on success
curl -s https://cronping.newlin.nl/api/ping/YOUR_CHECK_ID

Crontab (direct)

# Run backup daily at 2 AM, then ping CronPing
0 2 * * * /scripts/backup.sh && curl -s https://cronping.newlin.nl/api/ping/YOUR_CHECK_ID

Gebruik van && betekent dat CronPing alleen gepingt wordt als het script slaagt (exit code 0).

Python

import requests

# Your task logic here
do_daily_report()

# Ping CronPing
requests.get("https://cronping.newlin.nl/api/ping/YOUR_CHECK_ID")

Node.js

// After your task completes:
await fetch('https://cronping.newlin.nl/api/ping/YOUR_CHECK_ID');

PHP

// After your task completes:
file_get_contents('https://cronping.newlin.nl/api/ping/YOUR_CHECK_ID');

Docker / Docker Compose healthcheck

healthcheck:
test: ["CMD", "curl", "-sf", "https://cronping.newlin.nl/api/ping/YOUR_CHECK_ID"]
interval: 5m

WordPress (WP-Cron)

// In your theme's functions.php or a plugin:
add_action('my_scheduled_task', function() {
do_my_task();
wp_remote_get('https://cronping.newlin.nl/api/ping/YOUR_CHECK_ID');
});

4. Alert Kanalen

📧 E-mail

Beschikbaar op alle plannen. Alerts gaan standaard naar je account e-mail. Je kunt een apart alert e-mailadres instellen in Instellingen.

💬 Slack

Pro & Business plannen. Voeg je Slack Incoming Webhook URL toe in Instellingen. Alerts verschijnen als rijk opgemaakte berichten met status, duur en links.

🎮 Discord

Pro & Business plannen. Voeg je Discord Webhook URL toe in Instellingen. Alerts verschijnen als embedded berichten met kleurgecodeerde status.

🔗 Webhook

Pro & Business plannen. Ontvang JSON payloads op elke URL. Perfect voor custom integraties, PagerDuty, Telegram bots, etc.

5. API Referentie

Ping een check

GET /api/ping/{checkId}

Geeft 200 OK terug met de check status. Geen authenticatie nodig — de check ID is je geheim.

Lijst checks (API key)

GET /api/checks
Header: Authorization: Bearer YOUR_API_KEY

Geeft alle checks terug met hun huidige status. Vind je API key in Instellingen.

6. Status Badges

Voeg een status badge toe aan je README of status pagina:

![CronPing Status](https://cronping.newlin.nl/api/badge/YOUR_CHECK_ID)


<img src="https://cronping.newlin.nl/api/badge/YOUR_CHECK_ID" alt="Status" />

Badges tonen groen (UP) of rood (DOWN) en updaten in real-time.

7. FAQ

Wat gebeurt er als mijn script faalt?

Als je script faalt en de curl/ping regel niet bereikt, ontvangt CronPing nooit de ping. Nadat het verwachte interval is verstreken, markeert het de check als DOWN en stuurt het je een alert.

Is de ping URL geheim?

Ja. Elke check heeft een unieke UUID die als geheim fungeert. Deel je ping URLs niet publiekelijk. Als het gecompromitteerd is, verwijder de check en maak een nieuwe aan.

Kan ik vanaf meerdere servers monitoren?

Ja! Dezelfde ping URL werkt vanaf overal. Als je dezelfde job op meerdere servers draait, reset elke ping de timer.

Wat is het minimale interval?

Gratis plan: 5 minuten. Pro & Business: 1 minuut.

Ondersteunen jullie runtime tracking?

Ja (Pro & Business). CronPing registreert hoe lang elke job duurt, zodat je prestatie trends kunt zien.

Klaar om te starten?

Stel je eerste monitor in in minder dan 60 seconden.

Start Gratis — Geen Creditcard