DOC Document new queued job retry feature #870
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
4 tasks
GuySartorelli
force-pushed
the
pulls/6/auto-retries
branch
from
a1d0834 to
67ccc4e
Compare
GuySartorelli
force-pushed
the
pulls/6/auto-retries
branch
from
67ccc4e to
bb5fb6d
Compare
GuySartorelli
commented
Jan 23, 2026
Comment on lines
+147
to
+158
| ```yml | ||
| Symbiote\QueuedJobs\Services\AbstractQueuedJob: | ||
| # Retry pattern with spread | ||
| # First retry attempt - Retry after 8 to 12 minutes | ||
| # Second retry attempt - Retry after 6.4 to 14.4 minutes | ||
| # Third retry attempt - Retry after 5.1 to 27.4 minutes | ||
| # Fourth retry attempt - Retry after 4 to 38.4 minutes | ||
| retry_max_attempts: 4 | ||
| retry_initial_delay: 600 | ||
| retry_falloff_multiplier: 1 | ||
| retry_falloff_multiplier_variance: 0.2 | ||
| ``` |
Member
Author
There was a problem hiding this comment.
This example comes straight from the docs - see https://github.com/silverstripe/silverstripe-queuedjobs/blob/6/docs/en/08_troubleshooting.md#advanced-configuration
emteknetnz
requested changes
Jan 23, 2026
|
|
||
| ### Automatic retries for queued jobs | ||
|
|
||
| The [symbiote/silverstripe-queuedjobs](/optional_features/queuedjobs/) module now has the ability to automatically retry broken or paused jobs. By default no jobs will be retried, but you can easily enable this for all jobs by setting [`AbstractQueuedJob.retry_max_attempts`](api:Symbiote\QueuedJobs\Services\AbstractQueuedJob->retry_max_attempts) to the maximum number times you want to retry jobs. |
Member
There was a problem hiding this comment.
Suggested change
| The [symbiote/silverstripe-queuedjobs](/optional_features/queuedjobs/) module now has the ability to automatically retry broken or paused jobs. By default no jobs will be retried, but you can easily enable this for all jobs by setting [`AbstractQueuedJob.retry_max_attempts`](api:Symbiote\QueuedJobs\Services\AbstractQueuedJob->retry_max_attempts) to the maximum number times you want to retry jobs. | |
| The [symbiote/silverstripe-queuedjobs](/optional_features/queuedjobs/) module now has the ability to automatically retry broken or paused jobs. By default no jobs will be retried, but you can easily enable this for all jobs by setting [`AbstractQueuedJob.retry_max_attempts`](api:Symbiote\QueuedJobs\Services\AbstractQueuedJob->retry_max_attempts) to the maximum number of times you want to retry jobs. |
|
|
||
| You can also define the delay between retry attempts, and randomise that delay to prevent clobbering your site and any external services your jobs might connect to. | ||
|
|
||
| ```yml |
Member
There was a problem hiding this comment.
This example given is really confusing in the context of a changelog i.e. people reading (including myself) don't have knowledge of what the PR does so seeing things like Third retry attempt - Retry after 5.1 to 27.4 minutes is confusing based on the given config. I think it would be better to not have this example, say it's configurable and simply link to the docs
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Issue