solid_stack_web 1.1.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1717d75a5baabd8728f6f9877b5146849be9322a627cf295bd922690aa284592
-  data.tar.gz: ae814ccee9aa89798575f914652ccfbb51137473961d7fd1a22b7a4461449102
+  metadata.gz: d97689a002516820708b4d0fcd852eadb94d4c24cd67b2d6d9760cc842df2033
+  data.tar.gz: 14bb1935a9b57b09768ddfd32677b5b16a447d13c96ac605c8bd4f7491412240
 SHA512:
-  metadata.gz: e0d79705beafccb16561d20a28cac815607f2a202bc6d0839449c501f8d4f5bd93bd83ccb4a7c4be0d6b701ecb69b9aca8fa5ee2a3d4462712fc8399c935162a
-  data.tar.gz: 2663a57cf04ca3aa26463732638020c63ce76d10046979dbd22baae8f5b529d3092e3597aa9c4a8b9b06b0a43b9a648e0a573349bca1f39d6f944fe4a8313884
+  metadata.gz: e2f8057a998ccc88c642f5805fd63e850b9e23e60f3b02b48685a55f64d30958e1e2775caae4dc59f58ca68f58e40539df0c282b844c2f196b18bcaa06999887
+  data.tar.gz: e4ecd5a93a76121efc58e5f66ae50ceaa9590b065af359b840c0d6f7622ee8f0417ad3ff397152672828c645b37826f8e51c7a3a4cf3da32d8c50a62d81c3d58

data/README.md

@@ -2,6 +2,7 @@
 
 [![CI](https://github.com/eclectic-coding/solid_stack_web/actions/workflows/ci.yml/badge.svg)](https://github.com/eclectic-coding/solid_stack_web/actions/workflows/ci.yml)
 [![Gem Version](https://badge.fury.io/rb/solid_stack_web.svg)](https://badge.fury.io/rb/solid_stack_web)
+[![Downloads](https://img.shields.io/gem/dt/solid_stack_web.svg)](https://rubygems.org/gems/solid_stack_web)
 [![Ruby](https://img.shields.io/badge/ruby-%3E%3D%203.3-ruby)](https://www.ruby-lang.org)
 [![codecov](https://codecov.io/gh/eclectic-coding/solid_stack_web/branch/main/graph/badge.svg)](https://codecov.io/gh/eclectic-coding/solid_stack_web)
 
@@ -143,19 +144,20 @@ The dashboard is designed to be mounted behind your application's existing authe
 ### Features
 
 - **Overview dashboard** — live counts across all queue statuses; done (1h/24h), healthy/stale process counts, and optionally slow jobs (when `slow_job_threshold` is configured); 12-hour throughput sparkline and a 12-hour failures sparkline (red bars) with per-bar hover tooltips — failure spikes visible before clicking into the failed jobs list
-- **Job browser** — browse jobs by status (ready, scheduled, claimed, blocked) with filtering by job class, queue name, priority, and time period; **Discard All** bulk-discards every job matching the current filters in one request; **CSV export** downloads jobs respecting active filters
+- **Job browser** — browse jobs by status (ready, scheduled, claimed, blocked) with filtering by job class, queue name, priority, and time period; sortable by class, queue, priority, and enqueued-at; sort state is preserved across filter and period changes; **Discard All** bulk-discards every job matching the current filters in one request; **CSV export** downloads jobs respecting active filters
 - **Bulk selection** — checkbox-select individual jobs for discard; select-all support
 - **Per-queue browser** — click any queue name or size to drill into its ready jobs with per-row and bulk discard; pause/resume controls on the queue page
 - **Queue depth sparklines** — Queues index shows a 12-hour depth chart per queue; each bar is the ready-job count at an hourly snapshot with an instant hover tooltip
 - **Job detail page** — full arguments (pretty-printed JSON), queue, priority, enqueued time, Active Job ID, concurrency key, scheduled/blocked-until metadata, and a Discard button
-- **Failed jobs** — list with retry / discard / bulk retry / bulk discard; **Failed job detail page** — full error, backtrace, and an inline JSON argument editor; submit to update arguments and retry in one action
+- **Failed jobs** — list with retry / discard / bulk retry / bulk discard; sortable by class, queue, and failed-at; **Failed job detail page** — full error, backtrace, and an inline JSON argument editor; submit to update arguments and retry in one action
 - **Error frequency report** — `GET /failed_jobs/errors` groups all failed jobs by exception class and message prefix with a count and expandable sample backtrace; links through to a filtered list for each error group
 - **Scheduled job management** — "Run Now" and offset buttons (+1h / +24h / +7d) per row update the scheduled time inline via Turbo Stream; "Run All Now (N)" back-dates all matching executions at once
 - **Recurring task list** — enumerates all `SolidQueue::RecurringTask` records with cron schedule, job class or command, queue, next-run and last-run times, and a static/dynamic badge; each row has a "Run Now" button
 - **Performance statistics page** — `GET /stats` aggregates finished jobs by class name with execution count, avg, p50, p95, p99, std dev, min, and max duration; click any column header to sort; defaults to p95 descending; high std dev flags inconsistent jobs worth investigating
-- **Job history view** — paginated list of all finished jobs with class name, queue, duration, and finished-at time; filterable by queue (click a badge), class substring, and time period; CSV export respects active filters
+- **Job history view** — paginated list of all finished jobs with class name, queue, duration, and finished-at time; filterable by queue (click a badge), class substring, and time period; sortable by class, queue, and finished-at; CSV export respects active filters
 - **Auto-refresh** — dashboard, jobs, processes, and history views poll automatically; pauses when the tab is hidden or a checkbox is checked; intervals configurable via `dashboard_refresh_interval` and `default_refresh_interval`
 - **Turbo Stream** job discard — removes the row inline without a full page reload
+- **Sticky filter preferences** — last-used status, period, and queue filter saved to `localStorage`; a fresh visit to the jobs or history list with no URL params automatically restores the previous selection
 - **Dark mode** — toggle button in the header switches between light and dark palettes; preference persisted in `localStorage`; respects `prefers-color-scheme` on first visit
 - **Responsive layout** — stats cards, tables, and two-column grids adapt to narrow viewports; tables scroll horizontally rather than overflow; split page headers stack on small screens
 - **Empty-state improvements** — all list views show a contextual title and an actionable hint; search empty states include a "Clear search" link; filters-active history view offers "Clear filters"; processes and recurring tasks explain the next step

data/app/controllers/solid_stack_web/dashboard_controller.rb

@@ -6,6 +6,7 @@ module SolidStackWeb
       @cable_stats = CableStats.new.to_h
       @throughput  = ThroughputSparkline.new
       @failures    = FailedJobSparkline.new
+      AlertWebhook.check(@queue_stats)
     end
   end
 end

data/app/controllers/solid_stack_web/failed_jobs_controller.rb

@@ -1,9 +1,12 @@
 module SolidStackWeb
   class FailedJobsController < ApplicationController
     def index
+      @sort      = params[:sort].presence_in(sortable_columns) || "created_at"
+      @direction = params[:direction] == "asc" ? "asc" : "desc"
+
       respond_to do |format|
         format.html do
-          scope = ::SolidQueue::FailedExecution.includes(:job).order(created_at: :desc)
+          scope = ::SolidQueue::FailedExecution.includes(:job).references(:job).order(sort_expression)
           @error_class = params[:error_class].presence
           scope = scope.where(id: ids_for_error_class(@error_class)) if @error_class
           @pagy, @executions = pagy(scope)
@@ -43,6 +46,19 @@ module SolidStackWeb
 
     private
 
+    def sortable_columns
+      %w[class_name queue_name created_at]
+    end
+
+    def sort_expression
+      sql_col = case @sort
+      when "class_name" then "solid_queue_jobs.class_name"
+      when "queue_name" then "solid_queue_jobs.queue_name"
+      else "solid_queue_failed_executions.created_at"
+      end
+      Arel.sql("#{sql_col} #{@direction == 'asc' ? 'ASC' : 'DESC'}")
+    end
+
     def ids_for_error_class(ec)
       ::SolidQueue::FailedExecution.pluck(:id, :error).filter_map do |id, raw|
         error = raw.is_a?(Hash) ? raw : JSON.parse(raw)

data/app/controllers/solid_stack_web/history_controller.rb

@@ -16,13 +16,23 @@ module SolidStackWeb
     private
 
     def set_filters
-      @queue  = params[:queue].presence
-      @search = params[:q].presence
-      @period = params[:period].presence_in(PERIOD_DURATIONS.keys)
+      @queue     = params[:queue].presence
+      @search    = params[:q].presence
+      @period    = params[:period].presence_in(PERIOD_DURATIONS.keys)
+      @sort      = params[:sort].presence_in(sortable_columns) || "finished_at"
+      @direction = params[:direction] == "asc" ? "asc" : "desc"
+    end
+
+    def sortable_columns
+      %w[class_name queue_name finished_at]
+    end
+
+    def sort_expression
+      Arel.sql("#{@sort} #{@direction == 'asc' ? 'ASC' : 'DESC'}")
     end
 
     def filtered_scope
-      scope = SolidQueue::Job.where.not(finished_at: nil).order(finished_at: :desc)
+      scope = SolidQueue::Job.where.not(finished_at: nil).order(sort_expression)
       scope = scope.where(queue_name: @queue)                                 if @queue.present?
       scope = scope.where("class_name LIKE ?", "%#{@search}%")               if @search.present?
       scope = scope.where("finished_at >= ?", PERIOD_DURATIONS[@period].ago) if @period.present?
@@ -32,7 +42,7 @@ module SolidStackWeb
     def history_csv(scope)
       CSV.generate(headers: true) do |csv|
         csv << %w[id class_name queue_name duration_seconds finished_at]
-        scope.order(finished_at: :desc).each do |job|
+        scope.each do |job|
           duration = job.finished_at && job.created_at ? (job.finished_at - job.created_at).round : nil
           csv << [job.id, job.class_name, job.queue_name, duration, job.finished_at.iso8601]
         end

data/app/controllers/solid_stack_web/jobs/selections_controller.rb

@@ -10,11 +10,13 @@ module SolidStackWeb
         count   = SolidQueue::Job.where(id: job_ids).destroy_all.size
 
         redirect_to jobs_path(
-          status: status,
-          q:        params[:q].presence,
-          queue:    params[:queue].presence,
-          period:   params[:period].presence_in(PERIOD_DURATIONS.keys),
-          priority: params[:priority].presence
+          status:    status,
+          q:         params[:q].presence,
+          queue:     params[:queue].presence,
+          period:    params[:period].presence_in(PERIOD_DURATIONS.keys),
+          priority:  params[:priority].presence,
+          sort:      params[:sort].presence,
+          direction: params[:direction].presence
         ), notice: "#{count} #{count == 1 ? "job" : "jobs"} discarded."
       rescue ArgumentError => e
         redirect_to jobs_path(status: params[:status]), alert: e.message

data/app/controllers/solid_stack_web/jobs_controller.rb

@@ -36,13 +36,13 @@ module SolidStackWeb
         @notice = "Job discarded."
 
         respond_to do |format|
-          format.html { redirect_to jobs_path(status: @status, q: @search, queue: @queue, period: @period, priority: @priority) }
+          format.html { redirect_to jobs_path(status: @status, q: @search, queue: @queue, period: @period, priority: @priority, sort: @sort, direction: @direction) }
           format.turbo_stream
         end
       else
         job_ids = filtered_scope.pluck(:job_id)
         count = SolidQueue::Job.where(id: job_ids).destroy_all.size
-        redirect_to jobs_path(status: @status, q: @search, queue: @queue, period: @period, priority: @priority),
+        redirect_to jobs_path(status: @status, q: @search, queue: @queue, period: @period, priority: @priority, sort: @sort, direction: @direction),
                     notice: "#{count} #{count == 1 ? "job" : "jobs"} discarded."
       end
     end
@@ -54,10 +54,26 @@ module SolidStackWeb
     end
 
     def set_filters
-      @search   = params[:q].presence
-      @queue    = params[:queue].presence
-      @period   = params[:period].presence_in(PERIOD_DURATIONS.keys)
-      @priority = params[:priority].presence
+      @search    = params[:q].presence
+      @queue     = params[:queue].presence
+      @period    = params[:period].presence_in(PERIOD_DURATIONS.keys)
+      @priority  = params[:priority].presence
+      @sort      = params[:sort].presence_in(sortable_columns) || "created_at"
+      @direction = params[:direction] == "asc" ? "asc" : "desc"
+    end
+
+    def sortable_columns
+      %w[class_name queue_name priority created_at]
+    end
+
+    def sort_expression
+      sql_col = case @sort
+      when "class_name" then "solid_queue_jobs.class_name"
+      when "queue_name" then "solid_queue_jobs.queue_name"
+      when "priority"   then "solid_queue_jobs.priority"
+      else "#{Job::EXECUTION_MODELS[@status].quoted_table_name}.created_at"
+      end
+      Arel.sql("#{sql_col} #{@direction == 'asc' ? 'ASC' : 'DESC'}")
     end
 
     def require_discardable
@@ -66,20 +82,24 @@ module SolidStackWeb
 
     def jobs_csv
       CSV.generate(headers: true) do |csv|
-        csv << %w[id class_name queue_name status priority enqueued_at]
+        headers = %w[id class_name queue_name status priority enqueued_at]
+        headers << "wait_time_seconds" if @status == "claimed"
+        csv << headers
         filtered_scope.each do |execution|
           job = execution.job
-          csv << [job.id, job.class_name, job.queue_name, @status, job.priority, job.created_at.iso8601]
+          row = [job.id, job.class_name, job.queue_name, @status, job.priority, job.created_at.iso8601]
+          row << (execution.created_at - job.created_at).to_i if @status == "claimed"
+          csv << row
         end
       end
     end
 
     def filtered_scope
-      scope = Job::EXECUTION_MODELS[@status].includes(:job).order(created_at: :desc)
-      scope = scope.references(:job).where("solid_queue_jobs.class_name LIKE ?", "%#{@search}%") if @search.present?
-      scope = scope.references(:job).where("solid_queue_jobs.queue_name = ?", @queue)             if @queue.present?
-      scope = scope.references(:job).where("solid_queue_jobs.created_at >= ?", PERIOD_DURATIONS[@period].ago) if @period.present?
-      scope = scope.references(:job).where("solid_queue_jobs.priority = ?", @priority.to_i)       if @priority.present?
+      scope = Job::EXECUTION_MODELS[@status].includes(:job).references(:job).order(sort_expression)
+      scope = scope.where("solid_queue_jobs.class_name LIKE ?", "%#{@search}%") if @search.present?
+      scope = scope.where("solid_queue_jobs.queue_name = ?", @queue)             if @queue.present?
+      scope = scope.where("solid_queue_jobs.created_at >= ?", PERIOD_DURATIONS[@period].ago) if @period.present?
+      scope = scope.where("solid_queue_jobs.priority = ?", @priority.to_i)       if @priority.present?
       scope
     end
   end

data/app/helpers/solid_stack_web/application_helper.rb

@@ -87,6 +87,19 @@ module SolidStackWeb
       end
     end
 
+    def sort_header_th(label, col, url_proc, current_sort:, current_dir:)
+      is_active = current_sort == col
+      next_dir  = (is_active && current_dir == "desc") ? "asc" : "desc"
+      indicator = is_active ? content_tag(:span, current_dir == "desc" ? "↓" : "↑", class: "sqw-sort-indicator") : nil
+      tag_opts  = { scope: "col" }
+      tag_opts[:"aria-sort"] = is_active ? (current_dir == "asc" ? "ascending" : "descending") : nil if is_active
+      content_tag(:th, **tag_opts) do
+        link_to(url_proc.call(sort: col, direction: next_dir)) do
+          safe_join([label, indicator].compact)
+        end
+      end
+    end
+
     def failed_job_sparkline_svg(sparkline)
       build_sparkline_svg(sparkline, aria_label: "Failed jobs over the last 12 hours") do |count, i|
         hours_ago = SolidStackWeb::FailedJobSparkline::HOURS - i

data/app/javascript/solid_stack_web/application.js

@@ -1,5 +1,6 @@
 import "@hotwired/turbo"
 import { Application } from "@hotwired/stimulus"
+import FilterPersistController from "solid_stack_web/filter_persist_controller"
 import RefreshController from "solid_stack_web/refresh_controller"
 import SearchController from "solid_stack_web/search_controller"
 import SelectionController from "solid_stack_web/selection_controller"
@@ -8,6 +9,7 @@ import ThemeController from "solid_stack_web/theme_controller"
 import TimestampController from "solid_stack_web/timestamp_controller"
 
 const application = Application.start()
+application.register("filter-persist", FilterPersistController)
 application.register("refresh", RefreshController)
 application.register("search", SearchController)
 application.register("selection", SelectionController)

data/app/javascript/solid_stack_web/filter_persist_controller.js

@@ -0,0 +1,28 @@
+import { Controller } from "@hotwired/stimulus"
+
+const PERSIST_KEYS = ["status", "period", "queue"]
+
+export default class extends Controller {
+  static values = { key: String }
+
+  connect() {
+    const params = new URLSearchParams(window.location.search)
+
+    if (params.toString()) {
+      const toSave = new URLSearchParams()
+      PERSIST_KEYS.forEach(k => { if (params.get(k)) toSave.set(k, params.get(k)) })
+      if (toSave.toString()) this.write(toSave.toString())
+    } else {
+      const stored = this.read()
+      if (stored) window.location.replace(`${window.location.pathname}?${stored}`)
+    }
+  }
+
+  read() {
+    try { return localStorage.getItem(this.keyValue) } catch (e) { return null }
+  }
+
+  write(value) {
+    try { localStorage.setItem(this.keyValue, value) } catch (e) { /* ignore */ }
+  }
+}

data/app/models/solid_stack_web/alert_webhook.rb

@@ -39,6 +39,16 @@ module SolidStackWeb
         alerts << { type: "queue_depth", queue: queue_name.to_s, count: count, threshold: threshold } if count >= threshold
       end
 
+      if (job_threshold = SolidStackWeb.slow_job_threshold) && (count_threshold = SolidStackWeb.alert_slow_job_count_threshold)
+        count = ::SolidQueue::ClaimedExecution.where("created_at <= ?", job_threshold.seconds.ago).count
+        alerts << { type: "slow_jobs", count: count, threshold: count_threshold } if count >= count_threshold
+      end
+
+      if (threshold = SolidStackWeb.alert_stale_process_threshold)
+        count = @queue_stats[:processes_stale]
+        alerts << { type: "stale_processes", count: count, threshold: threshold } if count >= threshold
+      end
+
       alerts
     end
 

data/app/views/solid_stack_web/failed_jobs/index.html.erb

@@ -41,10 +41,11 @@
             <th scope="col"><input type="checkbox" class="sqw-checkbox" aria-label="Select all"
                        data-selection-target="selectAll"
                        data-action="change->selection#selectAll"></th>
-            <th scope="col">Job Class</th>
-            <th scope="col">Queue</th>
+            <% sort_url = ->(p) { failed_jobs_path(error_class: @error_class, **p) } %>
+            <%= sort_header_th("Job Class", "class_name", sort_url, current_sort: @sort, current_dir: @direction) %>
+            <%= sort_header_th("Queue",     "queue_name", sort_url, current_sort: @sort, current_dir: @direction) %>
             <th scope="col">Error</th>
-            <th scope="col">Failed At</th>
+            <%= sort_header_th("Failed At", "created_at", sort_url, current_sort: @sort, current_dir: @direction) %>
             <th scope="col"><span class="sqw-sr-only">Actions</span></th>
           </tr>
         </thead>

data/app/views/solid_stack_web/history/index.html.erb

@@ -10,11 +10,15 @@
   </div>
 </div>
 
-<form class="sqw-filters" action="<%= history_path %>" method="get" data-controller="search">
+<form class="sqw-filters" action="<%= history_path %>" method="get"
+      data-controller="search filter-persist"
+      data-filter-persist-key-value="sqw-history-filters">
   <% if @queue.present? %>
     <input type="hidden" name="queue" value="<%= @queue %>">
   <% end %>
   <input type="hidden" name="period" value="<%= @period %>">
+  <input type="hidden" name="sort" value="<%= @sort %>">
+  <input type="hidden" name="direction" value="<%= @direction %>">
   <input class="sqw-search-input" type="search" name="q" value="<%= @search %>"
          placeholder="Filter by job class…" autocomplete="off" aria-label="Filter by job class"
          data-action="input->search#filter">
@@ -44,11 +48,12 @@
   <div class="sqw-detail-card">
     <table class="sqw-table">
       <thead>
+        <% sort_url = ->(p) { history_path(queue: @queue, q: @search, period: @period, **p) } %>
         <tr>
-          <th scope="col">Job Class</th>
-          <th scope="col">Queue</th>
+          <%= sort_header_th("Job Class",   "class_name", sort_url, current_sort: @sort, current_dir: @direction) %>
+          <%= sort_header_th("Queue",       "queue_name", sort_url, current_sort: @sort, current_dir: @direction) %>
           <th scope="col">Duration</th>
-          <th scope="col">Finished At</th>
+          <%= sort_header_th("Finished At", "finished_at", sort_url, current_sort: @sort, current_dir: @direction) %>
         </tr>
       </thead>
       <tbody>

data/app/views/solid_stack_web/jobs/index.html.erb

@@ -1,7 +1,7 @@
 <div class="sqw-page-header sqw-page-header--split">
   <h1 class="sqw-page-title">Jobs</h1>
   <div class="sqw-header-actions">
-    <%= link_to "Export CSV", jobs_path(format: :csv, status: @status, q: @search, queue: @queue, period: @period, priority: @priority),
+    <%= link_to "Export CSV", jobs_path(format: :csv, status: @status, q: @search, queue: @queue, period: @period, priority: @priority, sort: @sort, direction: @direction),
           class: "sqw-btn sqw-btn--muted sqw-btn--sm", data: { turbo: false } %>
     <% if @status == "scheduled" && @executions&.any? %>
       <%= button_to "Run All Now (#{@pagy.count})",
@@ -24,7 +24,7 @@
 
 <div class="sqw-tabs">
   <% SolidStackWeb::Job::TAB_LABELS.each do |status, label| %>
-    <%= link_to label, jobs_path(status: status, q: @search, queue: @queue, period: @period, priority: @priority),
+    <%= link_to label, jobs_path(status: status, q: @search, queue: @queue, period: @period, priority: @priority, sort: @sort, direction: @direction),
           class: "sqw-tab #{"sqw-tab--active" if @status == status}" %>
   <% end %>
 </div>
@@ -32,9 +32,13 @@
 <%= turbo_frame_tag "sqw-jobs-filter",
       data: { turbo_action: "advance", controller: "refresh",
               refresh_interval_value: SolidStackWeb.default_refresh_interval } do %>
-<form class="sqw-filters" action="<%= jobs_path %>" method="get" data-controller="search">
+<form class="sqw-filters" action="<%= jobs_path %>" method="get"
+      data-controller="search filter-persist"
+      data-filter-persist-key-value="sqw-jobs-filters">
   <%= hidden_field_tag :status, @status %>
   <%= hidden_field_tag :period, @period %>
+  <%= hidden_field_tag :sort, @sort %>
+  <%= hidden_field_tag :direction, @direction %>
   <input class="sqw-search-input" type="search" name="q" value="<%= @search %>"
          placeholder="Filter by job class…" autocomplete="off" aria-label="Filter by job class"
          data-action="input->search#filter">
@@ -57,16 +61,16 @@
     </select>
   <% end %>
   <% if @search.present? || @queue.present? || @priority.present? %>
-    <%= link_to "Clear", jobs_path(status: @status, period: @period), class: "sqw-btn sqw-btn--muted sqw-btn--sm" %>
+    <%= link_to "Clear", jobs_path(status: @status, period: @period, sort: @sort, direction: @direction), class: "sqw-btn sqw-btn--muted sqw-btn--sm" %>
   <% end %>
   <div class="sqw-period-filter" role="group" aria-label="Time period">
-    <%= link_to "All", jobs_path(status: @status, q: @search, queue: @queue, priority: @priority),
+    <%= link_to "All", jobs_path(status: @status, q: @search, queue: @queue, priority: @priority, sort: @sort, direction: @direction),
           class: "sqw-period-btn #{"sqw-period-btn--active" if @period.nil?}" %>
-    <%= link_to "1h",  jobs_path(status: @status, q: @search, queue: @queue, priority: @priority, period: "1h"),
+    <%= link_to "1h",  jobs_path(status: @status, q: @search, queue: @queue, priority: @priority, period: "1h",  sort: @sort, direction: @direction),
           class: "sqw-period-btn #{"sqw-period-btn--active" if @period == "1h"}" %>
-    <%= link_to "24h", jobs_path(status: @status, q: @search, queue: @queue, priority: @priority, period: "24h"),
+    <%= link_to "24h", jobs_path(status: @status, q: @search, queue: @queue, priority: @priority, period: "24h", sort: @sort, direction: @direction),
           class: "sqw-period-btn #{"sqw-period-btn--active" if @period == "24h"}" %>
-    <%= link_to "7d",  jobs_path(status: @status, q: @search, queue: @queue, priority: @priority, period: "7d"),
+    <%= link_to "7d",  jobs_path(status: @status, q: @search, queue: @queue, priority: @priority, period: "7d",  sort: @sort, direction: @direction),
           class: "sqw-period-btn #{"sqw-period-btn--active" if @period == "7d"}" %>
   </div>
 </form>
@@ -77,11 +81,13 @@
       <% if SolidStackWeb::Job::DISCARDABLE.include?(@status) %>
         <%= form_with url: job_selection_path, method: :delete, id: "job-selection-form",
               data: { turbo_confirm: "Discard selected jobs? This cannot be undone." } do |f| %>
-          <%= f.hidden_field :status, value: @status %>
-          <%= f.hidden_field :q,      value: @search %>
-          <%= f.hidden_field :queue,  value: @queue %>
-          <%= f.hidden_field :period, value: @period %>
-          <%= f.hidden_field :priority, value: @priority %>
+          <%= f.hidden_field :status,    value: @status %>
+          <%= f.hidden_field :q,         value: @search %>
+          <%= f.hidden_field :queue,     value: @queue %>
+          <%= f.hidden_field :period,    value: @period %>
+          <%= f.hidden_field :priority,  value: @priority %>
+          <%= f.hidden_field :sort,      value: @sort %>
+          <%= f.hidden_field :direction, value: @direction %>
         <% end %>
 
         <div class="sqw-selection-bar" data-selection-target="bar" style="display: none;">
@@ -100,11 +106,13 @@
                          data-selection-target="selectAll"
                          data-action="change->selection#selectAll"></th>
             <% end %>
-            <th scope="col">Job Class</th>
-            <th scope="col">Queue</th>
-            <th scope="col">Priority</th>
-            <th scope="col">Enqueued At</th>
+            <% sort_url = ->(p) { jobs_path(status: @status, q: @search, queue: @queue, period: @period, priority: @priority, **p) } %>
+            <%= sort_header_th("Job Class",   "class_name", sort_url, current_sort: @sort, current_dir: @direction) %>
+            <%= sort_header_th("Queue",       "queue_name", sort_url, current_sort: @sort, current_dir: @direction) %>
+            <%= sort_header_th("Priority",    "priority",   sort_url, current_sort: @sort, current_dir: @direction) %>
+            <%= sort_header_th("Enqueued At", "created_at", sort_url, current_sort: @sort, current_dir: @direction) %>
             <% if @status == "scheduled" %><th scope="col">Scheduled At</th><% end %>
+            <% if @status == "claimed" %><th scope="col">Wait Time</th><% end %>
             <th scope="col"><span class="sqw-sr-only">Actions</span></th>
           </tr>
         </thead>
@@ -125,6 +133,9 @@
               <% if @status == "scheduled" %>
                 <td id="scheduled_at_<%= execution.id %>" class="sqw-muted"><%= local_time(execution.scheduled_at) %></td>
               <% end %>
+              <% if @status == "claimed" %>
+                <td class="sqw-monospace"><%= format_duration(execution.created_at - execution.job.created_at) %></td>
+              <% end %>
               <td class="sqw-actions">
                 <% if @status == "scheduled" %>
                   <%= button_to "Run Now", scheduled_job_path(execution),
@@ -140,7 +151,7 @@
                   <% end %>
                 <% end %>
                 <% if %w[ready scheduled blocked].include?(@status) %>
-                  <%= button_to "Discard", job_path(execution, status: @status, q: @search, queue: @queue, period: @period, priority: @priority),
+                  <%= button_to "Discard", job_path(execution, status: @status, q: @search, queue: @queue, period: @period, priority: @priority, sort: @sort, direction: @direction),
                         method: :delete, class: "sqw-btn sqw-btn--danger sqw-btn--sm",
                         data: { turbo_confirm: "Discard this job?" } %>
                 <% end %>

data/lib/generators/solid_stack_web/install/templates/initializer.rb

@@ -41,11 +41,13 @@ SolidStackWeb.configure do |config|
   # Alert webhook — POST to this URL when a threshold is breached.
   # Delivery failures are silently swallowed; configure a cooldown to avoid storms.
   #
-  # config.alert_webhook_url       = "https://hooks.example.com/my-alert"
-  # config.alert_failure_threshold = 10      # fire when failed jobs >= this
-  # config.alert_queue_thresholds  = {       # fire when a queue's ready depth >= value
+  # config.alert_webhook_url              = "https://hooks.example.com/my-alert"
+  # config.alert_failure_threshold        = 10      # fire when failed jobs >= this
+  # config.alert_queue_thresholds         = {       # fire when a queue's ready depth >= value
   #   "critical" => 50,
   #   "default"  => 500
   # }
-  # config.alert_webhook_cooldown  = 3600   # seconds between repeat alerts
+  # config.alert_slow_job_count_threshold  = 3       # fire when N+ claimed jobs exceed slow_job_threshold duration
+  # config.alert_stale_process_threshold   = 1       # fire when N+ workers have a stale heartbeat (>5 min old)
+  # config.alert_webhook_cooldown          = 3600    # seconds between repeat alerts
 end

data/lib/solid_stack_web/version.rb

@@ -1,3 +1,3 @@
 module SolidStackWeb
-  VERSION = "1.1.0"
+  VERSION = "1.3.0"
 end

data/lib/solid_stack_web.rb

@@ -6,6 +6,7 @@ module SolidStackWeb
     attr_writer :page_size, :connects_to, :slow_job_threshold,
                 :alert_webhook_url, :alert_webhook_cooldown,
                 :alert_failure_threshold, :alert_queue_thresholds,
+                :alert_slow_job_count_threshold, :alert_stale_process_threshold,
                 :dashboard_refresh_interval, :default_refresh_interval,
                 :search_results_limit, :allow_value_preview
 
@@ -37,6 +38,14 @@ module SolidStackWeb
       @alert_queue_thresholds || {}
     end
 
+    def alert_slow_job_count_threshold
+      @alert_slow_job_count_threshold
+    end
+
+    def alert_stale_process_threshold
+      @alert_stale_process_threshold
+    end
+
     def dashboard_refresh_interval
       @dashboard_refresh_interval || 5_000
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: solid_stack_web
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Chuck Smith
@@ -176,6 +176,7 @@ files:
 - app/controllers/solid_stack_web/stats_controller.rb
 - app/helpers/solid_stack_web/application_helper.rb
 - app/javascript/solid_stack_web/application.js
+- app/javascript/solid_stack_web/filter_persist_controller.js
 - app/javascript/solid_stack_web/refresh_controller.js
 - app/javascript/solid_stack_web/search_controller.js
 - app/javascript/solid_stack_web/selection_controller.js