Quartz.Plugins

Quartz.Plugins provides ready-made ISchedulerPlugin implementations: logging a history of job and trigger events, and loading jobs and triggers from a file at startup.

Two plugins were retired in 4.0 because the host already does their job. Interrupting a job that overruns is AddJobTimeout(…) in the core package, which needs no plugin and no job-data-map keys. Shutting the scheduler down when the process exits is AddQuartzHostedService(), whose QuartzHostedServiceOptions.WaitForJobsToComplete is what ShutdownHookPlugin.CleanShutdown was.

Installation

dotnet add package Quartz.Plugins

Usage

The extensions hang off IQuartzBuilder, so the same calls configure a scheduler with or without a host:

builder.Services.AddQuartz(q =>
{
    q.UseStructuredJobLogging();
    q.UseStructuredTriggerLogging();
    q.UseJsonSchedulingConfiguration("quartz_jobs.json");
});

The flat quartz.plugin.{name}.{property} keys Quartz 3 used still work and mean the same thing, and AddPlugin<TPlugin>() registers a plugin of your own so the container constructs it.

These plugins live in the Quartz.Plugins.* namespaces. In Quartz 3 they were the singular Quartz.Plugin.*; a quartz.plugin.<name>.type naming the old spelling still resolves, with a warning.

JSON is the maintained format for a schedule kept in a file. The XML format is frozen at job_scheduling_data_2_0.xsd — simple, cron and calendar-interval triggers — and will not gain the trigger kinds or trigger settings added since. Existing files keep working; write a new schedule as JSON.

Documentation

https://www.quartz-scheduler.net/documentation/quartz-4.x/packages/quartz-plugins.html