Health Check

Run a comprehensive health check on the Agent Monitor system.

Input

The user provides: $ARGUMENTS

This may be:

• "full" or empty (default: run all checks)
• "quick" for a fast connectivity check
• "deep" for extended checks including database integrity

Procedure

Run health checks in this order:

1. API Health

curl -sf http://localhost:4820/api/health

• Verify HTTP 200 response
• Check response time (<500ms expected, <1000ms acceptable)
• Confirm JSON response body

2. Database Health

curl -sf http://localhost:4820/api/stats

• Verify stats endpoint returns valid data
• Check that counts are non-negative integers
• Verify database file exists and has reasonable size

3. WebSocket Health

• Check that the WebSocket server is listening
• Verify WebSocket upgrade is supported on the dashboard port

4. API Endpoint Validation

Test each major endpoint:

curl -sf http://localhost:4820/api/sessions?limit=1
curl -sf http://localhost:4820/api/events?limit=1
curl -sf http://localhost:4820/api/analytics
curl -sf http://localhost:4820/api/pricing
curl -sf http://localhost:4820/api/settings/info

5. Hook Integration

• Verify hook handler script exists
• Check hooks are configured in ~/.claude/settings.json
• Verify the handler script targets the correct dashboard URL

6. Disk & Resource Usage (deep mode only)

• Database file size
• Log file sizes (if any)
• Available disk space
• Node.js process memory usage (if accessible)

7. Data Freshness

• Time since last event ingested
• Time since last session created
• Check for stale active sessions (active but no events in >1 hour)

Output Format

Present as a system health dashboard: