solid_stack_web 1.0.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e7932ddf2c50cc9ae63a884c0dabdc0fe4553c9dfb823870d3e1b15b4dc2a3a6
-  data.tar.gz: 04d6d15b941d21dfae0d1562095e6cdb4cd67a7e1163efa3bc2d33563df2fb92
+  metadata.gz: f3dbb76a6507f2e2a0480bafe3b9e18ac8f34777563c853911dfaf7b7f549f23
+  data.tar.gz: 49f69c487ad4580d704ce122e46024ba96ff05c0c4b25166d64148128a28949d
 SHA512:
-  metadata.gz: 37ac38026dbde5e629d132f18795797f84a7b48b8e19689435b0288f44c57abf73e7dae5aa9e51884021920b4b336160597529b4f87c44cac027e9b88c1293d6
-  data.tar.gz: c233686b589092befdcc5b19ca7bfd09a2f10e9f1d95b894f58afff4fb67475ddcae308bf6b65386f9af5479d670256dde1cd02cf3cf2b5466eadcd00a051a2d
+  metadata.gz: aa1598c4f1ee1a527ccc5b50240e5c866274e848ad2e7245dfe02ef6f05a6b1b889a7eb88ce80cad46f72f1b7f533a858b47cb1a3d130fd300c8bb32698d9842
+  data.tar.gz: 752a9f8176b029fa54f7c0dcef93081d4a6b25bc75dccebab67ae7561854ff3c5d1f9ae96804ac290841afbc38630b7329d0472b45fbaf7cbf95d3f342797b0b

data/README.md

@@ -21,23 +21,13 @@ Run:
 bundle install
 ```
 
-Mount the engine in `config/routes.rb`:
-
-```ruby
-mount SolidStackWeb::Engine, at: "/solid_stack"
-```
-
-The dashboard will be available at `/solid_stack` (or whatever path you choose).
-
-### Install generator
-
 Run the install generator to create a documented initializer and wire up the mount point in one step:
 
 ```bash
 rails generate solid_stack_web:install
 ```
 
-This creates `config/initializers/solid_stack_web.rb` with every configuration option commented inline, and injects `mount SolidStackWeb::Engine, at: "/solid_stack"` into `config/routes.rb`.
+This creates `config/initializers/solid_stack_web.rb` with every configuration option commented inline, and injects `mount SolidStackWeb::Engine, at: "/solid_stack"` into `config/routes.rb`. The dashboard will then be available at `/solid_stack` (or whatever path you choose).
 
 ---
 
@@ -77,7 +67,7 @@ This creates `config/initializers/solid_stack_web.rb` with every configuration o
 
 ## General configuration
 
-Create an initializer at `config/initializers/solid_stack_web.rb`:
+The install generator creates `config/initializers/solid_stack_web.rb` with all options documented inline. The available options are:
 
 ```ruby
 SolidStackWeb.configure do |config|
@@ -152,19 +142,21 @@ 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 with per-bar hover tooltips
-- **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
+- **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; 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, min, and max duration; click any column header to sort; defaults to p95 descending
-- **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
+- **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; 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/assets/stylesheets/solid_stack_web/_07_dashboard.css

@@ -86,6 +86,10 @@ a.sqw-inline-stat:hover { opacity: 0.7; text-decoration: none; }
   color: var(--primary);
 }
 
+.sqw-sparkline-wrap--failures {
+  color: var(--danger);
+}
+
 .sqw-sparkline-label {
   display: block;
   font-size: 10px;

data/app/assets/stylesheets/solid_stack_web/_09_detail.css

@@ -84,6 +84,29 @@
 
 .sqw-value-truncated { font-size: 12px; margin-top: 0.5rem; }
 
+.sqw-error-details > summary {
+  cursor: pointer;
+  list-style: none;
+  display: block;
+  max-width: 480px;
+}
+.sqw-error-details > summary::-webkit-details-marker { display: none; }
+.sqw-error-details[open] > summary { margin-bottom: 0.5rem; }
+
+.sqw-error-backtrace {
+  font-family: ui-monospace, "SFMono-Regular", Menlo, monospace;
+  font-size: 11px;
+  background: var(--bg);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  padding: 0.5rem 0.75rem;
+  overflow-x: auto;
+  white-space: pre;
+  max-height: 200px;
+  overflow-y: auto;
+  margin-top: 0.25rem;
+}
+
 .sqw-link { color: var(--primary); text-decoration: none; }
 .sqw-link:hover { text-decoration: underline; }
 

data/app/controllers/solid_stack_web/dashboard_controller.rb

@@ -5,6 +5,7 @@ module SolidStackWeb
       @cache_stats = CacheStats.new.to_h
       @cable_stats = CableStats.new.to_h
       @throughput  = ThroughputSparkline.new
+      @failures    = FailedJobSparkline.new
     end
   end
 end

data/app/controllers/solid_stack_web/failed_jobs/errors_controller.rb

@@ -0,0 +1,9 @@
+module SolidStackWeb
+  module FailedJobs
+    class ErrorsController < ApplicationController
+      def index
+        @groups = ErrorFrequencyReport.new.groups
+      end
+    end
+  end
+end

data/app/controllers/solid_stack_web/failed_jobs_controller.rb

@@ -1,9 +1,14 @@
 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)
         end
         format.csv do
@@ -41,6 +46,28 @@ 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)
+        id if error["exception_class"] == ec
+      rescue StandardError
+        nil
+      end
+    end
+
     def failed_jobs_csv
       CSV.generate(headers: true) do |csv|
         csv << %w[id class_name queue_name error_class error_message failed_at]

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
@@ -75,11 +91,11 @@ module SolidStackWeb
     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/controllers/solid_stack_web/stats_controller.rb

@@ -1,6 +1,6 @@
 module SolidStackWeb
   class StatsController < ApplicationController
-    SORTABLE_COLUMNS = %w[class_name count avg p50 p95 min max].freeze
+    SORTABLE_COLUMNS = %w[class_name count avg p50 p95 p99 stddev min max].freeze
 
     def index
       @sort      = params[:sort].presence_in(SORTABLE_COLUMNS) || "p95"
@@ -18,14 +18,17 @@ module SolidStackWeb
       jobs.group_by(&:class_name).map do |class_name, group|
         durations = group.map { |j| (j.finished_at - j.created_at).to_f }.sort
         count     = durations.size
+        avg = durations.sum / count
         {
           class_name: class_name,
           count:      count,
-          avg:        durations.sum / count,
+          avg:        avg,
           min:        durations.first,
           max:        durations.last,
           p50:        percentile(durations, 50),
-          p95:        percentile(durations, 95)
+          p95:        percentile(durations, 95),
+          p99:        percentile(durations, 99),
+          stddev:     stddev(durations, avg)
         }
       end
     end
@@ -35,5 +38,11 @@ module SolidStackWeb
       k = (sorted.size - 1) * pct / 100.0
       sorted[k.floor] + (sorted[k.ceil] - sorted[k.floor]) * (k - k.floor)
     end
+
+    def stddev(durations, avg)
+      return 0.0 if durations.size < 2
+      variance = durations.sum { |d| (d - avg)**2 } / durations.size
+      Math.sqrt(variance)
+    end
   end
 end

data/app/helpers/solid_stack_web/application_helper.rb

@@ -87,6 +87,30 @@ 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
+        if hours_ago == 1
+          "#{count} #{count == 1 ? "failure" : "failures"} in the last hour"
+        else
+          "#{count} #{count == 1 ? "failure" : "failures"} (#{hours_ago}h–#{hours_ago - 1}h ago)"
+        end
+      end
+    end
+
     private
 
     def build_sparkline_svg(sparkline, css_class: "sqw-sparkline", aria_label: nil, &tooltip_text)

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/error_frequency_report.rb

@@ -0,0 +1,34 @@
+module SolidStackWeb
+  class ErrorFrequencyReport
+    Row = Data.define(:exception_class, :message_prefix, :count, :sample_backtrace)
+
+    MESSAGE_LIMIT = 120
+
+    def groups
+      ::SolidQueue::FailedExecution
+        .order(created_at: :desc)
+        .each_with_object({}) do |execution, acc|
+          key = [execution.exception_class.to_s, message_prefix(execution.message)]
+          entry = acc[key] ||= { count: 0, sample_backtrace: nil }
+          entry[:count] += 1
+          entry[:sample_backtrace] ||= execution.backtrace
+        end
+        .map do |(exception_class, prefix), data|
+          Row.new(
+            exception_class:  exception_class,
+            message_prefix:   prefix,
+            count:            data[:count],
+            sample_backtrace: data[:sample_backtrace]
+          )
+        end
+        .sort_by { |row| -row.count }
+    end
+
+    private
+
+    def message_prefix(message)
+      return "" if message.nil?
+      message.length > MESSAGE_LIMIT ? "#{message[0, MESSAGE_LIMIT]}…" : message
+    end
+  end
+end

data/app/models/solid_stack_web/failed_job_sparkline.rb

@@ -0,0 +1,23 @@
+module SolidStackWeb
+  class FailedJobSparkline
+    HOURS = 12
+
+    def buckets
+      @buckets ||= begin
+        now    = Time.current
+        origin = now - HOURS.hours
+        times  = ::SolidQueue::FailedExecution.where(created_at: origin..now).pluck(:created_at)
+
+        HOURS.times.map do |i|
+          from = origin + i.hours
+          to   = origin + (i + 1).hours
+          times.count { |t| t >= from && t < to }
+        end
+      end
+    end
+
+    def max
+      buckets.max || 0
+    end
+  end
+end

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

@@ -68,6 +68,18 @@
         <span>now</span>
       </div>
     </div>
+    <div class="sqw-sparkline-wrap sqw-sparkline-wrap--failures" data-controller="sparkline-tooltip">
+      <span class="sqw-sparkline-label">Failures — last 12 hours</span>
+      <div class="sqw-sparkline-positioner">
+        <%= failed_job_sparkline_svg(@failures) %>
+        <div class="sqw-sparkline-tip" data-sparkline-tooltip-target="tip" hidden></div>
+      </div>
+      <div class="sqw-sparkline-axis">
+        <span>12h ago</span>
+        <span>6h ago</span>
+        <span>now</span>
+      </div>
+    </div>
   </div>
 
   <div class="sqw-gem-card sqw-gem-card--cache">

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

@@ -0,0 +1,48 @@
+<div class="sqw-page-header sqw-page-header--split">
+  <h1 class="sqw-page-title">Error Summary</h1>
+  <div class="sqw-header-actions">
+    <%= link_to "← Failed Jobs", failed_jobs_path, class: "sqw-btn sqw-btn--muted sqw-btn--sm" %>
+  </div>
+</div>
+
+<% if @groups.any? %>
+  <table class="sqw-table">
+    <thead>
+      <tr>
+        <th scope="col">Error Class</th>
+        <th scope="col">Message</th>
+        <th scope="col">Count</th>
+        <th scope="col"><span class="sqw-sr-only">Actions</span></th>
+      </tr>
+    </thead>
+    <tbody>
+      <% @groups.each do |group| %>
+        <tr>
+          <td class="sqw-monospace"><%= group.exception_class.presence || "—" %></td>
+          <td>
+            <% if group.sample_backtrace.present? %>
+              <details class="sqw-error-details">
+                <summary class="sqw-muted sqw-truncate" title="<%= group.message_prefix %>">
+                  <%= group.message_prefix.presence || "—" %>
+                </summary>
+                <pre class="sqw-error-backtrace"><%= Array(group.sample_backtrace).first(10).join("\n") %></pre>
+              </details>
+            <% else %>
+              <span class="sqw-muted sqw-truncate" title="<%= group.message_prefix %>"><%= group.message_prefix.presence || "—" %></span>
+            <% end %>
+          </td>
+          <td><%= group.count %></td>
+          <td class="sqw-actions">
+            <%= link_to "View Jobs", failed_jobs_path(error_class: group.exception_class),
+                  class: "sqw-btn sqw-btn--muted sqw-btn--sm" %>
+          </td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+<% else %>
+  <div class="sqw-empty">
+    <p class="sqw-empty__title">No failed jobs</p>
+    <p class="sqw-empty__hint">All clear — your jobs are running without errors.</p>
+  </div>
+<% end %>

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

@@ -1,6 +1,15 @@
 <div class="sqw-page-header sqw-page-header--split">
-  <h1 class="sqw-page-title">Failed Jobs</h1>
+  <div>
+    <h1 class="sqw-page-title">Failed Jobs</h1>
+    <% if @error_class %>
+      <div class="sqw-breadcrumb">
+        Filtered by <span class="sqw-monospace"><%= @error_class %></span>
+        — <%= link_to "Clear filter", failed_jobs_path %>
+      </div>
+    <% end %>
+  </div>
   <div class="sqw-header-actions">
+    <%= link_to "Error Summary", failed_job_errors_path, class: "sqw-btn sqw-btn--muted sqw-btn--sm" %>
     <%= link_to "Export CSV", failed_jobs_path(format: :csv),
           class: "sqw-btn sqw-btn--muted sqw-btn--sm", data: { turbo: false } %>
   </div>
@@ -32,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,10 +106,11 @@
                          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 %>
             <th scope="col"><span class="sqw-sr-only">Actions</span></th>
           </tr>
@@ -140,7 +147,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/app/views/solid_stack_web/stats/index.html.erb

@@ -12,6 +12,8 @@
           ["avg",        "Avg"],
           ["p50",        "p50"],
           ["p95",        "p95"],
+          ["p99",        "p99"],
+          ["stddev",     "Std Dev"],
           ["min",        "Min"],
           ["max",        "Max"]
         ].each do |col, label| %>
@@ -35,6 +37,8 @@
           <td class="sqw-muted"><%= format_duration(row[:avg]) %></td>
           <td class="sqw-muted"><%= format_duration(row[:p50]) %></td>
           <td><strong><%= format_duration(row[:p95]) %></strong></td>
+          <td class="sqw-muted"><%= format_duration(row[:p99]) %></td>
+          <td class="sqw-muted"><%= format_duration(row[:stddev]) %></td>
           <td class="sqw-muted"><%= format_duration(row[:min]) %></td>
           <td class="sqw-muted"><%= format_duration(row[:max]) %></td>
         </tr>

data/config/routes.rb

@@ -20,6 +20,8 @@ SolidStackWeb::Engine.routes.draw do
     end
   end
 
+  get "failed_jobs/errors", to: "failed_jobs/errors#index", as: :failed_job_errors
+
   resources :failed_jobs, only: [:index, :show, :destroy] do
     member { post :retry }
     resource :arguments, only: [:update], controller: "failed_jobs/arguments"

data/lib/solid_stack_web/version.rb

@@ -1,3 +1,3 @@
 module SolidStackWeb
-  VERSION = "1.0.0"
+  VERSION = "1.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: solid_stack_web
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Chuck Smith
@@ -160,6 +160,7 @@ files:
 - app/controllers/solid_stack_web/cache_entries_controller.rb
 - app/controllers/solid_stack_web/dashboard_controller.rb
 - app/controllers/solid_stack_web/failed_jobs/arguments_controller.rb
+- app/controllers/solid_stack_web/failed_jobs/errors_controller.rb
 - app/controllers/solid_stack_web/failed_jobs/selections_controller.rb
 - app/controllers/solid_stack_web/failed_jobs_controller.rb
 - app/controllers/solid_stack_web/history_controller.rb
@@ -175,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
@@ -187,6 +189,8 @@ files:
 - app/models/solid_stack_web/cache_size_stats.rb
 - app/models/solid_stack_web/cache_stats.rb
 - app/models/solid_stack_web/cache_timeline.rb
+- app/models/solid_stack_web/error_frequency_report.rb
+- app/models/solid_stack_web/failed_job_sparkline.rb
 - app/models/solid_stack_web/job.rb
 - app/models/solid_stack_web/queue_depth_sparkline.rb
 - app/models/solid_stack_web/queue_stats.rb
@@ -201,6 +205,7 @@ files:
 - app/views/solid_stack_web/errors/internal_server_error.html.erb
 - app/views/solid_stack_web/errors/not_found.html.erb
 - app/views/solid_stack_web/failed_jobs/destroy.turbo_stream.erb
+- app/views/solid_stack_web/failed_jobs/errors/index.html.erb
 - app/views/solid_stack_web/failed_jobs/index.html.erb
 - app/views/solid_stack_web/failed_jobs/show.html.erb
 - app/views/solid_stack_web/history/index.html.erb