Health Dashboard

Health Dashboard

The Health Dashboard provides an overview of your KV Manager's operational health, displaying potential issues and system metrics.

Accessing the Health Dashboard

Navigate to the Health tab in the main navigation bar. The dashboard displays live data with 2-minute caching.

Health Score

A 0-100 score calculated based on:

Issue	Penalty
Failed jobs in last 24h	-25
Active threshold breaches	-15
Orphaned metadata (>10%)	-15
Low namespace colors (<50%)	-10
Low backup coverage (<50%)	-10

Score Labels:

• 90-100: Healthy (green)
• 70-89: Good (blue)
• 50-69: Fair (yellow)
• 0-49: Needs Attention (red)

Summary Cards

Namespaces

Total namespaces tracked in the system, with count of those having D1 metadata entries.

Keys Tracked

Total key entries in D1 metadata. Orphaned records (D1 entries for deleted keys) are flagged if detected.

R2 Backups

Total backup count with number of namespaces covered. Shows timestamp of most recent backup.

Recent Jobs

Bulk operations in the last 24 hours, with 7-day total for context.

Alerts

Failed Jobs

Red banner appears when jobs have failed in the last 24 hours. Lists recent failures with:

• Operation type
• Job ID (truncated)
• Error count
• Completion timestamp

Threshold Breaches

If any namespace exceeds its configured limits for storage, latency, or operation rates, a red alert banner will display the active threshold breaches. These are evaluated by an hourly cron job that polls Cloudflare Analytics.

Low Metadata Coverage

Yellow warning for namespaces with few or no tracked keys. Encourages adding D1 metadata for search and tagging features.

Refresh and Caching

• Data is cached for 2 minutes
• Click Refresh to bypass cache and fetch latest data
• Loading spinner indicates data fetch in progress

API Endpoint

GET /api/health

Returns HealthSummary JSON with namespace stats, key counts, backup coverage, job history, and alerts.

Local Development

In local development mode (no production credentials), the dashboard displays mock data for testing.