VOOZH about

URL: https://www.nuget.org/packages/a2n.Hangfire.Dashboard/

⇱ NuGet Gallery | a2n.Hangfire.Dashboard 2.4.3


ο»Ώ

πŸ‘ Image
a2n.Hangfire.Dashboard 2.4.3

There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package a2n.Hangfire.Dashboard --version 2.4.3
 
 
NuGet\Install-Package a2n.Hangfire.Dashboard -Version 2.4.3
 
 
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="a2n.Hangfire.Dashboard" Version="2.4.3" />
 
 
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="a2n.Hangfire.Dashboard" Version="2.4.3" />
 
Directory.Packages.props
<PackageReference Include="a2n.Hangfire.Dashboard" />
 
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add a2n.Hangfire.Dashboard --version 2.4.3
 
 
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: a2n.Hangfire.Dashboard, 2.4.3"
 
 
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package a2n.Hangfire.Dashboard@2.4.3
 
 
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=a2n.Hangfire.Dashboard&version=2.4.3
 
Install as a Cake Addin
#tool nuget:?package=a2n.Hangfire.Dashboard&version=2.4.3
 
Install as a Cake Tool
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

a2n.Hangfire.Dashboard

A modern, open-source dashboard extension for Hangfire β€” analytics, console logs, tags, and recurring job management built in.

Open source (LGPL-3.0-or-later). Requires Hangfire 1.8+ and ASP.NET Core (.NET 8, 9, or 10). Not officially supported by Hangfire OÜ.

πŸ‘ NuGet
πŸ‘ .NET
πŸ‘ Hangfire


Get Started in 30 Seconds

dotnet add package a2n.Hangfire.Dashboard
// Use in place of app.UseHangfireDashboard():
builder.Services.AddHangfireDashboardUI();
app.UseHangfireDashboardUI("/hangfire");

Navigate to /hangfire. Done.

Authorization: By default, only local requests are allowed (same as the Hangfire dashboard). For remote access, set Authorization = [] or add your own filters. See and for a cookie login example.


πŸš€ What's New in 2.4 β€” Job Builder

Create and schedule jobs with their arguments directly from the dashboard β€” no code change, no redeploy. This closes a long-standing gap: the recurring editor previously built jobs with empty arguments, so parameterized methods couldn't be scheduled correctly (#8).

2.4.3 (patch) β€” UI/UX fixes: the Failed Jobs table no longer hides the "Failed" column behind a horizontal scrollbar when an exception is long (#17); the Create Job method dropdown keeps its Contract/Implementation pill aligned for long names (#18); the Recurring Jobs search no longer drops characters when typing quickly (#19); and the dark theme now persists across navigation and new sessions (#20). See the .

2.4.2 (patch) β€” recurring jobs now accept mixed-case/dotted ids and editable never-fire cron expressions (#11); a client-side filter on the Recurring Jobs page (#13); long job names no longer break the table layout (#12); a duplicate-id guard when creating; and the Audit Log page gains an items-per-page selector and paged navigation. See the .

2.4.1 (patch) β€” searchable method picker; contract-aware resolution so interface/abstract targets keep their class-level [Tag]/[Queue] and display names; fixed editing a recurring job whose method takes an injected parameter (#10); consistent solid-red Delete buttons across all job pages. See the .

Feature What you get
🧩 Guided parameter form A type-aware form generated from the method signature β€” text, numbers, dates, GUIDs, enums, booleans, arrays, and nested objects β€” with a live JSON mirror and a Form ⇄ JSON toggle. β†’
πŸ”Ž Method discovery Pick from methods discovered across loaded assemblies (decorated with JobDisplayName, Tag, or Queue) via a searchable picker that badges each entry as Contract or Implementation, with overload-safe resolution. Hand-typed arbitrary methods are opt-in via AllowArbitraryMethodInvocation. β†’
πŸ•‘ Visual cron builder Build a cron schedule field-by-field (every / specific / range / step) with a human-readable description and next-run preview in the selected time zone β€” or type a cron string manually. β†’
βž• Enqueue page A new /jobs/enqueue page reuses the same builder to fire one-off jobs, not just recurring ones. β†’
✏️ Typed args + edit pre-fill Values are converted to the method's declared types (["report", 42] β†’ string, int); injected parameters (PerformContext, CancellationToken) are skipped; existing argument values are pre-filled when editing. β†’
app.UseHangfireDashboardUI("/hangfire", new DashboardUIOptions
{
 EnableJobManagement = true, // show the recurring create/edit builder and Enqueue page
 AllowArbitraryMethodInvocation = false, // opt-in: allow hand-typed type+method (default false)
});

See Job Builder for the full feature description.


πŸš€ What's New in 2.3.0 β€” Operational Visibility & Controls

The biggest operations-focused release yet. The dashboard goes from a viewer you open when something breaks to a first-class operational tool.

Feature What you get
🩺 Health checks /healthz Β· /healthz/ready Β· /healthz/full endpoints for Kubernetes & load balancers, an ASP.NET Core IHealthCheck adapter, and a traffic-light hero card on the Home page. β†’
⏸️ Queue pause / resume Pause a single queue from the new card-based /queues page. Workers reschedule jobs instead of running them β€” no data loss. β†’
🚧 Maintenance mode One global toggle pauses every queue, with a persistent banner on every page. β†’
πŸ“‹ Audit log Every admin action recorded β€” who, when, what β€” on a new /audit page, attributed to the real signed-in user. β†’
πŸ”— Enhanced Job Details Continuation dependency graph, a retry summary banner, and clickable stack-trace source links (GitHub/GitLab/Azure DevOps/Bitbucket/local IDE). β†’
// Liveness/readiness probes + queue-pause enforcement in one place:
builder.Services.AddHangfire(config => config
 .UseSqlServerStorage(connStr)
 .UseDashboardQueuePauseFilter()); // honour pause toggles on running servers

builder.Services.AddHealthChecks()
 .AddHangfireDashboard(tags: new[] { "ready" }); // unified /health endpoint

See the full for every option and detail.


About

Hangfire ships a capable monitoring UI out of the box. Many teams extend it with community packages for additional dashboard features β€” for example Hangfire.Console, Hangfire.Tags, and Hangfire.RecurringJobAdmin. Dashboard analytics are also available in Hangfire Pro.

a2n.Hangfire.Dashboard combines several of these capabilities in one extension: search, filters, analytics (with optional storage adapters), console viewer, tags, recurring job CRUD, SignalR realtime updates, and theme options β€” while using the same Hangfire job storage and APIs.


Features

Feature Description
Job monitoring Job state pages, batch operations, servers, retries
Recurring jobs Create, edit, start, and stop recurring jobs from the UI, with a client-side id/name filter
Job Builder πŸ†• Create & schedule jobs with typed arguments β€” guided parameter form (+ JSON), method discovery, overload-safe resolution, and one-off enqueue at /jobs/enqueue β€” see Job Builder
Visual cron builder πŸ†• Build cron schedules field-by-field with a human-readable description and next-run preview
Console output Logs, progress bars, and colors (Hangfire.Console-compatible API)
Job tags Tagging and tag cloud (Hangfire.Tags-compatible storage)
Job dependency graph πŸ†• Continuation pipeline visualization on the Job Details page (with "Load more" expansion)
Retry summary πŸ†• Inline banner above state history showing retry count + exception consistency
Stack trace links πŸ†• File references in stack traces become clickable links to GitHub/GitLab/Azure DevOps/Bitbucket/local IDE
Global search Search by job ID, name, queue, tag, or exception text
Advanced filters Filter by date, duration, state, server, and more
Analytics Throughput, latency, failures, queue health (requires storage adapter β€” see Packages)
Health checks πŸ†• /healthz endpoints (liveness, readiness, full report) + at-a-glance hero card on Home β€” see Health Checks
Queue pause / maintenance πŸ†• Pause individual queues or enable global maintenance mode β€” see Operations
Audit log πŸ†• Every admin action recorded (who, when, what) β€” filterable, paged β€” see Operations
Realtime updates Live metrics via SignalR
Authorization Local-only default (same as Hangfire); optional async filters and LoginPath redirect
Theming Dark, light, or auto; responsive layout
Tech Blazor Server, Bootstrap 5, Chart.js

Screenshots

Home & Realtime Charts Console Viewer
Tags & Search Recurring Jobs
Advanced Search Analytics
Light / Dark / Auto

Packages

NuGet package Purpose
a2n.Hangfire.Dashboard Main dashboard UI (search, console, tags, recurring admin)
a2n.Hangfire.Dashboard.SqlServer Storage-specific queries + full analytics for SQL Server
a2n.Hangfire.Dashboard.PostgreSql Storage-specific queries + full analytics for PostgreSQL
a2n.Hangfire.Console Console integration (Hangfire.Console-compatible API)
a2n.Hangfire.Tags Tags integration (Hangfire.Tags-compatible storage)

Without a storage adapter package, search and core dashboard features work; the Analytics pages require a2n.Hangfire.Dashboard.SqlServer or a2n.Hangfire.Dashboard.PostgreSql.


Full Setup

using a2n.Hangfire.Dashboard;
using Hangfire;
using Hangfire.Console; // Hangfire.Console-compatible API (bundled in this package)
using Hangfire.Tags; // Hangfire.Tags-compatible API (bundled in this package)

var builder = WebApplication.CreateBuilder(args);

var connectionString = builder.Configuration.GetConnectionString("Hangfire")
 ?? throw new InvalidOperationException("Connection string 'Hangfire' not found.");

builder.Services.AddHangfire(config => config
 .UseSqlServerStorage(connectionString) // or .UsePostgreSqlStorage(connectionString)
 .UseConsole() // Enable console output
 .UseTags()); // Enable job tagging

builder.Services.AddHangfireServer();

// Basic setup (search works; analytics requires a storage adapter β€” see Packages)
builder.Services.AddHangfireDashboardUI();

// With storage adapter for storage-specific queries + full analytics:
// builder.Services.AddHangfireDashboardUI(options =>
// {
// options.UseSqlServerStorage(connectionString);
// // options.UsePostgreSqlStorage(connectionString);
// });

var app = builder.Build();

app.UseHangfireDashboardUI("/hangfire", new DashboardUIOptions
{
 DashboardTitle = "My Jobs",
 DefaultTheme = "auto", // "auto", "light", or "dark"
 EnableJobManagement = true, // set false to hide Create/Edit/Stop and the Enqueue page
 JobGraphMaxDepth = 5, // continuation graph traversal depth (default 5)
 JobGraphMaxNodes = 30, // continuation graph node budget (default 30)
 // SourceLink = SourceLinkOptions.GitHub("owner/repo"), // clickable stack-trace file links
});

app.Run();

Project Reference (Development Only)

If referencing via <ProjectReference> instead of NuGet, add this to your host .csproj:

<PropertyGroup>
 <RequiresAspNetWebAssets>true</RequiresAspNetWebAssets>
</PropertyGroup>

NuGet consumers don't need this β€” it's handled automatically.


Using with existing Hangfire code

Console & tags compatibility

Already using Hangfire.Console or Hangfire.Tags? You can keep those packages, or switch to the bundled ones β€” job code and storage formats are compatible:

// Works exactly the same
context.WriteLine("Processing order...");
context.WriteProgressBar();

[Tag("orders")]
public void ProcessOrder() { }

Existing DashboardOptions? Still works.

app.UseHangfireDashboardUI("/hangfire", new DashboardOptions
{
 DashboardTitle = "My Jobs",
 Authorization = new[] { new MyAuthFilter() },
});

Data compatibility

Reads the same storage format as Hangfire.Console and Hangfire.Tags. Existing console logs and tags are visible immediately β€” no migration needed.


Job Builder

The Job Builder lets operators construct, schedule, and enqueue Hangfire jobs with their arguments from the dashboard β€” no code change or redeploy. It powers two places:

  • Recurring β€” the Create/Edit recurring job form (/recurring), gated behind EnableJobManagement.
  • Enqueue β€” a new one-off job page at /jobs/enqueue for fire-and-forget jobs, also gated behind EnableJobManagement.

Both share the same method picker, parameter form, and argument conversion, so behavior is identical across the two.

Method discovery & selection

The picker offers two sources:

  • Registered methods β€” discovered by scanning loaded assemblies for public instance/static methods whose method or declaring class carries a recognized attribute (JobDisplayName, Tag, or Queue). Discovery is cached for the dashboard's lifetime and resilient to assemblies that fail to load. Interface and abstract-class contracts are surfaced alongside their concrete implementations, each badged as Contract or Implementation, and the list is searchable by display label, type name, or method name.
  • Custom methods β€” a full type name + method name typed by hand, validated on demand. This is opt-in and disabled by default:
app.UseHangfireDashboardUI("/hangfire", new DashboardUIOptions
{
 AllowArbitraryMethodInvocation = true, // default false β€” keeps arbitrary invocation opt-in
});

Resolution is overload-safe: when a method name has multiple overloads, the single overload whose parameter count and types match the supplied arguments is selected. Ambiguous, missing, or non-matching methods are rejected with an identifying error and never touch storage.

Parameter form

A type-aware form is generated from the method signature, one control per parameter:

Parameter type Control
string text input
integers / floats number input (whole vs. fractional, range-checked)
DateOnly / TimeOnly / DateTime / DateTimeOffset date / time / datetime-local picker
Guid text input
bool / bool? checkbox / tri-state (unset = null)
enum / [Flags] enum single-select / multi-select
scalar arrays (T[]) add/remove list
nested object (class, depth ≀ 5) collapsed placeholder + explicit "Add" to instantiate
anything else / depth > 5 JSON textarea

Key behaviors:

  • Form ⇄ JSON toggle β€” switch to a raw ["value", 42] JSON textarea at any time; the form and JSON stay in sync (a read-only JSON mirror is shown alongside the form).
  • Typed conversion β€” values are converted to each parameter's declared CLR type before the job is stored, matching how Hangfire serializes arguments.
  • Injected parameters skipped β€” PerformContext, IJobCancellationToken, and CancellationToken are excluded from the form and filled by Hangfire at runtime.
  • Empty fields are total β€” a blank field resolves to null for nullable types or default(T) for non-nullable types, never an error.
  • Edit pre-fill β€” when editing an existing recurring job, current argument values are loaded back into the form.

Schedule builder (recurring only)

For recurring jobs, the Schedule Builder offers a field-by-field cron editor (minute, hour, day-of-month, month, day-of-week) with an Every / Specific / Range / Step mode per field, plus a manual cron input. It shows a human-readable description and the next occurrence in the selected time zone (UTC when none is chosen). Unparseable expressions are flagged and block submission. (Cron parsing uses Cronos, already bundled with Hangfire β€” no new dependency.)

Queue handling

The queue control is editable with suggestions from current queues (defaulting to default). When the target method or its declaring class carries a [Queue(...)] attribute, the control becomes read-only and shows a precedence notice, because Hangfire's QueueAttribute overrides the stored queue at state election.

Gating

  • Read-only mode (IsReadOnly = true) β€” a persistent banner is shown and the submit controls are disabled.
  • Job management (EnableJobManagement = false) β€” the recurring create/edit builder is hidden, the navigation no longer links to the Enqueue page, and the /jobs/enqueue route returns Not Found (read-only gating still applies). Defaults to true.
  • Arbitrary methods (AllowArbitraryMethodInvocation = false, default) β€” only discovered registered methods may be selected.

Job Dependency Graph

The Job Details page includes a continuation visualization for jobs created via BackgroundJob.ContinueJobWith(...). The graph walks up to the root parent (via the Awaiting state's ParentId), then expands all descendants by parsing each job's Continuations parameter. Edge labels show the continuation condition (on succeeded, on deleted, on any).

The card only appears when a job is part of a continuation chain β€” standalone jobs render nothing. Each node is clickable and navigates to that job's details. Expired or deleted jobs render as dashed placeholders so the graph stays consistent.

Traversal is bounded by two options to keep page loads fast:

Option Default Description
JobGraphMaxDepth 5 Maximum hops in either direction (ancestors or descendants)
JobGraphMaxNodes 30 Maximum total nodes materialized

When either limit is hit, the card shows a truncated badge and a Load more button that doubles the node budget and adds depth (+3) on each click, up to a hard ceiling of 200 nodes / depth 12. Each click triggers exactly one storage round-trip per newly visited node, so expansion is incremental.


Stack Trace Source Links

When a job fails, the Job Details page shows the exception stack trace. By default the stack trace is plain text. Set DashboardUIOptions.SourceLink to turn ... in {path}:line {N} references into clickable links pointing to your source provider:

app.UseHangfireDashboardUI("/hangfire", new DashboardUIOptions
{
 DashboardTitle = "My Jobs",
 SourceLink = SourceLinkOptions.GitHub("anwarminarso/a2n.Hangfire.Dashboard", branch: "main"),
});

Built-in presets

SourceLinkOptions.GitHub("owner/repo"); // github.com
SourceLinkOptions.GitLab("group/repo"); // gitlab.com
SourceLinkOptions.GitLab("group/repo", host: "git.mycompany.com"); // self-hosted GitLab
SourceLinkOptions.AzureDevOps("org", "project", "repo"); // dev.azure.com
SourceLinkOptions.Bitbucket("workspace/repo"); // bitbucket.org
SourceLinkOptions.Local(); // vscode://file/{path}:{line}
SourceLinkOptions.Local(protocol: "vscode-insiders"); // VS Code Insiders
SourceLinkOptions.Local(protocol: "cursor"); // Cursor

Self-hosted / proprietary providers

Use UrlPattern directly with {path} and {line} placeholders:

SourceLink = new SourceLinkOptions
{
 UrlPattern = "https://gitea.mycompany.com/team/repo/src/branch/main/{path}#L{line}",
};

Visual Studio (Windows)

Visual Studio does not ship with a built-in URL protocol handler. To enable links that open files in Visual Studio, install a third-party handler such as VsHandler and configure:

SourceLink = new SourceLinkOptions
{
 UrlPattern = "vs://open?File={absolutePath}&Line={line}",
};

For VS Code (cross-platform), the built-in Local() preset works out of the box.

Path normalization

Stack traces often contain absolute paths from the build agent (e.g. C:\jenkins\workspace\proj\src\Foo.cs) that don't match the repository layout. Use WithPathStrip("src") to strip everything before the /src/ segment:

SourceLink = SourceLinkOptions.GitHub("owner/repo")
 .WithPathStrip("src");
// "C:\jenkins\workspace\proj\src\Models\Order.cs" β†’ "src/Models/Order.cs"

For more complex transforms, use WithPathReplace(pattern, replacement) (regex) or set PathTransform to a custom Func<string, string>.

Privacy note

Linked URLs only work when the viewer has access to the source provider. Private repositories return 404 to unauthenticated users. The dashboard does not embed source content β€” it only generates outbound links.


Health Checks

The dashboard exposes a structured health endpoint suitable for Kubernetes probes, load balancer health checks, and status pages.

Endpoint Use case Checks
GET /{dashboard}/healthz Liveness probe (K8s) Storage probe
GET /{dashboard}/healthz/ready Readiness probe (K8s) Storage + servers
GET /{dashboard}/healthz/full Status pages, dashboard hero card All six checks below

HTTP status follows the K8s convention: 200 for Healthy or Degraded, 503 for Unhealthy.

Built-in checks

Key What it covers
storage Round-trip time of a GetStatistics() call to the Hangfire storage backend
servers Total vs alive vs stale heartbeat (per ServerHeartbeatTolerance)
queue_depth Highest queue length compared to warn/critical thresholds
stuck_processing Processing jobs older than StuckProcessingMinutes (sample size: 200)
failure_rate Last-hour failure percentage from Hangfire's hourly counters
recurring_jobs Recurring jobs whose NextExecution is older than RecurringMissedTolerance

Sample response (/hangfire/healthz/full)

{
 "status": "Degraded",
 "version": "2.3.1",
 "timestamp": "2026-06-07T01:08:18.96Z",
 "durationMs": 50,
 "checks": {
 "storage": { "status": "Healthy", "data": { "responseTimeMs": 3 } },
 "servers": { "status": "Degraded", "description": "1 of 2 server(s) have stale heartbeats." },
 "queue_depth": { "status": "Healthy", "data": { "maxDepth": 0 } },
 "stuck_processing": { "status": "Healthy", "data": { "stuckCount": 0, "totalProcessing": 0 } },
 "failure_rate": { "status": "Degraded", "description": "Failure rate 20.0% in last hour (warn threshold 10%)." },
 "recurring_jobs": { "status": "Healthy", "data": { "total": 7, "missed": 0 } }
 }
}

Configuration

app.UseHangfireDashboardUI("/hangfire", new DashboardUIOptions
{
 // AllowAnonymous (default) so K8s/LB probes work without auth.
 // Use LocalOnly for loopback-only probes, or RequireDashboardAuth for the full filter chain.
 HealthCheckAuthorizationMode = HealthCheckAuthorization.AllowAnonymous,

 HealthCheckThresholds = new HealthThresholds
 {
 StuckProcessingMinutes = 30,
 QueueDepthWarn = 1000,
 QueueDepthCritical = 10000,
 FailureRatePercent = 10.0, // Degraded threshold
 FailureRateCritical = 25.0, // Unhealthy threshold
 RecurringMissedTolerance = TimeSpan.FromMinutes(5),
 ServerHeartbeatTolerance = TimeSpan.FromSeconds(60),
 StorageResponseTimeWarnMs = 1000,
 StorageResponseTimeCriticalMs = 5000,
 }
});

Plug into ASP.NET Core HealthChecks

If your host already exposes a unified /health endpoint aggregating multiple dependencies (database, message broker, Hangfire, ...), register the dashboard as an IHealthCheck:

builder.Services.AddHealthChecks()
 .AddHangfireDashboard(tags: new[] { "ready" });

app.MapHealthChecks("/health"); // all checks
app.MapHealthChecks("/health/ready", // readiness subset
 new() { Predicate = c => c.Tags.Contains("ready") });

The adapter reuses the same HealthCheckService.CheckFull() so results match what the dashboard's own endpoint and hero card show.

Hero card

The Home page shows a top-of-page traffic light (Healthy / Degraded / Critical) with per-issue descriptions and deep-link actions ("View processing β†’", "View failed β†’"). Auto-refreshes every 10 seconds. The detailed 8-card stat grid is now collapsed behind a "Detailed metrics" toggle to keep the hero front-and-center.


Operations

The dashboard ships day-to-day operational controls so ops teams don't need to redeploy or write SQL to handle common scenarios.

Queue pause / resume

The /queues page lists every queue with its current status and a per-row pause toggle. Paused queues stop workers from executing jobs β€” the dashboard's server filter intercepts each fetched job and reschedules it back into the future (default +30s) instead of running it.

// Required: register the server filter on the Hangfire pipeline so running servers
// honour the pause toggles set from the dashboard.
builder.Services.AddHangfire(config => config
 .UseSqlServerStorage(connStr)
 .UseDashboardQueuePauseFilter()); // <-- here

Without this call, the dashboard still records the pause and shows the badge β€” but jobs keep executing on running workers until the host restarts with the filter enabled.

Customize behaviour via DashboardUIOptions.QueueOperations:

QueueOperations = new QueueOperationsOptions
{
 Enabled = true,
 Behavior = PausedJobBehavior.Reschedule, // or Requeue (busy-loop, use sparingly)
 RescheduleDelay = TimeSpan.FromSeconds(30),
 PauseStateCacheTtl = TimeSpan.FromSeconds(2), // server-side cache window
}

Maintenance mode

A single global toggle (top of the /queues page) pauses every queue at once. While maintenance is active, a persistent yellow banner is rendered on every dashboard page with the operator's reason and a Manage β†’ link. Disable maintenance to resume β€” individual queue pauses set before maintenance was enabled remain in effect.

Audit log

Every admin action performed through the dashboard is recorded:

Category Actions
Job actions requeue, delete, batch requeue, batch delete
Recurring create, update, delete, trigger, stop, start
Queue ops queue pause, queue resume, maintenance enabled, maintenance disabled

Each entry captures: timestamp (UTC), user (or (anonymous) for unauthenticated local requests), client IP, action, target, optional reason, and a small metadata bag (e.g., batch counts).

The /audit page filters by action prefix (job/jobs/recurring/queue/maintenance), user (substring), and target, with an items-per-page selector and paged navigation. Storage uses Hangfire's KV primitives β€” no schema changes. Configurable retention:

AuditLog = new AuditLogOptions
{
 Enabled = true,
 Retention = TimeSpan.FromDays(30),
 MaxEntries = 10_000,
}

Old entries beyond either bound are trimmed on writes (best-effort, ~every 50 entries).


Tech Stack

Layer Technology
UI Blazor Server (Interactive SSR)
Styling Bootstrap 5.3 + Bootstrap Icons
Charts Chart.js + chartjs-plugin-streaming
Realtime ASP.NET Core SignalR
Theme data-bs-theme + localStorage persistence
Targets .NET 8, .NET 9, .NET 10

Project Structure

src/
β”œβ”€β”€ a2n.Hangfire.Dashboard/ # Main dashboard (Blazor + SignalR + Analytics)
β”œβ”€β”€ a2n.Hangfire.Dashboard.SqlServer/ # SQL Server adapter (Dapper + T-SQL)
β”œβ”€β”€ a2n.Hangfire.Dashboard.PostgreSql/ # PostgreSQL adapter (Dapper + Npgsql)
β”œβ”€β”€ a2n.Hangfire.Console/ # Console integration (Hangfire.Console-compatible)
└── a2n.Hangfire.Tags/ # Tags integration (Hangfire.Tags-compatible)

tests/
β”œβ”€β”€ a2n.Hangfire.Dashboard.Tests/
β”œβ”€β”€ a2n.Hangfire.Console.Tests/
└── a2n.Hangfire.Dashboard.PostgreSql.Tests/

samples/
β”œβ”€β”€ SampleApp/ # Full demo (all features)
β”œβ”€β”€ SampleAppAuth/ # Cookie authentication example
β”œβ”€β”€ SampleAppMvc/ # ASP.NET Core MVC host
β”œβ”€β”€ SampleAppRazor/ # Razor Pages host
β”œβ”€β”€ SampleAppBlazor/ # Blazor host
└── SampleAppOrig/ # Startup-class host pattern

Running the Sample

git clone https://github.com/anwarminarso/a2n.Hangfire.Dashboard.git
cd a2n.Hangfire.Dashboard/samples/SampleApp
dotnet run

Open https://localhost:7100/hangfire to see it in action.

For authentication with a login page, run samples/SampleAppAuth instead.


Roadmap

Version Status Scope
v1.0 βœ… Done Core dashboard pages + Console + Tags + Recurring Admin
v1.1 βœ… Done Global search & advanced filters
v1.2 βœ… Done Razor Class Library (NuGet-ready)
v1.3–v1.6 βœ… Done Storage adapters (SQL Server, PostgreSQL) + Analytics dashboard
v2.0 βœ… Done Feature-complete for current scope
v2.1 βœ… Done Search refactor + JobDisplayName + SQL Server fixes
v2.1.1 βœ… Done WebSocket fix for Startup-pattern host apps
v2.2 βœ… Done Processing progress circle, Fetched page, delete confirmations, mobile nav fix
v2.2.1 βœ… Done Security & auth hardening, default auth filter, LoginPath, SignalR/Blazor auth
v2.3.0 βœ… Done Operational visibility & controls β€” health checks (/healthz + IHealthCheck adapter) & hero card, queue pause/resume, maintenance mode, audit log
v2.3.1 βœ… Done Realtime analytics fixes β€” SQL Server GROUP BY (error 144) fix, fixed-cadence broadcast loop, NuGet XML docs
v2.4.0 βœ… Done Job Builder β€” create/schedule jobs with typed arguments, guided parameter form (+ JSON), method discovery, overload-safe resolution, visual cron builder, one-off enqueue page (#8)
v2.4.1 βœ… Done Job Builder follow-up β€” searchable method picker, contract-aware (interface/abstract) resolution + display names, injected-parameter edit fix (#10), consistent destructive-action buttons
v2.5.0 Planned Notifications & alert rules β€” Slack/Teams/Discord/webhook/email channels, 8 trigger types, cooldown, rule editor + history
v2.6.0 Planned Integrations β€” Prometheus /metrics, OpenTelemetry trace links, read-only REST API, CSV/JSON export
v2.7.0 Planned Customization β€” white-label theming, show/hide built-in pages, saved views
v3.0 Planned Stretch goals & long-term backlog (Gantt timeline, multi-instance federation, replay, fingerprint, etc.)

See the full for details.


Contributing

Contributions welcome β€” bug reports, feature requests, documentation improvements, and pull requests.

git clone https://github.com/anwarminarso/a2n.Hangfire.Dashboard.git
cd a2n.Hangfire.Dashboard
dotnet build src/Hangfire\ Dashboard.slnx
dotnet test
cd samples/SampleApp && dotnet run

See for fork workflow, code style, and pull request guidelines.

License

LGPL-3.0-or-later β€” see .

Acknowledgments

This project builds on the excellent work of the Hangfire community:

Community extensions are listed on the Hangfire Extensions page. This project is community-maintained and is not officially supported by Hangfire OÜ.


<p align="center"> <sub>Built with β˜• by <a href="https://github.com/anwarminarso">Anwar Minarso</a></sub> </p>

Product Versions Compatible and additional computed target framework versions.
.NET net8.0 net8.0 is compatible.  net8.0-android net8.0-android was computed.  net8.0-browser net8.0-browser was computed.  net8.0-ios net8.0-ios was computed.  net8.0-maccatalyst net8.0-maccatalyst was computed.  net8.0-macos net8.0-macos was computed.  net8.0-tvos net8.0-tvos was computed.  net8.0-windows net8.0-windows was computed.  net9.0 net9.0 is compatible.  net9.0-android net9.0-android was computed.  net9.0-browser net9.0-browser was computed.  net9.0-ios net9.0-ios was computed.  net9.0-maccatalyst net9.0-maccatalyst was computed.  net9.0-macos net9.0-macos was computed.  net9.0-tvos net9.0-tvos was computed.  net9.0-windows net9.0-windows was computed.  net10.0 net10.0 is compatible.  net10.0-android net10.0-android was computed.  net10.0-browser net10.0-browser was computed.  net10.0-ios net10.0-ios was computed.  net10.0-maccatalyst net10.0-maccatalyst was computed.  net10.0-macos net10.0-macos was computed.  net10.0-tvos net10.0-tvos was computed.  net10.0-windows net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on a2n.Hangfire.Dashboard:

Package Downloads
a2n.Hangfire.Dashboard.SqlServer

SQL Server storage adapter for a2n.Hangfire.Dashboard. Provides optimized Dapper-based queries for search, filtering, pagination, and analytics metrics using T-SQL.

a2n.Hangfire.Dashboard.PostgreSql

PostgreSQL storage adapter for a2n.Hangfire.Dashboard. Provides optimized Dapper-based queries for search, filtering, pagination, and analytics metrics using Npgsql.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.5.0-beta.2 52 6/24/2026
2.5.0-beta.1 63 6/20/2026
2.4.3 88 6/24/2026
2.4.2 155 6/17/2026
2.4.1 145 6/16/2026
2.4.0 142 6/15/2026
2.3.1 167 6/10/2026
2.3.0 148 6/7/2026
2.2.1 178 5/28/2026
2.2.0 142 5/21/2026
2.1.1-alpha 145 5/18/2026
2.1.0-alpha 144 5/17/2026
2.0.0-alpha.1 68 5/16/2026