N8.QuartzDashboard 1.0.0

QuartzDashboard v1.0

A beautiful, self-contained Quartz.NET scheduler dashboard — drop it into any ASP.NET Core app with two lines of code.

What it does

• See all your Quartz jobs, triggers, fire schedules, and currently executing work
• Control the scheduler — start, standby, trigger jobs, pause/resume jobs and triggers
• Track execution history with per-minute bucketed stats and live SVG charts
• Monitor execution rate, average duration, and error trends in real time
• Zero build step — single HTML SPA with Alpine.js + Tailwind CDN

Quick Start

dotnet add package N8.QuartzDashboard

// Program.cs
using QuartzDashboard;

builder.Services.AddQuartz();
builder.Services.AddQuartzHostedService();

builder.Services.AddQuartzDashboard();
// Optional: track fire history with per-minute statistics
builder.Services.AddQuartzDashboardHistory();

var app = builder.Build();
app.UseRouting();
app.UseQuartzDashboard();

app.Run();

Open /quartz in your browser.

Dashboard Pages

Auto-refreshes every 5 seconds. Dark theme, responsive, collapsible sidebar.

API Endpoints

All endpoints under {basePath}/api/ (default: /quartz/api/).

Scheduler

Jobs

Triggers

Runtime

Stats Response

{
  "totalExecutions": 145,
  "uptimeMinutes": 34.2,
  "executionRate": 4.0,
  "executionBuckets": [
    { "minute": "19:05", "count": 4, "avgDurationMs": 850.5, "errorRate": 0.0 },
    { "minute": "19:06", "count": 2, "avgDurationMs": 1200.3, "errorRate": 0.0 }
  ]
}

Configuration

builder.Services.AddQuartzDashboard(options =>
{
    options.Path = "/admin/scheduler";  // default: "/quartz"
});

Architecture

Request → app.Map("/quartz", branch)
          ├── /api/*       → HandleApi (route by path segments)
          ├── /index.html  → Serve embedded SPA (Alpine.js + Tailwind)
          └── anything else → SPA fallback (index.html)

• Backend: Raw ASP.NET Core middleware using app.Map() — zero routing conflicts
• Frontend: Single HTML file (~65KB) with Alpine.js 3.x + Tailwind CSS v4 CDN
• Target frameworks: net8.0, net9.0, net10.0
• Dependencies: Quartz 3.18.0, Quartz.Extensions.DependencyInjection 3.18.0

Demo

cd QuartzDashboard.Demo
dotnet run
# Open http://localhost:5190/quartz

The demo registers 5 jobs with different schedules:

• HealthCheck — every 15s (fast, generates frequent graph data)
• CacheWarmup — every 30s (variable 1-3s duration)
• ReportGeneration — every 2min (long 4-6s duration, visible spikes)
• DataSync — CRON 0/30 * * * * ? (fires at :00 and :30)
• ManualNotification — durable, fire from the dashboard UI

History & Stats

builder.Services.AddQuartzDashboardHistory() registers an IJobListener via an IHostedService that:

1. Records the last 100 fire events in a ConcurrentQueue<FireRecord>
2. Buckets executions per-minute into 120 rolling ExecutionBucket entries
3. Tracks per-bucket: count, total duration, error count
4. Powers the /api/stats endpoint and the SVG execution graph

No external storage — all data is in-memory, ~7KB for 120 buckets.

Changelog

v1.0.0 (2026-05-02)

• Complete UI/UX overhaul: glassmorphism, collapsible sidebar, animations, responsive
• Live execution graph: SVG dual-line chart with zoom toggles and tooltips
• New /api/stats endpoint with per-minute execution buckets
• Schedule descriptions on triggers ("Every 00:00:30", CRON expressions)
• Expandable job rows with inline trigger details
• Live search/filter on jobs and history pages
• Color-coded job borders by state
• Settings panel: refresh interval, per-page auto-refresh
• 5 demo jobs with diverse schedules

v0.3.0 (2026-05-02)

• Fixed routing via app.Map() for Blazor WASM compatibility

v0.2.0 (2026-05-02)

• Raw middleware approach, all endpoints verified

License

MIT — use it, ship it, open-source it.