Health Checks
Mark any endpoint as a health check and Wrapd will ping it automatically on a configurable interval. The dashboard shows current status, uptime percentage, and a response time sparkline.
Enabling a health check
Section titled “Enabling a health check”- Open an endpoint in the dashboard
- Click Edit
- Toggle Health check on
- Choose a check interval (30s to 1 hour)
- Save
The health check scheduler will start pinging the endpoint immediately.
How it works
Section titled “How it works”The API process runs a scheduler that calls each health check endpoint at the configured interval through the normal tunnel/agent execution path. The exit code determines status:
- Up: exit code is in the success codes list (default:
0) - Down: exit code is not in the success codes list, or the agent is offline
Results are stored in a health_check_events table and pruned at 1000 events per endpoint.
Dashboard
Section titled “Dashboard”When a health check is enabled, the endpoint detail sidebar shows:
- Status badge: Up, Down, or Unknown
- Uptime %: calculated over the last 24 hours
- Sparkline: response time over the last 50 checks (green = up, red = down)
- Last checked: timestamp of the most recent check
Tier limits
Section titled “Tier limits”| Free | Pro | Team | |
|---|---|---|---|
| Health check endpoints | 1 | 5 | Unlimited |
| Minimum interval | 5 min | 1 min | 30s |
The scheduler enforces the minimum interval for your tier — if you set 30s on a Pro plan, checks will run every 60s.
Combining with alerts
Section titled “Combining with alerts”Use alert rules to get notified when a health check endpoint goes down. Create an alert rule with the consecutive_failures condition to avoid noise from transient issues.