Skip to content
QueueClassicPlus is queue_classic with batteries included
Branch: master
Clone or download
Latest commit a255403 Jul 19, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore Added .project within .gitignore Jul 21, 2015
.rvmrc NewRelic support Dec 9, 2014
.travis.yml Fix Travis file Jul 18, 2019
Gemfile Rewrite NewRelic extension to use Module.prepend rather than the depr… Jul 18, 2019


Build Status

queue_classic is a simple Postgresql backed DB queue. However, it's a little too simple to use it as the main queueing system of a medium to large app. This was developed at Rainforest QA.

QueueClassicPlus adds many lacking features to QueueClassic.

  • Standardized job format
  • Retry on specific exceptions
  • Singleton jobs
  • Metrics
  • Error logging / handling
  • Transactions
  • Rails generator to create new jobs


This version of the matchers are compatible with queue_classic 3.1+ which includes built-in scheduling. See other branches for other compatible versions.


Add these line to your application's Gemfile:

gem 'queue_classic_plus'

And then execute:

$ bundle

Run the migration



Create a new job

rails g qc_plus_job test_job
# /app/jobs/my_job.rb
class Jobs::MyJob < QueueClassicPlus::Base
  # Specified the queue name
  @queue = :low

  # Extry up to 5 times when SomeException is raised
  retry! on: SomeException, max: 5

  def self.perform(a, b)
    # ...

# In your code, you can enqueue this task like so:, "foo")

# You can also schedule a job in the future by doing
Jobs::MyJob.enqueue_perform_in(1.hour, 1, "foo")

Run the QueueClassicPlus worker

QueueClassicPlus ships with its own worker and a rake task to run it. You need to use this worker to take advance of many features of QueueClassicPlus.

QUEUE=low bundle exec qc_plus:work

Other jobs options

Singleton Job

It's common for background jobs to never need to be enqueed multiple time. QueueClassicPlus support these type of single jobs. Here's an example one:

class Jobs::UpdateMetrics < QueueClassicPlus::Base
  @queue = :low

  # Use the lock! keyword to prevent the job from being enqueud once.

  def self.perform(metric_type)
    # ...

Note that lock! only prevents the same job from beeing enqued multiple times if the argument match.

So in our example: 'type_a' # enqueues job 'type_a' # does not enqueues job since it's already queued 'type_b' # enqueues job as the arguments are different.


By default, all QueueClassicPlus jobs are executed in a PostgreSQL transaction. This decision was made because most jobs are usually pretty small and it's preferable to have all the benefits of the transaction. You can optionally specify a postgres statement timeout (in seconds) for all transactions with the environment variable POSTGRES_STATEMENT_TIMEOUT.

You can disable this feature on a per job basis in the following way:

class Jobs::NoTransaction < QueueClassicPlus::Base
  # Don't run the perform method in a transaction
  @queue = :low

  def self.perform(user_id)
    # ...

Advanced configuration

If you want to log exceptions in your favorite exception tracker. You can configured it like sso:

QueueClassicPlus.exception_handler = -> (exception, job) do
  Raven.capture_exception(exception, extra: {job: job, env: ENV})

If you use Librato, we push useful metrics directly to them.

Push metrics to your metric provider (only Librato is supported for now).


Call this is a cron job or something similar.

If you are using NewRelic and want to push performance data to it, you can add this to an initializer:

require "queue_classic_plus/new_relic"


  1. Fork it ([my-github-username]/queue_classic_plus/fork )
  • Create your feature branch (git checkout -b my-new-feature)
  • Commit your changes (git commit -am 'Add some feature')
  • Push to the branch (git push origin my-new-feature)
  • Create a new Pull Request

Setting up the test database

createdb queue_classic_plus_test
You can’t perform that action at this time.