GlanceWatch Documentation

GlanceWatch provides HTTP endpoints that Uptime Kuma can monitor to track your system's health. When resource usage exceeds your configured thresholds, GlanceWatch returns an HTTP 503 status code, triggering alerts in Uptime Kuma.

GlanceWatch provides several monitoring endpoints. Use these URLs when adding monitors to Uptime Kuma:

Primary Monitoring Endpoint

Individual Metric Endpoints

Health Check Endpoint

Response Format

All endpoints return JSON responses. Example from /status:

{
  "ok": false,
  "ram": {
    "ok": false,
    "value": 85.2,
    "threshold": 80
  },
  "cpu": {
    "ok": true,
    "value": 45.3,
    "threshold": 80
  },
  "disk": {
    "ok": true,
    "threshold": 85,
    "disks": [...]
  },
  "last_check": "2025-11-12T10:30:45.123456"
}

Follow these steps to add GlanceWatch monitoring to Uptime Kuma:

http://localhost:3001

Monitoring Individual Metrics

Instead of monitoring all resources with /status, you can create separate monitors for each metric:

• RAM Monitor: http://localhost:8000/ram
• CPU Monitor: http://localhost:8000/cpu
• Disk Monitor: http://localhost:8000/disk

This gives you more granular control and separate alerts for each resource type.

Adjusting Check Intervals

For production systems:

• Critical systems: 30-60 second intervals
• Standard systems: 60-120 second intervals
• Non-critical systems: 300 second (5 minute) intervals

Remote Monitoring

If GlanceWatch is running on a remote server, replace localhost with the server's IP address or hostname:

http://192.168.1.100:8000/status
http://monitoring.example.com:8000/status

Monitor Shows "Down"

1. Verify GlanceWatch is running: ps aux | grep glancewatch
2. Check if the port is correct (default: 8000)
3. Test the endpoint manually: curl http://localhost:8000/status
4. Check GlanceWatch logs for errors

False Positives (Alerts when system is fine)

1. Adjust thresholds in the GlanceWatch dashboard
2. Increase the retry count in Uptime Kuma (to avoid transient spikes)
3. Verify Glances is running: ps aux | grep glances

Not Receiving Alerts

1. Check notification settings in Uptime Kuma
2. Test notifications using the "Test" button
3. Verify the monitor is set to send notifications
4. Manually trigger an alert by setting a very low threshold (e.g., RAM 1%)

Connection Refused Errors

1. Ensure GlanceWatch is listening on 0.0.0.0 not 127.0.0.1
2. Check firewall rules allow port 8000
3. If using Docker, verify port mappings

For complete API documentation, visit:

Status Codes