Filter is added to the global Filters collection by default. Intervals between attempts are based on increasing exponential back-off multiplier in seconds.

This filter works in a state election phase by changing the candidate state from FailedState to the ScheduledState when another retry should be attempted, or other state based on the value of the OnAttemptsExceeded property when attempts exceeded.

Disabling Automatic Retries

The following example shows how to disable automatic retries for a specific job method by applying an attribute to a method.

Note
Even if you disable AutomaticRetryAttribute filter, your background jobs can still be executed several times, due to re-queue on shutdown and other compensation logic that guarantees the at least once processing.

[AutomaticRetry(Attempts = 0)]
public void RetriesDisabled(string arg)
{
}

Overriding Defaults

The following example shows how to override the default number of retry attempts for all of the background jobs by modifying the global Filters collection.

// Call it in the application initialization logic
GlobalJobFilters.Filters.Add(new AutomaticRetryAttribute { Attempts = 3 });

Specifying Attempts Exceeded Action

The following example shows how to ignore a background job when number of retry attempts exceed using the OnAttemptsExceeded property.

Tip
Choose Delete action when you aren't interested in processing background job that failed several times.

[AutomaticRetry(OnAttemptsExceeded = AttemptsExceededAction.Delete)]
public void DeleteWhenAttemptsExdeeded()
{
}

Reference