Node.js-Anleitung

Verifagent-Heartbeat zu einem Node.js-Skript hinzufügen

Natives fetch reicht. Pingen Sie am Ende eines erfolgreichen Laufs, damit Abstürze und geworfene Fehler nie ein Heartbeat senden.

Bevor Sie beginnen

Erstellen Sie einen Monitor mit der tatsächlichen Frequenz Ihres Workflows und kopieren Sie dann die URL aus dem Dashboard. Der Token ist geheim — veröffentlichen Sie ihn nicht.

Zu verwendendes Modul : fetch (Node 18+). Platzieren Sie es nach der letzten sinnvollen Aktion auf dem Erfolgspfad.

Einrichtung

Monitor-URL kopieren

Erstellen Sie einen Monitor für die Kadenz dieses Jobs. Speichern Sie die URL in VERIFAGENT_URL (oder übergeben Sie sie als Argument).

https://verifagent.com/api/ping/your-ping-token

Nur nach Erfolg pingen

Erfordert Node 18+. Warten Sie auf die echte Arbeit, dann fetch. Nicht-OK-HTTP-Antworten werfen Fehler, damit ein defekter Ping in Logs sichtbar ist.

// Node.js 18+
const PING_URL = process.env.VERIFAGENT_URL;

if (!PING_URL) {
  throw new Error("Missing VERIFAGENT_URL");
}

async function doWork() {
  // Durch Ihren Job ersetzen
}

async function ping() {
  const response = await fetch(PING_URL, { method: "GET" });
  if (!response.ok) {
    throw new Error(`Ping failed: HTTP ${response.status}`);
  }
  const body = await response.json();
  console.log(body); // { ok: true }
}

async function main() {
  await doWork();
  await ping();
}

main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
  // Kein Ping bei Fehler
});

Optionale POST-Variante

GET reicht für einen Heartbeat. POST funktioniert gleich, wenn Sie es bevorzugen.

const response = await fetch(PING_URL, { method: "POST" });
if (!response.ok) throw new Error(`Ping failed: HTTP ${response.status}`);

Einmal ausführen

VERIFAGENT_URL='…' node job.mjs — erwarten Sie { ok: true } und Up im Dashboard.

{"ok":true}

Behalten Sie ping() nach await doWork(). Passen Sie die Periode an den Scheduler an; Kulanz über Cold-Start und Netzwerklatenz für Serverless-Hosts.

Verfügbare Routen

Die Basis-URL reicht für einen Heartbeat. Varianten bereichern den Verlauf, wenn Ihre Plattform mehrere Zweige hat.

GET https://YOUR_PING_URL

POST https://YOUR_PING_URL/success

POST https://YOUR_PING_URL/fail?msg=Error

Prüfen

Erfolgreicher Lauf → Up. Throw vor ping() → kein Signal; Verifagent eröffnet nach Periode + Kulanz einen Vorfall.

Erwartete Antwort: 200 {"ok":true}. Der Monitor wechselt von Pending zu Up.