solid_observer 0.4.0 → 0.6.0

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

@@ -0,0 +1,138 @@
+<div class="so-dashboard">
+  <% queue_enabled = SolidObserver.config.solid_queue_enabled? %>
+  <% queue_status_class = queue_enabled ? "so-badge--success" : "so-badge--warning" %>
+
+  <div class="so-content__header">
+    <h1>Queue overview</h1>
+    <div class="so-queue-overview__intro">
+      <span class="so-badge so-badge--pill <%= queue_status_class %>">
+        <svg class="so-badge__dot" viewBox="0 0 6 6" aria-hidden="true">
+          <circle r="3" cx="3" cy="3" />
+        </svg>
+        <%= queue_enabled ? "Available" : "Unavailable" %>
+      </span>
+      <% if queue_enabled %>
+        <p class="so-queue-overview__hint">Selected range: <%= range_label(@range) %></p>
+      <% end %>
+    </div>
+  </div>
+
+  <% if !queue_enabled %>
+    <section class="so-card so-card--section" aria-labelledby="so-queue-unavailable-heading">
+      <h2 id="so-queue-unavailable-heading">Queue Unavailable</h2>
+      <p class="so-dashboard-section__meta so-dashboard-section__meta--idle">Queue component is disabled or not installed. Enable SolidQueue to access dashboard controls.</p>
+    </section>
+  <% else %>
+  <%# Zone A: Toolbar — range selector, Refresh, Live toggle, help disclosure %>
+  <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()">
+        <% SolidObserver::QueueStats::RANGES.each_key do |key| %>
+          <option value="<%= key %>" <%= "selected" if key == @range %>><%= key %></option>
+        <% end %>
+      </select>
+      <button type="button" class="so-btn so-btn--refresh" data-so-refresh aria-busy="false">Refresh data</button>
+      <span class="so-toolbar-freshness" data-so-freshness aria-live="polite"></span>
+      <input type="hidden" name="live" value="<%= @live ? 'on' : '' %>">
+    </form>
+    <div class="so-dashboard-toolbar__right">
+      <label class="so-toggle so-toggle--pill <%= "so-toggle--on" if @live %>">
+        <input type="checkbox" name="live" value="on" <%= "checked" if @live %> data-so-live-toggle>
+        <span class="so-toggle__track" aria-hidden="true">
+          <span class="so-toggle__thumb"></span>
+        </span>
+        <span class="so-toggle__label">Live</span>
+        <span class="so-toggle__sep" aria-hidden="true"> · </span>
+        <span class="so-toggle__cadence" aria-live="polite"><%= @live ? "5s" : "off" %></span>
+        <span class="so-toggle__dot" aria-hidden="true"></span>
+      </label>
+      <div class="so-help-wrapper" data-so-help-wrapper>
+        <button type="button" class="so-btn so-btn--help" data-so-help-btn aria-expanded="false" aria-controls="so-help-panel">(?)
+        </button>
+        <div id="so-help-panel" class="so-help-panel" data-so-help-panel hidden>
+          <p>Live mode polls every 5 seconds for current queue state. Throughput and chart data update only on range change or manual refresh.</p>
+        </div>
+      </div>
+    </div>
+  </div>
+
+  <%# Zone B: Right now — live state %>
+  <section class="so-dashboard-section" aria-labelledby="so-live-state-heading">
+    <div class="so-dashboard-section__header">
+      <h2 class="so-dashboard-section__title" id="so-live-state-heading">Right now</h2>
+      <span class="so-dashboard-section__meta"><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" fill="var(--so-live-marker, var(--so-success))"/></svg></span> current</span>
+    </div>
+    <%= render "live_state", stats: @stats %>
+  </section>
+
+  <%# Zone C: Throughput in selected range %>
+  <% if persistence_mode? && @stats[:available] %>
+    <section class="so-dashboard-section" aria-labelledby="so-throughput-heading">
+      <div class="so-dashboard-section__header">
+        <h2 class="so-dashboard-section__title" id="so-throughput-heading">Throughput in selected range</h2>
+        <span class="so-dashboard-section__meta"><span class="so-badge so-badge--pill so-badge--info"><svg class="so-badge__dot" viewBox="0 0 6 6" aria-hidden="true"><circle r="3" cx="3" cy="3" fill="var(--so-range-marker, var(--so-info))"/></svg></span> <span data-so-range-copy><%= range_label(@range) %></span></span>
+      </div>
+      <%= render "throughput", stats: @stats, range: @range %>
+    </section>
+  <% end %>
+
+  <%# Zone D: Charts %>
+  <% if @stats[:available] %>
+    <section class="so-dashboard-section" aria-labelledby="so-chart-heading">
+      <div class="so-dashboard-section__header">
+        <h2 class="so-dashboard-section__title" id="so-chart-heading">Charts</h2>
+      </div>
+      <%= render "chart", range: @range %>
+    </section>
+  <% end %>
+
+  <%# Zone E: Per-queue table %>
+  <%= render "queue_table", stats: @stats, range: @range %>
+
+  <%# Zone F: Stability strip %>
+  <% if @stats[:available] && persistence_mode? %>
+    <section class="so-stability" data-so-zone="stability" aria-labelledby="so-stability-heading">
+      <span class="so-stability__label" id="so-stability-heading">Stability</span>
+      <%= stability_badge(@stats) %>
+      <span class="so-stability__detail"><%= stability_detail(@stats) %></span>
+      <%= link_to "View failures →", events_path(event_type: "job_failed"), class: "so-stability__link" %>
+    </section>
+  <% end %>
+
+  <%# Zone G: Recent Events %>
+  <% if @stats[:available] && persistence_mode? %>
+    <% if defined?(@recent_events) && @recent_events.present? %>
+      <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>
+              <th>Job Class</th>
+              <th>Queue</th>
+              <th>Time</th>
+            </tr>
+          </thead>
+          <tbody>
+            <% @recent_events.each do |event| %>
+              <tr>
+                <td><%= event.event_type.humanize %></td>
+                <td><%= event.job_class %></td>
+                <td><%= event.queue_name %></td>
+                <td><%= time_ago_in_words(event.recorded_at) %> ago</td>
+              </tr>
+            <% end %>
+          </tbody>
+        </table>
+      </div>
+    <% else %>
+      <div class="so-card">
+        <div class="so-card__label">Recent Events</div>
+        <p class="so-dashboard-section__meta so-dashboard-section__meta--empty-events">No recent events yet. Queue activity will appear here after jobs are enqueued, performed, or failed.</p>
+      </div>
+    <% end %>
+  <% end %>
+  <% 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/_unified_feed.html.erb

@@ -0,0 +1,38 @@
+<section class="so-card" data-so-zone="home-feed" aria-labelledby="so-feed-heading">
+  <div class="so-card__label" id="so-feed-heading">Recent Activity</div>
+  <% if SolidObserver.config.realtime_mode? %>
+    <p class="so-dashboard-section__meta so-dashboard-section__meta--empty-events">Feed requires persistence mode. Switch to persistence mode to see recent activity across components.</p>
+  <% elsif feed.present? %>
+    <table class="so-table so-table--card">
+      <caption class="sr-only">Unified recent activity across enabled components</caption>
+      <thead>
+        <tr>
+          <th>Component</th>
+          <th>Event</th>
+          <th>Detail</th>
+          <th>Time</th>
+        </tr>
+      </thead>
+      <tbody>
+        <% feed.each do |row| %>
+          <tr>
+            <td><%= row[:component].to_s.titleize %></td>
+            <td><%= row[:event_type].to_s.humanize %></td>
+            <td>
+              <%= unified_feed_detail(row) %>
+            </td>
+            <td>
+              <% if row[:recorded_at] %>
+                <time datetime="<%= row[:recorded_at].iso8601 %>" title="<%= row[:recorded_at].iso8601 %>"><%= time_ago_in_words(row[:recorded_at]) %> ago</time>
+              <% else %>
+                —
+              <% end %>
+            </td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  <% else %>
+    <p class="so-dashboard-section__meta so-dashboard-section__meta--empty-events">No recent activity yet. Events will appear here after components record activity.</p>
+  <% end %>
+</section>

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

@@ -1,143 +1,7 @@
 <% content_for :title, "Dashboard" %>
 
-<% if @component == "cache" %>
-  <%= render template: "solid_observer/cache_dashboard/index" %>
+<% if @component == "home" %>
+  <%= render "home", health: @health, feed: @feed %>
 <% else %>
-<div class="so-dashboard">
-  <% queue_enabled = SolidObserver.config.solid_queue_enabled? %>
-  <% queue_status_class = queue_enabled ? "so-badge--success" : "so-badge--warning" %>
-
-  <div class="so-content__header">
-    <h1>Queue overview</h1>
-    <div class="so-queue-overview__intro">
-      <span class="so-badge so-badge--pill <%= queue_status_class %>">
-        <svg class="so-badge__dot" viewBox="0 0 6 6" aria-hidden="true">
-          <circle r="3" cx="3" cy="3" />
-        </svg>
-        <%= queue_enabled ? "Available" : "Unavailable" %>
-      </span>
-      <% if queue_enabled %>
-        <p class="so-queue-overview__hint">Selected range: <%= range_label(@range) %></p>
-      <% end %>
-    </div>
-  </div>
-
-  <% if !queue_enabled %>
-    <section class="so-card so-card--section" aria-labelledby="so-queue-unavailable-heading">
-      <h2 id="so-queue-unavailable-heading">Queue Unavailable</h2>
-      <p class="so-dashboard-section__meta so-dashboard-section__meta--idle">Queue component is disabled or not installed. Enable SolidQueue to access dashboard controls.</p>
-    </section>
-  <% else %>
-  <%# Zone A: Toolbar — range selector, Refresh, Live toggle, help disclosure %>
-  <div class="so-dashboard-toolbar" data-so-live>
-    <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()">
-        <% SolidObserver::QueueStats::RANGES.each_key do |key| %>
-          <option value="<%= key %>" <%= "selected" if key == @range %>><%= key %></option>
-        <% end %>
-      </select>
-      <button type="button" class="so-btn so-btn--refresh" data-so-refresh aria-busy="false">Refresh data</button>
-      <span class="so-toolbar-freshness" data-so-freshness aria-live="polite"></span>
-      <input type="hidden" name="live" value="<%= @live ? 'on' : '' %>">
-    </form>
-    <div class="so-dashboard-toolbar__right">
-      <label class="so-toggle so-toggle--pill <%= "so-toggle--on" if @live %>">
-        <input type="checkbox" name="live" value="on" <%= "checked" if @live %> data-so-live-toggle>
-        <span class="so-toggle__track" aria-hidden="true">
-          <span class="so-toggle__thumb"></span>
-        </span>
-        <span class="so-toggle__label">Live</span>
-        <span class="so-toggle__sep" aria-hidden="true"> · </span>
-        <span class="so-toggle__cadence" aria-live="polite"><%= @live ? "5s" : "off" %></span>
-        <span class="so-toggle__dot" aria-hidden="true"></span>
-      </label>
-      <div class="so-help-wrapper" data-so-help-wrapper>
-        <button type="button" class="so-btn so-btn--help" data-so-help-btn aria-expanded="false" aria-controls="so-help-panel">(?)
-        </button>
-        <div id="so-help-panel" class="so-help-panel" data-so-help-panel hidden>
-          <p>Live mode polls every 5 seconds for current queue state. Throughput and chart data update only on range change or manual refresh.</p>
-        </div>
-      </div>
-    </div>
-  </div>
-
-  <%# Zone B: Right now — live state %>
-  <section class="so-dashboard-section" aria-labelledby="so-live-state-heading">
-    <div class="so-dashboard-section__header">
-      <h2 class="so-dashboard-section__title" id="so-live-state-heading">Right now</h2>
-      <span class="so-dashboard-section__meta"><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" fill="var(--so-live-marker, var(--so-success))"/></svg></span> current</span>
-    </div>
-    <%= render "live_state", stats: @stats %>
-  </section>
-
-  <%# Zone C: Throughput in selected range %>
-  <% if persistence_mode? && @stats[:available] %>
-    <section class="so-dashboard-section" aria-labelledby="so-throughput-heading">
-      <div class="so-dashboard-section__header">
-        <h2 class="so-dashboard-section__title" id="so-throughput-heading">Throughput in selected range</h2>
-        <span class="so-dashboard-section__meta"><span class="so-badge so-badge--pill so-badge--info"><svg class="so-badge__dot" viewBox="0 0 6 6" aria-hidden="true"><circle r="3" cx="3" cy="3" fill="var(--so-range-marker, var(--so-info))"/></svg></span> <span data-so-range-copy><%= range_label(@range) %></span></span>
-      </div>
-      <%= render "throughput", stats: @stats, range: @range %>
-    </section>
-  <% end %>
-
-  <%# Zone D: Charts %>
-  <% if @stats[:available] %>
-    <section class="so-dashboard-section" aria-labelledby="so-chart-heading">
-      <div class="so-dashboard-section__header">
-        <h2 class="so-dashboard-section__title" id="so-chart-heading">Charts</h2>
-      </div>
-      <%= render "chart", range: @range %>
-    </section>
-  <% end %>
-
-  <%# Zone E: Per-queue table %>
-  <%= render "queue_table", stats: @stats, range: @range %>
-
-  <%# Zone F: Stability strip %>
-  <% if @stats[:available] && persistence_mode? %>
-    <section class="so-stability" data-so-zone="stability" aria-labelledby="so-stability-heading">
-      <span class="so-stability__label" id="so-stability-heading">Stability</span>
-      <%= stability_badge(@stats) %>
-      <span class="so-stability__detail"><%= stability_detail(@stats) %></span>
-      <%= link_to "View failures →", events_path(event_type: "job_failed"), class: "so-stability__link" %>
-    </section>
-  <% end %>
-
-  <%# Zone G: Recent Events %>
-  <% if @stats[:available] && persistence_mode? %>
-    <% if defined?(@recent_events) && @recent_events.present? %>
-      <div class="so-card">
-        <div class="so-card__label">Recent Events</div>
-        <table class="so-table so-table--card">
-          <thead>
-            <tr>
-              <th>Event</th>
-              <th>Job Class</th>
-              <th>Queue</th>
-              <th>Time</th>
-            </tr>
-          </thead>
-          <tbody>
-            <% @recent_events.each do |event| %>
-              <tr>
-                <td><%= event.event_type.humanize %></td>
-                <td><%= event.job_class %></td>
-                <td><%= event.queue_name %></td>
-                <td><%= time_ago_in_words(event.recorded_at) %> ago</td>
-              </tr>
-            <% end %>
-          </tbody>
-        </table>
-      </div>
-    <% else %>
-      <div class="so-card">
-        <div class="so-card__label">Recent Events</div>
-        <p class="so-dashboard-section__meta so-dashboard-section__meta--empty-events">No recent events yet. Queue activity will appear here after jobs are enqueued, performed, or failed.</p>
-      </div>
-    <% end %>
-  <% end %>
-  <% end %>
-</div>
+  <%= render "queue" %>
 <% 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>
@@ -37,7 +38,12 @@
     <tbody>
       <% @events.each do |event| %>
         <tr>
-          <td><%= link_to event.event_type.humanize, event_path(event.id) %></td>
+          <td>
+            <%= link_to event.event_type.humanize, event_path(event.id) %>
+            <% if event.correlation_id.present? %>
+              <%= link_to "Trace →", trace_path(event.correlation_id), class: "so-trace__link" %>
+            <% end %>
+          </td>
           <td><%= event.job_class %></td>
           <td><%= event.queue_name %></td>
           <td><%= duration_with_semantic(event.duration, event.event_type) %></td>

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/app/views/solid_observer/traces/show.html.erb

@@ -0,0 +1,80 @@
+<% content_for :title, "Trace #{params[:id]}" %>
+
+<div class="so-trace">
+  <div class="so-back-link">
+    <%= link_to "← Back to Events", events_path, class: "so-btn" %>
+  </div>
+
+  <div class="so-content__header">
+    <h1>Trace <span class="so-trace__correlation"><%= params[:id] %></span></h1>
+  </div>
+
+  <% if @rows.any? %>
+    <p class="so-trace__meta">Showing newest <%= @rows.size %> events (maximum 100)</p>
+  <% end %>
+
+  <% if @unavailable_components.any? %>
+    <div class="so-flash so-flash--notice" role="status">
+      Some components could not be read: <%= @unavailable_components.map(&:to_s).sort.join(", ") %>. Showing available events only.
+    </div>
+  <% end %>
+
+  <% if @rows.any? %>
+    <% component_tones = {queue: "info", cache: "success", cable: "warning"} %>
+    <table class="so-table so-table--listing so-trace__table">
+      <caption class="sr-only">Trace timeline for correlation ID <%= params[:id] %></caption>
+      <thead>
+        <tr>
+          <th class="so-trace__time">Time</th>
+          <th class="so-trace__component">Component</th>
+          <th class="so-trace__event">Event</th>
+          <th class="so-trace__details">Details</th>
+        </tr>
+      </thead>
+      <tbody>
+        <% @rows.each do |row| %>
+          <tr>
+            <td class="so-trace__time"><%= row[:recorded_at].strftime("%Y-%m-%d %H:%M:%S") %></td>
+            <td class="so-trace__component">
+              <% component_tone = component_tones[row[:component]] || "default" %>
+              <span class="so-badge so-badge--pill so-badge--<%= component_tone %>">
+                <svg class="so-badge__dot" viewBox="0 0 6 6" aria-hidden="true"><circle r="3" cx="3" cy="3" /></svg>
+                <%= row[:component].to_s.capitalize %>
+              </span>
+            </td>
+            <td class="so-trace__event"><%= row[:event_type] %></td>
+            <td class="so-trace__details">
+              <% if row[:event_type] == "cable_summary" %>
+                <%= row[:collapsed_count] %> additional Cable broadcast events collapsed
+              <% else %>
+                <% case row[:component]
+                   when :queue %>
+                  <%= [
+                    ("job=#{row[:job_class]}" if row[:job_class]),
+                    ("queue=#{row[:queue_name]}" if row[:queue_name]),
+                    ("duration=#{format_duration(row[:duration])}" if row[:duration])
+                  ].compact.join(" ") %>
+                <% when :cache %>
+                  <%= [
+                    ("hit=#{row[:hit]}" unless row[:hit].nil?),
+                    ("error=#{row[:error_class]}" if row[:error_class]),
+                    ("duration=#{format_duration(row[:duration])}" if row[:duration])
+                  ].compact.join(" ") %>
+                <% when :cable %>
+                  <%= [
+                    ("channel=#{row[:channel_class]}" if row[:channel_class]),
+                    ("error=#{row[:error_class]}" if row[:error_class]),
+                    ("duration=#{format_duration(row[:duration])}" if row[:duration]),
+                    ("collapsed=#{row[:collapsed_count]}" if row[:collapsed_count])
+                  ].compact.join(" ") %>
+                <% end %>
+              <% end %>
+            </td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  <% else %>
+    <%= render "solid_observer/shared/empty_state", message: "No events found for correlation ID #{params[:id]}. The trace may have expired, not yet recorded, or belong to an unavailable component." %>
+  <% end %>
+</div>

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
@@ -19,4 +21,5 @@ SolidObserver::Engine.routes.draw do
 
   resource :storage, only: %i[show]
   resources :events, only: %i[index show]
+  resources :traces, only: [:show]
 end

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/db/migrate/20260630000001_add_correlation_id_to_cache_events.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+class AddCorrelationIdToCacheEvents < ActiveRecord::Migration[8.0]
+  def change
+    add_column :solid_observer_cache_events, :correlation_id, :string, limit: 64
+    add_index :solid_observer_cache_events, :correlation_id, where: "correlation_id IS NOT NULL"
+  end
+end

data/db/migrate/20260630000002_add_correlation_id_to_cable_events.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+class AddCorrelationIdToCableEvents < ActiveRecord::Migration[8.0]
+  def change
+    add_column :solid_observer_cable_events, :correlation_id, :string, limit: 64
+    add_index :solid_observer_cable_events, :correlation_id, where: "correlation_id IS NOT NULL"
+  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"