08 / 13
Dead-man switch (heartbeat)
External monitoring integration: success ping, fail ping, age gate, disabling
SupaCove integrates with dead-man switches such as healthchecks.io: after
every successful AND fresh backup it pings your URL; production-path failures
ping <url>/fail.
Configuration
In the database's "Schedule & heartbeat" drawer:
- Heartbeat URL: empty inherits the server-wide
SB_HEARTBEAT_URL;-disables explicitly (no success and no fail pings). - Expected period (hours): required when the URL is a real address; with
-(disable) no positive period is demanded (while disabled neither success nor fail pings are sent; a stored period value is NOT zeroed automatically and keeps working once you switch back to a real or inherited URL). When inheriting the fallback URL, success pings still require a positive period. Your external monitor alerts when pings stop for period+grace. - Grace (hours): extra tolerance on the period.
When a success ping fires
- an effective URL exists (per-database or fallback) and is not
-; - the expected period is > 0;
- the time from THIS run's export start (dumpStart) to now is within period + grace — not the completion time, and not a poll of history: a very long successful run may legitimately not ping;
- with a remote destination configured: that backup must be remote-committed (local-only deployments are exempt).
Fail pings bypass the age gate (the failure IS the signal) but still respect
-. Your external monitor's alerting period is configured on the monitor
side; SupaCove only pings.
One URL expresses "this monitor is alive". With several databases sharing the fallback URL, any healthy one refreshes it — configure per-database URLs when you need per-database monitoring.
Last updated