remote-health

Remote Health Command

Display comprehensive health status of your remote dev environment including containers, resources, connectivity, and recent issues.

📋 TEMPLATE: This command is a template. See "Customization Guide" at the end to adapt for your infrastructure.

Workflow

1. Container Health Check

Check all project services:

# ┌─────────────────────────────────────────────────────────────────────┐
# │ CUSTOMIZE: Replace with your SSH and container details              │
# └─────────────────────────────────────────────────────────────────────┘

ssh -i {{SSH_KEY_PATH}} {{REMOTE_USER}}@{{REMOTE_HOST}} \
  "docker ps --filter name={{PROJECT}} --format 'table {{.Names}}\t{{.Status}}\t{{.State}}'"

Get detailed health status:

ssh -i {{SSH_KEY_PATH}} {{REMOTE_USER}}@{{REMOTE_HOST}} \
  "docker inspect {{CONTAINER_NAME}} --format='{{.Name}}: {{.State.Health.Status}}'"

2. Resource Usage

Check CPU and Memory usage:

ssh -i {{SSH_KEY_PATH}} {{REMOTE_USER}}@{{REMOTE_HOST}} \
  "docker stats --no-stream --format 'table {{.Name}}\t{{.CPUPerc}}\t{{.MemUsage}}'"

Check disk space:

ssh -i {{SSH_KEY_PATH}} {{REMOTE_USER}}@{{REMOTE_HOST}} "df -h / | tail -1"

Check Docker disk usage:

ssh -i {{SSH_KEY_PATH}} {{REMOTE_USER}}@{{REMOTE_HOST}} "docker system df"

3. Application Health Endpoint

Test your app's health endpoint:

# ┌─────────────────────────────────────────────────────────────────────┐
# │ CUSTOMIZE: Replace with your health endpoint URL                    │
# └─────────────────────────────────────────────────────────────────────┘

curl -s -w '\nHTTP Status: %{http_code}\nResponse Time: %{time_total}s\n' \
  http://{{REMOTE_HOST}}:{{APP_PORT}}/api/health

Expected response:

{
  "status": "healthy",
  "timestamp": "2025-10-11T19:35:00.000Z",
  "uptime": 25234.567,
  "environment": "development"
}

4. Database Connectivity

Test PostgreSQL connection: