Vercel Cron überwachen: wissen, ob der Job gelaufen ist

Einrichtung

In drei Schritten eingerichtet

1. Heartbeat anlegen

   Legen Sie im Konto unter „Heartbeats“ einen neuen an, mit dem Rhythmus aus Ihrer vercel.json. Im Hobby-Tarif geben Sie großzügig Spielraum, mindestens zwei Stunden, weil Vercel den Job irgendwann innerhalb der Stunde startet. Sie bekommen eine eigene Ping-Adresse, etwa https://runcheck.de/a8k3m2x9q1.

2. Die Meldung ans Ende der Route

   Öffnen Sie die Route, die in vercel.json unter crons steht, und setzen Sie die Meldung hinter die eigentliche Arbeit, vor die Antwort. Die Prüfung auf CRON_SECRET stammt aus der Vercel-Dokumentation und bleibt, wie sie ist.

   // app/api/cron/route.ts
   import type { NextRequest } from 'next/server';
   
   export async function GET(request: NextRequest) {
     const authHeader = request.headers.get('authorization');
     if (!process.env.CRON_SECRET || authHeader !== `Bearer ${process.env.CRON_SECRET}`) {
       return new Response('Unauthorized', { status: 401 });
     }
   
     // ... Ihre Arbeit ...
   
     await fetch('https://runcheck.de/a8k3m2x9q1', { signal: AbortSignal.timeout(10000) }).catch(() => {});
     return Response.json({ success: true });
   }

3. Veröffentlichen und einmal auslösen

   Vercel ruft Cron Jobs nur für das Production-Deployment auf. Danach lösen Sie den Job im Dashboard in der Zusammenfassung des Deployments von Hand aus, oder in der Kommandozeile mit vercel crons run /api/cron (laut Vercel derzeit Beta). Im Konto bei Cronjob.de springt „Wartet auf die erste Meldung …“ auf Grün.

Die fertigen Zeilen für Linux, PHP, Python, Node.js, n8n, Make, Supabase und Vercel stehen auf der Seite Cronjob überwachen. Ihre eigene Ping-Adresse steht nach dem Anlegen im Konto, mit denselben Zeilen zum Kopieren.

Bei einem Ausfall

Was bei einem Ausfall passiert

Kommt der Aufruf nicht an, scheitert die Arbeit mit einer Ausnahme oder läuft die Funktion in ihre Zeitgrenze, wird die letzte Zeile nie erreicht: Die Meldung bleibt aus. Nach dem Spielraum warnen wir Sie, mit dem nächsten erfolgreichen Lauf kommt die Entwarnung.

FAQ

Häufige Fragen zu Vercel Cron

Wie sieht der Eintrag für einen Cron Job in vercel.json aus?

So, mit dem Pfad Ihrer Route und dem Zeitplan in UTC: { "crons": [ { "path": "/api/cron", "schedule": "0 5 * * *" } ] }

Wie oft darf ein Cron Job bei Vercel laufen?

Laut Vercel im Hobby-Tarif höchstens einmal am Tag; häufigere Ausdrücke scheitern beim Deployment. In Pro und Enterprise geht es bis zu einmal pro Minute (Stand Oktober 2026). Soll eine Route öfter laufen, ohne dass Sie den Tarif wechseln, kann Cronjob.de sie direkt aufrufen: Adresse eintragen, Kopfzeile Authorization: Bearer mit Ihrem CRON_SECRET ergänzen, Zeitplan wählen. Kostenlos geht das im 5-Minuten-Raster, ab Plus jede Minute. Jeder Aufruf zählt bei Vercel dann wie ein gewöhnlicher Funktionsaufruf.

Warum steht vor dem fetch ein await?

Damit die Meldung rausgeht, bevor die Funktion antwortet. Die Meldung heißt dann wirklich: Die Arbeit ist getan. AbortSignal.timeout begrenzt das Warten auf zehn Sekunden, und ein Fehler beim Melden wird ignoriert und stört Ihren Job nicht.

Funktioniert das auch mit dem Pages Router oder einem anderen Framework?

Ja. Die Meldung ist ein gewöhnlicher fetch-Aufruf; fetch und AbortSignal.timeout gehören seit Node.js 18 zum Standard. Wichtig ist nur der Platz: nach der Arbeit, vor der Antwort.