uptimecheck ✅
Lightweight URL uptime monitor with response time measurement and history tracking.
Commands
Check endpoints
# Check one or more URLs
python3 scripts/uptimecheck.py check https://github.com https://api.example.com
# Check from a file (one URL per line, # comments supported)
python3 scripts/uptimecheck.py check -f urls.txt
# Save results to history for trend analysis
python3 scripts/uptimecheck.py check https://myapi.com --save
# Custom timeout (default 10s)
python3 scripts/uptimecheck.py check https://slow-api.com -t 30
View history
# Recent checks
python3 scripts/uptimecheck.py history
# Filter by URL
python3 scripts/uptimecheck.py history --url github.com
# Last N entries
python3 scripts/uptimecheck.py history -n 100
Output
- ✅ for 2xx-4xx responses (client errors count as "up")
- ❌ for 5xx, timeouts, DNS failures, connection refused
- Response time in milliseconds
- Summary with count of down endpoints
History Storage
Results saved to ~/.uptimecheck/checks.jsonl — one JSON object per line with url, status, ms, ok, timestamp.
Exit Codes
- 0: All endpoints responding
- 1: One or more endpoints down (useful for CI/cron alerting)
