Table of Contents

Class FireInstanceQuery

Namespace
Quartz
Assembly
Quartz.dll

Selects firings, as FireInstances. The filters combine with AND.

public sealed record FireInstanceQuery : PagedQuery, IEquatable<PagedQuery>, IEquatable<FireInstanceQuery>
Inheritance
FireInstanceQuery
Implements
Inherited Members

Remarks

Firings are ordered by trigger group, then trigger name, then fire instance id (all ordinal). The fire instance id is the tiebreaker the rest of the query family does not need: a trigger can have several firings in flight at once, so group and name alone do not order a page deterministically.

Properties

Job

Limits the result to firings of one job.

public JobKey? Job { get; init; }

Property Value

JobKey

Remarks

A firing that is only Acquired has no job recorded yet, so it never matches this filter — combining it with State = null still lists executing firings only.

SchedulerInstanceId

Limits the result to firings owned by one scheduler node, identified by its SchedulerInstanceId. Null matches every node.

public string? SchedulerInstanceId { get; init; }

Property Value

string

State

Limits the result to firings in the given state. Defaults to Executing, so a query that says nothing lists what is running; set it to null to include reserved firings as well.

public FireInstanceState? State { get; init; }

Property Value

FireInstanceState?

TriggerGroup

Limits the result to firings of triggers whose group matches. Null matches every group.

public GroupMatcher<TriggerKey>? TriggerGroup { get; init; }

Property Value

GroupMatcher<TriggerKey>

TriggerName

Limits the result to firings of triggers whose name matches. Null matches every name.

public NameMatcher<TriggerKey>? TriggerName { get; init; }

Property Value

NameMatcher<TriggerKey>

Remarks

Combines with TriggerGroup by AND, so the two together select a name pattern within a group pattern.

Edit this page