solid_observer 0.4.0 → 0.5.0

data/app/views/layouts/solid_observer/application.html.erb

@@ -14,8 +14,8 @@
 
       /* text */
       --so-text: #171717;
-      --so-text-muted: #737373;
-      --so-text-subtle: #737373;
+      --so-text-muted: #707070;
+      --so-text-subtle: #707070;
 
       /* lines */
       --so-border: #e5e5e5;
@@ -398,7 +398,8 @@
     .so-cache-controls { max-width: 820px; }
     .so-cache-dashboard__intro,
     .so-cache-controls__intro,
-    .so-queue-overview__intro {
+    .so-queue-overview__intro,
+    .so-cable-dashboard__intro {
       display: flex;
       flex-wrap: wrap;
       align-items: center;
@@ -407,16 +408,19 @@
     }
     .so-cache-dashboard__hint,
     .so-cache-controls__hint,
-    .so-queue-overview__hint {
+    .so-queue-overview__hint,
+    .so-cable-dashboard__hint {
       font-size: 0.875rem;
       color: var(--so-text-subtle);
       line-height: 1.5;
     }
-    .so-cache-dashboard__range-form {
+    .so-cache-dashboard__range-form,
+    .so-cable-dashboard__range-form {
       align-items: center;
       margin-bottom: 2rem;
     }
     .so-cache-dashboard__range-form select,
+    .so-cable-dashboard__range-form select,
     .so-dashboard-toolbar select {
       padding: 0.4rem 0.6rem;
       border: 1px solid var(--so-border);
@@ -425,11 +429,13 @@
       background: var(--so-card-bg);
       color: var(--so-text);
     }
-    .so-cache-dashboard__chart-empty {
+    .so-cache-dashboard__chart-empty,
+    .so-cable-dashboard__chart-empty {
       max-width: 420px;
       margin-bottom: 0;
     }
-    .so-cache-dashboard__digest {
+    .so-cache-dashboard__digest,
+    .so-cable-dashboard__digest {
       font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace;
       white-space: nowrap;
     }
@@ -564,7 +570,12 @@
           <% end %>
         <% end %>
 
-        <% if persistence_mode? && (SolidObserver.config.solid_queue_enabled? || SolidObserver.config.solid_cache_enabled?) %>
+        <% if SolidObserver.config.solid_cable_enabled? %>
+          <div class="so-sidebar__section">Cable</div>
+          <%= link_to "Overview", cable_dashboard_path, class: ("active" if controller_name == "cable_dashboard"), "aria-current": (controller_name == "cable_dashboard" ? "page" : nil) %>
+        <% end %>
+
+        <% if persistence_mode? && (SolidObserver.config.solid_queue_enabled? || SolidObserver.config.solid_cache_enabled? || SolidObserver.config.solid_cable_enabled?) %>
           <%= link_to "Storage", storage_path, class: ("active" if controller_name == "storages"), "aria-current": (controller_name == "storages" ? "page" : nil) %>
         <% end %>
       </nav>

data/app/views/solid_observer/cable_dashboard/_charts.html.erb

@@ -0,0 +1,31 @@
+<section class="so-dashboard-section" aria-labelledby="so-cable-charts-heading">
+  <header class="so-dashboard-section__header">
+    <h2 id="so-cable-charts-heading" class="so-dashboard-section__title">Activity trends</h2>
+  </header>
+
+  <div class="so-chart-strip">
+    <% if @stats[:activity_trends]&.[](:available) %>
+      <figure class="so-spark" data-so-spark="cable-broadcasts">
+        <figcaption class="so-spark__label">Broadcasts total <span data-so-range-copy><%= cable_range_label(@range) %></span></figcaption>
+        <svg class="so-spark__svg" viewBox="0 0 120 32" preserveAspectRatio="none" aria-hidden="true">
+          <line class="so-spark__baseline" x1="1" x2="119" y1="31" y2="31"/>
+          <polyline class="so-spark__line" points="<%= spark_points(@stats[:activity_trends][:broadcasts]) %>"/>
+        </svg>
+        <span class="so-spark__value"><%= number_with_delimiter(@stats[:broadcasts_count].to_i) %></span>
+      </figure>
+
+      <figure class="so-spark" data-so-spark="cable-rejections">
+        <figcaption class="so-spark__label">Rejections total <span data-so-range-copy><%= cable_range_label(@range) %></span></figcaption>
+        <svg class="so-spark__svg" viewBox="0 0 120 32" preserveAspectRatio="none" aria-hidden="true">
+          <line class="so-spark__baseline" x1="1" x2="119" y1="31" y2="31"/>
+          <polyline class="so-spark__line" points="<%= spark_points(@stats[:activity_trends][:rejections]) %>"/>
+        </svg>
+        <span class="so-spark__value"><%= number_with_delimiter(@stats[:rejections_count].to_i) %></span>
+      </figure>
+    <% else %>
+      <div class="so-card so-cable-dashboard__chart-empty">
+        <p class="so-dashboard-section__meta so-dashboard-section__meta--empty-range">No chart data in the selected range yet. Summary metrics still use bounded cable stats.</p>
+      </div>
+    <% end %>
+  </div>
+</section>

data/app/views/solid_observer/cable_dashboard/_recent_events.html.erb

@@ -0,0 +1,34 @@
+<section class="so-card so-card--section" aria-labelledby="so-cable-events-heading">
+  <header class="so-dashboard-section__header">
+    <h2 id="so-cable-events-heading" class="so-dashboard-section__title">Recent Cable events</h2>
+    <span class="so-dashboard-section__meta">debug context only · broadcasting names and payloads are never shown</span>
+  </header>
+
+  <% if recent_events.present? %>
+    <table class="so-table so-table--card">
+      <caption class="sr-only">Recent Cable events without raw broadcasting names or payloads</caption>
+      <thead>
+        <tr>
+          <th>Event</th>
+          <th>Channel class</th>
+          <th>Broadcasting digest</th>
+          <th>Duration</th>
+          <th>Recorded</th>
+        </tr>
+      </thead>
+      <tbody>
+        <% recent_events.each do |event| %>
+          <tr>
+            <td><%= event.event_type.to_s %></td>
+            <td><%= event.channel_class.presence || "—" %></td>
+            <td><span class="so-cable-dashboard__digest"><%= cable_event_digest(event.broadcasting_digest) %></span></td>
+            <td><%= event.duration ? format_duration(event.duration) : "—" %></td>
+            <td><span title="<%= event.recorded_at.utc.strftime("%Y-%m-%d %H:%M:%S UTC") %>"><%= time_ago_in_words(event.recorded_at) %> ago</span></td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  <% else %>
+    <p class="so-dashboard-section__meta so-dashboard-section__meta--empty-events">No sampled cable events in the selected range yet. Broadcasts, rejections, and errors will appear here after Cable activity is recorded.</p>
+  <% end %>
+</section>

data/app/views/solid_observer/cable_dashboard/_summary.html.erb

@@ -0,0 +1,34 @@
+<% backlog_summary = cable_backlog_summary(stats) %>
+<% storage_summary = cable_storage_summary(storage_components) %>
+
+<section class="so-dashboard-section" aria-labelledby="so-cable-summary-heading">
+  <header class="so-dashboard-section__header">
+    <h2 id="so-cable-summary-heading" class="so-dashboard-section__title">Summary in selected range</h2>
+  </header>
+
+  <div class="so-stat-cards so-cable-dashboard__summary">
+    <article class="so-card so-metric">
+      <div class="so-card__label">Broadcasts</div>
+      <div class="so-metric__value"><%= number_with_delimiter(stats[:broadcasts_count].to_i) %></div>
+      <div class="so-card__subtitle">selected window</div>
+    </article>
+
+    <article class="so-card so-metric">
+      <div class="so-card__label">Rejection rate</div>
+      <div class="so-metric__value"><%= cable_ratio_percent(stats[:rejection_rate]) %></div>
+      <div class="so-card__subtitle">rejections / broadcasts</div>
+    </article>
+
+    <article class="so-card so-metric">
+      <div class="so-card__label">Message backlog</div>
+      <div class="so-metric__value"><%= backlog_summary[:value] %></div>
+      <div class="so-card__subtitle"><%= backlog_summary[:subtitle] %></div>
+    </article>
+
+    <article class="so-card so-metric">
+      <div class="so-card__label">Storage footprint</div>
+      <div class="so-metric__value"><%= storage_summary[:value] %></div>
+      <div class="so-card__subtitle"><%= storage_summary[:subtitle] %></div>
+    </article>
+  </div>
+</section>

data/app/views/solid_observer/cable_dashboard/index.html.erb

@@ -0,0 +1,118 @@
+<% content_for :title, "Cable overview" %>
+<% status_class = @cable_dashboard_available ? "so-badge--success" : "so-badge--warning" %>
+
+<div class="so-dashboard so-cable-dashboard">
+  <span class="sr-only">Cable Dashboard</span>
+
+  <div class="so-content__header">
+    <h1>Cable overview</h1>
+
+    <% if @cable_dashboard_available %>
+      <div class="so-cable-dashboard__intro">
+        <span class="so-badge so-badge--pill <%= status_class %>">
+          <svg class="so-badge__dot" viewBox="0 0 6 6" aria-hidden="true">
+            <circle r="3" cx="3" cy="3" />
+          </svg>
+          Available
+        </span>
+        <p class="so-cable-dashboard__hint">Selected range: <%= cable_range_label(@range) %> · broadcasting names and payloads are never shown.</p>
+      </div>
+    <% end %>
+  </div>
+
+  <% if @cable_dashboard_available %>
+    <form action="<%= request.path %>" method="get" class="so-dashboard-toolbar so-cable-dashboard__range-form">
+      <label for="so-cable-range" class="so-card__label so-filters__label">Range</label>
+      <select id="so-cable-range" name="range" onchange="this.form.submit()">
+        <% SolidObserver::Services::CableStats::RANGES.each_key do |key| %>
+          <option value="<%= key %>" <%= "selected" if key == @range %>><%= cable_range_label(key) %></option>
+        <% end %>
+      </select>
+      <button type="submit" class="so-btn so-btn--refresh">Refresh data</button>
+    </form>
+
+    <%= render "solid_observer/cable_dashboard/summary", stats: @stats, storage_components: @storage_components %>
+
+    <section class="so-card so-card--section" aria-labelledby="so-cable-controls-heading">
+      <header class="so-dashboard-section__header">
+        <h2 id="so-cable-controls-heading" class="so-dashboard-section__title">Operational controls</h2>
+      </header>
+
+      <% cable_controls_available = SolidObserver::Services::CableOperations.available? && @stats&.[](:backlog_available) %>
+      <% cable_backlog_count = @stats&.[](:backlog_count).to_i %>
+
+      <% if cable_controls_available %>
+        <% if cable_backlog_count > 1000 %>
+          <div class="so-cache-control-row">
+            <div class="so-cache-control-row__copy">
+              <h3 class="so-cache-control-row__title">Use the Rake task</h3>
+              <p class="so-cache-control-row__body">More than 1,000 expired/trimmable Solid Cable messages are pending. The UI will not run this trim. Run solid_observer:cable:trim from the server instead.</p>
+              <span class="so-badge so-badge--pill so-badge--warning">
+                <svg class="so-badge__dot" viewBox="0 0 6 6" aria-hidden="true">
+                  <circle r="3" cx="3" cy="3" />
+                </svg>
+                UI trim unavailable
+              </span>
+            </div>
+          </div>
+        <% else %>
+          <div class="so-cache-control-row">
+            <div class="so-cache-control-row__copy">
+              <h3 class="so-cache-control-row__title">Trim expired messages</h3>
+              <p class="so-cache-control-row__body">Removes expired/trimmable Solid Cable messages only. Active messages remain available to Cable.</p>
+              <span class="so-badge so-badge--pill so-badge--success">
+                <svg class="so-badge__dot" viewBox="0 0 6 6" aria-hidden="true">
+                  <circle r="3" cx="3" cy="3" />
+                </svg>
+                Trimmable backlog: <%= cable_backlog_count %>
+              </span>
+            </div>
+
+            <div class="so-cache-control-row__action">
+              <%= button_to "Trim expired messages",
+                    trim_cable_operations_path,
+                    method: :post,
+                    class: "so-btn",
+                    form: {class: "so-form--inline"} %>
+            </div>
+          </div>
+        <% end %>
+      <% else %>
+        <p class="so-dashboard-section__meta so-dashboard-section__meta--idle">Cable controls are unavailable because Solid Cable support is disabled or not detected. No trim was attempted.</p>
+        <span class="so-badge so-badge--pill so-badge--warning">
+          <svg class="so-badge__dot" viewBox="0 0 6 6" aria-hidden="true">
+            <circle r="3" cx="3" cy="3" />
+          </svg>
+          Unavailable
+        </span>
+      <% end %>
+    </section>
+
+    <%= render "solid_observer/cable_dashboard/charts" %>
+
+    <% if @stats&.[](:stability)&.[](:available) %>
+      <section class="so-stability" data-so-zone="cable-stability" aria-labelledby="so-cable-stability-heading">
+        <span class="so-stability__label" id="so-cable-stability-heading">Stability</span>
+        <%= cable_stability_badge(@stats[:stability][:state]) %>
+        <span class="so-stability__detail"><%= cable_stability_detail(@stats[:stability]) %></span>
+        <a href="#so-cable-events-heading" class="so-stability__link">View recent events →</a>
+      </section>
+    <% end %>
+
+    <%= render "solid_observer/cable_dashboard/recent_events", recent_events: @recent_events %>
+  <% else %>
+    <section class="so-card so-card--section" aria-labelledby="so-cable-unavailable-heading">
+      <header class="so-dashboard-section__header">
+        <h2 id="so-cable-unavailable-heading" class="so-dashboard-section__title">Cable dashboard unavailable</h2>
+        <span class="so-badge so-badge--pill <%= status_class %>">
+          <svg class="so-badge__dot" viewBox="0 0 6 6" aria-hidden="true">
+            <circle r="3" cx="3" cy="3" />
+          </svg>
+          Unavailable
+        </span>
+      </header>
+
+      <p class="so-dashboard-section__meta so-dashboard-section__meta--idle">Cable dashboard is unavailable because Solid Cable support is disabled or not detected. Metrics are unavailable.</p>
+    </section>
+  <% end %>
+</div>

data/app/views/solid_observer/dashboard/_queue_table.html.erb

@@ -8,6 +8,7 @@
     <% all_queue_names = (queues.keys | performed_by_queue.keys | failed_by_queue.keys).sort %>
     <% if all_queue_names.any? %>
       <table class="so-table so-table--card">
+        <caption class="sr-only">Queue throughput list</caption>
         <thead>
           <tr>
             <th>Queue</th>

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

@@ -1,8 +1,5 @@
 <% content_for :title, "Dashboard" %>
 
-<% if @component == "cache" %>
-  <%= render template: "solid_observer/cache_dashboard/index" %>
-<% else %>
 <div class="so-dashboard">
   <% queue_enabled = SolidObserver.config.solid_queue_enabled? %>
   <% queue_status_class = queue_enabled ? "so-badge--success" : "so-badge--warning" %>
@@ -29,7 +26,7 @@
     </section>
   <% else %>
   <%# Zone A: Toolbar — range selector, Refresh, Live toggle, help disclosure %>
-  <div class="so-dashboard-toolbar" data-so-live>
+  <div class="so-dashboard-toolbar" data-so-live data-so-poll-url="<%= poll_data_path %>">
     <form action="<%= request.path %>" method="get" class="so-dashboard-toolbar__left">
       <label for="so-range" class="so-card__label so-filters__label">Range</label>
       <select id="so-range" name="range" data-so-range-select onchange="this.form.submit()">
@@ -111,6 +108,7 @@
       <div class="so-card">
         <div class="so-card__label">Recent Events</div>
         <table class="so-table so-table--card">
+          <caption class="sr-only">Recent queue events</caption>
           <thead>
             <tr>
               <th>Event</th>
@@ -140,4 +138,3 @@
   <% end %>
   <% end %>
 </div>
-<% end %>

data/app/views/solid_observer/events/index.html.erb

@@ -25,6 +25,7 @@
 
 <% if @events.any? %>
   <table class="so-table so-table--listing">
+    <caption class="sr-only">Events list</caption>
     <thead>
       <tr>
         <th>Event</th>

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

@@ -20,6 +20,7 @@
 
 <% if @jobs.any? %>
   <table class="so-table so-table--listing">
+    <caption class="sr-only">Jobs list</caption>
     <thead>
       <tr>
         <th>ID</th>

data/app/views/solid_observer/storages/show.html.erb

@@ -28,7 +28,24 @@
             <div class="so-card__value"><%= size_value %></div>
             <div class="so-card__subtitle">
               <% if component[:available] %>
-                <%= records_value %> <%= component[:record_label] %>
+                <% if component[:component] == "solid_cable" %>
+                  <% parts = ["#{records_value} #{component[:record_label]}"] %>
+                  <% parts << "#{number_with_delimiter(component[:trimmable_count])} trimmable" unless component[:trimmable_count].nil? %>
+                  <% unless component[:oldest_message_age_seconds].nil? %>
+                    <% age = component[:oldest_message_age_seconds] %>
+                    <% if age < 3600 %>
+                      <% value = [age / 60, 1].max; unit = "m" %>
+                    <% elsif age < 86_400 %>
+                      <% value = age / 3600; unit = "h" %>
+                    <% else %>
+                      <% value = age / 86_400; unit = "d" %>
+                    <% end %>
+                    <% parts << "oldest #{value}#{unit}" %>
+                  <% end %>
+                  <%= parts.join(" · ") %>
+                <% else %>
+                  <%= records_value %> <%= component[:record_label] %>
+                <% end %>
               <% else %>
                 <%= component[:unavailable_reason] %>
               <% end %>
@@ -53,10 +70,19 @@
           </thead>
           <tbody>
             <% @storage_history.each do |snapshot| %>
-              <% record_label = snapshot.component == "solid_cache" ? "cache rows" : "observer events" %>
+              <% record_label = case snapshot.component
+                when "solid_cache" then "cache rows"
+                when "solid_cable" then "messages"
+                else "observer events"
+                end %>
+              <% component_label = case snapshot.component
+                when "solid_cable" then "Solid Cable messages"
+                when "cable_observer" then "Cable telemetry"
+                else snapshot.component.humanize
+                end %>
               <tr>
                 <td><%= snapshot.recorded_at.strftime("%Y-%m-%d %H:%M") %></td>
-                <td><%= snapshot.component.humanize %></td>
+                <td><%= component_label %></td>
                 <td><%= number_to_human_size(snapshot.db_size_bytes, precision: 1, significant: false, strip_insignificant_zeros: false) %></td>
                 <td><%= number_with_delimiter(snapshot.event_count) %> <%= record_label %></td>
               </tr>

data/config/routes.rb

@@ -4,6 +4,8 @@ SolidObserver::Engine.routes.draw do
   root "dashboard#index"
   get "queue", to: "dashboard#index", defaults: {component: "queue"}, as: :queue_dashboard
   get "cache", to: "cache_dashboard#index", as: :cache_dashboard
+  get "cable", to: "cable_dashboard#index", as: :cable_dashboard
+  post "cable/trim", to: "cable_operations#trim", as: :trim_cable_operations
   get "cache/controls", to: "cache_operations#index", as: :cache_operations
   post "cache/controls/prune", to: "cache_operations#prune", as: :prune_cache_operations
   post "cache/controls/clear", to: "cache_operations#clear", as: :clear_cache_operations

data/db/migrate/20260612000001_add_event_type_recorded_at_index_to_cache_events.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+class AddEventTypeRecordedAtIndexToCacheEvents < ActiveRecord::Migration[8.0]
+  disable_ddl_transaction!
+
+  def change
+    options = concurrent_supported? ? {algorithm: :concurrently} : {}
+
+    add_index :solid_observer_cache_events,
+      %i[event_type recorded_at],
+      order: {recorded_at: :desc},
+      if_not_exists: true,
+      **options
+  end
+
+  private
+
+  def concurrent_supported?
+    connection.adapter_name.match?(/postgres/i)
+  end
+end

data/db/migrate/20260619000001_create_solid_observer_cable_events.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+class CreateSolidObserverCableEvents < ActiveRecord::Migration[8.0]
+  def change
+    create_table :solid_observer_cable_events do |t|
+      t.string :event_type, null: false, limit: 64
+      t.string :channel_class, limit: 255
+      t.string :broadcasting_digest, limit: 64
+      t.float :duration
+      t.string :error_class, limit: 255
+      t.text :error_message
+      t.text :metadata
+      t.datetime :recorded_at, null: false
+
+      t.index :recorded_at
+      t.index :event_type
+      t.index :channel_class
+      t.index :broadcasting_digest
+      t.index :error_class
+    end
+  end
+end

data/db/migrate/20260619000002_create_solid_observer_cable_metrics.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+class CreateSolidObserverCableMetrics < ActiveRecord::Migration[8.0]
+  def change
+    create_table :solid_observer_cable_metrics do |t|
+      t.datetime :period_start, null: false
+      t.bigint :broadcasts_count, null: false, default: 0
+      t.bigint :transmissions_count, null: false, default: 0
+      t.bigint :confirmations_count, null: false, default: 0
+      t.bigint :rejections_count, null: false, default: 0
+      t.bigint :perform_actions_count, null: false, default: 0
+      t.bigint :errors_count, null: false, default: 0
+
+      t.index :period_start, unique: true, name: "idx_solid_observer_cable_metrics_unique"
+    end
+  end
+end

data/lib/generators/solid_observer/install_generator.rb

@@ -17,8 +17,11 @@ module SolidObserver
         %w[development test production].each do |env|
           config_block = <<-YAML
   solid_observer_queue:
-    <<: *default
+    adapter: sqlite3
+    pool: 5
+    timeout: 5000
     database: storage/#{env}_solid_observer_queue.sqlite3
+    migrations_paths: db/solid_observer_migrate
           YAML
           inject_into_file "config/database.yml", config_block, after: /^#{env}:\n(?:  .*\n)*/
         end
@@ -40,6 +43,10 @@ module SolidObserver
         say "  5. Restart your Rails server"
         say "  6. Visit /solid_observer to access the web dashboard"
         say "\n"
+        say "IMPORTANT: If your host app uses PostgreSQL or MySQL, review the", :yellow
+        say "solid_observer_queue entries in config/database.yml before running", :yellow
+        say "db:create. The generated config uses adapter: sqlite3 by default.", :yellow
+        say "\n"
         say "Documentation: https://solid.observer", :red
         say "GitHub: https://github.com/bart-oz/solid_observer", :red
         say "\n"

data/lib/generators/solid_observer/templates/initializer.rb.tt

@@ -9,11 +9,20 @@ SolidObserver.configure do |config|
   # Recommended: false in production, true in development/staging
   config.ui_enabled = !Rails.env.production?
 
-  # Authentication for web UI — set a username to enable HTTP Basic Auth
+  # Production dashboard exposure is the host app's responsibility. If you mount
+  # the dashboard in production, wrap the mount in your existing admin auth
+  # constraint, for example in config/routes.rb:
+  #
+  #   authenticate :user, ->(user) { user.admin? } do
+  #     mount SolidObserver::Engine, at: "/solid_observer"
+  #   end
+  #
+  # Built-in HTTP Basic Auth is enabled only when BOTH credentials are present.
+  # Setting only one credential disables Basic Auth and logs a boot warning.
   # config.ui_username = "admin"
   # config.ui_password = "secret"
 
-  # Base controller for UI (customize authorization)
+  # Base controller used only to detect API-only rendering compatibility
   # config.ui_base_controller = "ApplicationController"
 
   # === Queue Observability (v0.1.0) ===
@@ -24,8 +33,14 @@ SolidObserver.configure do |config|
   # config.observe_cache = true
   # config.cache_sampling_rate = 0.1  # Sample 10% of cache operations
 
-  # === Cable Observability (Coming in v0.5.0+) ===
+  # === Cable Observability (v0.5.0) ===
+  # Enable SolidCable event capture and trim controls.
+  # Requires SolidCable in the host app; SolidObserver does not add it.
   # 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
   config.event_retention = 30.days    # How long to keep event records

data/lib/solid_observer/base_event.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module SolidObserver
-  class BaseEvent < ActiveRecord::Base
+  class BaseEvent < BaseRecord
     self.abstract_class = true
 
     # connects_to is configured by the engine after Rails initializes

data/lib/solid_observer/base_metric.rb

@@ -7,7 +7,7 @@ module SolidObserver
   # will be configured by the Engine (similar to BaseEvent) when metrics are
   # fully implemented.
   #
-  class BaseMetric < ActiveRecord::Base
+  class BaseMetric < BaseRecord
     self.abstract_class = true
     self.table_name = "solid_observer_metrics"
 

data/lib/solid_observer/base_record.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module SolidObserver
+  class BaseRecord < ActiveRecord::Base
+    self.abstract_class = true
+    # connects_to is configured by the engine after Rails initializes
+  end
+end

data/lib/solid_observer/cable_event_buffer.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require "singleton"
+
+require_relative "event_buffer_core"
+
+module SolidObserver
+  class CableEventBuffer
+    include Singleton
+    include EventBufferCore
+
+    INITIAL_METRICS = EventBufferCore::INITIAL_METRICS
+
+    def initialize
+      initialize_event_buffer
+    end
+
+    private
+
+    def flush_service
+      Services::FlushCableEventBuffer
+    end
+
+    def log_label
+      "Cable buffer"
+    end
+  end
+end