solid_observer 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a9c3e774c9276371b59f696226979b922772191e0531a4d9ba2dbb09b8e3e452
-  data.tar.gz: 570ae5aacef981358f68998d3df14bfc532e2af48cbdd21c6cd18ecbfa7132e7
+  metadata.gz: 563c4874ef7e6a8ad8a485d0b3f86c9d1d8f924d5308d44c5137f76bda7e03de
+  data.tar.gz: 88ba3331b45977349604047db1a4e3e98efb17ebc1eca8d4c52a96825d320a83
 SHA512:
-  metadata.gz: 50684bd0b286fc9b93f77a57f5d0b60c3e0334b6d7804bf63307b8cdc05a78cab5bb586305b96617f5fe0e76f76cd89112c6cb6e059a45d190ca6dc7c49fa885
-  data.tar.gz: 9e456400209630d4e3b777355bf1d1a651e0bac1d90d6d40de4272c9cce8afb322bf5ff9afed10fe1a9e0911c7e84c15d02e6b2de3360e04f5d4d349bbf02f34
+  metadata.gz: e56550b5f3cfbbb6a54325901a19bb4a70850a994e047d282cea653b420822cd1a9148c603c2886c92fb5bc9683b650587db575ef90d85b39800430ee7ffbdde
+  data.tar.gz: dbf38ea6c5205ef027642cf02b84e3c59950299ea0477a2f7fef8df7543d71ece58dd90026f396650a99ad948ffa49cf16978f6a596c998d87ab085df739a114

data/CHANGELOG.md

@@ -1,3 +1,16 @@
+## [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,7 +7,7 @@
 </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.5.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>
@@ -18,20 +18,20 @@
   <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.5.0 covers **Solid Queue**, **Solid Cache**, and **Solid Cable** with a unified Web UI dashboard, CLI tools, metrics collection, and distributed tracing support.
 
-## Features (v0.4.0)
+## Features (v0.5.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 |
+| **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, 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
 
@@ -40,6 +40,8 @@ Additional: 🔗 APM distributed tracing · ⚡ buffered writes · 🛡️ Docke
 - 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 +77,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
@@ -182,6 +184,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 +221,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 +285,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 +350,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
@@ -386,6 +443,7 @@ 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 |
 
 > **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 +481,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,8 +533,8 @@ 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.4.0 | Solid Cache monitoring | ✅ Released |
+| v0.5.0 | Solid Cable monitoring | ✅ Current |
 | v0.6.0 | Cross-component correlation, health scores | 🔜 Planned |
 | 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,7 +11,6 @@ module SolidObserver
 
     def index
       @component = selected_component
-      return assign_cache_dashboard if @component == "cache"
 
       return unless @component == "queue" && SolidObserver.config.solid_queue_enabled?
 
@@ -20,6 +19,7 @@ module SolidObserver
     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 +54,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

data/app/helpers/solid_observer/application_helper.rb

@@ -156,6 +156,63 @@ module SolidObserver
       CACHE_RANGE_LABELS.fetch(range_key.to_s, "in selected range")
     end
 
+    def cable_range_label(range_key)
+      CACHE_RANGE_LABELS.fetch(range_key.to_s, "in selected range")
+    end
+
+    def cable_ratio_percent(value)
+      number_to_percentage(value.to_f * 100, precision: 1, strip_insignificant_zeros: true)
+    end
+
+    def cable_stability_badge(state)
+      stability_badge_for(state.to_sym)
+    end
+
+    def cable_stability_detail(stability)
+      state = (stability || {})[:state]&.to_sym
+      state = :stable unless STABILITY_STATES.key?(state)
+
+      case state
+      when :critical
+        critical_cable_stability_detail(stability)
+      when :degraded
+        degraded_cable_stability_detail(stability)
+      else
+        "No cable errors or subscription rejections in the selected range and backlog current snapshot is healthy"
+      end
+    end
+
+    def cable_event_digest(digest, visible_chars: 10)
+      digest = digest.to_s
+      return "—" if digest.empty?
+      return digest if digest.length <= visible_chars
+
+      "#{digest.first(visible_chars)}…"
+    end
+
+    # :reek:FeatureEnvy
+    def cable_backlog_summary(stats)
+      if stats[:backlog_available]
+        {
+          value: number_with_delimiter(stats[:backlog_count].to_i),
+          subtitle: "current Solid Cable snapshot"
+        }
+      else
+        {value: "—", subtitle: "current Solid Cable snapshot unavailable"}
+      end
+    end
+
+    def cable_storage_summary(storage_components)
+      snapshots = Array(storage_components)
+      reason = cable_storage_unavailable_reason(snapshots)
+      return {value: "—", subtitle: "— #{reason}"} if reason
+
+      {
+        value: number_to_human_size(cable_storage_total_bytes(snapshots), precision: 1, significant: false, strip_insignificant_zeros: false),
+        subtitle: "Cable telemetry + Solid Cable messages"
+      }
+    end
+
     def cache_stability_detail(stability)
       state = (stability || {})[:state]&.to_sym
       state = :stable unless STABILITY_STATES.key?(state)
@@ -189,6 +246,10 @@ module SolidObserver
       SolidObserver.config.solid_cache_enabled?
     end
 
+    def cable_component_enabled?
+      SolidObserver.config.solid_cable_enabled?
+    end
+
     def dashboard_section_active?(component)
       current_component = @component.presence || "queue"
       controller_name == "dashboard" && current_component == component.to_s
@@ -231,6 +292,59 @@ module SolidObserver
       snapshots.find { |snapshot| !snapshot[:available] }&.[](:unavailable_reason)
     end
 
+    # :reek:FeatureEnvy
+    # :reek:TooManyStatements
+    def critical_cable_stability_detail(stability)
+      parts = []
+      error_count = stability[:error_count].to_i
+      parts << pluralize(error_count, "cable error") if error_count.positive?
+
+      rejection_count = stability[:rejection_count].to_i
+      rejection_rate = stability[:rejection_rate].to_f
+      if rejection_rate > 0.0
+        parts << "#{cable_ratio_percent(rejection_rate)} rejection rate"
+      elsif rejection_count.positive?
+        parts << pluralize(rejection_count, "subscription rejection")
+      end
+
+      backlog_ratio = stability[:backlog_ratio].to_f
+      if backlog_ratio >= 0.5
+        parts << "backlog at #{number_to_percentage(backlog_ratio * 100, precision: 0)} in current snapshot"
+      end
+
+      return "Cable stability critical" if parts.empty?
+
+      "#{parts.join("; ")} in the selected range"
+    end
+
+    # :reek:FeatureEnvy
+    # :reek:TooManyStatements
+    def degraded_cable_stability_detail(stability)
+      return "Backlog current snapshot unavailable" unless stability[:backlog_available]
+
+      backlog_ratio = stability[:backlog_ratio].to_f
+      if backlog_ratio >= SolidObserver.config.cable_backlog_threshold.to_f
+        return "Backlog at #{number_to_percentage(backlog_ratio * 100, precision: 0)} in current snapshot"
+      end
+
+      rejection_count = stability[:rejection_count].to_i
+      if rejection_count.positive?
+        return "#{pluralize(rejection_count, "subscription rejection")} in the selected range"
+      end
+
+      "Cable stability degraded"
+    end
+
+    def cable_storage_total_bytes(snapshots)
+      snapshots.sum { |snapshot| snapshot[:db_size_bytes].to_i }
+    end
+
+    def cable_storage_unavailable_reason(snapshots)
+      return "Storage snapshot unavailable" unless snapshots.size == 2
+
+      snapshots.find { |snapshot| !snapshot[:available] }&.[](:unavailable_reason)
+    end
+
     def cache_event_outcome_meta(event)
       hit = event.hit
 

data/app/models/solid_observer/cable_event.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module SolidObserver
+  class CableEvent < BaseEvent
+    self.table_name = "solid_observer_cable_events"
+
+    validates :event_type, presence: true
+    validates :recorded_at, presence: true
+
+    scope :errored, -> { where.not(error_class: nil) }
+    scope :recent, ->(limit = 10) { order(recorded_at: :desc).limit(limit) }
+  end
+end

data/app/models/solid_observer/cable_metric.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module SolidObserver
+  class CableMetric < BaseRecord
+    self.table_name = "solid_observer_cable_metrics"
+
+    validates :period_start, presence: true
+    validates :broadcasts_count, :transmissions_count, :confirmations_count,
+      :rejections_count, :perform_actions_count, :errors_count,
+      numericality: {only_integer: true, greater_than_or_equal_to: 0}
+  end
+end

data/app/models/solid_observer/cache_metric.rb

@@ -1,9 +1,8 @@
 # frozen_string_literal: true
 
 module SolidObserver
-  class CacheMetric < BaseMetric
+  class CacheMetric < BaseRecord
     self.table_name = "solid_observer_cache_metrics"
-    clear_validators!
 
     validates :event_type, presence: true, length: {maximum: 64}
     validates :period_start, presence: true

data/app/models/solid_observer/storage_info.rb

@@ -6,7 +6,7 @@ module SolidObserver
 
     MB_TO_BYTES = 1_048_576
     GB_TO_BYTES = 1_073_741_824
-    COMPONENTS = %w[queue_observer cache_observer solid_cache].freeze
+    COMPONENTS = %w[queue_observer cache_observer solid_cache cable_observer solid_cable].freeze
 
     validates :db_size_bytes, presence: true, numericality: {only_integer: true, greater_than_or_equal_to: 0}
     validates :event_count, presence: true, numericality: {only_integer: true, greater_than_or_equal_to: 0}