asimonson1125.github.io/STATUS_MONITOR_README.md

# Service Status Monitor

## Overview
Server-side monitoring system that checks the availability of asimonson.com services every 2 hours and provides uptime statistics.

## Architecture

### Backend Components

#### 1. `monitor.py` - Service Monitoring Module
- **Purpose**: Performs automated health checks on all services
- **Check Interval**: Every 2 hours (7200 seconds)
- **Services Monitored**:
  - asimonson.com
  - files.asimonson.com
  - git.asimonson.com
  - pass.asimonson.com
  - ssh.asimonson.com

**Features**:
- Tracks response times and HTTP status codes
- Stores check history (up to 720 checks = 60 days of data)
- Calculates uptime percentages for multiple time periods (24h, 7d, 30d, all-time)
- Persists data to `static/json/status_history.json`
- Runs in a background thread

#### 2. `app.py` - Flask Integration
- **New API Endpoint**: `/api/status`
  - Returns current status for all services
  - Includes uptime statistics
  - Provides last check and next check times
- **Auto-start**: Monitoring begins when the Flask app starts

### Frontend Components

#### 1. `templates/status.html` - Status Page Template
- Displays real-time service status
- Shows uptime percentages (24h, 7d, 30d, all-time)
- Displays response times and status codes
- Shows total number of checks performed
- Manual refresh button
- Auto-refreshes every 5 minutes

#### 2. `static/js/status.js` - Frontend Logic
- Fetches status data from `/api/status` API
- Updates UI with service status and uptime
- Handles error states gracefully
- Auto-refresh every 5 minutes

#### 3. `static/css/App.css` - Styling
- Color-coded status indicators:
  - Green: Operational
  - Yellow: Degraded/Timeout
  - Red: Offline
- Responsive grid layout
- Dark theme matching existing site design

## Data Storage

Status history is stored in `src/static/json/status_history.json`:

```json
{
  "last_check": "2026-02-11T14:30:00",
  "services": {
    "main": {
      "name": "asimonson.com",
      "url": "https://asimonson.com",
      "status": "online",
      "response_time": 156,
      "status_code": 200,
      "last_online": "2026-02-11T14:30:00",
      "checks": [
        {
          "timestamp": "2026-02-11T14:30:00",
          "status": "online",
          "response_time": 156,
          "status_code": 200
        }
      ]
    }
  }
}
```

## Status Types

- **online**: HTTP status 2xx-4xx, service responding
- **degraded**: HTTP status 5xx or slow response
- **timeout**: Request exceeded timeout limit (10 seconds)
- **offline**: Unable to reach service
- **unknown**: No checks performed yet

## Uptime Calculation

Uptime percentage = (number of online checks / total checks) × 100

Calculated for:
- Last 24 hours
- Last 7 days
- Last 30 days
- All-time (since monitoring began)

## Usage

### Starting the Server
```bash
cd src
python3 app.py
```

The monitoring will start automatically and perform an initial check immediately, then every 2 hours thereafter.

### Accessing the Status Page
Navigate to: `https://asimonson.com/status`

### API Access
Direct API access: `https://asimonson.com/api/status`

Returns JSON with current status and uptime statistics for all services.

## Configuration

To modify monitoring behavior, edit `src/monitor.py`:

```python
# Change check interval (in seconds)
CHECK_INTERVAL = 7200  # 2 hours

# Modify service list
SERVICES = [
    {
        'id': 'main',
        'name': 'asimonson.com',
        'url': 'https://asimonson.com',
        'timeout': 10  # seconds
    },
    # Add more services here
]
```

## Notes

- First deployment will show limited uptime data until enough checks accumulate
- Historical data is preserved across server restarts
- Maximum 720 checks stored per service (60 days at 2-hour intervals)
- Page auto-refreshes every 5 minutes to show latest server data
- Manual refresh button available for immediate updates
- All checks performed server-side (no client-side CORS issues)