rails_error_dashboard 0.3.1 → 0.4.1

data/app/controllers/rails_error_dashboard/errors_controller.rb

@@ -348,6 +348,95 @@ module RailsErrorDashboard
       @pagy, @entries = pagy(:offset, all_entries, limit: params[:per_page] || 25)
     end
 
+    def swallowed_exceptions
+      unless RailsErrorDashboard.configuration.detect_swallowed_exceptions
+        # On Ruby < 3.3, validate! auto-disables this feature — tell the user why
+        if RUBY_VERSION < "3.3"
+          flash[:alert] = "Swallowed exception detection requires Ruby 3.3+ (you have #{RUBY_VERSION}). Upgrade Ruby to use this feature."
+        else
+          flash[:alert] = "Swallowed exception detection is not enabled. Enable it in config/initializers/rails_error_dashboard.rb"
+        end
+        redirect_to errors_path
+        return
+      end
+
+      days = (params[:days] || 30).to_i
+      @days = days
+      result = Queries::SwallowedExceptionSummary.call(days, application_id: @current_application_id)
+      all_entries = result[:entries]
+
+      # Summary stats (computed before pagination)
+      @unique_count = all_entries.size
+      @total_rescue_count = all_entries.sum { |e| e[:rescue_count] }
+      @total_raise_count = all_entries.sum { |e| e[:raise_count] }
+
+      @pagy, @entries = pagy(:offset, all_entries, limit: params[:per_page] || 25)
+    end
+
+    def rack_attack_summary
+      unless RailsErrorDashboard.configuration.enable_rack_attack_tracking &&
+             RailsErrorDashboard.configuration.enable_breadcrumbs
+        flash[:alert] = "Rack Attack tracking is not enabled. Enable enable_rack_attack_tracking and enable_breadcrumbs in config/initializers/rails_error_dashboard.rb"
+        redirect_to errors_path
+        return
+      end
+
+      days = (params[:days] || 30).to_i
+      @days = days
+      result = Queries::RackAttackSummary.call(days, application_id: @current_application_id)
+      all_events = result[:events]
+
+      # Summary stats (computed before pagination)
+      @unique_rules = all_events.size
+      @total_events = all_events.sum { |e| e[:count] }
+      @unique_ips = all_events.flat_map { |e| e[:ips] }.uniq.size
+
+      @pagy, @events = pagy(:offset, all_events, limit: params[:per_page] || 25)
+    end
+
+    def diagnostic_dumps
+      unless RailsErrorDashboard.configuration.enable_diagnostic_dump
+        flash[:alert] = "Diagnostic dumps are not enabled. Enable them in config/initializers/rails_error_dashboard.rb"
+        redirect_to errors_path
+        return
+      end
+
+      scope = DiagnosticDump.recent
+      scope = scope.where(application_id: @current_application_id) if @current_application_id.present?
+      @total_dumps = scope.count
+
+      @pagy, @dumps = pagy(:offset, scope, limit: params[:per_page] || 25)
+    end
+
+    def create_diagnostic_dump
+      unless RailsErrorDashboard.configuration.enable_diagnostic_dump
+        flash[:alert] = "Diagnostic dumps are not enabled."
+        redirect_to errors_path
+        return
+      end
+
+      dump = Services::DiagnosticDumpGenerator.call
+
+      app_name = RailsErrorDashboard.configuration.application_name ||
+                 ENV["APPLICATION_NAME"] ||
+                 (defined?(Rails) && Rails.application.class.module_parent_name) ||
+                 "Unknown"
+      app = Commands::FindOrCreateApplication.call(app_name)
+
+      DiagnosticDump.create!(
+        application_id: app.id,
+        dump_data: dump.to_json,
+        captured_at: Time.current,
+        note: params[:note].presence
+      )
+
+      flash[:notice] = "Diagnostic dump captured successfully."
+      redirect_to diagnostic_dumps_errors_path
+    rescue => e
+      flash[:alert] = "Failed to capture diagnostic dump: #{e.message}"
+      redirect_to diagnostic_dumps_errors_path
+    end
+
     def settings
       @config = RailsErrorDashboard.configuration
     end

data/app/jobs/rails_error_dashboard/swallowed_exception_flush_job.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module RailsErrorDashboard
+  # Job: Persist swallowed exception counters to the database.
+  #
+  # Two usage modes:
+  # 1. With arguments (raise_counts, rescue_counts) — dispatched by the TracePoint
+  #    periodic flush. Zero I/O in the request path; all DB writes happen here.
+  # 2. Without arguments — scheduled periodic sweep that flushes the current
+  #    thread's counters (useful as a cron safety net).
+  #
+  # Example cron (via solid_queue or whenever):
+  #   every 5.minutes { RailsErrorDashboard::SwallowedExceptionFlushJob.perform_later }
+  class SwallowedExceptionFlushJob < ApplicationJob
+    queue_as :default
+
+    def perform(raise_counts = nil, rescue_counts = nil)
+      return unless RailsErrorDashboard.configuration.detect_swallowed_exceptions
+
+      if raise_counts && rescue_counts
+        # Mode 1: Persist provided snapshots (dispatched from TracePoint flush)
+        Commands::FlushSwallowedExceptions.call(
+          raise_counts: raise_counts,
+          rescue_counts: rescue_counts
+        )
+      else
+        # Mode 2: Flush current thread's counters (scheduled cron safety net)
+        Services::SwallowedExceptionTracker.flush!
+      end
+    end
+  end
+end

data/app/models/rails_error_dashboard/diagnostic_dump.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module RailsErrorDashboard
+  class DiagnosticDump < ErrorLogsRecord
+    self.table_name = "rails_error_dashboard_diagnostic_dumps"
+
+    belongs_to :application
+
+    validates :captured_at, presence: true
+    validates :dump_data, presence: true
+
+    scope :recent, -> { order(captured_at: :desc) }
+  end
+end

data/app/models/rails_error_dashboard/swallowed_exception.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module RailsErrorDashboard
+  # Stores aggregated counts of raised-then-rescued exceptions per hourly bucket.
+  #
+  # Swallowed exceptions are raised but silently rescued, never reaching the error
+  # dashboard. This table tracks raise/rescue counts keyed by exception class,
+  # raise location, rescue location, and hourly period.
+  #
+  # A high rescue_count/raise_count ratio indicates exceptions being swallowed.
+  class SwallowedException < ErrorLogsRecord
+    self.table_name = "rails_error_dashboard_swallowed_exceptions"
+
+    belongs_to :application, optional: true
+
+    validates :exception_class, presence: true
+    validates :raise_location, presence: true
+    validates :period_hour, presence: true
+    validates :raise_count, presence: true, numericality: { greater_than_or_equal_to: 0 }
+    validates :rescue_count, presence: true, numericality: { greater_than_or_equal_to: 0 }
+
+    scope :for_application, ->(app_id) { where(application_id: app_id) }
+    scope :since, ->(time) { where("period_hour >= ?", time) }
+    scope :recent, -> { order(period_hour: :desc) }
+
+    # Rescue ratio: fraction of raises that were rescued (0.0 to 1.0)
+    def rescue_ratio
+      return 0.0 if raise_count.zero?
+      rescue_count.to_f / raise_count
+    end
+
+    # Whether this exception is considered "swallowed" (rescue ratio >= threshold)
+    def swallowed?(threshold: nil)
+      threshold ||= RailsErrorDashboard.configuration.swallowed_exception_threshold
+      rescue_ratio >= threshold
+    end
+  end
+end

data/app/views/layouts/rails_error_dashboard.html.erb

@@ -1657,6 +1657,13 @@ body.dark-mode .sidebar-section-body { background: var(--ctp-mantle); }
                   <% end %>
                 </li>
               <% end %>
+              <% if RailsErrorDashboard.configuration.enable_rack_attack_tracking && RailsErrorDashboard.configuration.enable_breadcrumbs %>
+                <li class="nav-item">
+                  <%= link_to rack_attack_summary_errors_path(nav_params), class: "nav-link #{request.path == rack_attack_summary_errors_path ? 'active' : ''}" do %>
+                    <i class="bi bi-shield-exclamation"></i> Rate Limits
+                  <% end %>
+                </li>
+              <% end %>
               <% if RailsErrorDashboard.configuration.enable_system_health %>
                 <li class="nav-item">
                   <%= link_to job_health_summary_errors_path(nav_params), class: "nav-link #{request.path == job_health_summary_errors_path ? 'active' : ''}" do %>
@@ -1669,6 +1676,20 @@ body.dark-mode .sidebar-section-body { background: var(--ctp-mantle); }
                   <% end %>
                 </li>
               <% end %>
+              <% if RailsErrorDashboard.configuration.detect_swallowed_exceptions %>
+                <li class="nav-item">
+                  <%= link_to swallowed_exceptions_errors_path(nav_params), class: "nav-link #{request.path == swallowed_exceptions_errors_path ? 'active' : ''}" do %>
+                    <i class="bi bi-eye-slash"></i> Swallowed
+                  <% end %>
+                </li>
+              <% end %>
+              <% if RailsErrorDashboard.configuration.enable_diagnostic_dump %>
+                <li class="nav-item">
+                  <%= link_to diagnostic_dumps_errors_path(nav_params), class: "nav-link #{request.path == diagnostic_dumps_errors_path ? 'active' : ''}" do %>
+                    <i class="bi bi-clipboard-pulse"></i> Diagnostics
+                  <% end %>
+                </li>
+              <% end %>
             </ul>
 
             <h6 class="mt-4">QUICK FILTERS</h6>

data/app/views/rails_error_dashboard/errors/_instance_variables.html.erb

@@ -0,0 +1,55 @@
+      <!-- Instance Variables (captured from receiver object at raise time) -->
+      <% if RailsErrorDashboard.configuration.enable_instance_variables && error.class.column_names.include?("instance_variables") && error.read_attribute(:instance_variables).present? %>
+        <% instance_vars = JSON.parse(error.read_attribute(:instance_variables)) rescue {} %>
+        <% self_class = instance_vars.delete("_self_class") %>
+        <% if instance_vars.any? %>
+          <div class="card mb-4" id="section-instance-variables">
+            <div class="card-header bg-white">
+              <h5 class="mb-0">
+                <i class="bi bi-box"></i> Instance Variables
+                <span class="badge bg-secondary"><%= instance_vars.size %> captured</span>
+              </h5>
+              <small class="text-muted">
+                Instance variables from
+                <% if self_class && self_class["value"] %>
+                  <code><%= self_class["value"] %></code>
+                <% else %>
+                  the object
+                <% end %>
+                where the exception was raised
+              </small>
+            </div>
+            <div class="card-body p-0">
+              <div class="table-responsive">
+                <table class="table table-sm table-hover mb-0">
+                  <thead class="table-light">
+                    <tr>
+                      <th width="200">Variable</th>
+                      <th width="120">Type</th>
+                      <th>Value</th>
+                    </tr>
+                  </thead>
+                  <tbody>
+                    <% instance_vars.each do |name, info| %>
+                      <tr>
+                        <td><code><%= name %></code></td>
+                        <td><small class="text-muted"><%= info["type"] %></small></td>
+                        <td>
+                          <% if info["filtered"] %>
+                            <span class="badge bg-warning text-dark">[FILTERED]</span>
+                          <% else %>
+                            <code style="word-break: break-all; font-size: 0.85em;"><%= truncate(info["value"].to_s, length: 500) %></code>
+                            <% if info["truncated"] %>
+                              <span class="badge bg-info text-dark ms-1" style="font-size: 0.7em;">truncated</span>
+                            <% end %>
+                          <% end %>
+                        </td>
+                      </tr>
+                    <% end %>
+                  </tbody>
+                </table>
+              </div>
+            </div>
+          </div>
+        <% end %>
+      <% end %>

data/app/views/rails_error_dashboard/errors/_local_variables.html.erb

@@ -0,0 +1,46 @@
+      <!-- Local Variables (captured via TracePoint) -->
+      <% if RailsErrorDashboard.configuration.enable_local_variables && error.respond_to?(:local_variables) && error.local_variables.present? %>
+        <% local_vars = JSON.parse(error.local_variables) rescue {} %>
+        <% if local_vars.any? %>
+          <div class="card mb-4" id="section-local-variables">
+            <div class="card-header bg-white">
+              <h5 class="mb-0">
+                <i class="bi bi-braces"></i> Local Variables
+                <span class="badge bg-secondary"><%= local_vars.size %> captured</span>
+              </h5>
+              <small class="text-muted">Variables from the stack frame where the exception was raised</small>
+            </div>
+            <div class="card-body p-0">
+              <div class="table-responsive">
+                <table class="table table-sm table-hover mb-0">
+                  <thead class="table-light">
+                    <tr>
+                      <th width="200">Variable</th>
+                      <th width="120">Type</th>
+                      <th>Value</th>
+                    </tr>
+                  </thead>
+                  <tbody>
+                    <% local_vars.each do |name, info| %>
+                      <tr>
+                        <td><code><%= name %></code></td>
+                        <td><small class="text-muted"><%= info["type"] %></small></td>
+                        <td>
+                          <% if info["filtered"] %>
+                            <span class="badge bg-warning text-dark">[FILTERED]</span>
+                          <% else %>
+                            <code style="word-break: break-all; font-size: 0.85em;"><%= truncate(info["value"].to_s, length: 500) %></code>
+                            <% if info["truncated"] %>
+                              <span class="badge bg-info text-dark ms-1" style="font-size: 0.7em;">truncated</span>
+                            <% end %>
+                          <% end %>
+                        </td>
+                      </tr>
+                    <% end %>
+                  </tbody>
+                </table>
+              </div>
+            </div>
+          </div>
+        <% end %>
+      <% end %>

data/app/views/rails_error_dashboard/errors/_sidebar_metadata.html.erb

@@ -334,6 +334,54 @@
                       </code>
                     </div>
                   <% end %>
+
+                  <% if health[:ruby_vm] %>
+                    <% vm = health[:ruby_vm] %>
+                    <div class="mb-1">
+                      <small class="text-muted">VM Cache Invalidations:</small>
+                      <% invals = vm[:constant_cache_invalidations].to_i %>
+                      <code class="ms-1 <%= 'text-danger' if invals > 10_000 %>"><%= begin; number_with_delimiter(invals); rescue; invals; end %></code>
+                    </div>
+                    <div class="mb-1">
+                      <small class="text-muted">VM Cache Misses:</small>
+                      <code class="ms-1"><%= begin; number_with_delimiter(vm[:constant_cache_misses]); rescue; vm[:constant_cache_misses]; end %></code>
+                    </div>
+                    <% if vm[:shape_cache_size] %>
+                      <div class="mb-1">
+                        <small class="text-muted">Shape Cache Size:</small>
+                        <code class="ms-1"><%= begin; number_with_delimiter(vm[:shape_cache_size]); rescue; vm[:shape_cache_size]; end %></code>
+                      </div>
+                    <% end %>
+                  <% end %>
+
+                  <% if health[:yjit] %>
+                    <% yj = health[:yjit] %>
+                    <% if yj[:compiled_iseq_count] || yj[:compiled_block_count] %>
+                      <div class="mb-1">
+                        <small class="text-muted">YJIT Compiled:</small>
+                        <code class="ms-1"><%= yj[:compiled_iseq_count] %> iseqs / <%= yj[:compiled_block_count] %> blocks</code>
+                      </div>
+                    <% end %>
+                    <% if yj[:invalidation_count] %>
+                      <div class="mb-1">
+                        <small class="text-muted">YJIT Invalidations:</small>
+                        <% yj_invals = yj[:invalidation_count].to_i %>
+                        <code class="ms-1 <%= 'text-danger' if yj_invals > 100 %>"><%= yj_invals %></code>
+                      </div>
+                    <% end %>
+                    <% if yj[:code_region_size] %>
+                      <div class="mb-1">
+                        <small class="text-muted">YJIT Code Size:</small>
+                        <code class="ms-1"><%= (yj[:code_region_size].to_f / 1024).round(1) %> KB</code>
+                      </div>
+                    <% end %>
+                    <% if yj[:compile_time_ns] %>
+                      <div class="mb-1">
+                        <small class="text-muted">YJIT Compile Time:</small>
+                        <code class="ms-1"><%= (yj[:compile_time_ns].to_f / 1_000_000).round(2) %> ms</code>
+                      </div>
+                    <% end %>
+                  <% end %>
                 </div>
               </div>
             <% end %>

data/app/views/rails_error_dashboard/errors/diagnostic_dumps.html.erb

@@ -0,0 +1,182 @@
+<% content_for :page_title, "Diagnostic Dumps" %>
+
+<div class="container-fluid py-4">
+  <div class="d-flex justify-content-between align-items-center mb-4">
+    <h1 class="h3 mb-0">
+      <i class="bi bi-clipboard-pulse me-2"></i>
+      Diagnostic Dumps
+    </h1>
+
+    <%= button_to create_diagnostic_dump_errors_path, method: :post, class: "btn btn-primary btn-sm" do %>
+      <i class="bi bi-camera me-1"></i> Capture Dump
+    <% end %>
+  </div>
+
+  <% if @total_dumps == 0 %>
+    <div class="text-center py-5">
+      <i class="bi bi-clipboard-pulse display-1 text-muted mb-3"></i>
+      <h4 class="text-muted">No Diagnostic Dumps Yet</h4>
+      <p class="text-muted">
+        Capture an on-demand snapshot of your system state for debugging.
+      </p>
+      <div class="card mx-auto" style="max-width: 500px;">
+        <div class="card-body text-start">
+          <h6>How diagnostic dumps work:</h6>
+          <ul class="mb-0">
+            <li>Click <strong>Capture Dump</strong> above or run <code>rails error_dashboard:diagnostic_dump</code></li>
+            <li>Captures: environment, GC stats, threads, connection pool, memory, job queue</li>
+            <li>Each dump is saved to the database for historical comparison</li>
+            <li>Use dumps to investigate production issues or verify system health</li>
+          </ul>
+        </div>
+      </div>
+    </div>
+  <% else %>
+    <div class="row mb-4">
+      <div class="col-md-4">
+        <div class="card text-center">
+          <div class="card-body">
+            <div class="display-6 text-info"><%= @total_dumps %></div>
+            <small class="text-muted">Total Dumps</small>
+          </div>
+        </div>
+      </div>
+      <div class="col-md-4">
+        <div class="card text-center">
+          <div class="card-body">
+            <%
+              latest = @dumps.first
+              latest_data = begin; JSON.parse(latest.dump_data); rescue; {}; end if latest
+              thread_count = latest_data&.dig("system_health", "thread_count")
+            %>
+            <div class="display-6 text-secondary"><%= thread_count || "N/A" %></div>
+            <small class="text-muted">Threads (Latest)</small>
+          </div>
+        </div>
+      </div>
+      <div class="col-md-4">
+        <div class="card text-center">
+          <div class="card-body">
+            <%
+              memory_mb = latest_data&.dig("system_health", "process_memory_mb")
+            %>
+            <div class="display-6 text-secondary"><%= memory_mb ? "#{memory_mb} MB" : "N/A" %></div>
+            <small class="text-muted">Memory (Latest)</small>
+          </div>
+        </div>
+      </div>
+    </div>
+
+    <div class="card mb-4">
+      <div class="card-header bg-white d-flex justify-content-between align-items-center">
+        <h5 class="mb-0">
+          <i class="bi bi-clipboard-pulse text-info me-2"></i>
+          Dump History
+          <span class="badge bg-info"><%= @total_dumps %></span>
+        </h5>
+        <small class="text-muted"><%== @pagy.info_tag %></small>
+      </div>
+      <div class="card-body p-0">
+        <% @dumps.each do |dump| %>
+          <%
+            data = begin; JSON.parse(dump.dump_data); rescue; {}; end
+            env = data["environment"] || {}
+            health = data["system_health"] || {}
+            gc = data["gc"] || {}
+            threads = data["threads"] || []
+          %>
+          <div class="border-bottom p-3">
+            <div class="d-flex justify-content-between align-items-start mb-2">
+              <div>
+                <strong>
+                  <i class="bi bi-clock me-1"></i>
+                  <%= dump.captured_at.strftime("%Y-%m-%d %H:%M:%S %Z") %>
+                </strong>
+                <span class="text-muted ms-2">PID: <%= data["pid"] %></span>
+                <% if data["uptime_seconds"] %>
+                  <span class="text-muted ms-2">
+                    Uptime: <%= (data["uptime_seconds"].to_i / 60) %>m
+                  </span>
+                <% end %>
+                <% if dump.note.present? %>
+                  <span class="badge bg-secondary ms-2"><%= dump.note %></span>
+                <% end %>
+              </div>
+              <button class="btn btn-outline-secondary btn-sm"
+                      type="button"
+                      data-bs-toggle="collapse"
+                      data-bs-target="#dump-<%= dump.id %>"
+                      aria-expanded="false">
+                <i class="bi bi-chevron-down"></i> Details
+              </button>
+            </div>
+
+            <div class="row">
+              <div class="col-md-3">
+                <small class="text-muted d-block">Environment</small>
+                <small>
+                  Ruby <%= env["ruby_version"] || "?" %> /
+                  Rails <%= env["rails_version"] || "?" %>
+                  <% if env["server"] && env["server"] != "unknown" %>
+                    / <%= env["server"].capitalize %>
+                  <% end %>
+                </small>
+              </div>
+              <div class="col-md-3">
+                <small class="text-muted d-block">System Health</small>
+                <small>
+                  <% mem = health["process_memory_mb"] %>
+                  <% tc = health["thread_count"] %>
+                  <% pool = health["connection_pool"] %>
+                  <%= mem ? "#{mem} MB" : "N/A" %> /
+                  <%= tc || "?" %> threads
+                  <% if pool %>
+                    / Pool: <%= pool["busy"] %>/<%= pool["size"] %>
+                  <% end %>
+                </small>
+              </div>
+              <div class="col-md-3">
+                <small class="text-muted d-block">GC</small>
+                <small>
+                  <% gc_health = health["gc"] || {} %>
+                  Live: <%= gc_health["heap_live_slots"]&.to_s(:delimited) rescue gc_health["heap_live_slots"] || "?" %> /
+                  Major GC: <%= gc_health["major_gc_count"] || "?" %>
+                </small>
+              </div>
+              <div class="col-md-3">
+                <small class="text-muted d-block">Job Queue</small>
+                <small>
+                  <% jq = health["job_queue"] %>
+                  <% if jq %>
+                    <%= jq["adapter"] %>
+                    <% if jq["failed"] || jq["errored"] %>
+                      — failed: <%= jq["failed"] || jq["errored"] %>
+                    <% end %>
+                  <% else %>
+                    N/A
+                  <% end %>
+                </small>
+              </div>
+            </div>
+
+            <div class="collapse mt-3" id="dump-<%= dump.id %>">
+              <pre class="bg-light p-3 rounded" style="max-height: 400px; overflow-y: auto; font-size: 0.8rem;"><%= JSON.pretty_generate(data) rescue dump.dump_data %></pre>
+            </div>
+          </div>
+        <% end %>
+      </div>
+      <div class="card-footer bg-white border-top d-flex justify-content-between align-items-center">
+        <div>
+          <small class="text-muted">
+            <i class="bi bi-lightbulb text-warning"></i>
+            You can also capture dumps via: <code>rails error_dashboard:diagnostic_dump</code>
+            <span class="ms-2">Add a note: <code>NOTE="deploy check" rails error_dashboard:diagnostic_dump</code></span>
+          </small>
+        </div>
+        <div>
+          <%== @pagy.series_nav(:bootstrap) if @pagy.pages > 1 %>
+        </div>
+      </div>
+    </div>
+  <% end %>
+</div>