solid_observer 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a9c3e774c9276371b59f696226979b922772191e0531a4d9ba2dbb09b8e3e452
-  data.tar.gz: 570ae5aacef981358f68998d3df14bfc532e2af48cbdd21c6cd18ecbfa7132e7
+  metadata.gz: 7c363ea187ff44b2a28184384cfbdee1d570c6e8fd981abceded3844819a2338
+  data.tar.gz: ff5bb32bb53ad65ea688365a5b8666aa34552580d3d78856f8e542fcf53b6d4c
 SHA512:
-  metadata.gz: 50684bd0b286fc9b93f77a57f5d0b60c3e0334b6d7804bf63307b8cdc05a78cab5bb586305b96617f5fe0e76f76cd89112c6cb6e059a45d190ca6dc7c49fa885
-  data.tar.gz: 9e456400209630d4e3b777355bf1d1a651e0bac1d90d6d40de4272c9cce8afb322bf5ff9afed10fe1a9e0911c7e84c15d02e6b2de3360e04f5d4d349bbf02f34
+  metadata.gz: cbac07f62a04d4ea7ae4c8c2c1200f04c07f400f94ca5775785380853cd63f56eccdc154b1debe55438fc60482d54be55199265c299eae43577e1943b60abd1e
+  data.tar.gz: '018f433df069c72a8a12ced3434e4b05f5a26eb6209bb33af0e5c29b3aca2df1961359692e250f247769cb0e9bab322b946dc208ca265688fb4ae0316de24dd9'

data/CHANGELOG.md

@@ -1,3 +1,33 @@
+## [0.6.0] - 2026-08-04
+
+Headline: **Cross-component Tracing, Health Scoring & Unified Dashboard** — trace correlation across Queue/Cache/Cable, unified home dashboard, health scoring service, and CLI health & trace commands.
+
+### Added
+- **Correlation ID propagation** — automatic correlation ID generation and propagation across ActiveJob (`Correlated.stamp`), SolidCache, and SolidCable events; configurable `correlation_id_generator`.
+- **Cross-component trace service & CLI** — `Queries::TraceQuery` for fetching cross-component events by `correlation_id`; `rails solid_observer:trace[CORRELATION_ID,LIMIT]` CLI command.
+- **Trace Web UI** — Web interface at `/solid_observer/traces/:correlation_id` displaying component-tagged event timelines across Queue, Cache, and Cable.
+- **Unified health scoring service** — `Services::HealthScore` auto-calculates overall host stability using worst-of component statuses (Queue, Cache, Cable) with zero configuration required.
+- **CLI health command** — `rails solid_observer:health` CLI command displaying aggregate and per-component health status.
+
+### Changed
+- **Combined / Unified Dashboard** — Engine root (`GET /solid_observer/`) now renders the unified Home dashboard (overall health banner, per-component status cards, and merged multi-component activity feed). Dedicated Queue overview moved to `/solid_observer/queue`.
+
+### Upgrade & Database Migration
+- **Required DB Migration** — Running `bin/rails solid_observer:install:migrations && bin/rails db:migrate` is required when upgrading to v0.6.0. Adds `correlation_id` columns to `solid_observer_cache_events` and `solid_observer_cable_events` tables.
+
+## [0.5.0] - 2026-06-24
+
+Headline: **Solid Cable observability** — optional Cable telemetry, dashboard, storage health, and guarded trim controls.
+
+### Added
+- **Cable telemetry foundation** (SO-089, SO-090) — `observe_cable` config gate with `solid_cable_available?`/`solid_cable_enabled?` predicates; `CableSubscriber` hooks into `ActiveSupport::Notifications` broadcast events; event/metric buffers reuse `EventBufferCore`; `CableEvent`/`CableMetric` models with two migrations; `cable_sampling_rate` default 0.1; broadcasting names stored as `Digest::SHA256.hexdigest` (PII boundary).
+- **Cable storage health** (SO-091) — Storages page aggregates Solid Cable message storage and SolidObserver Cable telemetry rows with optional fallback states.
+- **Cable dashboard** (SO-092) — `/solid_observer/cable_dashboard` with summary cards, broadcast/rejection trends, stability indicator (hybrid: event + backlog signals), recent events. Three configurable thresholds: `cable_rejection_threshold` (0.05), `cable_backlog_threshold` (0.10), `cable_error_threshold` (0.0). Sidebar navigation entry.
+- **Guarded Cable trim** (SO-093) — UI button for ≤1,000 trimmable messages; `solid_observer:cable:trim` Rake task for larger backlogs. No clear-all.
+
+### Changed
+- **Self-contained SQLite generator config** (SO-094) — install generator produces a `solid_observer_queue` block with explicit `adapter: sqlite3`, `pool`, `timeout`, `database`, and `migrations_paths: db/solid_observer_migrate` — no `<<: *default` YAML merge. Post-install warning printed for PostgreSQL/MySQL hosts. Cable telemetry label standardised to `Cable telemetry`.
+
 ## [0.4.0] - 2026-06-03
 
 Headline: **Solid Cache observability** — multi-component foundation, cache dashboard, operational controls, and shared storage health.

data/README.md

@@ -7,39 +7,43 @@
 </p>
 
 <p align="center">
-  <a href="https://github.com/bart-oz/solid_observer/releases"><img src="https://img.shields.io/badge/version-0.4.0-blue.svg" alt="Version"></a>
+  <a href="https://github.com/bart-oz/solid_observer/releases"><img src="https://img.shields.io/badge/version-0.6.0-blue.svg" alt="Version"></a>
   <a href="LICENSE.txt"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a>
   <a href="https://github.com/bart-oz/solid_observer/actions"><img src="https://img.shields.io/badge/tests-passing-brightgreen.svg" alt="Tests"></a>
-  <a href="https://github.com/bart-oz/solid_observer/actions"><img src="https://img.shields.io/badge/coverage-96.22%25-brightgreen.svg" alt="Coverage"></a>
-</p>
+  <a href="https://github.com/bart-oz/solid_observer/actions"><img src="https://img.shields.io/badge/coverage-97.96%25-brightgreen.svg" alt="Coverage"></a>
 
 ---
 <p align="center">
   <a href=".github/assets/dash_1.png"><img src=".github/assets/dash_1.png" alt="SolidObserver dashboard overview" width="700"></a>
 </p>
 
-SolidObserver is a production-grade observability solution for Rails 8's Solid Stack. v0.4.0 covers both **Solid Queue** and **Solid Cache** with a unified Web UI dashboard, CLI tools, metrics collection, and distributed tracing support.
+SolidObserver is a production-grade observability solution for Rails 8's Solid Stack. v0.6.0 covers **Solid Queue**, **Solid Cache**, and **Solid Cable** with a unified Web UI dashboard, health scoring (`Services::HealthScore`), CLI tools, metrics collection, and cross-component trace correlation by `correlation_id`.
 
-## Features (v0.4.0)
+## Features (v0.6.0)
 
-| | Solid Queue | Solid Cache |
-|---|---|---|
-| **Web UI Dashboard** | Queue stats, jobs browser, events log | Hit rate, ops/sec, error rate, avg duration |
-| **Storage footprint** | DB size, event counts | SolidCache table size, row counts |
-| **Activity trends** | Sparklines (Performed, Ready, Failed) | Activity trend sparklines |
-| **Stability indicator** | Stable / Degraded / Critical badge | Stability pill badge |
-| **Operational controls** | Retry / discard failed jobs | Prune expired entries, clear all entries |
-| **CLI tools** | status, jobs:list/show/retry/discard | cache:prune, cache:clear |
-| **Privacy** | Job arguments excluded from persisted events | Keys and values **never** shown |
-| **Operating modes** | Real-time (no DB) or persistence (full history) | Persistence mode only |
+| | Solid Queue | Solid Cache | Solid Cable |
+|---|---|---|---|
+| **Web UI Dashboard** | Queue stats, jobs browser, events log | Hit rate, ops/sec, error rate, avg duration | Broadcasts, rejection rate, trends |
+| **Unified Home** | Overall health banner, component cards, merged activity feed at `/solid_observer` |
+| **Health Scoring** | Worst-of aggregate stability (`Services::HealthScore`), config-free |
+| **Cross-Component Trace** | Timeline by `correlation_id` across Queue, Cache, Cable (`/solid_observer/traces/:id`) |
+| **Storage footprint** | DB size, event counts | SolidCache table size, row counts | Message count + backlogs |
+| **Activity trends** | Sparklines (Performed, Ready, Failed) | Activity trend sparklines | Broadcast/rejection sparklines |
+| **Stability indicator** | Stable / Degraded / Critical badge | Stability pill badge | Stable / Degraded / Critical (hybrid) |
+| **Operational controls** | Retry / discard failed jobs | Prune expired entries, clear all entries | Trim expired messages |
+| **CLI tools** | status, health, trace, jobs:list/show/retry/discard | cache:prune, cache:clear | cable:trim |
+| **Privacy** | Job arguments excluded from persisted events | Keys and values **never** shown | Broadcasting names hashed (SHA256) |
+| **Operating modes** | Real-time (no DB) or persistence (full history) | Persistence mode only | Persistence mode only |
 
-Additional: 🔗 APM distributed tracing · ⚡ buffered writes · 🛡️ Docker/CI/K8s safe boot
+Additional: 🔗 Cross-component trace lookup by correlation_id · 🩺 Config-free aggregate health score · 🏠 Unified Home dashboard · ⚡ buffered writes · 🛡️ Docker/CI/K8s safe boot
 
 ## Requirements
 
 - Ruby 3.2+
 - Rails 8.0+
 - Solid Queue (configured with `connects_to` in all environments)
+- Solid Cache (optional — enable with `config.observe_cache = true`)
+- Solid Cable (optional — enable with `config.observe_cable = true`)
 
 > **Note:** Ensure Solid Queue is configured with `connects_to` in all environments, not just production. See [Troubleshooting](#troubleshooting) if you encounter database connection issues.
 
@@ -75,7 +79,7 @@ That's it. You now have access to queue status, job listing, retry, and discard
 
 Store event history, metrics, and storage snapshots in a dedicated observer database. This gives you everything in real-time mode plus long-term event tracking, buffered writes, and retention-based cleanup. The install generator defaults to SQLite; the database can use any Rails-supported adapter for record persistence, and storage-size monitoring is implemented for SQLite, PostgreSQL/PostGIS, MySQL, and Trilogy. See [Database Setup](#database-setup-persistence-mode) below.
 
-> If your host app uses a different adapter than SQLite (e.g. PostgreSQL or MySQL), see [Multi-adapter setup](#multi-adapter-setup) before running these commands.
+> **⚠️ PostgreSQL / MySQL hosts:** The generator writes a self-contained `solid_observer_queue` block with `adapter: sqlite3`. **Review `config/database.yml` before running `db:create`** — do not merge `<<: *default` into the observer entry, as that pulls the host adapter in and `db:create` will fail. See [Multi-adapter setup](#multi-adapter-setup) for the correct pattern.
 
 ```bash
 bin/rails solid_observer:install:migrations
@@ -173,6 +177,14 @@ Configuration:
 
 SolidObserver ships with a zero-dependency Web UI (no asset pipeline, no JS framework) at `/solid_observer`.
 
+### Views & Routes
+
+- **Unified Home Dashboard** (`/solid_observer/`) — Overall worst-of health score banner, per-component status cards (Queue, Cache, Cable), and a unified cross-component activity feed.
+- **Queue Overview** (`/solid_observer/queue`) — Dedicated Queue metrics, job browser (ready/scheduled/claimed/failed), events log, time-range trends, and operational controls.
+- **Cache Dashboard** (`/solid_observer/cache_dashboard`) — SolidCache hit rates, ops/sec, error rates, storage footprint, and prune/clear controls.
+- **Cable Dashboard** (`/solid_observer/cable_dashboard`) — SolidCable broadcast volume, rejection rates, backlog trends, and message trim controls.
+- **Cross-Component Trace Timeline** (`/solid_observer/traces/:correlation_id`) — Component-tagged event sequence across Queue, Cache, and Cable for a specific correlation ID.
+
 ### Mount
 
 The install generator mounts it for you. To mount manually:
@@ -182,6 +194,18 @@ The install generator mounts it for you. To mount manually:
 mount SolidObserver::Engine, at: "/solid_observer"
 ```
 
+Production dashboard exposure is the host application's responsibility. If you
+enable and mount the dashboard in production, wrap the mount in your existing
+admin authentication/authorization constraint (example shown for apps that
+already provide an `authenticate` route helper):
+
+```ruby
+# config/routes.rb
+authenticate :user, ->(user) { user.admin? } do
+  mount SolidObserver::Engine, at: "/solid_observer"
+end
+```
+
 ### Auth Configuration
 
 ```ruby
@@ -207,6 +231,7 @@ For production hardening (fail-loud on missing env var vs. fail-open), see [Conf
 - **API-only apps** — the Web UI works without manual configuration. The engine ships its own Cookies/Session/Flash middleware stack scoped to `/solid_observer/*`.
 - **Host-app callbacks are not inherited.** Use `ui_username` / `ui_password` for built-in HTTP Basic Auth.
 - **Auth misconfiguration is fail-open, but loud.** If `ui_username` is set but `ui_password` resolves to `nil`, the UI ships unauthenticated and logs a boot `WARNING`.
+- **HTTP Basic Auth requires both credentials.** Setting only `ui_username` or only `ui_password` disables built-in auth; protect production mounts at the host-app route boundary.
 
 See the full component breakdown in [Components](#components) below.
 
@@ -270,16 +295,51 @@ bin/rails solid_observer:cache:clear  # Clear all SolidCache entries (with confi
 bin/rails solid_observer:cache:prune  # Prune expired SolidCache entries
 ```
 
+### Solid Cable Observability
+
+Cable observability is optional. Enable with `config.observe_cable = true`. Requires SolidCable in the host app. SolidObserver does not add any SolidCable dependency.
+
+Cable dashboard (`/solid_observer/cable_dashboard`) shows broadcast/rejection trends, a stability indicator (hybrid: event + backlog signals), and recent safe events. Storages page includes Cable telemetry rows. Guarded trim controls: UI button for ≤1,000 trimmable messages; `solid_observer:cable:trim` Rake task for larger backlogs. **Broadcasting names are stored as SHA256 digests** — raw names are never persisted.
+
+**Enabling Cable observability:**
+
+```ruby
+SolidObserver.configure do |config|
+  config.observe_cable = true  # default: false
+  # config.cable_sampling_rate = 0.1  # Sample 10% of broadcast events (default: 0.1)
+  # config.cable_rejection_threshold = 0.05  # Rejection rate threshold for Degraded (default: 0.05)
+  # config.cable_backlog_threshold = 0.10    # Backlog ratio threshold (default: 0.10)
+  # config.cable_error_threshold = 0.0       # Error rate threshold (default: 0.0)
+end
+```
+
+`solid_cable_enabled?` is `true` when both `observe_cable = true` and SolidCable is available in the host app.
+
+**CLI commands (Solid Cable):**
+
+```bash
+bin/rails solid_observer:cable:trim  # Trim expired Cable messages (with confirmation)
+```
+
+> Cable dashboard screenshots are not yet available — capture from a host app with SolidCable configured.
+
 ### Storage
 
-The Storage page aggregates per-component health rows: Queue Observer database, Cache Observer, and SolidCache table sizes. Each row reports size, record counts, and a status indicator.
+The Storage page aggregates per-component health rows: Queue Observer database, Cache Observer, SolidCache table sizes, and Cable telemetry. Each row reports size, record counts, and a status indicator.
 
 <p align="center">
-  <a href=".github/assets/dash_8.png"><img src=".github/assets/dash_8.png" alt="Component health — Queue Observer + Cache Observer + SolidCache" width="700"></a>
+  <a href=".github/assets/dash_8.png"><img src=".github/assets/dash_8.png" alt="Component health — Queue Observer + Cache Observer + SolidCache + Cable telemetry" width="700"></a>
 </p>
 
 For adapter notes and multi-adapter setup, see [Database Setup](#database-setup-persistence-mode) below.
 
+### Storage unavailable diagnostics
+
+The dashboard is admin/developer-facing. When SolidObserver storage is not
+reachable, the current default 503 error page includes the raw exception class
+and message so maintainers can diagnose adapter, credential, migration, or
+database availability problems. Do not expose the dashboard to untrusted users.
+
 ## Configuration
 
 <details>
@@ -300,6 +360,13 @@ SolidObserver.configure do |config|
   # Enable cache monitoring (default: false; requires SolidCache in host app)
   config.observe_cache = true
 
+  # Enable cable monitoring (default: false; requires SolidCable in host app)
+  config.observe_cable = true
+  config.cable_sampling_rate = 0.1          # Sample 10% of broadcast events
+  config.cable_rejection_threshold = 0.05   # Rejection rate → Degraded stability
+  config.cable_backlog_threshold = 0.10     # Backlog ratio threshold
+  config.cable_error_threshold = 0.0        # Error rate threshold
+
   # Data Retention (persistence mode only)
   config.event_retention = 30.days    # Keep events for 30 days
   config.metrics_retention = 90.days  # Keep metrics for 90 days
@@ -341,7 +408,10 @@ SolidObserver.configure do |config|
 end
 ```
 
-When configured, all job events will include your correlation ID, allowing you to trace jobs back to the originating request.
+When configured, all job, cache, and cable events will include your correlation ID. You can query the full cross-component event timeline for any request or job:
+
+- **CLI**: `bin/rails "solid_observer:trace[CORRELATION_ID,LIMIT]"`
+- **Web UI**: `/solid_observer/traces/:correlation_id`
 
 ### Production hardening (recommended)
 
@@ -370,6 +440,7 @@ end
 | Command | Description |
 |---------|-------------|
 | `solid_observer:status` | Show queue status overview |
+| `solid_observer:health` | Display aggregate and per-component health status |
 | `solid_observer:jobs:list[status,queue,class,limit]` | List jobs with optional filters |
 | `solid_observer:jobs:show[ID]` | Show job details |
 | `solid_observer:jobs:retry[ID]` | Retry a failed job |
@@ -386,6 +457,8 @@ end
 | `solid_observer:storage:purge` | Delete ALL SolidObserver data |
 | `solid_observer:cache:clear` | Clear all SolidCache entries (with confirmation) |
 | `solid_observer:cache:prune` | Prune expired SolidCache entries |
+| `solid_observer:cable:trim` | Trim expired Solid Cable messages |
+| `solid_observer:trace[CORRELATION_ID,LIMIT]` | Show cross-component trace timeline |
 
 > **Note:** Storage commands manage **SolidObserver's storage** (event logs, metrics, snapshots) — not Solid Queue's jobs. Cache commands operate on SolidCache entries in the host app's cache store.
 
@@ -423,16 +496,18 @@ The example below is what `rails generate solid_observer:install` produces:
 ```yaml
 # config/database.yml (generator default)
 solid_observer_queue:
-  <<: *default
   adapter: sqlite3
+  pool: 5
+  timeout: 5000
   database: storage/<%= Rails.env %>_solid_observer_queue.sqlite3
+  migrations_paths: db/solid_observer_migrate
 ```
 
 > **Note:** SQLite is the generator default, not a requirement. The `solid_observer_queue` database can use any Rails-supported adapter for record persistence. Adapter-native **storage-size monitoring** is currently implemented for SQLite, PostgreSQL/PostGIS, MySQL, and Trilogy. On other adapters, the size query returns `nil` and the engine logs a single `[SolidObserver] Unknown adapter for DatabaseSize: …` warning — record persistence still works.
 
 ### Multi-adapter setup
 
-If your host application uses PostgreSQL and you want SolidObserver to use SQLite, keep the `solid_observer_queue` block **self-contained** — do not rely on `<<: *default`. The generator default uses `<<: *default` with an explicit `adapter: sqlite3` override; that is safe on SQLite-primary hosts. On a PostgreSQL host, merging `<<: *default` without an explicit adapter override pulls the PG adapter in and fails at `db:create`. For multi-adapter connections, omit the merge entirely:
+If your host application uses PostgreSQL and you want SolidObserver to use SQLite, keep the `solid_observer_queue` block **self-contained** — do not rely on `<<: *default`. The generator produces a self-contained block with explicit `adapter: sqlite3` and `migrations_paths`, which is safe on any host adapter. On a PostgreSQL host, merging `<<: *default` without an explicit adapter override pulls the PG adapter in and fails at `db:create`. For multi-adapter connections, omit the merge entirely:
 
 ```yaml
 # config/database.yml
@@ -473,9 +548,9 @@ gem "sqlite3", "~> 2.0"
 | v0.1.0 | Solid Queue monitoring, CLI tools | ✅ Released |
 | v0.1.1 | Real-time mode (no migrations needed) | ✅ Released |
 | v0.3.0 | Web UI dashboard + stability hardening | ✅ Released |
-| v0.4.0 | Solid Cache monitoring | ✅ Current |
-| v0.5.0 | Solid Cable monitoring | 🔜 Planned |
-| v0.6.0 | Cross-component correlation, health scores | 🔜 Planned |
+| v0.4.0 | Solid Cache monitoring | ✅ Released |
+| v0.5.0 | Solid Cable monitoring | ✅ Released |
+| v0.6.0 | Cross-component trace correlation, health scores, unified dashboard | ✅ Current |
 | v0.7.0 | Alerting & notifications | 🔜 Planned |
 | v1.0.0 | Production stable release | 🎯 Goal |
 

data/app/assets/javascripts/solid_observer/live_poll.js

@@ -10,7 +10,7 @@
   var checkbox, rangeSelect, refreshBtn, helpBtn, helpPanel, helpWrapper, freshnessEl;
   var hoverActive = false;
   var sparks = {};
-  var url = "/solid_observer/poll_data";
+  var url;
   var inFlight = false;
   var timerId = null;
   var lastFullSnapshot = null;
@@ -21,6 +21,8 @@
     var wrapper = document.querySelector("[data-so-live]");
     if (!wrapper) return;
 
+    url = wrapper.getAttribute("data-so-poll-url") || "/solid_observer/poll_data";
+
     checkbox = wrapper.querySelector('[data-so-live-toggle]');
     if (!checkbox) return;
 

data/app/controllers/solid_observer/application_controller.rb

@@ -6,6 +6,7 @@ module SolidObserver
       [
         *([PG::ConnectionBad] if defined?(PG::ConnectionBad)),
         *([Mysql2::Error::ConnectionError] if defined?(Mysql2::Error::ConnectionError)),
+        *([Trilogy::Error] if defined?(Trilogy::Error)),
         *([SQLite3::CantOpenException] if defined?(SQLite3::CantOpenException))
       ]
     end

data/app/controllers/solid_observer/cable_dashboard_controller.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require_relative "dashboard_controller"
+
+module SolidObserver
+  # :reek:TooManyInstanceVariables
+  class CableDashboardController < DashboardController
+    CABLE_STORAGE_COMPONENTS = %w[cable_observer solid_cable].freeze
+
+    def index
+      @component = "cable"
+      assign_cable_dashboard
+    end
+
+    private
+
+    # :reek:TooManyStatements
+    def assign_cable_dashboard
+      unless SolidObserver.config.solid_cable_enabled?
+        @cable_dashboard_available = false
+        @storage_components = []
+        @recent_events = []
+        return
+      end
+
+      range = SolidObserver::Services::CableStats.parse_range(request_range_param)
+      window = SolidObserver::Services::CableStats.range_duration(range)
+      stats = SolidObserver::Services::CableStats.call(window: window)
+
+      @cable_dashboard_available = true
+      @range = range
+      @stats = stats
+      @storage_components = cable_storage_components
+      @recent_events = recent_events(window)
+    end
+
+    def cable_storage_components
+      SolidObserver::Services::StorageInfoSnapshot.call.select do |snapshot|
+        CABLE_STORAGE_COMPONENTS.include?(snapshot[:component])
+      end
+    rescue *SolidObserver::Services::StorageInfoSnapshot::CONNECTION_ERRORS, TypeError, NoMethodError
+      []
+    end
+
+    def recent_events(window)
+      current_time = Time.current
+      SolidObserver::CableEvent.where(recorded_at: (current_time - window)..current_time).recent(10)
+    rescue ActiveRecord::StatementInvalid
+      []
+    end
+  end
+end

data/app/controllers/solid_observer/cable_operations_controller.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module SolidObserver
+  class CableOperationsController < ApplicationController
+    def trim
+      redirect_with_result(SolidObserver::Services::CableOperations.trim)
+    end
+
+    private
+
+    def redirect_with_result(result)
+      flash_key = result[:ok] ? :notice : :alert
+      redirect_to cable_dashboard_path, flash_key => result[:message]
+    end
+  end
+end

data/app/controllers/solid_observer/cache_dashboard_controller.rb

@@ -6,54 +6,47 @@ module SolidObserver
   class CacheDashboardController < DashboardController
     CACHE_STORAGE_COMPONENTS = %w[solid_cache cache_observer].freeze
 
-    class << self
-      def cache_dashboard_assignments(range_param:)
-        return unavailable_assignments unless SolidObserver.config.solid_cache_enabled?
-
-        range = SolidObserver::Services::CacheStats.parse_range(range_param)
-        window = SolidObserver::Services::CacheStats.range_duration(range)
-        stats = SolidObserver::Services::CacheStats.call(window: window)
-
-        {
-          cache_dashboard_available: true,
-          range: range,
-          stats: stats,
-          activity_trends: stats[:activity_trends],
-          stability: stats[:stability],
-          storage_components: cache_storage_components,
-          recent_events: recent_events(window)
-        }
-      end
+    def index
+      @component = "cache"
+      assign_cache_dashboard
+    end
 
-      private
+    private
 
-      def unavailable_assignments
-        {
-          cache_dashboard_available: false,
-          storage_components: [],
-          recent_events: [],
-          activity_trends: SolidObserver::Services::CacheStats::ACTIVITY_TREND_EMPTY,
-          stability: SolidObserver::Services::CacheStats::STABILITY_EMPTY
-        }
+    def assign_cache_dashboard
+      unless SolidObserver.config.solid_cache_enabled?
+        @cache_dashboard_available = false
+        @storage_components = []
+        @recent_events = []
+        @activity_trends = SolidObserver::Services::CacheStats::ACTIVITY_TREND_EMPTY
+        @stability = SolidObserver::Services::CacheStats::STABILITY_EMPTY
+        return
       end
 
-      def cache_storage_components
-        SolidObserver::Services::StorageInfoSnapshot.call.select do |snapshot|
-          CACHE_STORAGE_COMPONENTS.include?(snapshot[:component])
-        end
-      end
+      range = SolidObserver::Services::CacheStats.parse_range(request_range_param)
+      window = SolidObserver::Services::CacheStats.range_duration(range)
+      stats = SolidObserver::Services::CacheStats.call(window: window)
+
+      @cache_dashboard_available = true
+      @range = range
+      @stats = stats
+      @activity_trends = stats[:activity_trends]
+      @stability = stats[:stability]
+      @storage_components = cache_storage_components
+      @recent_events = recent_events(window)
+    end
 
-      def recent_events(window)
-        current_time = Time.current
-        SolidObserver::CacheEvent.where(recorded_at: (current_time - window)..current_time).recent(10)
-      rescue ActiveRecord::StatementInvalid
-        []
+    def cache_storage_components
+      SolidObserver::Services::StorageInfoSnapshot.call.select do |snapshot|
+        CACHE_STORAGE_COMPONENTS.include?(snapshot[:component])
       end
     end
 
-    def index
-      @component = "cache"
-      assign_cache_dashboard
+    def recent_events(window)
+      current_time = Time.current
+      SolidObserver::CacheEvent.where(recorded_at: (current_time - window)..current_time).recent(10)
+    rescue ActiveRecord::StatementInvalid
+      []
     end
   end
 end

data/app/controllers/solid_observer/dashboard_controller.rb

@@ -11,15 +11,28 @@ module SolidObserver
 
     def index
       @component = selected_component
-      return assign_cache_dashboard if @component == "cache"
 
-      return unless @component == "queue" && SolidObserver.config.solid_queue_enabled?
-
-      assign_range_and_stats
-      load_persistence_data if persistence_mode?
+      if @component == "queue" && SolidObserver.config.solid_queue_enabled?
+        assign_range_and_stats
+        load_persistence_data if persistence_mode?
+      elsif @component == "home"
+        @health = begin
+          Services::HealthScore.call
+        rescue => error
+          Rails.logger&.warn("Home HealthScore: #{error.class}: #{error.message}")
+          {overall: :degraded, components: {}}
+        end
+        @feed = begin
+          Services::UnifiedFeed.call
+        rescue => error
+          Rails.logger&.warn("Home UnifiedFeed: #{error.class}: #{error.message}")
+          []
+        end
+      end
     end
 
     def live_poll
+      expires_in 1.day, public: true
       send_file(
         SolidObserver::Engine.root.join("app/assets/javascripts/solid_observer/live_poll.js"),
         type: "application/javascript; charset=utf-8",
@@ -54,12 +67,6 @@ module SolidObserver
       @recent_events = QueueEvent.recent(10)
     end
 
-    def assign_cache_dashboard
-      SolidObserver::CacheDashboardController.cache_dashboard_assignments(range_param: request_range_param).each do |name, value|
-        instance_variable_set("@#{name}", value)
-      end
-    end
-
     def request_range_param
       request&.query_parameters&.[]("range") || request&.query_parameters&.[](:range)
     end
@@ -104,17 +111,18 @@ module SolidObserver
         ""
       end
       requested = path_component if requested.empty?
+      return "queue" if requested == "queue" && SolidObserver.config.solid_queue_enabled?
       return "cache" if requested == "cache" && SolidObserver.config.solid_cache_enabled?
 
-      "queue"
+      "home"
     end
 
     def path_component
       return "" unless request&.respond_to?(:path)
 
       path = request&.path.to_s
-      return "cache" if path.end_with?("/cache")
       return "queue" if path.end_with?("/queue")
+      return "cache" if path.end_with?("/cache")
 
       ""
     end

data/app/controllers/solid_observer/traces_controller.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require_relative "../../helpers/solid_observer/application_helper"
+
+module SolidObserver
+  class TracesController < ApplicationController
+    helper SolidObserver::ApplicationHelper
+
+    include RequirePersistenceMode
+
+    def show
+      result = SolidObserver::Queries::TraceQuery.new.call(correlation_id: params[:id])
+      @rows = result.rows
+      @unavailable_components = result.unavailable_components
+    end
+  end
+end