job_board 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b9383d573ca40430673ec3e2ad7436edec021a856b72ebfcd45c3e557b8b4ac7
-  data.tar.gz: 6d0849f4f83e665364ea8769483adbbc53f9189ff8ddd50de6fb957d1adc76ae
+  metadata.gz: c0a2428d3806231d3051a64d1ed7f693e51341cbbc12a4a2fe8240f1f1c56d73
+  data.tar.gz: 59cb3f9a17d3ae3cc0b9ac69adb11ec5c1c27838391d559c2c6f9a23e2a65306
 SHA512:
-  metadata.gz: 544bcb5aa2cbddefa3d4ee47f708398e7fcda871addfbf95ac7184d5c5e48b332da2a34aec62ebb60158461c62c637d664df3ee0177336afa51b8d8cd93a1f39
-  data.tar.gz: 28f552a8ed1840b90b7984806dc2794674819ea442d9e1b6da439bc0fd4cbf465c6900544e39a3f9fe5b5ebc65dbf6771b4207f06f0f2807f25763f0ba2de0c4
+  metadata.gz: fc936decbae3e1e9457ac3a6d6643f67907e4b0314ee3368e22516040779381f549af59c7b60fffa28f026b1edb88feddfa62cdd32772b9e4571eb413ad1e46f
+  data.tar.gz: c7f69762ffd1695bb6fc3dd64d59a8248f3d445255cc8f2276d9c7ddfb3a0b2008898c8557988fe4c76455389fbe213e752b36bdf1d4ccbdf56393e5c74ef4b0

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.2.0
+
+- Queues page: new **Last enqueued** column showing when each queue last received a job.
+- Queues with nothing enqueued in the last 30 days collapse into a one-click
+  "Inactive queues" section. Configurable via `config.queue_activity_window`
+  (`nil` shows everything in one table); paused queues always stay in the main table.
+- The auto-refresh poller now preserves the open/closed state of collapsible sections
+  across refreshes.
+
 ## 0.1.0
 
 Initial release.

data/README.md

@@ -69,6 +69,9 @@ JobBoard.configure do |config|
   config.stale_process_threshold = nil  # heartbeat age before a process is flagged stale;
                                         # nil uses SolidQueue.process_alive_threshold (5 min)
   config.http_basic_auth = nil          # see Authentication above
+  config.queue_activity_window = 30.days # collapse queues with nothing enqueued in
+                                         # that window into "Inactive queues";
+                                         # nil shows everything in one table
 
   # Latency (seconds) above which a queue is highlighted as breaching:
   config.latency_warning_threshold = 60                      # global default
@@ -94,6 +97,30 @@ Explicit `latency_warning_thresholds` entries still win over the naming conventi
 The queues page also sorts by SLA: queues with a detectable latency target come first
 (strictest at the top), and everything else follows alphabetically.
 
+### Hiding inactive queues
+
+Because Solid Queue derives the queue list from the jobs table, a queue keeps showing
+up as long as *any* job row with its name exists — including queues you retired long
+ago. Each queue's **Last enqueued** column shows when it last received a job, and
+queues with nothing enqueued in the last **30 days** (configurable) collapse into a
+one-click **Inactive queues** section at the bottom of the page — out of the way but
+never invisible, since a quiet queue can be a symptom rather than noise. Paused
+queues always stay in the main table regardless of idleness, because a pause is
+deliberate state someone needs to see.
+
+```ruby
+JobBoard.configure do |config|
+  config.queue_activity_window = 7.days # tighter window
+  # or nil to always show every queue in one table
+end
+```
+
+Also worth knowing: if the lingering rows are preserved finished jobs, Solid Queue's
+dispatcher normally clears them after `SolidQueue.clear_finished_jobs_after` (default
+1 day) — stale names often mean that cleanup isn't running, or that old failed jobs
+are still waiting to be retried or discarded. Dealing with those makes retired queues
+disappear entirely.
+
 ## Notes
 
 - **Separate queue database**: works automatically. Job Board reads and writes exclusively

data/app/controllers/job_board/queues_controller.rb

@@ -1,7 +1,7 @@
 module JobBoard
   class QueuesController < ApplicationController
     def index
-      @queues = LatencySla.sort(SolidQueue::Queue.all)
+      @queue_list = QueueList.build
       @failed_counts = SolidQueue::FailedExecution.joins(:job)
         .group("solid_queue_jobs.queue_name").count
     end

data/app/models/job_board/queue_list.rb

@@ -0,0 +1,35 @@
+module JobBoard
+  # Partitions queues into active and inactive based on when each queue last
+  # had a job enqueued. A queue is inactive when its newest job is older than
+  # the activity window; paused queues always count as active, since a pause
+  # is deliberate state someone needs to see. Without a window, every queue
+  # is active.
+  class QueueList
+    attr_reader :active, :inactive, :last_enqueued_at, :window
+
+    def self.build(window: JobBoard.config.queue_activity_window)
+      new(LatencySla.sort(SolidQueue::Queue.all),
+        last_enqueued_at: SolidQueue::Job.group(:queue_name).maximum(:created_at),
+        window: window)
+    end
+
+    def initialize(queues, last_enqueued_at:, window: nil)
+      @last_enqueued_at = last_enqueued_at
+      @window = window
+      @active, @inactive = partition(queues)
+    end
+
+    private
+
+    def partition(queues)
+      return [queues, []] unless window
+
+      cutoff = Time.current - window
+      paused = SolidQueue::Pause.where(queue_name: queues.map(&:name)).pluck(:queue_name).to_set
+      queues.partition do |queue|
+        newest = last_enqueued_at[queue.name]
+        paused.include?(queue.name) || (newest && newest >= cutoff)
+      end
+    end
+  end
+end

data/app/views/job_board/queues/_table.html.erb

@@ -0,0 +1,44 @@
+<table class="data-table">
+  <thead>
+    <tr>
+      <th>Queue</th>
+      <th class="num">Ready jobs</th>
+      <th class="num">Failed</th>
+      <th class="num">Latency</th>
+      <th>Last enqueued</th>
+      <th>Status</th>
+      <th class="actions"></th>
+    </tr>
+  </thead>
+  <tbody>
+    <% queues.each do |queue| %>
+      <tr>
+        <td><%= link_to queue.name, jobs_path(status: "ready", queue_name: queue.name) %></td>
+        <td class="num"><%= queue.size %></td>
+        <td class="num">
+          <% failed = @failed_counts[queue.name] || 0 %>
+          <% if failed.positive? %>
+            <%= link_to failed, jobs_path(status: "failed", queue_name: queue.name), class: "failed-count" %>
+          <% else %>
+            <span class="muted">0</span>
+          <% end %>
+        </td>
+        <td class="num">
+          <span class="latency <%= "latency--high" if queue.latency > latency_threshold_for(queue.name) %>" title="<%= queue.latency %> seconds">
+            <%= duration(queue.latency) %>
+          </span>
+        </td>
+        <td><%= time_ago(@queue_list.last_enqueued_at[queue.name]) %></td>
+        <td><%= queue.paused? ? status_badge(:paused) : status_badge(:active) %></td>
+        <td class="actions">
+          <% if queue.paused? %>
+            <%= button_to "Resume", queue_pause_path(queue.name), method: :delete, class: "btn" %>
+          <% else %>
+            <%= button_to "Pause", queue_pause_path(queue.name), method: :post, class: "btn",
+                  form: { data: { confirm: "Pause queue \"#{queue.name}\"? Workers will stop picking up its jobs." } } %>
+          <% end %>
+        </td>
+      </tr>
+    <% end %>
+  </tbody>
+</table>

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

@@ -1,50 +1,23 @@
 <h1>Queues</h1>
 
 <div data-poll-region="queues">
-  <% if @queues.empty? %>
+  <% if @queue_list.active.empty? && @queue_list.inactive.empty? %>
     <p class="empty-state">No queues yet — queues appear once jobs are enqueued.</p>
   <% else %>
-    <table class="data-table">
-      <thead>
-        <tr>
-          <th>Queue</th>
-          <th class="num">Ready jobs</th>
-          <th class="num">Failed</th>
-          <th class="num">Latency</th>
-          <th>Status</th>
-          <th class="actions"></th>
-        </tr>
-      </thead>
-      <tbody>
-        <% @queues.each do |queue| %>
-          <tr>
-            <td><%= link_to queue.name, jobs_path(status: "ready", queue_name: queue.name) %></td>
-            <td class="num"><%= queue.size %></td>
-            <td class="num">
-              <% failed = @failed_counts[queue.name] || 0 %>
-              <% if failed.positive? %>
-                <%= link_to failed, jobs_path(status: "failed", queue_name: queue.name), class: "failed-count" %>
-              <% else %>
-                <span class="muted">0</span>
-              <% end %>
-            </td>
-            <td class="num">
-              <span class="latency <%= "latency--high" if queue.latency > latency_threshold_for(queue.name) %>" title="<%= queue.latency %> seconds">
-                <%= duration(queue.latency) %>
-              </span>
-            </td>
-            <td><%= queue.paused? ? status_badge(:paused) : status_badge(:active) %></td>
-            <td class="actions">
-              <% if queue.paused? %>
-                <%= button_to "Resume", queue_pause_path(queue.name), method: :delete, class: "btn" %>
-              <% else %>
-                <%= button_to "Pause", queue_pause_path(queue.name), method: :post, class: "btn",
-                      form: { data: { confirm: "Pause queue \"#{queue.name}\"? Workers will stop picking up its jobs." } } %>
-              <% end %>
-            </td>
-          </tr>
-        <% end %>
-      </tbody>
-    </table>
+    <% if @queue_list.active.any? %>
+      <%= render "table", queues: @queue_list.active %>
+    <% else %>
+      <p class="empty-state">No queues have had jobs enqueued in the last <%= duration(@queue_list.window.to_i) %>.</p>
+    <% end %>
+
+    <% if @queue_list.inactive.any? %>
+      <details class="inactive-queues" data-persist="inactive-queues">
+        <summary>
+          Inactive queues (<%= @queue_list.inactive.size %>)
+          <span class="muted">— nothing enqueued in the last <%= duration(@queue_list.window.to_i) %></span>
+        </summary>
+        <%= render "table", queues: @queue_list.inactive %>
+      </details>
+    <% end %>
   <% end %>
 </div>

data/lib/job_board/assets/application.css

@@ -52,9 +52,7 @@ body {
 }
 
 main {
-  max-width: 1100px;
-  margin: 0 auto;
-  padding: 1.5rem 1rem 4rem;
+  padding: 1.5rem 1.5rem 4rem;
 }
 
 h1 { font-size: 1.4rem; margin: 0.5rem 0 1rem; }
@@ -176,6 +174,18 @@ code {
   color: var(--text-muted);
 }
 
+/* Queues page: collapsed section for idle queues */
+.inactive-queues { margin-top: 1.25rem; }
+.inactive-queues > summary {
+  cursor: pointer;
+  color: var(--text-muted);
+  font-size: 0.85rem;
+  padding: 0.35rem 0.25rem;
+  user-select: none;
+}
+.inactive-queues > summary:hover { color: var(--text); }
+.inactive-queues[open] > summary { margin-bottom: 0.5rem; }
+
 .latency { font-weight: 600; }
 .latency--high { color: var(--danger); }
 .failed-count { color: var(--danger); font-weight: 600; }

data/lib/job_board/assets/application.js

@@ -31,7 +31,20 @@
         document.querySelectorAll("[data-poll-region]").forEach(function (region) {
           var key = region.getAttribute("data-poll-region");
           var replacement = fresh.querySelector('[data-poll-region="' + key + '"]');
-          if (replacement) region.innerHTML = replacement.innerHTML;
+          if (!replacement) return;
+
+          // Remember which <details data-persist> are open so the swap
+          // doesn't collapse them.
+          var open = {};
+          region.querySelectorAll("details[data-persist]").forEach(function (details) {
+            open[details.dataset.persist] = details.open;
+          });
+
+          region.innerHTML = replacement.innerHTML;
+
+          region.querySelectorAll("details[data-persist]").forEach(function (details) {
+            if (details.dataset.persist in open) details.open = open[details.dataset.persist];
+          });
         });
       })
       .catch(function () { /* transient network errors are fine; try again next tick */ });

data/lib/job_board/configuration.rb

@@ -13,6 +13,12 @@ module JobBoard
     # nil falls back to SolidQueue.process_alive_threshold.
     attr_accessor :stale_process_threshold
 
+    # Queues with no job enqueued inside this window (seconds or an
+    # ActiveSupport::Duration) are collapsed into an "Inactive queues"
+    # section on the queues page. Paused queues always stay visible.
+    # nil shows every queue in one table.
+    attr_accessor :queue_activity_window
+
     # Seconds of latency after which a queue is highlighted as breaching.
     # Per-queue override: latency_warning_thresholds["queue_name"] = seconds.
     # Queues named in the within_* convention (e.g. "within_5_minutes") get
@@ -25,6 +31,7 @@ module JobBoard
       @poll_interval = 5
       @per_page = 25
       @stale_process_threshold = nil
+      @queue_activity_window = 30.days
       @latency_warning_threshold = 60
       @latency_warning_thresholds = {}
     end

data/lib/job_board/version.rb

@@ -1,3 +1,3 @@
 module JobBoard
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: job_board
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Mike
@@ -62,12 +62,14 @@ files:
 - app/models/job_board/latency_sla.rb
 - app/models/job_board/page.rb
 - app/models/job_board/process_tree.rb
+- app/models/job_board/queue_list.rb
 - app/views/job_board/jobs/_filters.html.erb
 - app/views/job_board/jobs/_job_row.html.erb
 - app/views/job_board/jobs/index.html.erb
 - app/views/job_board/jobs/show.html.erb
 - app/views/job_board/processes/_process.html.erb
 - app/views/job_board/processes/index.html.erb
+- app/views/job_board/queues/_table.html.erb
 - app/views/job_board/queues/index.html.erb
 - app/views/job_board/recurring_tasks/index.html.erb
 - app/views/job_board/shared/_nav.html.erb