class Sidekiq::Workers
The WorkSet
stores the work being done by this Sidekiq
cluster. It tracks the process and thread working on each job.
WARNING WARNING WARNING
This is live data that can change every millisecond. If you call size
=> 5 and then expect each
to be called 5 times, you’re going to have a bad time.
works = Sidekiq::WorkSet.new works.size => 2 works.each do |process_id, thread_id, work| # process_id is a unique identifier per Sidekiq process # thread_id is a unique identifier per thread # work is a Hash which looks like: # { 'queue' => name, 'run_at' => timestamp, 'payload' => job_hash } # run_at is an epoch Integer. end
Public Instance Methods
each(&block)
click to toggle source
# File lib/sidekiq/api.rb, line 1125 def each(&block) results = [] procs = nil all_works = nil Sidekiq.redis do |conn| procs = conn.sscan("processes").to_a.sort all_works = conn.pipelined do |pipeline| procs.each do |key| pipeline.hgetall("#{key}:work") end end end procs.zip(all_works).each do |key, workers| workers.each_pair do |tid, json| results << [key, tid, Sidekiq::Work.new(key, tid, Sidekiq.load_json(json))] unless json.empty? end end results.sort_by { |(_, _, hsh)| hsh.raw("run_at") }.each(&block) end
find_work_by_jid(jid)
click to toggle source
Find the work which represents a job with the given JID. *This is a slow O(n) operation*. Do not use for app logic.
@param jid [String] the job identifier @return [Sidekiq::Work] the work or nil
# File lib/sidekiq/api.rb, line 1175 def find_work_by_jid(jid) each do |_process_id, _thread_id, work| job = work.job return work if job.jid == jid end nil end
size()
click to toggle source
Note that size
is only as accurate as Sidekiq’s heartbeat, which happens every 5 seconds. It is NOT real-time.
Not very efficient if you have lots of Sidekiq
processes but the alternative is a global counter which can easily get out of sync with crashy processes.
# File lib/sidekiq/api.rb, line 1154 def size Sidekiq.redis do |conn| procs = conn.sscan("processes").to_a if procs.empty? 0 else conn.pipelined { |pipeline| procs.each do |key| pipeline.hget(key, "busy") end }.sum(&:to_i) end end end