Get API key

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:

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:

VariableValue
timestampThe current UTC time in ISO 8601 format, e.g. 2022-07-04T13:31:55+0000.
signatureThe 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

SettingDescription
PublicShows an Online/Offline badge on your public node page, along with your uptime and downtime history.
IntervalHow 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.