Site Health Dashboard

A production-grade site monitoring tool. Monitor multiple websites with comprehensive health checks, beautiful dashboards, and detailed reporting.

Features

Core Monitoring

DNS Resolution - Verify domains resolve correctly
SSL/TLS Certificates - Check expiration, issuer, and security
HTTP Status Codes - Validate expected response codes
Response Times - Monitor performance with configurable thresholds
Security Headers - Analyze HSTS, CSP, X-Frame-Options, etc.
Content Checks - Keyword matching and regex patterns
Redirects - Ensure HTTP→HTTPS redirects work properly
Standard Files - Check robots.txt and sitemap.xml accessibility
Visual Screenshots - Capture homepage screenshots for visual verification

Modern Dashboard

Real-time Progress - Live updates during test execution
Interactive UI - Filter, search, and drill down into results
Dark Neon Theme - Modern Orbitron font with sleek styling
Summary Metrics - Pass rates, response times, trends
History Tracking - View past runs with trend analysis
Multiple Exports - JSON, CSV, and beautiful HTML reports
Screenshot Gallery - View captured homepage screenshots with thumbnails

Reliability & Performance

Async HTTP Requests - Fast concurrent testing with httpx
Retry Logic - Exponential backoff for transient failures
Connection Pooling - Efficient resource usage
Timeout Protection - Never hang the UI
Error Handling - Graceful degradation with clear messages
Windows Compatibility - Automatic subprocess fixes for Python 3.12+

Reporting & Exports

HTML Reports - Portable, stylish standalone files
JSON Export - Machine-readable data for automation
CSV Export - Spreadsheet-compatible format
Trend Charts - Historical performance visualization
Run History - Automatic archival with cleanup

Quick Start

Install & Run -> Windows (Recommended)

Download the installer: SiteHealthDashboard-v2.0-Setup.exe
Run the setup wizard
Double-click the Site Health Dashboard shortcut
The dashboard opens automatically in your browser on port 8501

No need for Python, scripts, or virtual environments. Everything is embedded.

The installer includes:

Embedded Python environment
All required dependencies (Streamlit, httpx, Playwright, etc.)
Chromium browser for screenshots
Default configuration and directory structure

macOS/Linux Setup

cd site-health-dashboard
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
playwright install chromium
streamlit run dashboard.py

CLI Usage

python -m cli run --json results.json --html report.html
python -m cli history --limit 20
python -m cli cleanup --days 7

Configuration Example (sites.yaml)

default:
  timeout_seconds: 10
  max_response_ms: 2000
  min_ssl_days_left: 14
  check_ssl: true
  check_http_to_https_redirect: true
  check_security_headers: true
  check_robots: true
  check_sitemap: true
  check_keyword: true
  check_visual: false
  screenshot_width: 1280
  screenshot_height: 1024
  screenshot_timeout: 30

Live Production Sites

live_sites:
  - url: https://example.com
    expected_status: [200]
    keyword: "Welcome"

  - url: https://api.example.com
    expected_status: [200, 401]
    custom_headers:
      Authorization: "Bearer token"
    check_robots: false
    check_sitemap: false

Staging Sites

staging_sites:
  - url: https://staging.example.com
    expected_status: [200, 401, 403]
    check_visual: true             # Enable screenshots for staging

Per-Site Overrides

sites:
  - url: https://slow-site.com
    max_response_ms: 5000          # Allow slower response
    timeout_seconds: 15            # Longer timeout
    screenshot_timeout: 45         # Longer screenshot timeout

  - url: https://legacy.com
    min_ssl_days_left: 7           # Lower SSL threshold
    check_security_headers: false  # Skip modern header checks
    check_visual: false            # Disable screenshots for this site

Visual Screenshot Configuration

default:
  check_visual: true               # Enable screenshot capture
  screenshot_width: 1920           # Higher resolution
  screenshot_height: 1080
  screenshot_timeout: 45           # Allow more time for slow sites
  keep_screenshots_days: 7         # How long to keep screenshot files
  max_screenshots: 100             # Maximum screenshots to keep per site

Dashboard Features

Run Settings Sidebar

Environment Selection – Choose between Live and Staging sites
Timeouts – Configure request timeouts (2–30 seconds)
Response Time Threshold – Maximum acceptable response time
SSL Days – Minimum days before certificate expiration warning
Check Toggles – Enable/disable specific checks per run
Visual Screenshot Toggle – Enable/disable homepage screenshots

Main Dashboard Tabs

Dashboard

Live Progress – Real-time test execution with smooth progress bars
Summary Metrics – Pass/fail counts, response times, trends
Site Results – Expandable cards with detailed check results
Screenshot Display – View captured homepage images with thumbnails
Filtering – Search by URL, show only failures, etc.

History

Recent Runs – Table of past test executions with environment tracking
Trend Charts – Pass rate and response time over time
Run Details – Click to view historical results

Configuration

Current Settings – View active configuration
Sites Overview – Table of configured sites by environment
Reload Config – Refresh without restarting

Trends

Global Trends – Overall system health over time
Per-Site Analysis – Individual site performance trends
Interactive Charts – Zoom, filter, and explore data

Manage Sites

Add new sites (URL, name, expected status, optional keyword)
Choose between Live and Staging environments
Remove unwanted sites instantly
Changes saved to sites.yaml
Backup saved to sites.bak.yaml

ℹ️ Note: If you don’t see your updated sites in the Dashboard, just switch environments in the sidebar, or go to the Configuration tab and click Reload Config.

Visual Screenshot Features

Automatic Capture – Screenshots taken during test runs when enabled
Thumbnail Generation – Compressed previews for quick viewing
Full-Size Display – Click to view complete screenshots
Date Organization – Screenshots organized by date in folder structure
Automatic Cleanup – Old screenshots removed after configurable period

Screenshot Storage

Screenshot files are stored in a date-organized folder structure:

snapshots/
├── 2025-08-26/
│   ├── example.com_143022.png
│   └── staging.example.com_143045.png
└── thumbnails/
    └── 2025-08-26/
        ├── example.com_143022_thumb.jpg
        └── staging.example.com_143045_thumb.jpg

Other Checks

DNS Resolution – IPv4/IPv6 resolution with timing
SSL/TLS Analysis – Certificate validation, expiration, security
HTTP Checks – Status codes, response times, headers
Security Headers – HSTS, CSP, X-Frame-Options, etc.
Content Validation – Keyword matching and regex patterns

File Structure

site-health-dashboard/
├── dashboard.py              # Streamlit web interface
├── site_checks.py            # Core testing logic with visual integration
├── cli.py                    # Command-line interface
├── models.py                 # Data models and validation
├── sites.yaml                # Configuration file with live/staging separation
├── sites.bak.yaml            # Backup of the configuration file
├── requirements.txt          # Python dependencies including Playwright
├── utils/
│   ├── retry.py              # Retry logic with backoff
│   └── storage.py            # History and export utilities
├── checks/
│   ├── dns.py                # DNS resolution checks
│   ├── ssl.py                # SSL/TLS certificate checks
│   ├── http.py               # HTTP and security checks
│   └── visual.py             # Screenshot capture with Windows fixes
├── snapshots/                # Screenshot storage
│   ├── YYYY-MM-DD/           # Date-organized screenshots
│   └── thumbnails/           # Compressed thumbnail images
└── runs/                     # Historical test results
    ├── run_20241201_143022_live_abc123.json
    └── run_20241201_150045_staging_def456.json

Environment Separation

Configure separate site lists for different environments:

live_sites:
  - url: https://production.com

staging_sites:
  - url: https://staging.com
    check_visual: true  # More visual testing in staging

Reports

Generated reports will be available in the root folder:

site-health-dashboard/
├── site_health_yyyymmdd_ssmmhh.html      # HTML Report example
├── site_health_yyyymmdd_ssmmhh.json      # JSON Report example
├── site_health_yyyymmdd_ssmmhh.csv       # CSV Report example

Closing the Dashboard (Background Process)

When launching the dashboard, the app runs in the background. If you close the browser window, the dashboard still runs in the background and keeps the port (8501) occupied. To shut it down completely, hit Disconnect first. Once confirmed, you're safe to close the tab.

System Requirements

Windows 10+, macOS 10.14+, or Linux
4GB RAM recommended (2GB minimum)
1GB free disk space
Internet connection for dependency installation
Modern browser (Chrome, Firefox, Edge, Safari, Opera/GX, Brave)

What’s New in v2.0

One-Click Windows Installer
GUI for Managing Sites
Visual Screenshot Monitoring
Environment Separation
Secure by Default
Enhanced Dashboard UI
Chromium Integration
Better Error Handling

Ready to monitor your sites with visual verification? Install Site Health Dashboard, run it, and let the automated setup handle everything else!