SolidQueueWeb

Gem Version

A Rails engine that mounts a monitoring dashboard for Solid Queue. View queues, inspect jobs by status, browse failed executions, and take action — all without leaving your app.

Features

  • Dashboard — stat cards showing counts for ready, scheduled, running, blocked, and failed jobs, plus queues and processes
  • Queues — all queues sorted by name
  • Jobs — filterable by status (ready, scheduled, claimed, blocked, failed) and by queue; discard individual or all jobs
  • Failed jobs — list of failed executions with error details; retry or discard individually or in bulk
  • Job detail — full arguments, timestamps, and error backtrace; action buttons based on job status
  • Queue management — pause and resume individual queues
  • Processes — workers, dispatchers, and supervisors with heartbeat health status
  • No external CSS framework — works out of the box

Installation

Add to your application's Gemfile:

gem "solid_queue_web"

Then run:

bundle install

Mounting the engine

Add to your config/routes.rb:

mount SolidQueueWeb::Engine, at: "/jobs"

The dashboard will be available at /jobs.

Authentication

The engine ships with no authentication by default. Add a block to an initializer (e.g. config/initializers/solid_queue_web.rb) to protect the dashboard:

SolidQueueWeb.authenticate do
  # Called in the context of ApplicationController — use any helper available there.
  # Return a truthy value to allow access, falsy to deny (triggers HTTP Basic prompt).
  current_user&.admin?
end

HTTP Basic authentication is used as a fallback when the block returns falsy.

Requirements

  • Ruby >= 3.3
  • Rails >= 8.1.3
  • solid_queue >= 1.0

Contributing

Bug reports and pull requests are welcome on GitHub.

License

The gem is available as open source under the terms of the MIT License.