Quickstart

Create a monitor and send your first ping in two minutes.

1. Create a heartbeat monitor

In Monitors → New heartbeat, give it a name and tell Vivere how often the job runs (period) and how late a ping may be before you want to know (grace). A nightly backup that takes ten minutes is period 1d, grace 30m.

2. Ping it when the job finishes

curl -fsS -m 10 --retry 3 https://vivere.dev/p/<monitor-id>

That is the whole integration. The monitor turns Up on the first ping and Vivere now expects one every period.

3. Add an alert channel

Under Channels add your email, a webhook, Slack, Discord, Telegram or ntfy, press Send test, then select the channel on the monitor.

4. Optional: report failures and duration

curl -fsS https://vivere.dev/p/<monitor-id>/start   # before the job
./backup.sh
curl -fsS https://vivere.dev/p/<monitor-id>/$?      # after: 0 = success, anything else = failure

Or let the CLI do all of that and capture the output too:

vivere run --url https://vivere.dev/p/<monitor-id> -- ./backup.sh