Sensu plugins for Sidekiq


Build Status Gem Version Code Climate Test Coverage Dependency Status


Check various metrics and checks for Sidekiq. The following scripts:

  • bin/check-sidekiq.rb
  • bin/sidekiq-metrics.rb

require sidekiq-monitor-stats running on your application. Pass the --url URL option with the url to your monitor stats. Both scripts also accept a --auth USER:PASSWORD option in case the monitor stats url sits behind basic authorization.

  • bin/check-sidekiq-dead-queue.rb uses the native sidekiq JSON dashboard under <mount point>/dashboard/stats More info


Uses the maximum latency to figure out when to raise warnings. The latency is the time a job has been waiting in the queue (without being processed). It's generally a good metric to know when there's trouble with Sidekiq. There are some options you can pass to this script:

  • --warn SECONDS: Warn after job has been SECONDS seconds in a queue. The default is 120.
  • --crit SECONDS: Critical after job has been SECONDS seconds in a queue. The default is 300.


Generates total concurrency (concurrency), total busy (busy) and maximum latency (latency) metrics for your sidekiq. A graph of busy vs. concurrency is specially useful for capacity planning. The latency metric should let you know if something is wrong (or there are spikes that don't trigger a warning or a critical). Accepts an --scheme SCHEME option to know what scheme to append to the metrics (the default is sidekiq).


Checks the dead queue and raises a CRITICAL if it's not empty. Jobs in the dead queue have failed over 25 times. Some organisations might consider this an issue to address and could benefit from this check.


  • bin/check-sidekiq.rb
  • bin/sidekiq-metrics.rb
  • bin/check-sidekiq-dead-queue.rb



Installation and Setup


Thanks to xxxxxx for contributing.

Get Integration


3 stars on GitHub
5 open issues on GitHub
4 open forks on GitHub

Sensu Integrations

Sensu integrations and extensions are available for dozens of modern applications and services.