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

   Nach dem nächsten Deployment können Sie den Job im Vercel-Dashboard von Hand starten. 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 in vercel.json aus?

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

Warum await – ginge die Meldung nicht auch so raus?

Eine Vercel Function kann beendet werden, sobald die Antwort draußen ist. Mit await wartet sie die Meldung ab, höchstens zehn Sekunden, und Fehler beim Melden werden ignoriert.

Pages Router oder ein anderes Framework?

Die Meldung ist ein gewöhnlicher fetch-Aufruf und funktioniert in jeder Vercel Function mit Node.js 18 oder neuer. Wichtig ist nur der Platz: nach der Arbeit, vor der Antwort.