solid_stack_web 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 777352d5919952ea022a545b13608ace8f35e0f91077431c45a679e5c30bec19
-  data.tar.gz: d36dbf96b4234d730249df1d259099883d0473c160c62ab9bee73fe88ff133c4
+  metadata.gz: c446164425203124cb715d09c520cfa7b2cc03a6abeefb4eb27ca0514327160a
+  data.tar.gz: ef9abaa3fe16c5ffc1e019dfff0ce97d7541950db9f6f25ae5ce034f4780efb5
 SHA512:
-  metadata.gz: eefbb43300e8e244b6354d1fb952edc7577585c76f5721920d6fa28aba41038840d4924cae9799903a3742e0782a2e8f95d8b142502194d1726e87fbb8c35e7a
-  data.tar.gz: 254f13440a71b0dcfbeb3330f2c1be4c21a5e038e09355493bba1fe5b3767b70d314ba37982d7adced753915a971d159d06bdc29741e5c37e223e520184f34e9
+  metadata.gz: 30b738bcc2e57c4f81fb03d7b4a74bf88e18a1b69d4b71bc646357703006d6a1b639090a77a11d258427b7ad080f0b93b317cd949ff9b3b3353f77caa3e69066
+  data.tar.gz: 37f9a4d50e42360411c4213be03ce5c343874314a048b5f09b13b450bfc2ccf3568a2033cf5d4d137ee59723658f9a3cccbcd6353cf7f2f677159bd2b04fba73

data/README.md

@@ -7,21 +7,6 @@
 
 A mountable Rails engine that provides a unified web dashboard for the full [Solid Stack](https://github.com/rails/solid_queue) — **Solid Queue**, **Solid Cache**, and **Solid Cable** — in a single interface with no asset pipeline dependency and no JavaScript runtime requirement.
 
-## Features
-
-- **Overview dashboard** with live counts across all three Solid Stack components; cards are clickable and link directly to each section
-- **Solid Queue** — browse jobs by status (ready, scheduled, claimed, blocked) with filtering by job class, queue name, priority, and time period; manage failed jobs (retry / discard / bulk retry / bulk discard), pause/resume queues, and inspect worker processes; **Bulk selection** checkbox-selects individual jobs for discard or retry; **Discard All** bulk-discards every job matching the current filters in one request; **CSV export** downloads jobs or failed jobs as a CSV file respecting active filters; **Per-queue browser** — click any queue name or size to drill into its ready jobs with per-row and bulk discard
-- **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
-- **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)" in the header 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 that immediately enqueues the task
-- **Job detail page** — drill into any job to see full arguments (pretty-printed JSON), queue, priority, enqueued time, Active Job ID, concurrency key, scheduled/blocked-until metadata, and a Discard button
-- **Failed job detail page** — drill into any failed job to see the full error, backtrace, and an inline JSON argument editor; submit to update arguments and retry in one action
-- **Solid Cache** — entry count and total byte size at a glance
-- **Solid Cable** — active message count and distinct channel count
-- **Turbo Stream** job discard — removes the row inline without a full page reload
-- **Authentication hook** — plug in your own auth logic (Devise, Basic Auth, custom) via a one-line initializer
-- **Zero asset pipeline coupling** — CSS is injected inline; safe to mount in any host app
-
 ## Installation
 
 Add the gem to your application's `Gemfile`:
@@ -44,24 +29,55 @@ mount SolidStackWeb::Engine, at: "/solid_stack"
 
 The dashboard will be available at `/solid_stack` (or whatever path you choose).
 
-## Configuration
+---
 
-Create an initializer at `config/initializers/solid_stack_web.rb`:
+## Solid Queue
+
+### 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
+- **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
+- **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
+- **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
+
+### Configuration
 
 ```ruby
 SolidStackWeb.configure do |config|
-  # Number of items per paginated page (default: 25)
-  config.page_size = 50
-
-  # Authentication — block runs in controller context.
-  # Return a truthy value to allow access; falsy falls back to HTTP Basic.
-  config.authenticate do
-    current_user&.admin?
-  end
+  # Slow job threshold in seconds (default: nil — stat hidden).
+  # When set, the dashboard shows a "Slow (24h)" count of finished jobs
+  # whose wall time exceeded this value. Links to the Stats page.
+  config.slow_job_threshold = 30
+
+  # Alert webhooks — fired on every GET /metrics poll when a threshold is met.
+  # Delivery failures are silently swallowed; cooldown prevents alert storms.
+  config.alert_webhook_url       = "https://hooks.example.com/my-alert"
+  config.alert_failure_threshold = 10          # POST when failed jobs >= this
+  config.alert_queue_thresholds  = {           # POST when a queue's ready depth >= value
+    "critical" => 50,
+    "default"  => 500
+  }
+  config.alert_webhook_cooldown  = 3600        # seconds between alerts (default: 3600)
+
+  # Auto-refresh intervals in milliseconds.
+  config.dashboard_refresh_interval = 5_000   # overview dashboard (default: 5000)
+  config.default_refresh_interval   = 10_000  # jobs, processes, history (default: 10000)
+
+  # Maximum results shown by the search feature (default: 25).
+  config.search_results_limit = 25
 end
 ```
 
-### Job Filtering
+#### Job Filtering
 
 The jobs list supports four independent filters, all driven by query params:
 
@@ -74,10 +90,71 @@ The jobs list supports four independent filters, all driven by query params:
 
 Filters are preserved when switching between status tabs (Ready / Scheduled / Running / Blocked) and when discarding a job. They can be combined freely.
 
+---
+
+## Solid Cache
+
+_Deep cache monitoring coming in v0.5.0. Currently shows entry count and total byte size on the overview dashboard._
+
+---
+
+## Solid Cable
+
+_Channel monitoring coming in v0.6.0. Currently shows active message count and distinct channel count on the overview dashboard._
+
+---
+
+## Metrics endpoint
+
+`GET /metrics` (relative to your mount path) returns a JSON payload suitable for external monitoring tools, uptime checkers, or custom alerting:
+
+```json
+{
+  "queue": {
+    "ready": 4,
+    "scheduled": 1,
+    "claimed": 2,
+    "blocked": 0,
+    "failed": 3,
+    "done_1h": 45,
+    "done_24h": 312,
+    "processes_healthy": 2,
+    "processes_stale": 0,
+    "slow_jobs": 7
+  },
+  "cache": { "entries": 1024, "byte_size": 2097152 },
+  "cable": { "messages": 50, "channels": 3 },
+  "generated_at": "2026-05-26T10:00:00Z"
+}
+```
+
+`slow_jobs` is only present when `slow_job_threshold` is configured. The endpoint is protected by the same authentication as the rest of the dashboard.
+
+---
+
+## General configuration
+
+Create an initializer at `config/initializers/solid_stack_web.rb`:
+
+```ruby
+SolidStackWeb.configure do |config|
+  # Number of items per paginated page (default: 25)
+  config.page_size = 50
+
+  # Authentication — block runs in controller context.
+  # Return a truthy value to allow access; falsy falls back to HTTP Basic.
+  config.authenticate do
+    current_user&.admin?
+  end
+end
+```
+
 ### Authentication
 
 The `authenticate` block is evaluated in the context of each request's controller instance, so any helper method available to controllers (e.g. `current_user` from Devise) works directly. If the block returns `false` or `nil`, the engine falls back to HTTP Basic authentication. If no `authenticate` block is configured, the dashboard is open.
 
+---
+
 ## Requirements
 
 - Ruby >= 3.3

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

@@ -30,6 +30,10 @@
 .sqw-actions { text-align: right; white-space: nowrap; }
 .sqw-actions form { display: inline; }
 
+.sqw-table th a { color: inherit; text-decoration: none; }
+.sqw-table th a:hover { color: var(--text); }
+.sqw-sort-indicator { margin-left: 0.2rem; }
+
 .sqw-empty {
   background: var(--surface);
   border: 1px solid var(--border);

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

@@ -12,7 +12,6 @@
   border-radius: var(--radius);
   box-shadow: var(--shadow);
   overflow: hidden;
-  position: relative;
   transition: box-shadow 0.15s;
 }
 .sqw-gem-card:hover { box-shadow: 0 3px 8px rgba(0,0,0,.12); }
@@ -44,16 +43,6 @@
 }
 .sqw-gem-card__link:hover { color: var(--primary); text-decoration: none; }
 
-/* Stretch the header link to cover the whole card */
-.sqw-gem-card__link::after {
-  content: "";
-  position: absolute;
-  inset: 0;
-}
-
-/* Stat links and other interactive elements sit above the overlay */
-.sqw-inline-stat { position: relative; z-index: 1; }
-
 .sqw-gem-card__body {
   display: grid;
   grid-template-columns: repeat(auto-fill, minmax(90px, 1fr));
@@ -68,6 +57,7 @@
   color: var(--text);
   transition: opacity 0.15s;
 }
+
 a.sqw-inline-stat:hover { opacity: 0.7; text-decoration: none; }
 
 .sqw-inline-stat__label {
@@ -87,4 +77,66 @@ a.sqw-inline-stat:hover { opacity: 0.7; text-decoration: none; }
 .sqw-inline-stat--failed    .sqw-inline-stat__value { color: var(--danger); }
 .sqw-inline-stat--cache     .sqw-inline-stat__value { color: var(--purple); }
 .sqw-inline-stat--cable     .sqw-inline-stat__value { color: var(--info); }
-.sqw-inline-stat--neutral   .sqw-inline-stat__value { color: var(--muted); }
+.sqw-inline-stat--neutral   .sqw-inline-stat__value { color: var(--muted); }
+
+.sqw-sparkline-wrap {
+  padding: 0.75rem 1.25rem 1rem;
+  border-top: 1px solid var(--border);
+  color: var(--primary);
+}
+
+.sqw-sparkline-label {
+  display: block;
+  font-size: 10px;
+  font-weight: 500;
+  text-transform: uppercase;
+  letter-spacing: .06em;
+  color: var(--muted);
+  margin-bottom: 0.5rem;
+}
+
+.sqw-sparkline-positioner {
+  position: relative;
+}
+
+.sqw-sparkline {
+  display: block;
+  width: 100%;
+  height: 40px;
+}
+
+.sqw-sparkline--sm {
+  height: 24px;
+}
+
+.sqw-queue-sparkline {
+  width: 120px;
+  color: var(--primary);
+}
+
+.sqw-sparkline rect {
+  cursor: pointer;
+}
+
+.sqw-sparkline-tip {
+  position: fixed;
+  transform: translate(-50%, -100%);
+  background: var(--text);
+  color: var(--surface);
+  font-size: 11px;
+  font-weight: 500;
+  white-space: nowrap;
+  padding: 3px 7px;
+  border-radius: 4px;
+  pointer-events: none;
+  z-index: 100;
+}
+
+.sqw-sparkline-axis {
+  display: flex;
+  justify-content: space-between;
+  font-size: 9px;
+  color: var(--muted);
+  margin-top: 3px;
+  opacity: 0.7;
+}

data/app/controllers/solid_stack_web/dashboard_controller.rb

@@ -1,22 +1,10 @@
 module SolidStackWeb
   class DashboardController < ApplicationController
     def index
-      @queue_stats = {
-        ready:     ::SolidQueue::ReadyExecution.count,
-        scheduled: ::SolidQueue::ScheduledExecution.count,
-        claimed:   ::SolidQueue::ClaimedExecution.count,
-        blocked:   ::SolidQueue::BlockedExecution.count,
-        failed:    ::SolidQueue::FailedExecution.count,
-        processes: ::SolidQueue::Process.count
-      }
-      @cache_stats = {
-        entries:   ::SolidCache::Entry.count,
-        byte_size: ::SolidCache::Entry.sum(:byte_size)
-      }
-      @cable_stats = {
-        messages: ::SolidCable::Message.count,
-        channels: ::SolidCable::Message.distinct.count(:channel)
-      }
+      @queue_stats = QueueStats.new.to_h
+      @cache_stats = CacheStats.new.to_h
+      @cable_stats = CableStats.new.to_h
+      @throughput  = ThroughputSparkline.new
     end
   end
 end

data/app/controllers/solid_stack_web/metrics_controller.rb

@@ -0,0 +1,15 @@
+module SolidStackWeb
+  class MetricsController < ApplicationController
+    def index
+      queue_stats = QueueStats.new.to_h
+      AlertWebhook.check(queue_stats)
+
+      render json: {
+        queue:        queue_stats,
+        cache:        CacheStats.new.to_h,
+        cable:        CableStats.new.to_h,
+        generated_at: Time.current.iso8601
+      }
+    end
+  end
+end

data/app/controllers/solid_stack_web/queues_controller.rb

@@ -11,6 +11,10 @@ module SolidStackWeb
           paused: paused.include?(name)
         }
       end
+
+      @sparklines = @queues.each_with_object({}) do |queue, h|
+        h[queue[:name]] = QueueDepthSparkline.new(queue[:name])
+      end
     end
 
     def show

data/app/controllers/solid_stack_web/stats_controller.rb

@@ -0,0 +1,39 @@
+module SolidStackWeb
+  class StatsController < ApplicationController
+    SORTABLE_COLUMNS = %w[class_name count avg p50 p95 min max].freeze
+
+    def index
+      @sort      = params[:sort].presence_in(SORTABLE_COLUMNS) || "p95"
+      @direction = params[:direction] == "asc" ? "asc" : "desc"
+
+      jobs   = SolidQueue::Job.where.not(finished_at: nil).select(:class_name, :created_at, :finished_at)
+      @stats = build_stats(jobs)
+      @stats.sort_by! { |row| row[@sort.to_sym] || 0 }
+      @stats.reverse! if @direction == "desc"
+    end
+
+    private
+
+    def build_stats(jobs)
+      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
+        {
+          class_name: class_name,
+          count:      count,
+          avg:        durations.sum / count,
+          min:        durations.first,
+          max:        durations.last,
+          p50:        percentile(durations, 50),
+          p95:        percentile(durations, 95)
+        }
+      end
+    end
+
+    def percentile(sorted, pct)
+      return 0.0 if sorted.empty?
+      k = (sorted.size - 1) * pct / 100.0
+      sorted[k.floor] + (sorted[k.ceil] - sorted[k.floor]) * (k - k.floor)
+    end
+  end
+end

data/app/helpers/solid_stack_web/application_helper.rb

@@ -1,13 +1,69 @@
 module SolidStackWeb
   module ApplicationHelper
     def format_duration(seconds)
+      return "—" if seconds.nil?
+      return "#{(seconds * 1000).round}ms" if seconds < 1
       s = seconds.to_i
-      return "#{s}s"          if s < 60
-      return "#{s / 60}m #{s % 60}s" if s < 3600
+      return "#{sprintf("%g", seconds.round(1))}s" if s < 60
+      return "#{s / 60}m #{s % 60}s"      if s < 3600
 
       "#{s / 3600}h #{(s % 3600) / 60}m"
     end
 
+    def throughput_sparkline_svg(sparkline)
+      build_sparkline_svg(sparkline, aria_label: "Throughput over the last 12 hours") do |count, i|
+        hours_ago = SolidStackWeb::ThroughputSparkline::HOURS - i
+        if hours_ago == 1
+          "#{count} #{count == 1 ? "job" : "jobs"} in the last hour"
+        else
+          "#{count} #{count == 1 ? "job" : "jobs"} (#{hours_ago}h–#{hours_ago - 1}h ago)"
+        end
+      end
+    end
+
+    def queue_depth_sparkline_svg(sparkline)
+      build_sparkline_svg(sparkline, css_class: "sqw-sparkline sqw-sparkline--sm",
+                                     aria_label: "Queue depth over the last 12 hours") do |count, i|
+        hours_ago = SolidStackWeb::QueueDepthSparkline::HOURS - 1 - i
+        jobs_word = count == 1 ? "job" : "jobs"
+        hours_ago.zero? ? "#{count} ready #{jobs_word} now" : "#{count} ready #{jobs_word} #{hours_ago}h ago"
+      end
+    end
+
+    private
+
+    def build_sparkline_svg(sparkline, css_class: "sqw-sparkline", aria_label: nil, &tooltip_text)
+      buckets = sparkline.buckets
+      peak    = [sparkline.max.to_f, 1.0].max
+      h       = 40
+      bar_w   = 8
+      gap     = 2
+      total_w = buckets.size * (bar_w + gap) - gap
+
+      bars = buckets.each_with_index.map do |count, i|
+        x       = i * (bar_w + gap)
+        bar_h   = [(count / peak * (h - 4)).round, 2].max
+        y       = h - bar_h
+        opacity = count.zero? ? "0.18" : "1"
+        tip     = tooltip_text.call(count, i)
+        attrs = %( x="#{x}" y="#{y}" width="#{bar_w}" height="#{bar_h}" rx="1") +
+                %( fill="currentColor" opacity="#{opacity}") +
+                %( data-sparkline-tooltip-target="bar") +
+                %( data-tip="#{ERB::Util.html_escape(tip)}") +
+                %( data-action="mouseenter->sparkline-tooltip#show mouseleave->sparkline-tooltip#hide")
+        "<rect#{attrs}></rect>"
+      end.join
+
+      content_tag(:svg, bars.html_safe,
+                  viewBox: "0 0 #{total_w} #{h}",
+                  preserveAspectRatio: "none",
+                  class: css_class,
+                  role: "img",
+                  "aria-label": aria_label)
+    end
+
+    public
+
     def inline_styles
       dir = SolidStackWeb::Engine.root.join("app/assets/stylesheets/solid_stack_web")
       css = dir.glob("_*.css").sort.map(&:read).join("\n")

data/app/javascript/solid_stack_web/application.js

@@ -1,6 +1,10 @@
 import "@hotwired/turbo"
 import { Application } from "@hotwired/stimulus"
+import RefreshController from "solid_stack_web/refresh_controller"
 import SelectionController from "solid_stack_web/selection_controller"
+import SparklineTooltipController from "solid_stack_web/sparkline_tooltip_controller"
 
 const application = Application.start()
-application.register("selection", SelectionController)
+application.register("refresh", RefreshController)
+application.register("selection", SelectionController)
+application.register("sparkline-tooltip", SparklineTooltipController)

data/app/javascript/solid_stack_web/refresh_controller.js

@@ -0,0 +1,52 @@
+import { Controller } from "@hotwired/stimulus"
+
+export default class extends Controller {
+  static values = { interval: { type: Number, default: 5000 } }
+
+  initialize() {
+    this._onVisibilityChange = this._onVisibilityChange.bind(this)
+  }
+
+  connect() {
+    document.addEventListener("visibilitychange", this._onVisibilityChange)
+    this._schedule()
+  }
+
+  disconnect() {
+    clearTimeout(this._timer)
+    document.removeEventListener("visibilitychange", this._onVisibilityChange)
+  }
+
+  _schedule() {
+    this._timer = setTimeout(() => this._reload(), this.intervalValue)
+  }
+
+  async _reload() {
+    clearTimeout(this._timer)
+    const hasSelection = this.element.querySelector("input[type='checkbox']:checked")
+    if (!document.hidden && !hasSelection) {
+      try {
+        const response = await fetch(window.location.href, {
+          headers: { "Turbo-Frame": this.element.id, Accept: "text/html" }
+        })
+        if (response.ok) {
+          const html = await response.text()
+          const doc = new DOMParser().parseFromString(html, "text/html")
+          const frame = doc.querySelector(`turbo-frame#${this.element.id}`)
+          if (frame && this.element.isConnected) this.element.innerHTML = frame.innerHTML
+        }
+      } catch {
+        // network error — skip this tick
+      }
+    }
+    if (this.element.isConnected) this._schedule()
+  }
+
+  _onVisibilityChange() {
+    if (document.hidden) {
+      clearTimeout(this._timer)
+    } else if (!this.element.querySelector("input[type='checkbox']:checked")) {
+      this._reload()
+    }
+  }
+}

data/app/javascript/solid_stack_web/sparkline_tooltip_controller.js

@@ -0,0 +1,23 @@
+import { Controller } from "@hotwired/stimulus"
+
+export default class extends Controller {
+  static targets = ["bar", "tip"]
+
+  connect() {
+    this._tip = this.tipTarget
+  }
+
+  show({ currentTarget }) {
+    const label = currentTarget.dataset.tip
+    if (!label) return
+    const rect = currentTarget.getBoundingClientRect()
+    this._tip.textContent = label
+    this._tip.style.left = `${rect.left + rect.width / 2}px`
+    this._tip.style.top = `${rect.top - 6}px`
+    this._tip.hidden = false
+  }
+
+  hide() {
+    this._tip.hidden = true
+  }
+}

data/app/models/solid_stack_web/alert_webhook.rb

@@ -0,0 +1,67 @@
+require "net/http"
+require "json"
+
+module SolidStackWeb
+  class AlertWebhook
+    COOLDOWN_CACHE_KEY = "solid_stack_web/alert_webhook/cooldown"
+
+    def self.check(queue_stats)
+      new(queue_stats).check
+    end
+
+    def initialize(queue_stats)
+      @queue_stats = queue_stats
+    end
+
+    def check
+      return unless SolidStackWeb.alert_webhook_url
+      return if on_cooldown?
+
+      alerts = build_alerts
+      return if alerts.empty?
+
+      deliver(alerts)
+      set_cooldown
+    end
+
+    private
+
+    def build_alerts
+      alerts = []
+
+      if (threshold = SolidStackWeb.alert_failure_threshold)
+        count = @queue_stats[:failed]
+        alerts << { type: "failed_jobs", count: count, threshold: threshold } if count >= threshold
+      end
+
+      SolidStackWeb.alert_queue_thresholds.each do |queue_name, threshold|
+        count = ::SolidQueue::ReadyExecution.where(queue_name: queue_name.to_s).count
+        alerts << { type: "queue_depth", queue: queue_name.to_s, count: count, threshold: threshold } if count >= threshold
+      end
+
+      alerts
+    end
+
+    def deliver(alerts)
+      payload = { alerts: alerts, generated_at: Time.current.iso8601 }
+      uri = URI(SolidStackWeb.alert_webhook_url)
+      Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https",
+                      open_timeout: 5, read_timeout: 5) do |http|
+        request = Net::HTTP::Post.new(uri, "Content-Type" => "application/json")
+        request.body = payload.to_json
+        http.request(request)
+      end
+    rescue StandardError
+      # webhook delivery failures must not affect the response
+    end
+
+    def on_cooldown?
+      Rails.cache.read(COOLDOWN_CACHE_KEY).present?
+    end
+
+    def set_cooldown
+      Rails.cache.write(COOLDOWN_CACHE_KEY, Time.current.iso8601,
+                        expires_in: SolidStackWeb.alert_webhook_cooldown)
+    end
+  end
+end

data/app/models/solid_stack_web/cable_stats.rb

@@ -0,0 +1,10 @@
+module SolidStackWeb
+  class CableStats
+    def to_h
+      {
+        messages: ::SolidCable::Message.count,
+        channels: ::SolidCable::Message.distinct.count(:channel)
+      }
+    end
+  end
+end

data/app/models/solid_stack_web/cache_stats.rb

@@ -0,0 +1,10 @@
+module SolidStackWeb
+  class CacheStats
+    def to_h
+      {
+        entries:   ::SolidCache::Entry.count,
+        byte_size: ::SolidCache::Entry.sum(:byte_size)
+      }
+    end
+  end
+end

data/app/models/solid_stack_web/queue_depth_sparkline.rb

@@ -0,0 +1,30 @@
+module SolidStackWeb
+  class QueueDepthSparkline
+    HOURS = 12
+
+    def initialize(queue_name)
+      @queue_name = queue_name
+    end
+
+    def buckets
+      @buckets ||= begin
+        now    = Time.current
+        origin = now - HOURS.hours
+
+        jobs = ::SolidQueue::Job
+                 .where(queue_name: @queue_name)
+                 .where("created_at <= ? AND (finished_at IS NULL OR finished_at >= ?)", now, origin)
+                 .pluck(:created_at, :finished_at)
+
+        HOURS.times.map do |i|
+          snapshot = origin + (i + 1).hours
+          jobs.count { |created_at, finished_at| created_at <= snapshot && (finished_at.nil? || finished_at > snapshot) }
+        end
+      end
+    end
+
+    def max
+      buckets.max || 0
+    end
+  end
+end

data/app/models/solid_stack_web/queue_stats.rb

@@ -0,0 +1,34 @@
+module SolidStackWeb
+  class QueueStats
+    def to_h
+      finished_24h = finished_since(24.hours.ago)
+      stats = {
+        ready:             ::SolidQueue::ReadyExecution.count,
+        scheduled:         ::SolidQueue::ScheduledExecution.count,
+        claimed:           ::SolidQueue::ClaimedExecution.count,
+        blocked:           ::SolidQueue::BlockedExecution.count,
+        failed:            ::SolidQueue::FailedExecution.count,
+        done_1h:           finished_since(1.hour.ago).count,
+        done_24h:          finished_24h.count,
+        processes_healthy: ::SolidQueue::Process.where("last_heartbeat_at > ?", 5.minutes.ago).count,
+        processes_stale:   ::SolidQueue::Process.where("last_heartbeat_at <= ? OR last_heartbeat_at IS NULL", 5.minutes.ago).count
+      }
+      add_slow_jobs(stats, finished_24h)
+      stats
+    end
+
+    private
+
+    def finished_since(time)
+      ::SolidQueue::Job.where.not(finished_at: nil).where("finished_at >= ?", time)
+    end
+
+    def add_slow_jobs(stats, finished_24h)
+      threshold = SolidStackWeb.slow_job_threshold
+      return unless threshold
+
+      stats[:slow_jobs] = finished_24h.select(:created_at, :finished_at)
+                                      .count { |j| (j.finished_at - j.created_at) > threshold }
+    end
+  end
+end

data/app/models/solid_stack_web/throughput_sparkline.rb

@@ -0,0 +1,23 @@
+module SolidStackWeb
+  class ThroughputSparkline
+    HOURS = 12
+
+    def buckets
+      @buckets ||= begin
+        now    = Time.current
+        origin = now - HOURS.hours
+        times  = ::SolidQueue::Job.where(finished_at: origin..now).pluck(:finished_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/layouts/solid_stack_web/application.html.erb

@@ -35,6 +35,8 @@
               class: "sqw-subnav__link#{" sqw-subnav__link--active" if controller_name == "queues"}" %>
         <%= link_to "Recurring", recurring_tasks_path,
               class: "sqw-subnav__link#{" sqw-subnav__link--active" if controller_name == "recurring_tasks"}" %>
+        <%= link_to "Stats", stats_path,
+              class: "sqw-subnav__link#{" sqw-subnav__link--active" if controller_name == "stats"}" %>
         <%= link_to "History", history_path,
               class: "sqw-subnav__link#{" sqw-subnav__link--active" if controller_name == "history"}" %>
         <%= link_to "Processes", processes_path,

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

@@ -1,3 +1,5 @@
+<%= turbo_frame_tag "sqw-dashboard", target: "_top",
+      data: { controller: "refresh", refresh_interval_value: SolidStackWeb.dashboard_refresh_interval } do %>
 <div class="sqw-page-header">
   <h1 class="sqw-page-title">Overview</h1>
 </div>
@@ -29,10 +31,42 @@
         <span class="sqw-inline-stat__label">Failed</span>
         <span class="sqw-inline-stat__value"><%= @queue_stats[:failed] %></span>
       </a>
+      <a href="<%= history_path(period: "1h") %>" class="sqw-inline-stat sqw-inline-stat--neutral">
+        <span class="sqw-inline-stat__label">Done (1h)</span>
+        <span class="sqw-inline-stat__value"><%= @queue_stats[:done_1h] %></span>
+      </a>
+      <a href="<%= history_path(period: "24h") %>" class="sqw-inline-stat sqw-inline-stat--neutral">
+        <span class="sqw-inline-stat__label">Done (24h)</span>
+        <span class="sqw-inline-stat__value"><%= @queue_stats[:done_24h] %></span>
+      </a>
+      <% if @queue_stats.key?(:slow_jobs) %>
+        <a href="<%= stats_path %>" class="sqw-inline-stat sqw-inline-stat--<%= @queue_stats[:slow_jobs] > 0 ? "failed" : "neutral" %>">
+          <span class="sqw-inline-stat__label">Slow (24h)</span>
+          <span class="sqw-inline-stat__value"><%= @queue_stats[:slow_jobs] %></span>
+        </a>
+      <% end %>
       <a href="<%= processes_path %>" class="sqw-inline-stat sqw-inline-stat--neutral">
-        <span class="sqw-inline-stat__label">Processes</span>
-        <span class="sqw-inline-stat__value"><%= @queue_stats[:processes] %></span>
+        <span class="sqw-inline-stat__label">Healthy</span>
+        <span class="sqw-inline-stat__value"><%= @queue_stats[:processes_healthy] %></span>
       </a>
+      <% if @queue_stats[:processes_stale] > 0 %>
+        <a href="<%= processes_path %>" class="sqw-inline-stat sqw-inline-stat--failed">
+          <span class="sqw-inline-stat__label">Stale</span>
+          <span class="sqw-inline-stat__value"><%= @queue_stats[:processes_stale] %></span>
+        </a>
+      <% end %>
+    </div>
+    <div class="sqw-sparkline-wrap" data-controller="sparkline-tooltip">
+      <span class="sqw-sparkline-label">Throughput — last 12 hours</span>
+      <div class="sqw-sparkline-positioner">
+        <%= throughput_sparkline_svg(@throughput) %>
+        <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>
 
@@ -70,3 +104,4 @@
     </div>
   </div>
 </div>
+<% end %>

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

@@ -1,3 +1,5 @@
+<%= turbo_frame_tag "sqw-history-table",
+      data: { controller: "refresh", refresh_interval_value: SolidStackWeb.default_refresh_interval } do %>
 <div class="sqw-page-header sqw-page-header--split">
   <h1 class="sqw-page-title">Job History</h1>
   <div class="sqw-header-actions">
@@ -70,4 +72,5 @@
   <div class="sqw-empty">
     <p>No finished jobs found.</p>
   </div>
+<% end %>
 <% end %>

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

@@ -29,7 +29,9 @@
   <% end %>
 </div>
 
-<turbo-frame id="sqw-jobs-filter" data-turbo-action="advance">
+<%= 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">
   <%= hidden_field_tag :status, @status %>
   <%= hidden_field_tag :period, @period %>
@@ -151,4 +153,4 @@
     <%= render "empty" %>
   <% end %>
 </div>
-</turbo-frame>
+<% end %>

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

@@ -1,3 +1,5 @@
+<%= turbo_frame_tag "sqw-processes", target: "_top",
+      data: { controller: "refresh", refresh_interval_value: SolidStackWeb.default_refresh_interval } do %>
 <div class="sqw-page-header">
   <h1 class="sqw-page-title">Processes</h1>
 </div>
@@ -30,3 +32,4 @@
     <p>No active processes.</p>
   </div>
 <% end %>
+<% end %>

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

@@ -8,6 +8,7 @@
       <tr>
         <th>Name</th>
         <th>Size</th>
+        <th>Depth (12h)</th>
         <th>Status</th>
         <th></th>
       </tr>
@@ -17,6 +18,10 @@
         <tr>
           <td class="sqw-monospace"><%= link_to queue[:name], queue_path(queue[:name]) %></td>
           <td><%= link_to queue[:size], queue_path(queue[:name]) %></td>
+          <td class="sqw-queue-sparkline" data-controller="sparkline-tooltip">
+            <%= queue_depth_sparkline_svg(@sparklines[queue[:name]]) %>
+            <div class="sqw-sparkline-tip" data-sparkline-tooltip-target="tip" hidden></div>
+          </td>
           <td>
             <% if queue[:paused] %>
               <span class="sqw-badge sqw-badge--paused">Paused</span>
@@ -41,4 +46,4 @@
   <div class="sqw-empty">
     <p>No queues with ready jobs.</p>
   </div>
-<% end %>
+<% end %>

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

@@ -0,0 +1,48 @@
+<div class="sqw-page-header">
+  <h1 class="sqw-page-title">Performance Stats</h1>
+</div>
+
+<% if @stats.any? %>
+  <table class="sqw-table">
+    <thead>
+      <tr>
+        <% [
+          ["class_name", "Job Class"],
+          ["count",      "Executions"],
+          ["avg",        "Avg"],
+          ["p50",        "p50"],
+          ["p95",        "p95"],
+          ["min",        "Min"],
+          ["max",        "Max"]
+        ].each do |col, label| %>
+          <th>
+            <% next_dir = (@sort == col && @direction == "desc") ? "asc" : "desc" %>
+            <%= link_to stats_path(sort: col, direction: next_dir) do %>
+              <%= label %>
+              <% if @sort == col %>
+                <span class="sqw-sort-indicator"><%= @direction == "desc" ? "↓" : "↑" %></span>
+              <% end %>
+            <% end %>
+          </th>
+        <% end %>
+      </tr>
+    </thead>
+    <tbody>
+      <% @stats.each do |row| %>
+        <tr>
+          <td class="sqw-monospace"><%= row[:class_name] %></td>
+          <td><%= row[:count] %></td>
+          <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[:min]) %></td>
+          <td class="sqw-muted"><%= format_duration(row[:max]) %></td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+<% else %>
+  <div class="sqw-empty">
+    <p>No finished jobs yet.</p>
+  </div>
+<% end %>

data/config/importmap.rb

@@ -1,2 +1,6 @@
+pin "@hotwired/turbo", to: "https://cdn.jsdelivr.net/npm/@hotwired/turbo@8.0.23/dist/turbo.es2017-esm.js"
+pin "@hotwired/stimulus", to: "https://cdn.jsdelivr.net/npm/@hotwired/stimulus@3.2.2/dist/stimulus.js"
 pin "solid_stack_web", to: "solid_stack_web/application.js"
+pin "solid_stack_web/refresh_controller", to: "solid_stack_web/refresh_controller.js"
 pin "solid_stack_web/selection_controller", to: "solid_stack_web/selection_controller.js"
+pin "solid_stack_web/sparkline_tooltip_controller", to: "solid_stack_web/sparkline_tooltip_controller.js"

data/config/routes.rb

@@ -31,6 +31,8 @@ SolidStackWeb::Engine.routes.draw do
 
   resources :processes, only: [:index]
 
+  get "metrics", to: "metrics#index", as: :metrics
+  get "stats",   to: "stats#index",   as: :stats
   get "history", to: "history#index", as: :history
   get "cache", to: "cache#index", as: :cache
   get "cable", to: "cable#index", as: :cable

data/lib/solid_stack_web/version.rb

@@ -1,3 +1,3 @@
 module SolidStackWeb
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

data/lib/solid_stack_web.rb

@@ -3,7 +3,11 @@ require "solid_stack_web/engine"
 
 module SolidStackWeb
   class << self
-    attr_writer :page_size, :connects_to
+    attr_writer :page_size, :connects_to, :slow_job_threshold,
+                :alert_webhook_url, :alert_webhook_cooldown,
+                :alert_failure_threshold, :alert_queue_thresholds,
+                :dashboard_refresh_interval, :default_refresh_interval,
+                :search_results_limit
 
     def page_size
       @page_size || 25
@@ -13,6 +17,38 @@ module SolidStackWeb
       @connects_to
     end
 
+    def slow_job_threshold
+      @slow_job_threshold
+    end
+
+    def alert_webhook_url
+      @alert_webhook_url
+    end
+
+    def alert_webhook_cooldown
+      @alert_webhook_cooldown || 3600
+    end
+
+    def alert_failure_threshold
+      @alert_failure_threshold
+    end
+
+    def alert_queue_thresholds
+      @alert_queue_thresholds || {}
+    end
+
+    def dashboard_refresh_interval
+      @dashboard_refresh_interval || 5_000
+    end
+
+    def default_refresh_interval
+      @default_refresh_interval || 10_000
+    end
+
+    def search_results_limit
+      @search_results_limit || 25
+    end
+
     def configure
       yield self
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: solid_stack_web
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Chuck Smith
@@ -153,16 +153,26 @@ files:
 - app/controllers/solid_stack_web/history_controller.rb
 - app/controllers/solid_stack_web/jobs/selections_controller.rb
 - app/controllers/solid_stack_web/jobs_controller.rb
+- app/controllers/solid_stack_web/metrics_controller.rb
 - app/controllers/solid_stack_web/processes_controller.rb
 - app/controllers/solid_stack_web/queues/pauses_controller.rb
 - app/controllers/solid_stack_web/queues_controller.rb
 - app/controllers/solid_stack_web/recurring_tasks/runs_controller.rb
 - app/controllers/solid_stack_web/recurring_tasks_controller.rb
 - app/controllers/solid_stack_web/scheduled_jobs_controller.rb
+- 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/refresh_controller.js
 - app/javascript/solid_stack_web/selection_controller.js
+- app/javascript/solid_stack_web/sparkline_tooltip_controller.js
+- app/models/solid_stack_web/alert_webhook.rb
+- app/models/solid_stack_web/cable_stats.rb
+- app/models/solid_stack_web/cache_stats.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
+- app/models/solid_stack_web/throughput_sparkline.rb
 - app/views/layouts/solid_stack_web/application.html.erb
 - app/views/solid_stack_web/cable/index.html.erb
 - app/views/solid_stack_web/cache/index.html.erb
@@ -180,6 +190,7 @@ files:
 - app/views/solid_stack_web/queues/show.html.erb
 - app/views/solid_stack_web/recurring_tasks/index.html.erb
 - app/views/solid_stack_web/scheduled_jobs/update.turbo_stream.erb
+- app/views/solid_stack_web/stats/index.html.erb
 - config/importmap.rb
 - config/routes.rb
 - lib/solid_stack_web.rb
@@ -207,7 +218,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.10
+rubygems_version: 4.0.12
 specification_version: 4
 summary: A unified Rails engine dashboard for Solid Queue, Solid Cache, and Solid
   Cable.