Health Dashboard

Health Dashboard

The Health Dashboard provides an at-a-glance view of your KV Manager's operational status, helping you quickly identify issues and monitor system health.

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
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

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.