sidekiq 6.0.7

Sign up to get free protection for your applications and to get access to all the features.

Potentially problematic release.


This version of sidekiq might be problematic. Click here for more details.

Files changed (126) hide show
  1. checksums.yaml +7 -0
  2. data/.circleci/config.yml +60 -0
  3. data/.github/contributing.md +32 -0
  4. data/.github/issue_template.md +11 -0
  5. data/.gitignore +13 -0
  6. data/.standard.yml +20 -0
  7. data/3.0-Upgrade.md +70 -0
  8. data/4.0-Upgrade.md +53 -0
  9. data/5.0-Upgrade.md +56 -0
  10. data/6.0-Upgrade.md +72 -0
  11. data/COMM-LICENSE +97 -0
  12. data/Changes.md +1700 -0
  13. data/Ent-2.0-Upgrade.md +37 -0
  14. data/Ent-Changes.md +256 -0
  15. data/Gemfile +24 -0
  16. data/Gemfile.lock +208 -0
  17. data/LICENSE +9 -0
  18. data/Pro-2.0-Upgrade.md +138 -0
  19. data/Pro-3.0-Upgrade.md +44 -0
  20. data/Pro-4.0-Upgrade.md +35 -0
  21. data/Pro-5.0-Upgrade.md +25 -0
  22. data/Pro-Changes.md +782 -0
  23. data/README.md +97 -0
  24. data/Rakefile +10 -0
  25. data/bin/sidekiq +37 -0
  26. data/bin/sidekiqload +157 -0
  27. data/bin/sidekiqmon +8 -0
  28. data/code_of_conduct.md +50 -0
  29. data/lib/generators/sidekiq/templates/worker.rb.erb +9 -0
  30. data/lib/generators/sidekiq/templates/worker_spec.rb.erb +6 -0
  31. data/lib/generators/sidekiq/templates/worker_test.rb.erb +8 -0
  32. data/lib/generators/sidekiq/worker_generator.rb +57 -0
  33. data/lib/sidekiq.rb +260 -0
  34. data/lib/sidekiq/api.rb +960 -0
  35. data/lib/sidekiq/cli.rb +393 -0
  36. data/lib/sidekiq/client.rb +258 -0
  37. data/lib/sidekiq/delay.rb +41 -0
  38. data/lib/sidekiq/exception_handler.rb +27 -0
  39. data/lib/sidekiq/extensions/action_mailer.rb +47 -0
  40. data/lib/sidekiq/extensions/active_record.rb +42 -0
  41. data/lib/sidekiq/extensions/class_methods.rb +42 -0
  42. data/lib/sidekiq/extensions/generic_proxy.rb +31 -0
  43. data/lib/sidekiq/fetch.rb +80 -0
  44. data/lib/sidekiq/job_logger.rb +63 -0
  45. data/lib/sidekiq/job_retry.rb +262 -0
  46. data/lib/sidekiq/launcher.rb +205 -0
  47. data/lib/sidekiq/logger.rb +165 -0
  48. data/lib/sidekiq/manager.rb +135 -0
  49. data/lib/sidekiq/middleware/chain.rb +160 -0
  50. data/lib/sidekiq/middleware/i18n.rb +40 -0
  51. data/lib/sidekiq/monitor.rb +133 -0
  52. data/lib/sidekiq/paginator.rb +47 -0
  53. data/lib/sidekiq/processor.rb +280 -0
  54. data/lib/sidekiq/rails.rb +52 -0
  55. data/lib/sidekiq/redis_connection.rb +143 -0
  56. data/lib/sidekiq/scheduled.rb +173 -0
  57. data/lib/sidekiq/sd_notify.rb +149 -0
  58. data/lib/sidekiq/systemd.rb +24 -0
  59. data/lib/sidekiq/testing.rb +344 -0
  60. data/lib/sidekiq/testing/inline.rb +30 -0
  61. data/lib/sidekiq/util.rb +67 -0
  62. data/lib/sidekiq/version.rb +5 -0
  63. data/lib/sidekiq/web.rb +205 -0
  64. data/lib/sidekiq/web/action.rb +93 -0
  65. data/lib/sidekiq/web/application.rb +357 -0
  66. data/lib/sidekiq/web/helpers.rb +336 -0
  67. data/lib/sidekiq/web/router.rb +101 -0
  68. data/lib/sidekiq/worker.rb +247 -0
  69. data/sidekiq.gemspec +21 -0
  70. data/web/assets/images/favicon.ico +0 -0
  71. data/web/assets/images/logo.png +0 -0
  72. data/web/assets/images/status.png +0 -0
  73. data/web/assets/javascripts/application.js +95 -0
  74. data/web/assets/javascripts/dashboard.js +296 -0
  75. data/web/assets/stylesheets/application-dark.css +122 -0
  76. data/web/assets/stylesheets/application-rtl.css +246 -0
  77. data/web/assets/stylesheets/application.css +1153 -0
  78. data/web/assets/stylesheets/bootstrap-rtl.min.css +9 -0
  79. data/web/assets/stylesheets/bootstrap.css +5 -0
  80. data/web/locales/ar.yml +81 -0
  81. data/web/locales/cs.yml +78 -0
  82. data/web/locales/da.yml +68 -0
  83. data/web/locales/de.yml +81 -0
  84. data/web/locales/el.yml +68 -0
  85. data/web/locales/en.yml +83 -0
  86. data/web/locales/es.yml +70 -0
  87. data/web/locales/fa.yml +80 -0
  88. data/web/locales/fr.yml +78 -0
  89. data/web/locales/he.yml +79 -0
  90. data/web/locales/hi.yml +75 -0
  91. data/web/locales/it.yml +69 -0
  92. data/web/locales/ja.yml +83 -0
  93. data/web/locales/ko.yml +68 -0
  94. data/web/locales/lt.yml +83 -0
  95. data/web/locales/nb.yml +77 -0
  96. data/web/locales/nl.yml +68 -0
  97. data/web/locales/pl.yml +59 -0
  98. data/web/locales/pt-br.yml +68 -0
  99. data/web/locales/pt.yml +67 -0
  100. data/web/locales/ru.yml +78 -0
  101. data/web/locales/sv.yml +68 -0
  102. data/web/locales/ta.yml +75 -0
  103. data/web/locales/uk.yml +76 -0
  104. data/web/locales/ur.yml +80 -0
  105. data/web/locales/vi.yml +83 -0
  106. data/web/locales/zh-cn.yml +68 -0
  107. data/web/locales/zh-tw.yml +68 -0
  108. data/web/views/_footer.erb +20 -0
  109. data/web/views/_job_info.erb +89 -0
  110. data/web/views/_nav.erb +52 -0
  111. data/web/views/_paging.erb +23 -0
  112. data/web/views/_poll_link.erb +7 -0
  113. data/web/views/_status.erb +4 -0
  114. data/web/views/_summary.erb +40 -0
  115. data/web/views/busy.erb +101 -0
  116. data/web/views/dashboard.erb +75 -0
  117. data/web/views/dead.erb +34 -0
  118. data/web/views/layout.erb +41 -0
  119. data/web/views/morgue.erb +78 -0
  120. data/web/views/queue.erb +55 -0
  121. data/web/views/queues.erb +38 -0
  122. data/web/views/retries.erb +83 -0
  123. data/web/views/retry.erb +34 -0
  124. data/web/views/scheduled.erb +57 -0
  125. data/web/views/scheduled_job_info.erb +8 -0
  126. metadata +225 -0
@@ -0,0 +1,1700 @@
1
+ # Sidekiq Changes
2
+
3
+ [Sidekiq Changes](https://github.com/mperham/sidekiq/blob/master/Changes.md) | [Sidekiq Pro Changes](https://github.com/mperham/sidekiq/blob/master/Pro-Changes.md) | [Sidekiq Enterprise Changes](https://github.com/mperham/sidekiq/blob/master/Ent-Changes.md)
4
+
5
+ 6.0.7
6
+ ---------
7
+
8
+ - Refactor systemd integration to work better with custom binaries [#4511]
9
+ - Don't connect to Redis at process exit if not needed [#4502]
10
+ - Remove Redis connection naming [#4479]
11
+ - Fix Redis Sentinel password redaction [#4499]
12
+ - Add Vietnamese locale (vi) [#4528]
13
+
14
+ 6.0.6
15
+ ---------
16
+
17
+ - **Integrate with systemd's watchdog and notification features** [#4488]
18
+ Set `Type=notify` in [sidekiq.service](https://github.com/mperham/sidekiq/blob/4b8a8bd3ae42f6e48ae1fdaf95ed7d7af18ed8bb/examples/systemd/sidekiq.service#L30-L39). The integration works automatically.
19
+ - Use `setTimeout` rather than `setInterval` to avoid thundering herd [#4480]
20
+ - Fix edge case where a job can be pushed without a queue.
21
+ - Flush job stats at exit [#4498]
22
+ - Check RAILS_ENV before RACK_ENV [#4493]
23
+ - Add Lithuanian locale [#4476]
24
+
25
+ 6.0.5
26
+ ---------
27
+
28
+ - Fix broken Web UI response when using NewRelic and Rack 2.1.2+. [#4440]
29
+ - Update APIs to use `UNLINK`, not `DEL`. [#4449]
30
+ - Fix Ruby 2.7 warnings [#4412]
31
+ - Add support for `APP_ENV` [[95fa5d9]](https://github.com/mperham/sidekiq/commit/95fa5d90192148026e52ca2902f1b83c70858ce8)
32
+
33
+ 6.0.4
34
+ ---------
35
+
36
+ - Fix ActiveJob's `sidekiq_options` integration [#4404]
37
+ - Sidekiq Pro users will now see a Pause button next to each queue in
38
+ the Web UI, allowing them to pause queues manually [#4374, shayonj]
39
+ - Fix Sidekiq::Workers API unintentional change in 6.0.2 [#4387]
40
+
41
+
42
+ 6.0.3
43
+ ---------
44
+
45
+ - Fix `Sidekiq::Client.push_bulk` API which was erroneously putting
46
+ invalid `at` values in the job payloads [#4321]
47
+
48
+ 6.0.2
49
+ ---------
50
+
51
+ - Fix Sidekiq Enterprise's rolling restart functionality, broken by refactoring in 6.0.0. [#4334]
52
+ - More internal refactoring and performance tuning [fatkodima]
53
+
54
+ 6.0.1
55
+ ---------
56
+
57
+ - **Performance tuning**, Sidekiq should be 10-15% faster now [#4303, 4299,
58
+ 4269, fatkodima]
59
+ - **Dark Mode support in Web UI** (further design polish welcome!) [#4227, mperham,
60
+ fatkodima, silent-e]
61
+ - **Job-specific log levels**, allowing you to turn on debugging for
62
+ problematic workers. [fatkodima, #4287]
63
+ ```ruby
64
+ MyWorker.set(log_level: :debug).perform_async(...)
65
+ ```
66
+ - **Ad-hoc job tags**. You can tag your jobs with, e.g, subdomain, tenant, country,
67
+ locale, application, version, user/client, "alpha/beta/pro/ent", types of jobs,
68
+ teams/people responsible for jobs, additional metadata, etc.
69
+ Tags are shown on different pages with job listings. Sidekiq Pro users
70
+ can filter based on them [fatkodima, #4280]
71
+ ```ruby
72
+ class MyWorker
73
+ include Sidekiq::Worker
74
+ sidekiq_options tags: ['bank-ops', 'alpha']
75
+ ...
76
+ end
77
+ ```
78
+ - Fetch scheduled jobs in batches before pushing into specific queues.
79
+ This will decrease enqueueing time of scheduled jobs by a third. [fatkodima, #4273]
80
+ ```
81
+ ScheduledSet with 10,000 jobs
82
+ Before: 56.6 seconds
83
+ After: 39.2 seconds
84
+ ```
85
+ - Compress error backtraces before pushing into Redis, if you are
86
+ storing error backtraces, this will halve the size of your RetrySet
87
+ in Redis [fatkodima, #4272]
88
+ ```
89
+ RetrySet with 100,000 jobs
90
+ Before: 261 MB
91
+ After: 129 MB
92
+ ```
93
+ - Support display of ActiveJob 6.0 payloads in the Web UI [#4263]
94
+ - Add `SortedSet#scan` for pattern based scanning. For large sets this API will be **MUCH** faster
95
+ than standard iteration using each. [fatkodima, #4262]
96
+ ```ruby
97
+ Sidekiq::DeadSet.new.scan("UnreliableApi") do |job|
98
+ job.retry
99
+ end
100
+ ```
101
+ - Dramatically speed up SortedSet#find\_job(jid) by using Redis's ZSCAN
102
+ support, approx 10x faster. [fatkodima, #4259]
103
+ ```
104
+ zscan 0.179366 0.047727 0.227093 ( 1.161376)
105
+ enum 8.522311 0.419826 8.942137 ( 9.785079)
106
+ ```
107
+ - Respect rails' generators `test_framework` option and gracefully handle extra `worker` suffix on generator [fatkodima, #4256]
108
+ - Add ability to sort 'Enqueued' page on Web UI by position in the queue [fatkodima, #4248]
109
+ - Support `Client.push_bulk` with different delays [fatkodima, #4243]
110
+ ```ruby
111
+ Sidekiq::Client.push_bulk("class" => FooJob, "args" => [[1], [2]], "at" => [1.minute.from_now.to_f, 5.minutes.from_now.to_f])
112
+ ```
113
+ - Easier way to test enqueuing specific ActionMailer and ActiveRecord delayed jobs. Instead of manually
114
+ parsing embedded class, you can now test by fetching jobs for specific classes. [fatkodima, #4292]
115
+ ```ruby
116
+ assert_equal 1, Sidekiq::Extensions::DelayedMailer.jobs_for(FooMailer).size
117
+ ```
118
+ - Add `sidekiqmon` to gemspec executables [#4242]
119
+ - Gracefully handle `Sidekiq.logger = nil` [#4240]
120
+ - Inject Sidekiq::LogContext module if user-supplied logger does not include it [#4239]
121
+
122
+ 6.0
123
+ ---------
124
+
125
+ This release has major breaking changes. Read and test carefully in production.
126
+
127
+ - With Rails 6.0.1+, ActiveJobs can now use `sidekiq_options` directly to configure Sidekiq
128
+ features/internals like the retry subsystem. [#4213, pirj]
129
+ ```ruby
130
+ class MyJob < ActiveJob::Base
131
+ queue_as :myqueue
132
+ sidekiq_options retry: 10, backtrace: 20
133
+ def perform(...)
134
+ end
135
+ end
136
+ ```
137
+ - Logging has been redesigned to allow for pluggable log formatters:
138
+ ```ruby
139
+ Sidekiq.configure_server do |config|
140
+ config.log_formatter = Sidekiq::Logger::Formatters::JSON.new
141
+ end
142
+ ```
143
+ See the [Logging wiki page](https://github.com/mperham/sidekiq/wiki/Logging) for more details.
144
+ - **BREAKING CHANGE** Validate proper usage of the `REDIS_PROVIDER`
145
+ variable. This variable is meant to hold the name of the environment
146
+ variable which contains your Redis URL, so that you can switch Redis
147
+ providers quickly and easily with a single variable change. It is not
148
+ meant to hold the actual Redis URL itself. If you want to manually set
149
+ the Redis URL (not recommended as it implies you have no failover),
150
+ then you may set `REDIS_URL` directly. [#3969]
151
+ - **BREAKING CHANGE** Increase default shutdown timeout from 8 seconds
152
+ to 25 seconds. Both Heroku and ECS now use 30 second shutdown timeout
153
+ by default and we want Sidekiq to take advantage of this time. If you
154
+ have deployment scripts which depend on the old default timeout, use `-t 8` to
155
+ get the old behavior. [#3968]
156
+ - **BREAKING CHANGE** Remove the daemonization, logfile and pidfile
157
+ arguments to Sidekiq. Use a proper process supervisor (e.g. systemd or
158
+ foreman) to manage Sidekiq. See the Deployment wiki page for links to
159
+ more resources.
160
+ - Integrate the StandardRB code formatter to ensure consistent code
161
+ styling. [#4114, gearnode]
162
+
163
+ 5.2.8
164
+ ---------
165
+
166
+ - Lock to Rack 2.0.x to prevent future incompatibilities
167
+ - Fix invalid reference in `sidekiqctl`
168
+
169
+ 5.2.7
170
+ ---------
171
+
172
+ - Fix stale `enqueued_at` when retrying [#4149]
173
+ - Move build to [Circle CI](https://circleci.com/gh/mperham/sidekiq) [#4120]
174
+
175
+ 5.2.6
176
+ ---------
177
+
178
+ - Fix edge case where a job failure during Redis outage could result in a lost job [#4141]
179
+ - Better handling of malformed job arguments in payload [#4095]
180
+ - Restore bootstap's dropdown css component [#4099, urkle]
181
+ - Display human-friendly time diff for longer queue latencies [#4111, interlinked]
182
+ - Allow `Sidekiq::Worker#set` to be chained
183
+
184
+ 5.2.5
185
+ ---------
186
+
187
+ - Fix default usage of `config/sidekiq.yml` [#4077, Tensho]
188
+
189
+ 5.2.4
190
+ ---------
191
+
192
+ - Add warnings for various deprecations and changes coming in Sidekiq 6.0.
193
+ See the 6-0 branch. [#4056]
194
+ - Various improvements to the Sidekiq test suite and coverage [#4026, #4039, Tensho]
195
+
196
+ 5.2.3
197
+ ---------
198
+
199
+ - Warning message on invalid REDIS\_PROVIDER [#3970]
200
+ - Add `sidekiqctl status` command [#4003, dzunk]
201
+ - Update elapsed time calculatons to use monotonic clock [#3999]
202
+ - Fix a few issues with mobile Web UI styling [#3973, navied]
203
+ - Jobs with `retry: false` now go through the global `death_handlers`,
204
+ meaning you can take action on failed ephemeral jobs. [#3980, Benjamin-Dobell]
205
+ - Fix race condition in defining Workers. [#3997, mattbooks]
206
+
207
+ 5.2.2
208
+ ---------
209
+
210
+ - Raise error for duplicate queue names in config to avoid unexpected fetch algorithm change [#3911]
211
+ - Fix concurrency bug on JRuby [#3958, mattbooks]
212
+ - Add "Kill All" button to the retries page [#3938]
213
+
214
+ 5.2.1
215
+ -----------
216
+
217
+ - Fix concurrent modification error during heartbeat [#3921]
218
+
219
+ 5.2.0
220
+ -----------
221
+
222
+ - **Decrease default concurrency from 25 to 10** [#3892]
223
+ - Verify connection pool sizing upon startup [#3917]
224
+ - Smoother scheduling for large Sidekiq clusters [#3889]
225
+ - Switch Sidekiq::Testing impl from alias\_method to Module#prepend, for resiliency [#3852]
226
+ - Update Sidekiq APIs to use SCAN for scalability [#3848, ffiller]
227
+ - Remove concurrent-ruby gem dependency [#3830]
228
+ - Optimize Web UI's bootstrap.css [#3914]
229
+
230
+ 5.1.3
231
+ -----------
232
+
233
+ - Fix version comparison so Ruby 2.2.10 works. [#3808, nateberkopec]
234
+
235
+ 5.1.2
236
+ -----------
237
+
238
+ - Add link to docs in Web UI footer
239
+ - Fix crash on Ctrl-C in Windows [#3775, Bernica]
240
+ - Remove `freeze` calls on String constants. This is superfluous with Ruby
241
+ 2.3+ and `frozen_string_literal: true`. [#3759]
242
+ - Fix use of AR middleware outside of Rails [#3787]
243
+ - Sidekiq::Worker `sidekiq_retry_in` block can now return nil or 0 to use
244
+ the default backoff delay [#3796, dsalahutdinov]
245
+
246
+ 5.1.1
247
+ -----------
248
+
249
+ - Fix Web UI incompatibility with Redis 3.x gem [#3749]
250
+
251
+ 5.1.0
252
+ -----------
253
+
254
+ - **NEW** Global death handlers - called when your job exhausts all
255
+ retries and dies. Now you can take action when a job fails permanently. [#3721]
256
+ - **NEW** Enable ActiveRecord query cache within jobs by default [#3718, sobrinho]
257
+ This will prevent duplicate SELECTS; cache is cleared upon any UPDATE/INSERT/DELETE.
258
+ See the issue for how to bypass the cache or disable it completely.
259
+ - Scheduler timing is now more accurate, 15 -> 5 seconds [#3734]
260
+ - Exceptions during the :startup event will now kill the process [#3717]
261
+ - Make `Sidekiq::Client.via` reentrant [#3715]
262
+ - Fix use of Sidekiq logger outside of the server process [#3714]
263
+ - Tweak `constantize` to better match Rails class lookup. [#3701, caffeinated-tech]
264
+
265
+ 5.0.5
266
+ -----------
267
+
268
+ - Update gemspec to allow newer versions of the Redis gem [#3617]
269
+ - Refactor Worker.set so it can be memoized [#3602]
270
+ - Fix display of Redis URL in web footer, broken in 5.0.3 [#3560]
271
+ - Update `Sidekiq::Job#display_args` to avoid mutation [#3621]
272
+
273
+ 5.0.4
274
+ -----------
275
+
276
+ - Fix "slow startup" performance regression from 5.0.2. [#3525]
277
+ - Allow users to disable ID generation since some redis providers disable the CLIENT command. [#3521]
278
+
279
+ 5.0.3
280
+ -----------
281
+
282
+ - Fix overriding `class_attribute` core extension from ActiveSupport with Sidekiq one [PikachuEXE, #3499]
283
+ - Allow job logger to be overridden [AlfonsoUceda, #3502]
284
+ - Set a default Redis client identifier for debugging [#3516]
285
+ - Fix "Uninitialized constant" errors on startup with the delayed extensions [#3509]
286
+
287
+ 5.0.2
288
+ -----------
289
+
290
+ - fix broken release, thanks @nateberkopec
291
+
292
+ 5.0.1
293
+ -----------
294
+
295
+ - Fix incorrect server identity when daemonizing [jwilm, #3496]
296
+ - Work around error running Web UI against Redis Cluster [#3492]
297
+ - Remove core extensions, Sidekiq is now monkeypatch-free! [#3474]
298
+ - Reimplement Web UI's HTTP\_ACCEPT\_LANGUAGE parsing because the spec is utterly
299
+ incomprehensible for various edge cases. [johanlunds, natematykiewicz, #3449]
300
+ - Update `class_attribute` core extension to avoid warnings
301
+ - Expose `job_hash_context` from `Sidekiq::Logging` to support log customization
302
+
303
+ 5.0.0
304
+ -----------
305
+
306
+ - **BREAKING CHANGE** Job dispatch was refactored for safer integration with
307
+ Rails 5. The **Logging** and **RetryJobs** server middleware were removed and
308
+ functionality integrated directly into Sidekiq::Processor. These aren't
309
+ commonly used public APIs so this shouldn't impact most users.
310
+ ```
311
+ Sidekiq::Middleware::Server::RetryJobs -> Sidekiq::JobRetry
312
+ Sidekiq::Middleware::Server::Logging -> Sidekiq::JobLogger
313
+ ```
314
+ - Quieting Sidekiq is now done via the TSTP signal, the USR1 signal is deprecated.
315
+ - The `delay` extension APIs are no longer available by default, you
316
+ must opt into them.
317
+ - The Web UI is now BiDi and can render RTL languages like Arabic, Farsi and Hebrew.
318
+ - Rails 3.2 and Ruby 2.0 and 2.1 are no longer supported.
319
+ - The `SomeWorker.set(options)` API was re-written to avoid thread-local state. [#2152]
320
+ - Sidekiq Enterprise's encrypted jobs now display "[encrypted data]" in the Web UI instead
321
+ of random hex bytes.
322
+ - Please see the [5.0 Upgrade notes](5.0-Upgrade.md) for more detail.
323
+
324
+ 4.2.10
325
+ -----------
326
+
327
+ - Scheduled jobs can now be moved directly to the Dead queue via API [#3390]
328
+ - Fix edge case leading to job duplication when using Sidekiq Pro's
329
+ reliability feature [#3388]
330
+ - Fix error class name display on retry page [#3348]
331
+ - More robust latency calculation [#3340]
332
+
333
+ 4.2.9
334
+ -----------
335
+
336
+ - Rollback [#3303] which broke Heroku Redis users [#3311]
337
+ - Add support for TSTP signal, for Sidekiq 5.0 forward compatibility. [#3302]
338
+
339
+ 4.2.8
340
+ -----------
341
+
342
+ - Fix rare edge case with Redis driver that can create duplicate jobs [#3303]
343
+ - Fix Rails 5 loading issue [#3275]
344
+ - Restore missing tooltips to timestamps in Web UI [#3310]
345
+ - Work on **Sidekiq 5.0** is now active! [#3301]
346
+
347
+ 4.2.7
348
+ -----------
349
+
350
+ - Add new integration testing to verify code loading and job execution
351
+ in development and production modes with Rails 4 and 5 [#3241]
352
+ - Fix delayed extensions in development mode [#3227, DarthSim]
353
+ - Use Worker's `retry` default if job payload does not have a retry
354
+ attribute [#3234, mlarraz]
355
+
356
+ 4.2.6
357
+ -----------
358
+
359
+ - Run Rails Executor when in production [#3221, eugeneius]
360
+
361
+ 4.2.5
362
+ -----------
363
+
364
+ - Re-enable eager loading of all code when running non-development Rails 5. [#3203]
365
+ - Better root URL handling for zany web servers [#3207]
366
+
367
+ 4.2.4
368
+ -----------
369
+
370
+ - Log errors coming from the Rails 5 reloader. [#3212, eugeneius]
371
+ - Clone job data so middleware changes don't appear in Busy tab
372
+
373
+ 4.2.3
374
+ -----------
375
+
376
+ - Disable use of Rails 5's Reloader API in non-development modes, it has proven
377
+ to be unstable under load [#3154]
378
+ - Allow disabling of Sidekiq::Web's cookie session to handle the
379
+ case where the app provides a session already [#3180, inkstak]
380
+ ```ruby
381
+ Sidekiq::Web.set :sessions, false
382
+ ```
383
+ - Fix Web UI sharding support broken in 4.2.2. [#3169]
384
+ - Fix timestamps not updating during UI polling [#3193, shaneog]
385
+ - Relax rack-protection version to >= 1.5.0
386
+ - Provide consistent interface to exception handlers, changing the structure of the context hash. [#3161]
387
+
388
+ 4.2.2
389
+ -----------
390
+
391
+ - Fix ever-increasing cookie size with nginx [#3146, cconstantine]
392
+ - Fix so Web UI works without trailing slash [#3158, timdorr]
393
+
394
+ 4.2.1
395
+ -----------
396
+
397
+ - Ensure browser does not cache JSON/AJAX responses. [#3136]
398
+ - Support old Sinatra syntax for setting config [#3139]
399
+
400
+ 4.2.0
401
+ -----------
402
+
403
+ - Enable development-mode code reloading. **With Rails 5.0+, you don't need
404
+ to restart Sidekiq to pick up your Sidekiq::Worker changes anymore!** [#2457]
405
+ - **Remove Sinatra dependency**. Sidekiq's Web UI now uses Rack directly.
406
+ Thank you to Sidekiq's newest committer, **badosu**, for writing the code
407
+ and doing a lot of testing to ensure compatibility with many different
408
+ 3rd party plugins. If your Web UI works with 4.1.4 but fails with
409
+ 4.2.0, please open an issue. [#3075]
410
+ - Allow tuning of concurrency with the `RAILS_MAX_THREADS` env var. [#2985]
411
+ This is the same var used by Puma so you can tune all of your systems
412
+ the same way:
413
+ ```sh
414
+ web: RAILS_MAX_THREADS=5 bundle exec puma ...
415
+ worker: RAILS_MAX_THREADS=10 bundle exec sidekiq ...
416
+ ```
417
+ Using `-c` or `config/sidekiq.yml` overrides this setting. I recommend
418
+ adjusting your `config/database.yml` to use it too so connections are
419
+ auto-scaled:
420
+ ```yaml
421
+ pool: <%= ENV['RAILS_MAX_THREADS'] || 5 %>
422
+ ```
423
+
424
+ 4.1.4
425
+ -----------
426
+
427
+ - Unlock Sinatra so a Rails 5.0 compatible version may be used [#3048]
428
+ - Fix race condition on startup with JRuby [#3043]
429
+
430
+
431
+ 4.1.3
432
+ -----------
433
+
434
+ - Please note the Redis 3.3.0 gem has a [memory leak](https://github.com/redis/redis-rb/issues/612),
435
+ Redis 3.2.2 is recommended until that issue is fixed.
436
+ - Sinatra 1.4.x is now a required dependency, avoiding cryptic errors
437
+ and old bugs due to people not upgrading Sinatra for years. [#3042]
438
+ - Fixed race condition in heartbeat which could rarely lead to lingering
439
+ processes on the Busy tab. [#2982]
440
+ ```ruby
441
+ # To clean up lingering processes, modify this as necessary to connect to your Redis.
442
+ # After 60 seconds, lingering processes should disappear from the Busy page.
443
+
444
+ require 'redis'
445
+ r = Redis.new(url: "redis://localhost:6379/0")
446
+ # uncomment if you need a namespace
447
+ #require 'redis-namespace'
448
+ #r = Redis::Namespace.new("foo", r)
449
+ r.smembers("processes").each do |pro|
450
+ r.expire(pro, 60)
451
+ r.expire("#{pro}:workers", 60)
452
+ end
453
+ ```
454
+
455
+
456
+ 4.1.2
457
+ -----------
458
+
459
+ - Fix Redis data leak with worker data when a busy Sidekiq process
460
+ crashes. You can find and expire leaked data in Redis with this
461
+ script:
462
+ ```bash
463
+ $ redis-cli keys "*:workers" | while read LINE ; do TTL=`redis-cli expire "$LINE" 60`; echo "$LINE"; done;
464
+ ```
465
+ Please note that `keys` can be dangerous to run on a large, busy Redis. Caveat runner.
466
+ - Freeze all string literals with Ruby 2.3. [#2741]
467
+ - Client middleware can now stop bulk job push. [#2887]
468
+
469
+ 4.1.1
470
+ -----------
471
+
472
+ - Much better behavior when Redis disappears and comes back. [#2866]
473
+ - Update FR locale [dbachet]
474
+ - Don't fill logfile in case of Redis downtime [#2860]
475
+ - Allow definition of a global retries_exhausted handler. [#2807]
476
+ ```ruby
477
+ Sidekiq.configure_server do |config|
478
+ config.default_retries_exhausted = -> (job, ex) do
479
+ Sidekiq.logger.info "#{job['class']} job is now dead"
480
+ end
481
+ end
482
+ ```
483
+
484
+ 4.1.0
485
+ -----------
486
+
487
+ - Tag quiet processes in the Web UI [#2757, jcarlson]
488
+ - Pass last exception to sidekiq\_retries\_exhausted block [#2787, Nowaker]
489
+ ```ruby
490
+ class MyWorker
491
+ include Sidekiq::Worker
492
+ sidekiq_retries_exhausted do |job, exception|
493
+ end
494
+ end
495
+ ```
496
+ - Add native support for ActiveJob's `set(options)` method allowing
497
+ you to override worker options dynamically. This should make it
498
+ even easier to switch between ActiveJob and Sidekiq's native APIs [#2780]
499
+ ```ruby
500
+ class MyWorker
501
+ include Sidekiq::Worker
502
+ sidekiq_options queue: 'default', retry: true
503
+
504
+ def perform(*args)
505
+ # do something
506
+ end
507
+ end
508
+
509
+ MyWorker.set(queue: 'high', retry: false).perform_async(1)
510
+ ```
511
+
512
+ 4.0.2
513
+ -----------
514
+
515
+ - Better Japanese translations
516
+ - Remove `json` gem dependency from gemspec. [#2743]
517
+ - There's a new testing API based off the `Sidekiq::Queues` namespace. All
518
+ assertions made against the Worker class still work as expected.
519
+ [#2676, brandonhilkert]
520
+ ```ruby
521
+ assert_equal 0, Sidekiq::Queues["default"].size
522
+ HardWorker.perform_async("log")
523
+ assert_equal 1, Sidekiq::Queues["default"].size
524
+ assert_equal "log", Sidekiq::Queues["default"].first['args'][0]
525
+ Sidekiq::Queues.clear_all
526
+ ```
527
+
528
+ 4.0.1
529
+ -----------
530
+
531
+ - Yank new queue-based testing API [#2663]
532
+ - Fix invalid constant reference in heartbeat
533
+
534
+ 4.0.0
535
+ -----------
536
+
537
+ - Sidekiq's internals have been completely overhauled for performance
538
+ and to remove dependencies. This has resulted in major speedups, as
539
+ [detailed on my blog](http://www.mikeperham.com/2015/10/14/optimizing-sidekiq/).
540
+ - See the [4.0 upgrade notes](4.0-Upgrade.md) for more detail.
541
+
542
+ 3.5.4
543
+ -----------
544
+
545
+ - Ensure exception message is a string [#2707]
546
+ - Revert racy Process.kill usage in sidekiqctl
547
+
548
+ 3.5.3
549
+ -----------
550
+
551
+ - Adjust shutdown event to run in parallel with the rest of system shutdown. [#2635]
552
+
553
+ 3.5.2
554
+ -----------
555
+
556
+ - **Sidekiq 3 is now in maintenance mode**, only major bugs will be fixed.
557
+ - The exception triggering a retry is now passed into `sidekiq_retry_in`,
558
+ allowing you to retry more frequently for certain types of errors.
559
+ [#2619, kreynolds]
560
+ ```ruby
561
+ sidekiq_retry_in do |count, ex|
562
+ case ex
563
+ when RuntimeError
564
+ 5 * count
565
+ else
566
+ 10 * count
567
+ end
568
+ end
569
+ ```
570
+
571
+ 3.5.1
572
+ -----------
573
+
574
+ - **FIX MEMORY LEAK** Under rare conditions, threads may leak [#2598, gazay]
575
+ - Add Ukrainian locale [#2561, elrakita]
576
+ - Disconnect and retry Redis operations if we see a READONLY error [#2550]
577
+ - Add server middleware testing harness; see [wiki](https://github.com/mperham/sidekiq/wiki/Testing#testing-server-middleware) [#2534, ryansch]
578
+
579
+ 3.5.0
580
+ -----------
581
+
582
+ - Polished new banner! [#2522, firedev]
583
+ - Upgrade to Celluloid 0.17. [#2420, digitalextremist]
584
+ - Activate sessions in Sinatra for CSRF protection, requires Rails
585
+ monkeypatch due to rails/rails#15843. [#2460, jc00ke]
586
+
587
+ 3.4.2
588
+ -----------
589
+
590
+ - Don't allow `Sidekiq::Worker` in ActiveJob::Base classes. [#2424]
591
+ - Safer display of job data in Web UI [#2405]
592
+ - Fix CSRF vulnerability in Web UI, thanks to Egor Homakov for
593
+ reporting. [#2422] If you are running the Web UI as a standalone Rack app,
594
+ ensure you have a [session middleware
595
+ configured](https://github.com/mperham/sidekiq/wiki/Monitoring#standalone):
596
+ ```ruby
597
+ use Rack::Session::Cookie, :secret => "some unique secret string here"
598
+ ```
599
+
600
+ 3.4.1
601
+ -----------
602
+
603
+ - Lock to Celluloid 0.16
604
+
605
+
606
+ 3.4.0
607
+ -----------
608
+
609
+ - Set a `created_at` attribute when jobs are created, set `enqueued_at` only
610
+ when they go into a queue. Fixes invalid latency calculations with scheduled jobs.
611
+ [#2373, mrsimo]
612
+ - Don't log timestamp on Heroku [#2343]
613
+ - Run `shutdown` event handlers in reverse order of definition [#2374]
614
+ - Rename and rework `poll_interval` to be simpler, more predictable [#2317, cainlevy]
615
+ The new setting is `average_scheduled_poll_interval`. To configure
616
+ Sidekiq to look for scheduled jobs every 5 seconds, just set it to 5.
617
+ ```ruby
618
+ Sidekiq.configure_server do |config|
619
+ config.average_scheduled_poll_interval = 5
620
+ end
621
+ ```
622
+
623
+ 3.3.4
624
+ -----------
625
+
626
+ - **Improved ActiveJob integration** - Web UI now shows ActiveJobs in a
627
+ nicer format and job logging shows the actual class name, requires
628
+ Rails 4.2.2+ [#2248, #2259]
629
+ - Add Sidekiq::Process#dump\_threads API to trigger TTIN output [#2247]
630
+ - Web UI polling now uses Ajax to avoid page reload [#2266, davydovanton]
631
+ - Several Web UI styling improvements [davydovanton]
632
+ - Add Tamil, Hindi translations for Web UI [ferdinandrosario, tejasbubane]
633
+ - Fix Web UI to work with country-specific locales [#2243]
634
+ - Handle circular error causes [#2285, eugenk]
635
+
636
+ 3.3.3
637
+ -----------
638
+
639
+ - Fix crash on exit when Redis is down [#2235]
640
+ - Fix duplicate logging on startup
641
+ - Undeprecate delay extension for ActionMailer 4.2+ . [#2186]
642
+
643
+ 3.3.2
644
+ -----------
645
+
646
+ - Add Sidekiq::Stats#queues back
647
+ - Allows configuration of dead job set size and timeout [#2173, jonhyman]
648
+ - Refactor scheduler enqueuing so Sidekiq Pro can override it. [#2159]
649
+
650
+ 3.3.1
651
+ -----------
652
+
653
+ - Dumb down ActionMailer integration so it tries to deliver if possible [#2149]
654
+ - Stringify Sidekiq.default\_worker\_options's keys [#2126]
655
+ - Add random integer to process identity [#2113, michaeldiscala]
656
+ - Log Sidekiq Pro's Batch ID if available [#2076]
657
+ - Refactor Processor Redis usage to avoid redis/redis-rb#490 [#2094]
658
+ - Move /dashboard/stats to /stats. Add /stats/queues. [moserke, #2099]
659
+ - Add processes count to /stats [ismaelga, #2141]
660
+ - Greatly improve speed of Sidekiq::Stats [ismaelga, #2142]
661
+ - Add better usage text for `sidekiqctl`.
662
+ - `Sidekiq::Logging.with_context` is now a stack so you can set your
663
+ own job context for logging purposes [grosser, #2110]
664
+ - Remove usage of Google Fonts in Web UI so it loads in China [#2144]
665
+
666
+ 3.3.0
667
+ -----------
668
+
669
+ - Upgrade to Celluloid 0.16 [#2056]
670
+ - Fix typo for generator test file name [dlackty, #2016]
671
+ - Add Sidekiq::Middleware::Chain#prepend [seuros, #2029]
672
+
673
+ 3.2.6
674
+ -----------
675
+
676
+ - Deprecate delay extension for ActionMailer 4.2+ . [seuros, #1933]
677
+ - Poll interval tuning now accounts for dead processes [epchris, #1984]
678
+ - Add non-production environment to Web UI page titles [JacobEvelyn, #2004]
679
+
680
+ 3.2.5
681
+ -----------
682
+
683
+ - Lock Celluloid to 0.15.2 due to bugs in 0.16.0. This prevents the
684
+ "hang on shutdown" problem with Celluloid 0.16.0.
685
+
686
+ 3.2.4
687
+ -----------
688
+
689
+ - Fix issue preventing ActionMailer sends working in some cases with
690
+ Rails 4. [pbhogan, #1923]
691
+
692
+ 3.2.3
693
+ -----------
694
+
695
+ - Clean invalid bytes from error message before converting to JSON (requires Ruby 2.1+) [#1705]
696
+ - Add queues list for each process to the Busy page. [davetoxa, #1897]
697
+ - Fix for crash caused by empty config file. [jordan0day, #1901]
698
+ - Add Rails Worker generator, `rails g sidekiq:worker User` will create `app/workers/user_worker.rb`. [seuros, #1909]
699
+ - Fix Web UI rendering with huge job arguments [jhass, #1918]
700
+ - Minor refactoring of Sidekiq::Client internals, for Sidekiq Pro. [#1919]
701
+
702
+ 3.2.2
703
+ -----------
704
+
705
+ - **This version of Sidekiq will no longer start on Ruby 1.9.** Sidekiq
706
+ 3 does not support MRI 1.9 but we've allowed it to run before now.
707
+ - Fix issue which could cause Sidekiq workers to disappear from the Busy
708
+ tab while still being active [#1884]
709
+ - Add "Back to App" button in Web UI. You can set the button link via
710
+ `Sidekiq::Web.app_url = 'http://www.mysite.com'` [#1875, seuros]
711
+ - Add process tag (`-g tag`) to the Busy page so you can differentiate processes at a glance. [seuros, #1878]
712
+ - Add "Kill" button to move retries directly to the DJQ so they don't retry. [seuros, #1867]
713
+
714
+ 3.2.1
715
+ -----------
716
+
717
+ - Revert eager loading change for Rails 3.x apps, as it broke a few edge
718
+ cases.
719
+
720
+ 3.2.0
721
+ -----------
722
+
723
+ - **Fix issue which caused duplicate job execution in Rails 3.x**
724
+ This issue is caused by [improper exception handling in ActiveRecord](https://github.com/rails/rails/blob/3-2-stable/activerecord/lib/active_record/connection_adapters/abstract_adapter.rb#L281) which changes Sidekiq's Shutdown exception into a database
725
+ error, making Sidekiq think the job needs to be retried. **The fix requires Ruby 2.1**. [#1805]
726
+ - Update how Sidekiq eager loads Rails application code [#1791, jonleighton]
727
+ - Change logging timestamp to show milliseconds.
728
+ - Reverse sorting of Dead tab so newer jobs are listed first [#1802]
729
+
730
+ 3.1.4
731
+ -----------
732
+
733
+ - Happy π release!
734
+ - Self-tuning Scheduler polling, we use heartbeat info to better tune poll\_interval [#1630]
735
+ - Remove all table column width rules, hopefully get better column formatting [#1747]
736
+ - Handle edge case where YAML can't be decoded in dev mode [#1761]
737
+ - Fix lingering jobs in Busy page on Heroku [#1764]
738
+
739
+ 3.1.3
740
+ -----------
741
+
742
+ - Use ENV['DYNO'] on Heroku for hostname display, rather than an ugly UUID. [#1742]
743
+ - Show per-process labels on the Busy page, for feature tagging [#1673]
744
+
745
+
746
+ 3.1.2
747
+ -----------
748
+
749
+ - Suitably chastised, @mperham reverts the Bundler change.
750
+
751
+
752
+ 3.1.1
753
+ -----------
754
+
755
+ - Sidekiq::CLI now runs `Bundler.require(:default, environment)` to boot all gems
756
+ before loading any app code.
757
+ - Sort queues by name in Web UI [#1734]
758
+
759
+
760
+ 3.1.0
761
+ -----------
762
+
763
+ - New **remote control** feature: you can remotely trigger Sidekiq to quiet
764
+ or terminate via API, without signals. This is most useful on JRuby
765
+ or Heroku which does not support the USR1 'quiet' signal. Now you can
766
+ run a rake task like this at the start of your deploy to quiet your
767
+ set of Sidekiq processes. [#1703]
768
+ ```ruby
769
+ namespace :sidekiq do
770
+ task :quiet => :environment do
771
+ Sidekiq::ProcessSet.new.each(&:quiet!)
772
+ end
773
+ end
774
+ ```
775
+ - The Web UI can use the API to quiet or stop all processes via the Busy page.
776
+ - The Web UI understands and hides the `Sidekiq::Extensions::Delay*`
777
+ classes, instead showing `Class.method` as the Job. [#1718]
778
+ - Polish the Dashboard graphs a bit, update Rickshaw [brandonhilkert, #1725]
779
+ - The poll interval is now configurable in the Web UI [madebydna, #1713]
780
+ - Delay extensions can be removed so they don't conflict with
781
+ DelayedJob: put `Sidekiq.remove_delay!` in your initializer. [devaroop, #1674]
782
+
783
+
784
+ 3.0.2
785
+ -----------
786
+
787
+ - Revert gemfile requirement of Ruby 2.0. JRuby 1.7 calls itself Ruby
788
+ 1.9.3 and broke with this requirement.
789
+
790
+ 3.0.1
791
+ -----------
792
+
793
+ - Revert pidfile behavior from 2.17.5: Sidekiq will no longer remove its own pidfile
794
+ as this is a race condition when restarting. [#1470, #1677]
795
+ - Show warning on the Queues page if a queue is paused [#1672]
796
+ - Only activate the ActiveRecord middleware if ActiveRecord::Base is defined on boot. [#1666]
797
+ - Add ability to disable jobs going to the DJQ with the `dead` option.
798
+ ```ruby
799
+ sidekiq_options :dead => false, :retry => 5
800
+ ```
801
+ - Minor fixes
802
+
803
+
804
+ 3.0.0
805
+ -----------
806
+
807
+ Please see [3.0-Upgrade.md](3.0-Upgrade.md) for more comprehensive upgrade notes.
808
+
809
+ - **Dead Job Queue** - jobs which run out of retries are now moved to a dead
810
+ job queue. These jobs must be retried manually or they will expire
811
+ after 6 months or 10,000 jobs. The Web UI contains a "Dead" tab
812
+ exposing these jobs. Use `sidekiq_options :retry => false` if you
813
+ don't wish jobs to be retried or put in the DJQ. Use
814
+ `sidekiq_options :retry => 0` if you don't want jobs to retry but go
815
+ straight to the DJQ.
816
+ - **Process Lifecycle Events** - you can now register blocks to run at
817
+ certain points during the Sidekiq process lifecycle: startup, quiet and
818
+ shutdown.
819
+ ```ruby
820
+ Sidekiq.configure_server do |config|
821
+ config.on(:startup) do
822
+ # do something
823
+ end
824
+ end
825
+ ```
826
+ - **Global Error Handlers** - blocks of code which handle errors that
827
+ occur anywhere within Sidekiq, not just within middleware.
828
+ ```ruby
829
+ Sidekiq.configure_server do |config|
830
+ config.error_handlers << proc {|ex,ctx| ... }
831
+ end
832
+ ```
833
+ - **Process Heartbeat** - each Sidekiq process will ping Redis every 5
834
+ seconds to give a summary of the Sidekiq population at work.
835
+ - The Workers tab is now renamed to Busy and contains a list of live
836
+ Sidekiq processes and jobs in progress based on the heartbeat.
837
+ - **Shardable Client** - Sidekiq::Client instances can use a custom
838
+ Redis connection pool, allowing very large Sidekiq installations to scale by
839
+ sharding: sending different jobs to different Redis instances.
840
+ ```ruby
841
+ client = Sidekiq::Client.new(ConnectionPool.new { Redis.new })
842
+ client.push(...)
843
+ ```
844
+ ```ruby
845
+ Sidekiq::Client.via(ConnectionPool.new { Redis.new }) do
846
+ FooWorker.perform_async
847
+ BarWorker.perform_async
848
+ end
849
+ ```
850
+ **Sharding support does require a breaking change to client-side
851
+ middleware, see 3.0-Upgrade.md.**
852
+ - New Chinese, Greek, Swedish and Czech translations for the Web UI.
853
+ - Updated most languages translations for the new UI features.
854
+ - **Remove official Capistrano integration** - this integration has been
855
+ moved into the [capistrano-sidekiq](https://github.com/seuros/capistrano-sidekiq) gem.
856
+ - **Remove official support for MRI 1.9** - Things still might work but
857
+ I no longer actively test on it.
858
+ - **Remove built-in support for Redis-to-Go**.
859
+ Heroku users: `heroku config:set REDIS_PROVIDER=REDISTOGO_URL`
860
+ - **Remove built-in error integration for Airbrake, Honeybadger, ExceptionNotifier and Exceptional**.
861
+ Each error gem should provide its own Sidekiq integration. Update your error gem to the latest
862
+ version to pick up Sidekiq support.
863
+ - Upgrade to connection\_pool 2.0 which now creates connections lazily.
864
+ - Remove deprecated Sidekiq::Client.registered\_\* APIs
865
+ - Remove deprecated support for the old Sidekiq::Worker#retries\_exhausted method.
866
+ - Removed 'sidekiq/yaml\_patch', this was never documented or recommended.
867
+ - Removed --profile option, #1592
868
+ - Remove usage of the term 'Worker' in the UI for clarity. Users would call both threads and
869
+ processes 'workers'. Instead, use "Thread", "Process" or "Job".
870
+
871
+ 2.17.7
872
+ -----------
873
+
874
+ - Auto-prune jobs older than one hour from the Workers page [#1508]
875
+ - Add Sidekiq::Workers#prune which can perform the auto-pruning.
876
+ - Fix issue where a job could be lost when an exception occurs updating
877
+ Redis stats before the job executes [#1511]
878
+
879
+ 2.17.6
880
+ -----------
881
+
882
+ - Fix capistrano integration due to missing pidfile. [#1490]
883
+
884
+ 2.17.5
885
+ -----------
886
+
887
+ - Automatically use the config file found at `config/sidekiq.yml`, if not passed `-C`. [#1481]
888
+ - Store 'retried\_at' and 'failed\_at' timestamps as Floats, not Strings. [#1473]
889
+ - A `USR2` signal will now reopen _all_ logs, using IO#reopen. Thus, instead of creating a new Logger object,
890
+ Sidekiq will now just update the existing Logger's file descriptor [#1163].
891
+ - Remove pidfile when shutting down if started with `-P` [#1470]
892
+
893
+ 2.17.4
894
+ -----------
895
+
896
+ - Fix JID support in inline testing, #1454
897
+ - Polish worker arguments display in UI, #1453
898
+ - Marshal arguments fully to avoid worker mutation, #1452
899
+ - Support reverse paging sorted sets, #1098
900
+
901
+
902
+ 2.17.3
903
+ -----------
904
+
905
+ - Synchronously terminates the poller and fetcher to fix a race condition in bulk requeue during shutdown [#1406]
906
+
907
+ 2.17.2
908
+ -----------
909
+
910
+ - Fix bug where strictly prioritized queues might be processed out of
911
+ order [#1408]. A side effect of this change is that it breaks a queue
912
+ declaration syntax that worked, although only because of a bug—it was
913
+ never intended to work and never supported. If you were declaring your
914
+ queues as a comma-separated list, e.g. `sidekiq -q critical,default,low`,
915
+ you must now use the `-q` flag before each queue, e.g.
916
+ `sidekiq -q critical -q default -q low`.
917
+
918
+ 2.17.1
919
+ -----------
920
+
921
+ - Expose `delay` extension as `sidekiq_delay` also. This allows you to
922
+ run Delayed::Job and Sidekiq in the same process, selectively porting
923
+ `delay` calls to `sidekiq_delay`. You just need to ensure that
924
+ Sidekiq is required **before** Delayed::Job in your Gemfile. [#1393]
925
+ - Bump redis client required version to 3.0.6
926
+ - Minor CSS fixes for Web UI
927
+
928
+ 2.17.0
929
+ -----------
930
+
931
+ - Change `Sidekiq::Client#push_bulk` to return an array of pushed `jid`s. [#1315, barelyknown]
932
+ - Web UI refactoring to use more API internally (yummy dogfood!)
933
+ - Much faster Sidekiq::Job#delete performance for larger queue sizes
934
+ - Further capistrano 3 fixes
935
+ - Many misc minor fixes
936
+
937
+ 2.16.1
938
+ -----------
939
+
940
+ - Revert usage of `resolv-replace`. MRI's native DNS lookup releases the GIL.
941
+ - Fix several Capistrano 3 issues
942
+ - Escaping dynamic data like job args and error messages in Sidekiq Web UI. [#1299, lian]
943
+
944
+ 2.16.0
945
+ -----------
946
+
947
+ - Deprecate `Sidekiq::Client.registered_workers` and `Sidekiq::Client.registered_queues`
948
+ - Refactor Sidekiq::Client to be instance-based [#1279]
949
+ - Pass all Redis options to the Redis driver so Unix sockets
950
+ can be fully configured. [#1270, salimane]
951
+ - Allow sidekiq-web extensions to add locale paths so extensions
952
+ can be localized. [#1261, ondrejbartas]
953
+ - Capistrano 3 support [#1254, phallstrom]
954
+ - Use Ruby's `resolv-replace` to enable pure Ruby DNS lookups.
955
+ This ensures that any DNS resolution that takes place in worker
956
+ threads won't lock up the entire VM on MRI. [#1258]
957
+
958
+ 2.15.2
959
+ -----------
960
+
961
+ - Iterating over Sidekiq::Queue and Sidekiq::SortedSet will now work as
962
+ intended when jobs are deleted [#866, aackerman]
963
+ - A few more minor Web UI fixes [#1247]
964
+
965
+ 2.15.1
966
+ -----------
967
+
968
+ - Fix several Web UI issues with the Bootstrap 3 upgrade.
969
+
970
+ 2.15.0
971
+ -----------
972
+
973
+ - The Core Sidekiq actors are now monitored. If any crash, the
974
+ Sidekiq process logs the error and exits immediately. This is to
975
+ help prevent "stuck" Sidekiq processes which are running but don't
976
+ appear to be doing any work. [#1194]
977
+ - Sidekiq's testing behavior is now dynamic. You can choose between
978
+ `inline` and `fake` behavior in your tests. See
979
+ [Testing](https://github.com/mperham/sidekiq/wiki/Testing) for detail. [#1193]
980
+ - The Retries table has a new column for the error message.
981
+ - The Web UI topbar now contains the status and live poll button.
982
+ - Orphaned worker records are now auto-vacuumed when you visit the
983
+ Workers page in the Web UI.
984
+ - Sidekiq.default\_worker\_options allows you to configure default
985
+ options for all Sidekiq worker types.
986
+
987
+ ```ruby
988
+ Sidekiq.default_worker_options = { 'queue' => 'default', 'backtrace' => true }
989
+ ```
990
+ - Added two Sidekiq::Client class methods for compatibility with resque-scheduler:
991
+ `enqueue_to_in` and `enqueue_in` [#1212]
992
+ - Upgrade Web UI to Bootstrap 3.0. [#1211, jeffboek]
993
+
994
+ 2.14.1
995
+ -----------
996
+
997
+ - Fix misc Web UI issues due to ERB conversion.
998
+ - Bump redis-namespace version due to security issue.
999
+
1000
+ 2.14.0
1001
+ -----------
1002
+
1003
+ - Removed slim gem dependency, Web UI now uses ERB [Locke23rus, #1120]
1004
+ - Fix more race conditions in Web UI actions
1005
+ - Don't reset Job enqueued\_at when retrying
1006
+ - Timestamp tooltips in the Web UI should use UTC
1007
+ - Fix invalid usage of handle\_exception causing issues in Airbrake
1008
+ [#1134]
1009
+
1010
+
1011
+ 2.13.1
1012
+ -----------
1013
+
1014
+ - Make Sidekiq::Middleware::Chain Enumerable
1015
+ - Make summary bar and graphs responsive [manishval, #1025]
1016
+ - Adds a job status page for scheduled jobs [jonhyman]
1017
+ - Handle race condition in retrying and deleting jobs in the Web UI
1018
+ - The Web UI relative times are now i18n. [MadRabbit, #1088]
1019
+ - Allow for default number of retry attempts to be set for
1020
+ `Sidekiq::Middleware::Server::RetryJobs` middleware. [czarneckid] [#1091]
1021
+
1022
+ ```ruby
1023
+ Sidekiq.configure_server do |config|
1024
+ config.server_middleware do |chain|
1025
+ chain.add Sidekiq::Middleware::Server::RetryJobs, :max_retries => 10
1026
+ end
1027
+ end
1028
+ ```
1029
+
1030
+
1031
+ 2.13.0
1032
+ -----------
1033
+
1034
+ - Adding button to move scheduled job to main queue [guiceolin, #1020]
1035
+ - fix i18n support resetting saved locale when job is retried [#1011]
1036
+ - log rotation via USR2 now closes the old logger [#1008]
1037
+ - Add ability to customize retry schedule, like so [jmazzi, #1027]
1038
+
1039
+ ```ruby
1040
+ class MyWorker
1041
+ include Sidekiq::Worker
1042
+ sidekiq_retry_in { |count| count * 2 }
1043
+ end
1044
+ ```
1045
+ - Redesign Worker#retries\_exhausted callback to use same form as above [jmazzi, #1030]
1046
+
1047
+ ```ruby
1048
+ class MyWorker
1049
+ include Sidekiq::Worker
1050
+ sidekiq_retries_exhausted do |msg|
1051
+ Rails.logger.error "Failed to process #{msg['class']} with args: #{msg['args']}"
1052
+ end
1053
+ end
1054
+ ```
1055
+
1056
+ 2.12.4
1057
+ -----------
1058
+
1059
+ - Fix error in previous release which crashed the Manager when a
1060
+ Processor died.
1061
+
1062
+ 2.12.3
1063
+ -----------
1064
+
1065
+ - Revert back to Celluloid's TaskFiber for job processing which has proven to be more
1066
+ stable than TaskThread. [#985]
1067
+ - Avoid possible lockup during hard shutdown [#997]
1068
+
1069
+ At this point, if you are experiencing stability issues with Sidekiq in
1070
+ Ruby 1.9, please try Ruby 2.0. It seems to be more stable.
1071
+
1072
+ 2.12.2
1073
+ -----------
1074
+
1075
+ - Relax slim version requirement to >= 1.1.0
1076
+ - Refactor historical stats to use TTL, not explicit cleanup. [grosser, #971]
1077
+
1078
+ 2.12.1
1079
+ -----------
1080
+
1081
+ - Force Celluloid 0.14.1 as 0.14.0 has a serious bug. [#954]
1082
+ - Scheduled and Retry jobs now use Sidekiq::Client to push
1083
+ jobs onto the queue, so they use client middleware. [dimko, #948]
1084
+ - Record the timestamp when jobs are enqueued. Add
1085
+ Sidekiq::Job#enqueued\_at to query the time. [mariovisic, #944]
1086
+ - Add Sidekiq::Queue#latency - calculates diff between now and
1087
+ enqueued\_at for the oldest job in the queue.
1088
+ - Add testing method `perform_one` that dequeues and performs a single job.
1089
+ This is mainly to aid testing jobs that spawn other jobs. [fumin, #963]
1090
+
1091
+ 2.12.0
1092
+ -----------
1093
+
1094
+ - Upgrade to Celluloid 0.14, remove the use of Celluloid's thread
1095
+ pool. This should halve the number of threads in each Sidekiq
1096
+ process, thus requiring less resources. [#919]
1097
+ - Abstract Celluloid usage to Sidekiq::Actor for testing purposes.
1098
+ - Better handling for Redis downtime when fetching jobs and shutting
1099
+ down, don't print exceptions every second and print success message
1100
+ when Redis is back.
1101
+ - Fix unclean shutdown leading to duplicate jobs [#897]
1102
+ - Add Korean locale [#890]
1103
+ - Upgrade test suite to Minitest 5
1104
+ - Remove usage of `multi_json` as `json` is now robust on all platforms.
1105
+
1106
+ 2.11.2
1107
+ -----------
1108
+
1109
+ - Fix Web UI when used without Rails [#886]
1110
+ - Add Sidekiq::Stats#reset [#349]
1111
+ - Add Norwegian locale.
1112
+ - Updates for the JA locale.
1113
+
1114
+ 2.11.1
1115
+ -----------
1116
+
1117
+ - Fix timeout warning.
1118
+ - Add Dutch web UI locale.
1119
+
1120
+ 2.11.0
1121
+ -----------
1122
+
1123
+ - Upgrade to Celluloid 0.13. [#834]
1124
+ - Remove **timeout** support from `sidekiq_options`. Ruby's timeout
1125
+ is inherently unsafe in a multi-threaded application and was causing
1126
+ stability problems for many. See http://bit.ly/OtYpK
1127
+ - Add Japanese locale for Web UI [#868]
1128
+ - Fix a few issues with Web UI i18n.
1129
+
1130
+ 2.10.1
1131
+ -----------
1132
+
1133
+ - Remove need for the i18n gem. (brandonhilkert)
1134
+ - Improve redis connection info logging on startup for debugging
1135
+ purposes [#858]
1136
+ - Revert sinatra/slim as runtime dependencies
1137
+ - Add `find_job` method to sidekiq/api
1138
+
1139
+
1140
+ 2.10.0
1141
+ -----------
1142
+
1143
+ - Refactor algorithm for putting scheduled jobs onto the queue [#843]
1144
+ - Fix scheduler thread dying due to incorrect error handling [#839]
1145
+ - Fix issue which left stale workers if Sidekiq wasn't shutdown while
1146
+ quiet. [#840]
1147
+ - I18n for web UI. Please submit translations of `web/locales/en.yml` for
1148
+ your own language. [#811]
1149
+ - 'sinatra', 'slim' and 'i18n' are now gem dependencies for Sidekiq.
1150
+
1151
+
1152
+ 2.9.0
1153
+ -----------
1154
+
1155
+ - Update 'sidekiq/testing' to work with any Sidekiq::Client call. It
1156
+ also serializes the arguments as using Redis would. [#713]
1157
+ - Raise a Sidekiq::Shutdown error within workers which don't finish within the hard
1158
+ timeout. This is to prevent unwanted database transaction commits. [#377]
1159
+ - Lazy load Redis connection pool, you no longer need to specify
1160
+ anything in Passenger or Unicorn's after_fork callback [#794]
1161
+ - Add optional Worker#retries_exhausted hook after max retries failed. [jkassemi, #780]
1162
+ - Fix bug in pagination link to last page [pitr, #774]
1163
+ - Upstart scripts for multiple Sidekiq instances [dariocravero, #763]
1164
+ - Use select via pipes instead of poll to catch signals [mrnugget, #761]
1165
+
1166
+ 2.8.0
1167
+ -----------
1168
+
1169
+ - I18n support! Sidekiq can optionally save and restore the Rails locale
1170
+ so it will be properly set when your jobs execute. Just include
1171
+ `require 'sidekiq/middleware/i18n'` in your sidekiq initializer. [#750]
1172
+ - Fix bug which could lose messages when using namespaces and the message
1173
+ needs to be requeued in Redis. [#744]
1174
+ - Refactor Redis namespace support [#747]. The redis namespace can no longer be
1175
+ passed via the config file, the only supported way is via Ruby in your
1176
+ initializer:
1177
+
1178
+ ```ruby
1179
+ sidekiq_redis = { :url => 'redis://localhost:3679', :namespace => 'foo' }
1180
+ Sidekiq.configure_server { |config| config.redis = sidekiq_redis }
1181
+ Sidekiq.configure_client { |config| config.redis = sidekiq_redis }
1182
+ ```
1183
+
1184
+ A warning is printed out to the log if a namespace is found in your sidekiq.yml.
1185
+
1186
+
1187
+ 2.7.5
1188
+ -----------
1189
+
1190
+ - Capistrano no longer uses daemonization in order to work with JRuby [#719]
1191
+ - Refactor signal handling to work on Ruby 2.0 [#728, #730]
1192
+ - Fix dashboard refresh URL [#732]
1193
+
1194
+ 2.7.4
1195
+ -----------
1196
+
1197
+ - Fixed daemonization, was broken by some internal refactoring in 2.7.3 [#727]
1198
+
1199
+ 2.7.3
1200
+ -----------
1201
+
1202
+ - Real-time dashboard is now the default web page
1203
+ - Make config file optional for capistrano
1204
+ - Fix Retry All button in the Web UI
1205
+
1206
+ 2.7.2
1207
+ -----------
1208
+
1209
+ - Remove gem signing infrastructure. It was causing Sidekiq to break
1210
+ when used via git in Bundler. This is why we can't have nice things. [#688]
1211
+
1212
+
1213
+ 2.7.1
1214
+ -----------
1215
+
1216
+ - Fix issue with hard shutdown [#680]
1217
+
1218
+
1219
+ 2.7.0
1220
+ -----------
1221
+
1222
+ - Add -d daemonize flag, capistrano recipe has been updated to use it [#662]
1223
+ - Support profiling via `ruby-prof` with -p. When Sidekiq is stopped
1224
+ via Ctrl-C, it will output `profile.html`. You must add `gem 'ruby-prof'` to your Gemfile for it to work.
1225
+ - Dynamically update Redis stats on dashboard [brandonhilkert]
1226
+ - Add Sidekiq::Workers API giving programmatic access to the current
1227
+ set of active workers.
1228
+
1229
+ ```
1230
+ workers = Sidekiq::Workers.new
1231
+ workers.size => 2
1232
+ workers.each do |name, work|
1233
+ # name is a unique identifier per Processor instance
1234
+ # work is a Hash which looks like:
1235
+ # { 'queue' => name, 'run_at' => timestamp, 'payload' => msg }
1236
+ end
1237
+ ```
1238
+
1239
+ - Allow environment-specific sections within the config file which
1240
+ override the global values [dtaniwaki, #630]
1241
+
1242
+ ```
1243
+ ---
1244
+ :concurrency: 50
1245
+ :verbose: false
1246
+ staging:
1247
+ :verbose: true
1248
+ :concurrency: 5
1249
+ ```
1250
+
1251
+
1252
+ 2.6.5
1253
+ -----------
1254
+
1255
+ - Several reliability fixes for job requeueing upon termination [apinstein, #622, #624]
1256
+ - Fix typo in capistrano recipe
1257
+ - Add `retry_queue` option so retries can be given lower priority [ryanlower, #620]
1258
+
1259
+ ```ruby
1260
+ sidekiq_options queue: 'high', retry_queue: 'low'
1261
+ ```
1262
+
1263
+ 2.6.4
1264
+ -----------
1265
+
1266
+ - Fix crash upon empty queue [#612]
1267
+
1268
+ 2.6.3
1269
+ -----------
1270
+
1271
+ - sidekiqctl exits with non-zero exit code upon error [jmazzi]
1272
+ - better argument validation in Sidekiq::Client [karlfreeman]
1273
+
1274
+ 2.6.2
1275
+ -----------
1276
+
1277
+ - Add Dashboard beacon indicating when stats are updated. [brandonhilkert, #606]
1278
+ - Revert issue with capistrano restart. [#598]
1279
+
1280
+ 2.6.1
1281
+ -----------
1282
+
1283
+ - Dashboard now live updates summary stats also. [brandonhilkert, #605]
1284
+ - Add middleware chain APIs `insert_before` and `insert_after` for fine
1285
+ tuning the order of middleware. [jackrg, #595]
1286
+
1287
+ 2.6.0
1288
+ -----------
1289
+
1290
+ - Web UI much more mobile friendly now [brandonhilkert, #573]
1291
+ - Enable live polling for every section in Web UI [brandonhilkert, #567]
1292
+ - Add Stats API [brandonhilkert, #565]
1293
+ - Add Stats::History API [brandonhilkert, #570]
1294
+ - Add Dashboard to Web UI with live and historical stat graphs [brandonhilkert, #580]
1295
+ - Add option to log output to a file, reopen log file on USR2 signal [mrnugget, #581]
1296
+
1297
+ 2.5.4
1298
+ -----------
1299
+
1300
+ - `Sidekiq::Client.push` now accepts the worker class as a string so the
1301
+ Sidekiq client does not have to load your worker classes at all. [#524]
1302
+ - `Sidekiq::Client.push_bulk` now works with inline testing.
1303
+ - **Really** fix status icon in Web UI this time.
1304
+ - Add "Delete All" and "Retry All" buttons to Retries in Web UI
1305
+
1306
+
1307
+ 2.5.3
1308
+ -----------
1309
+
1310
+ - Small Web UI fixes
1311
+ - Add `delay_until` so you can delay jobs until a specific timestamp:
1312
+
1313
+ ```ruby
1314
+ Auction.delay_until(@auction.ends_at).close(@auction.id)
1315
+ ```
1316
+
1317
+ This is identical to the existing Sidekiq::Worker method, `perform_at`.
1318
+
1319
+ 2.5.2
1320
+ -----------
1321
+
1322
+ - Remove asset pipeline from Web UI for much faster, simpler runtime. [#499, #490, #481]
1323
+ - Add -g option so the procline better identifies a Sidekiq process, defaults to File.basename(Rails.root). [#486]
1324
+
1325
+ sidekiq 2.5.1 myapp [0 of 25 busy]
1326
+
1327
+ - Add splay to retry time so groups of failed jobs don't fire all at once. [#483]
1328
+
1329
+ 2.5.1
1330
+ -----------
1331
+
1332
+ - Fix issues with core\_ext
1333
+
1334
+ 2.5.0
1335
+ -----------
1336
+
1337
+ - REDESIGNED WEB UI! [unity, cavneb]
1338
+ - Support Honeybadger for error delivery
1339
+ - Inline testing runs the client middleware before executing jobs [#465]
1340
+ - Web UI can now remove jobs from queue. [#466, dleung]
1341
+ - Web UI can now show the full message, not just 100 chars [#464, dleung]
1342
+ - Add APIs for manipulating the retry and job queues. See sidekiq/api. [#457]
1343
+
1344
+
1345
+ 2.4.0
1346
+ -----------
1347
+
1348
+ - ActionMailer.delay.method now only tries to deliver if method returns a valid message.
1349
+ - Logging now uses "MSG-#{Job ID}", not a random msg ID
1350
+ - Allow generic Redis provider as environment variable. [#443]
1351
+ - Add ability to customize sidekiq\_options with delay calls [#450]
1352
+
1353
+ ```ruby
1354
+ Foo.delay(:retry => false).bar
1355
+ Foo.delay(:retry => 10).bar
1356
+ Foo.delay(:timeout => 10.seconds).bar
1357
+ Foo.delay_for(5.minutes, :timeout => 10.seconds).bar
1358
+ ```
1359
+
1360
+ 2.3.3
1361
+ -----------
1362
+
1363
+ - Remove option to disable Rails hooks. [#401]
1364
+ - Allow delay of any module class method
1365
+
1366
+ 2.3.2
1367
+ -----------
1368
+
1369
+ - Fix retry. 2.3.1 accidentally disabled it.
1370
+
1371
+ 2.3.1
1372
+ -----------
1373
+
1374
+ - Add Sidekiq::Client.push\_bulk for bulk adding of jobs to Redis.
1375
+ My own simple test case shows pushing 10,000 jobs goes from 5 sec to 1.5 sec.
1376
+ - Add support for multiple processes per host to Capistrano recipe
1377
+ - Re-enable Celluloid::Actor#defer to fix stack overflow issues [#398]
1378
+
1379
+ 2.3.0
1380
+ -----------
1381
+
1382
+ - Upgrade Celluloid to 0.12
1383
+ - Upgrade Twitter Bootstrap to 2.1.0
1384
+ - Rescue more Exceptions
1385
+ - Change Job ID to be Hex, rather than Base64, for HTTP safety
1386
+ - Use `Airbrake#notify_or_ignore`
1387
+
1388
+ 2.2.1
1389
+ -----------
1390
+
1391
+ - Add support for custom tabs to Sidekiq::Web [#346]
1392
+ - Change capistrano recipe to run 'quiet' before deploy:update\_code so
1393
+ it is run upon both 'deploy' and 'deploy:migrations'. [#352]
1394
+ - Rescue Exception rather than StandardError to catch and log any sort
1395
+ of Processor death.
1396
+
1397
+ 2.2.0
1398
+ -----------
1399
+
1400
+ - Roll back Celluloid optimizations in 2.1.0 which caused instability.
1401
+ - Add extension to delay any arbitrary class method to Sidekiq.
1402
+ Previously this was limited to ActiveRecord classes.
1403
+
1404
+ ```ruby
1405
+ SomeClass.delay.class_method(1, 'mike', Date.today)
1406
+ ```
1407
+
1408
+ - Sidekiq::Client now generates and returns a random, 128-bit Job ID 'jid' which
1409
+ can be used to track the processing of a Job, e.g. for calling back to a webhook
1410
+ when a job is finished.
1411
+
1412
+ 2.1.1
1413
+ -----------
1414
+
1415
+ - Handle networking errors causing the scheduler thread to die [#309]
1416
+ - Rework exception handling to log all Processor and actor death (#325, subelsky)
1417
+ - Clone arguments when calling worker so modifications are discarded. (#265, hakanensari)
1418
+
1419
+ 2.1.0
1420
+ -----------
1421
+
1422
+ - Tune Celluloid to no longer run message processing within a Fiber.
1423
+ This gives us a full Thread stack and also lowers Sidekiq's memory
1424
+ usage.
1425
+ - Add pagination within the Web UI [#253]
1426
+ - Specify which Redis driver to use: *hiredis* or *ruby* (default)
1427
+ - Remove FailureJobs and UniqueJobs, which were optional middleware
1428
+ that I don't want to support in core. [#302]
1429
+
1430
+ 2.0.3
1431
+ -----------
1432
+ - Fix sidekiq-web's navbar on mobile devices and windows under 980px (ezkl)
1433
+ - Fix Capistrano task for first deploys [#259]
1434
+ - Worker subclasses now properly inherit sidekiq\_options set in
1435
+ their superclass [#221]
1436
+ - Add random jitter to scheduler to spread polls across POLL\_INTERVAL
1437
+ window. [#247]
1438
+ - Sidekiq has a new mailing list: sidekiq@librelist.org See README.
1439
+
1440
+ 2.0.2
1441
+ -----------
1442
+
1443
+ - Fix "Retry Now" button on individual retry page. (ezkl)
1444
+
1445
+ 2.0.1
1446
+ -----------
1447
+
1448
+ - Add "Clear Workers" button to UI. If you kill -9 Sidekiq, the workers
1449
+ set can fill up with stale entries.
1450
+ - Update sidekiq/testing to support new scheduled jobs API:
1451
+
1452
+ ```ruby
1453
+ require 'sidekiq/testing'
1454
+ DirectWorker.perform_in(10.seconds, 1, 2)
1455
+ assert_equal 1, DirectWorker.jobs.size
1456
+ assert_in_delta 10.seconds.from_now.to_f, DirectWorker.jobs.last['at'], 0.01
1457
+ ```
1458
+
1459
+ 2.0.0
1460
+ -----------
1461
+
1462
+ - **SCHEDULED JOBS**!
1463
+
1464
+ You can now use `perform_at` and `perform_in` to schedule jobs
1465
+ to run at arbitrary points in the future, like so:
1466
+
1467
+ ```ruby
1468
+ SomeWorker.perform_in(5.days, 'bob', 13)
1469
+ SomeWorker.perform_at(5.days.from_now, 'bob', 13)
1470
+ ```
1471
+
1472
+ It also works with the delay extensions:
1473
+
1474
+ ```ruby
1475
+ UserMailer.delay_for(5.days).send_welcome_email(user.id)
1476
+ ```
1477
+
1478
+ The time is approximately when the job will be placed on the queue;
1479
+ it is not guaranteed to run at precisely at that moment in time.
1480
+
1481
+ This functionality is meant for one-off, arbitrary jobs. I still
1482
+ recommend `whenever` or `clockwork` if you want cron-like,
1483
+ recurring jobs. See `examples/scheduling.rb`
1484
+
1485
+ I want to specially thank @yabawock for his work on sidekiq-scheduler.
1486
+ His extension for Sidekiq 1.x filled an obvious functional gap that I now think is
1487
+ useful enough to implement in Sidekiq proper.
1488
+
1489
+ - Fixed issues due to Redis 3.x API changes. Sidekiq now requires
1490
+ the Redis 3.x client.
1491
+ - Inline testing now round trips arguments through JSON to catch
1492
+ serialization issues (betelgeuse)
1493
+
1494
+ 1.2.1
1495
+ -----------
1496
+
1497
+ - Sidekiq::Worker now has access to Sidekiq's standard logger
1498
+ - Fix issue with non-StandardErrors leading to Processor exhaustion
1499
+ - Fix issue with Fetcher slowing Sidekiq shutdown
1500
+ - Print backtraces for all threads upon TTIN signal [#183]
1501
+ - Overhaul retries Web UI with new index page and bulk operations [#184]
1502
+
1503
+ 1.2.0
1504
+ -----------
1505
+
1506
+ - Full or partial error backtraces can optionally be stored as part of the retry
1507
+ for display in the web UI if you aren't using an error service. [#155]
1508
+
1509
+ ```ruby
1510
+ class Worker
1511
+ include Sidekiq::Worker
1512
+ sidekiq_options :backtrace => [true || 10]
1513
+ end
1514
+ ```
1515
+ - Add timeout option to kill a worker after N seconds (blackgold9)
1516
+
1517
+ ```ruby
1518
+ class HangingWorker
1519
+ include Sidekiq::Worker
1520
+ sidekiq_options :timeout => 600
1521
+ def perform
1522
+ # will be killed if it takes longer than 10 minutes
1523
+ end
1524
+ end
1525
+ ```
1526
+
1527
+ - Fix delayed extensions not available in workers [#152]
1528
+ - In test environments add the `#drain` class method to workers. This method
1529
+ executes all previously queued jobs. (panthomakos)
1530
+ - Sidekiq workers can be run inline during tests, just `require 'sidekiq/testing/inline'` (panthomakos)
1531
+ - Queues can now be deleted from the Sidekiq web UI [#154]
1532
+ - Fix unnecessary shutdown delay due to Retry Poller [#174]
1533
+
1534
+ 1.1.4
1535
+ -----------
1536
+
1537
+ - Add 24 hr expiry for basic keys set in Redis, to avoid any possible leaking.
1538
+ - Only register workers in Redis while working, to avoid lingering
1539
+ workers [#156]
1540
+ - Speed up shutdown significantly.
1541
+
1542
+ 1.1.3
1543
+ -----------
1544
+
1545
+ - Better network error handling when fetching jobs from Redis.
1546
+ Sidekiq will retry once per second until it can re-establish
1547
+ a connection. (ryanlecompte)
1548
+ - capistrano recipe now uses `bundle_cmd` if set [#147]
1549
+ - handle multi\_json API changes (sferik)
1550
+
1551
+ 1.1.2
1552
+ -----------
1553
+
1554
+ - Fix double restart with cap deploy [#137]
1555
+
1556
+ 1.1.1
1557
+ -----------
1558
+
1559
+ - Set procline for easy monitoring of Sidekiq status via "ps aux"
1560
+ - Fix race condition on shutdown [#134]
1561
+ - Fix hang with cap sidekiq:start [#131]
1562
+
1563
+ 1.1.0
1564
+ -----------
1565
+
1566
+ - The Sidekiq license has switched from GPLv3 to LGPLv3!
1567
+ - Sidekiq::Client.push now returns whether the actual Redis
1568
+ operation succeeded or not. [#123]
1569
+ - Remove UniqueJobs from the default middleware chain. Its
1570
+ functionality, while useful, is unexpected for new Sidekiq
1571
+ users. You can re-enable it with the following config.
1572
+ Read #119 for more discussion.
1573
+
1574
+ ```ruby
1575
+ Sidekiq.configure_client do |config|
1576
+ require 'sidekiq/middleware/client/unique_jobs'
1577
+ config.client_middleware do |chain|
1578
+ chain.add Sidekiq::Middleware::Client::UniqueJobs
1579
+ end
1580
+ end
1581
+ Sidekiq.configure_server do |config|
1582
+ require 'sidekiq/middleware/server/unique_jobs'
1583
+ config.server_middleware do |chain|
1584
+ chain.add Sidekiq::Middleware::Server::UniqueJobs
1585
+ end
1586
+ end
1587
+ ```
1588
+
1589
+ 1.0.0
1590
+ -----------
1591
+
1592
+ Thanks to all Sidekiq users and contributors for helping me
1593
+ get to this big milestone!
1594
+
1595
+ - Default concurrency on client-side to 5, not 25 so we don't
1596
+ create as many unused Redis connections, same as ActiveRecord's
1597
+ default pool size.
1598
+ - Ensure redis= is given a Hash or ConnectionPool.
1599
+
1600
+ 0.11.2
1601
+ -----------
1602
+
1603
+ - Implement "safe shutdown". The messages for any workers that
1604
+ are still busy when we hit the TERM timeout will be requeued in
1605
+ Redis so the messages are not lost when the Sidekiq process exits.
1606
+ [#110]
1607
+ - Work around Celluloid's small 4kb stack limit [#115]
1608
+ - Add support for a custom Capistrano role to limit Sidekiq to
1609
+ a set of machines. [#113]
1610
+
1611
+ 0.11.1
1612
+ -----------
1613
+
1614
+ - Fix fetch breaking retry when used with Redis namespaces. [#109]
1615
+ - Redis connection now just a plain ConnectionPool, not CP::Wrapper.
1616
+ - Capistrano initial deploy fix [#106]
1617
+ - Re-implemented weighted queues support (ryanlecompte)
1618
+
1619
+ 0.11.0
1620
+ -----------
1621
+
1622
+ - Client-side API changes, added sidekiq\_options for Sidekiq::Worker.
1623
+ As a side effect of this change, the client API works on Ruby 1.8.
1624
+ It's not officially supported but should work [#103]
1625
+ - NO POLL! Sidekiq no longer polls Redis, leading to lower network
1626
+ utilization and lower latency for message processing.
1627
+ - Add --version CLI option
1628
+
1629
+ 0.10.1
1630
+ -----------
1631
+
1632
+ - Add details page for jobs in retry queue (jcoene)
1633
+ - Display relative timestamps in web interface (jcoene)
1634
+ - Capistrano fixes (hinrik, bensie)
1635
+
1636
+ 0.10.0
1637
+ -----------
1638
+
1639
+ - Reworked capistrano recipe to make it more fault-tolerant [#94].
1640
+ - Automatic failure retry! Sidekiq will now save failed messages
1641
+ and retry them, with an exponential backoff, over about 20 days.
1642
+ Did a message fail to process? Just deploy a bug fix in the next
1643
+ few days and Sidekiq will retry the message eventually.
1644
+
1645
+ 0.9.1
1646
+ -----------
1647
+
1648
+ - Fix missed deprecations, poor method name in web UI
1649
+
1650
+ 0.9.0
1651
+ -----------
1652
+
1653
+ - Add -t option to configure the TERM shutdown timeout
1654
+ - TERM shutdown timeout is now configurable, defaults to 5 seconds.
1655
+ - USR1 signal now stops Sidekiq from accepting new work,
1656
+ capistrano sends USR1 at start of deploy and TERM at end of deploy
1657
+ giving workers the maximum amount of time to finish.
1658
+ - New Sidekiq::Web rack application available
1659
+ - Updated Sidekiq.redis API
1660
+
1661
+ 0.8.0
1662
+ -----------
1663
+
1664
+ - Remove :namespace and :server CLI options (mperham)
1665
+ - Add ExceptionNotifier support (masterkain)
1666
+ - Add capistrano support (mperham)
1667
+ - Workers now log upon start and finish (mperham)
1668
+ - Messages for terminated workers are now automatically requeued (mperham)
1669
+ - Add support for Exceptional error reporting (bensie)
1670
+
1671
+ 0.7.0
1672
+ -----------
1673
+
1674
+ - Example chef recipe and monitrc script (jc00ke)
1675
+ - Refactor global configuration into Sidekiq.configure\_server and
1676
+ Sidekiq.configure\_client blocks. (mperham)
1677
+ - Add optional middleware FailureJobs which saves failed jobs to a
1678
+ 'failed' queue (fbjork)
1679
+ - Upon shutdown, workers are now terminated after 5 seconds. This is to
1680
+ meet Heroku's hard limit of 10 seconds for a process to shutdown. (mperham)
1681
+ - Refactor middleware API for simplicity, see sidekiq/middleware/chain. (mperham)
1682
+ - Add `delay` extensions for ActionMailer and ActiveRecord. (mperham)
1683
+ - Added config file support. See test/config.yml for an example file. (jc00ke)
1684
+ - Added pidfile for tools like monit (jc00ke)
1685
+
1686
+ 0.6.0
1687
+ -----------
1688
+
1689
+ - Resque-compatible processing stats in redis (mperham)
1690
+ - Simple client testing support in sidekiq/testing (mperham)
1691
+ - Plain old Ruby support via the -r cli flag (mperham)
1692
+ - Refactored middleware support, introducing ability to add client-side middleware (ryanlecompte)
1693
+ - Added middleware for ignoring duplicate jobs (ryanlecompte)
1694
+ - Added middleware for displaying jobs in resque-web dashboard (maxjustus)
1695
+ - Added redis namespacing support (maxjustus)
1696
+
1697
+ 0.5.1
1698
+ -----------
1699
+
1700
+ - Initial release!