Extension for Delayed::Job that allows for better tracking of jobs!
- add to Gemfile:
rails g delayed_job:progress
Configuration and Usage
class User < ActiveRecord::Base # convenient relationship to grab associated jobs has_many :jobs, :as => :record, :class_name => 'Delayed::Job' end
Creating a delayed job:
user = User.find(123) user.delay.do_things!
If you're using custom jobs you'll need to do something like this:
class CustomUserJob < Struct.new(:user_id) def enqueue(job) job.record = User.find(user_id) job.identifier = 'unique_identifier' job.progress_max = 100 job.progress_current = 0 end def before(job) @job = job @user = job.record end def perform @job.update_column(:message, 'working') (0..100).each do |i| @user.do_a_thing(i) @job.update_column(:progress_current, i) end @job.update_column(:message, 'complete') end end Delayed::Job.enqueue CustomUserJob.new(123)
This will create a Delayed::Job record:
-> user.jobs => [#<Delayed::Job>]
That job knows about object that spawned it:
-> Delayed::Job.last.record => #<User>
Delayed::Job records now have new attributes:
`progress_max` - Default is `100`. You can change it to whatever during `enqueue`. `progress_current` - Default is `0`. You can manually increment it while job is running. Will be set to `process_max` when job completes. `message` - Default is `nil`. Optional informational string. `error_message` - Error message without backtrace. Also useful to set your own message. `completed_at` - When job is done this timestamp is recorded. `identifier` - You can assign something during `enqueue` so you can fetch that job later for display. `status` - Virtual read-only attribute. Can be `queued`, `processing`, `completed` or `failed`
This extension also introduces worker setting that keeps completed jobs around. This way you can keep list of completed jobs for a while. If you want to remove them, you need to
Delayed::Worker.destroy_completed_jobs = false
You may mount jobs controller in your routes by adding:
mount :: => '/delayed'
Following JSON serving end-points will become available:
GET /jobs - List all jobs. Can filter based on associated record via `record_type` and `record_id` parameters. `identifier` parameter can be used as well GET /jobs/<id> - Status of a job. Will see all the Delayed::Job attributes including things like progress DELETE /jobs/<id>` - If job is stuck/failed, we can remove it POST /jobs/<id>/reload` - Restart failed job
/jobs/<id> enpoint and update progress bar with progress data + messages.
Copyright 2016 Oleg Khabarov