Class JobRunStatus

Namespace

Quartz

Assembly

Quartz.dll

How one job's runs have gone: its last run, its last success and failure, and its counts.

public sealed record JobRunStatus : IEquatable<JobRunStatus>

Inheritance

object

JobRunStatus

Implements

IEquatable<JobRunStatus>

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Remarks

Kept by the history store beside the rows, from every execution it records, so it survives the rows being trimmed. The counts start when the store first recorded the job.

The Last* run fields describe the execution that fired latest. A run that completes after a later-fired one is counted but does not replace them.

Constructors

JobRunStatus(string, JobKey, DateTimeOffset, JobRunResult)

How one job's runs have gone: its last run, its last success and failure, and its counts.

public JobRunStatus(string SchedulerName, JobKey Job, DateTimeOffset LastFiredAtUtc, JobRunResult LastResult)

Parameters

SchedulerName string

The scheduler the job belongs to.

Job JobKey

The job.

LastFiredAtUtc DateTimeOffset

When the latest-fired recorded run fired.

LastResult JobRunResult

What that run achieved.

Remarks

Kept by the history store beside the rows, from every execution it records, so it survives the rows being trimmed. The counts start when the store first recorded the job.

The Last* run fields describe the execution that fired latest. A run that completes after a later-fired one is counted but does not replace them.

Properties

ConsecutiveFailures

How many occurrences in a row have failed for the last time, counted from the latest-fired run back. A success resets it; a cancelled run and a failure the trigger retries leave it alone.

public int ConsecutiveFailures { get; init; }

Property Value

int

Remarks

Above zero is what Failing selects.

FailureCount

How many occurrences have failed for the last time. A failure the trigger retries is not counted.

public long FailureCount { get; init; }

Property Value

long

FirstFiredAtUtc

When the earliest-fired recorded run fired.

public DateTimeOffset FirstFiredAtUtc { get; init; }

Property Value

DateTimeOffset

Job

The job.

public JobKey Job { get; init; }

Property Value

JobKey

LastDuration

How long the latest-fired run took.

public TimeSpan LastDuration { get; init; }

Property Value

TimeSpan

LastEntryId

The latest-fired run's EntryId, which GetExecution(string, string, CancellationToken) reads it back by while it is kept.

public string? LastEntryId { get; init; }

Property Value

string

LastFailedAtUtc

When the latest failed run fired, a failure the trigger retries included. null until one is recorded.

public DateTimeOffset? LastFailedAtUtc { get; init; }

Property Value

DateTimeOffset?

LastFailureMessage

The ExceptionMessage of the run at LastFailedAtUtc: the message of what the job threw, or else the run's summary.

public string? LastFailureMessage { get; init; }

Property Value

string

LastFiredAtUtc

When the latest-fired recorded run fired.

public DateTimeOffset LastFiredAtUtc { get; init; }

Property Value

DateTimeOffset

LastResult

What that run achieved.

public JobRunResult LastResult { get; init; }

Property Value

JobRunResult

LastSchedulerInstanceId

The node that ran the latest-fired run.

public string? LastSchedulerInstanceId { get; init; }

Property Value

string

LastSucceededAtUtc

When the latest successful run fired: Succeeded or Skipped. null until one is recorded.

public DateTimeOffset? LastSucceededAtUtc { get; init; }

Property Value

DateTimeOffset?

LastSummary

The latest-fired run's Summary.

public string? LastSummary { get; init; }

Property Value

string

RunCount

How many runs have been recorded, every result included.

public long RunCount { get; init; }

Property Value

long

SchedulerName

The scheduler the job belongs to.

public string SchedulerName { get; init; }

Property Value

string