uTPro.Feature.JobMonitor 1.0.1

uTPro Background Jobs Monitor for Umbraco

A read-and-trigger management UI for Umbraco recurring background jobs. Surfaces every recurring job registered in your site under a Settings dashboard — with timing parameters, execution telemetry the CMS does not persist natively, an estimated next run, server-role awareness, and an authorized on-demand Run now action.

Works with Umbraco 16, 17 and 18 (multi-targeted net9.0 / net10.0).

Optional durable telemetry runs on SQL Server, SQLite and PostgreSQL.

Features

• Auto-discovery of every recurring background job — no per-job wiring.
  • Modern jobs implementing IRecurringBackgroundJob (full support).
  • Legacy jobs deriving from RecurringHostedServiceBase (listed with limited support).
  • Plain IHostedService registrations are excluded.
• Timing parameters per job: period, delay and server roles (human-readable durations).
• Execution telemetry the CMS does not persist natively: last run start, duration and outcome.
• Estimated next run = most recent run start + period (clearly labelled as an estimate).
• Manual trigger ("Run now") for modern jobs — runs off the request thread, guards against overlap, honours the node's server role, and records the initiating backoffice user.
• Load-balancing aware — shows the current node's server role and warns when scheduled jobs do not run on the node, or when history is in-memory / per-node only.
• Configurable storage — in-memory ring buffer (default) or a durable database table that survives restarts and is shared across nodes.
• Secure by default — every endpoint requires access to the Settings section.

Quick Start

dotnet add package uTPro.Feature.JobMonitor

Start Umbraco and open Settings → Background Jobs Monitor. Your recurring jobs appear automatically — no configuration or per-job registration required.

Configuration

All settings are optional, under uTPro:Feature:JobMonitor in appsettings.json:

{
  "uTPro": {
    "Feature": {
      "JobMonitor": {
        "Storage": "InMemory",
        "HistoryCapacity": 50,
        "DiscoveryCacheSeconds": 30
      }
    }
  }
}

See Configuration and Telemetry & Storage.

Database support (durable storage)

When Storage is Durable, a state-keyed migration creates the uTProJobExecution table on startup (once per database). Data access uses NPoco strongly-typed queries with provider-quoted identifiers, so it runs on SQL Server, SQLite and PostgreSQL — the same cross-database approach used by uTPro.Feature.AuditLog and uTPro.Feature.SimpleFormBuilder. When durable storage is disabled (the default) the package touches no schema.

Documentation

Building from source

dotnet build uTPro.Feature.JobMonitor.sln

src/uTPro.Feature.JobMonitor.TestSite is a runnable Umbraco 18 site (SQLite, unattended install) that registers example modern / legacy / plain services to exercise the dashboard.

Produce a NuGet package deterministically:

pwsh ./pack.ps1

License & Author

MIT © T4VN. Issues and contributions welcome on the GitHub repository.