Auto-removal of jobs
By default, when your queue jobs are completed (or failed), they are stored in two special sets, the "completed" and the "failed" set. This is useful so that you can examine the results of your jobs, particularly in the early stages of development. However, as the solution reaches a production-grade level, we usually need to restrict the number of finished jobs to be kept, so that we do not fill Redis with data that is not particularly useful.
BullMQ supports different strategies for auto-removing finalized jobs. These strategies are configured on the Worker's options removeOnComplete and removeOnFail.
Remove all finalized jobs
The simplest option is to set removeOnComplete/removeOnFail to {count: 0}, in this case, all jobs will be removed automatically as soon as they are finalized:
const myWorker = new Worker(
'myQueueName',
async job => {
// do some work
},
{
connection,
removeOnFail: { count: 0 },
},
);from bullmq import Worker
async def process_job(job, token):
# do some work
pass
worker = Worker(
'myQueueName',
process_job,
{
"connection": connection,
"removeOnFail": {"count": 0},
},
){:ok, worker} = BullMQ.Worker.start_link(
queue: "myQueueName",
processor: fn _job ->
# do some work
:ok
end,
connection: :my_redis,
remove_on_fail: %{count: 0}
)use bullmq::types::RemoveOnFinish;
use bullmq::worker::CancellationToken;
use bullmq::{Job, Worker, WorkerOptions};
let worker = Worker::with_options(
"myQueueName",
|_job: Job, _token: CancellationToken| async move {
// do some work
Ok(serde_json::Value::Null)
},
WorkerOptions {
connection,
remove_on_fail: Some(RemoveOnFinish::Count(0)),
..Default::default()
},
)
.await?;WARNING
Jobs will be deleted regardless of their names.
Keep a certain number of jobs
It is also possible to specify a maximum number of jobs to keep. A good practice is to keep a handful of completed jobs and a much larger value of failed jobs:
const myWorker = new Worker(
'myQueueName',
async job => {
// do some work
},
{
connection,
removeOnComplete: { count: 1000 },
removeOnFail: { count: 5000 },
},
);from bullmq import Worker
async def process_job(job, token):
# do some work
pass
worker = Worker(
'myQueueName',
process_job,
{
"connection": connection,
"removeOnComplete": {"count": 1000},
"removeOnFail": {"count": 5000},
},
){:ok, worker} = BullMQ.Worker.start_link(
queue: "myQueueName",
processor: fn _job ->
# do some work
:ok
end,
connection: :my_redis,
remove_on_complete: %{count: 1000},
remove_on_fail: %{count: 5000}
)use bullmq::types::RemoveOnFinish;
use bullmq::worker::CancellationToken;
use bullmq::{Job, Worker, WorkerOptions};
let worker = Worker::with_options(
"myQueueName",
|_job: Job, _token: CancellationToken| async move {
// do some work
Ok(serde_json::Value::Null)
},
WorkerOptions {
connection,
remove_on_complete: Some(RemoveOnFinish::Count(1000)),
remove_on_fail: Some(RemoveOnFinish::Count(5000)),
..Default::default()
},
)
.await?;Keep jobs based on their age
Another possibility is to keep jobs up to a certain age. The removeOn option accepts a KeepJobs object, that includes age, count, and limit fields. The age is used to specify how old jobs to keep (in seconds), the count can be used to limit the total amount to keep, and the limit controls how many jobs are removed per cleanup iteration. The count option is useful in cases we get an unexpected amount of jobs in a very short time, in this case we may just want to limit to a certain amount to avoid running out of memory. The limit option helps control the performance impact of cleanup operations by limiting how many jobs are processed at once.
const myWorker = new Worker(
'myQueueName',
async job => {
// do some work
},
{
connection,
removeOnComplete: {
age: 3600, // keep up to 1 hour
count: 1000, // keep up to 1000 jobs
limit: 100, // remove up to 100 jobs per cleanup iteration
},
removeOnFail: {
age: 24 * 3600, // keep up to 24 hours
limit: 50, // remove up to 50 jobs per cleanup iteration
},
},
);from bullmq import Worker
async def process_job(job, token):
# do some work
pass
worker = Worker(
'myQueueName',
process_job,
{
"connection": connection,
"removeOnComplete": {
"age": 3600, # keep up to 1 hour
"count": 1000, # keep up to 1000 jobs
"limit": 100, # remove up to 100 jobs per cleanup iteration
},
"removeOnFail": {
"age": 24 * 3600, # keep up to 24 hours
"limit": 50, # remove up to 50 jobs per cleanup iteration
},
},
){:ok, worker} = BullMQ.Worker.start_link(
queue: "myQueueName",
processor: fn _job ->
# do some work
:ok
end,
connection: :my_redis,
remove_on_complete: %{
"age" => 3600, # keep up to 1 hour
"count" => 1000, # keep up to 1000 jobs
"limit" => 100 # remove up to 100 jobs per cleanup iteration
},
remove_on_fail: %{
"age" => 24 * 3600, # keep up to 24 hours
"limit" => 50 # remove up to 50 jobs per cleanup iteration
}
)use bullmq::types::{KeepJobs, RemoveOnFinish};
use bullmq::worker::CancellationToken;
use bullmq::{Job, Worker, WorkerOptions};
let worker = Worker::with_options(
"myQueueName",
|_job: Job, _token: CancellationToken| async move {
// do some work
Ok(serde_json::Value::Null)
},
WorkerOptions {
connection,
remove_on_complete: Some(RemoveOnFinish::Options(KeepJobs {
age: Some(3600), // keep up to 1 hour
count: Some(1000), // keep up to 1000 jobs
limit: Some(100), // remove up to 100 jobs per cleanup iteration
})),
remove_on_fail: Some(RemoveOnFinish::Options(KeepJobs {
age: Some(24 * 3600), // keep up to 24 hours
count: None,
limit: Some(50), // remove up to 50 jobs per cleanup iteration
})),
..Default::default()
},
)
.await?;INFO
The auto removal of jobs works lazily. This means that jobs are not removed unless a new job completes or fails, since that is when the auto-removal takes place.