Health Checks
Monitor your Lightning node's uptime with Space health checks: send signed pings from your node and get alerted when they stop.
Health checks are an uptime monitor for your node. Your node sends Amboss a signed ping on a schedule, and Amboss notifies you when the pings stop arriving.
How It Works
Once health checks are enabled, Amboss reports your node as OFFLINE until the first ping arrives, and again whenever a ping is overdue. You choose the interval, between 1 and 60 minutes. If it's set to 60 minutes, you're notified when the last ping is more than 60 minutes old.
Enable Health Checks
Log in to Space with your node.
Open Settings → Monitoring, enable health checks and choose an interval.
Start sending pings from your node:
- LND: enable health checks in ThunderHub.
- CLN: use this script.
- Any node: call the API below, for example with this JavaScript snippet.
Turn on uptime and downtime alerts in Settings → Notifications.
Send a Ping
A ping is a healthCheck mutation on the Space API (https://api.amboss.space/graphql) with two variables:
| Variable | Value |
|---|---|
timestamp | The current UTC time in ISO 8601 format, e.g. 2022-07-04T13:31:55+0000. |
signature | The timestamp signed with your node's message-signing feature (e.g. lncli signmessage). |
mutation HealthCheck($signature: String!, $timestamp: String!) {
healthCheck(signature: $signature, timestamp: $timestamp)
}{
"signature": "SIGNED TIMESTAMP",
"timestamp": "UTC TIME IN ISO FORMAT"
}See Making Requests for how to call the API from cURL, Node.js, or Postman.
Settings
| Setting | Description |
|---|---|
| Public | Shows an Online/Offline badge on your public node page, along with your uptime and downtime history. |
| Interval | How often you ping, from 1 to 60 minutes. Downtime alerts fire when a ping is later than this. |
If you make your node's online status public, consider running a watchtower as well.