rails_error_dashboard 0.1.38 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2e6cc2792ac8e61248b57b513ac64f02426ee651bb9cf07c3d4557760f8d7d31
-  data.tar.gz: 9450f4745f01d22c8eef4e5988c745d89f7951d318a7f625a8839b1eebd371f5
+  metadata.gz: 7ded53b39ba42ddedec2dea52df11dc8e69c77376bb8204891e6c4f9d3fc165b
+  data.tar.gz: c0d80a90c1a2f9dff08f82d4bd40dcc2e1f0336ffe443cc5c96420d059b42a64
 SHA512:
-  metadata.gz: 49a0c0f2988e1dfe03a40599693411d4a55690be71b7f7921d3dc6e305bc9f2bb54e2792bea7ad8a956127a7d87abf565b81e935536e8b37adbfe844fd017025
-  data.tar.gz: c040c6f3ea54b21d6c23addd72c9a787075e17cc4413c5a88c911c7e06c6376e3d5969bea85f106c53bb8b226a155b5ad01646626372488496120f580475cec7
+  metadata.gz: fcd8b1b91f2d6a9563ff137b8ceeb50fd82cbda3738792680a3d08b418a204102be98b3527dce1da6e1495a6a0c0647cc85e0d3a073de53e0657fdb8a4d4b490
+  data.tar.gz: 0f374fc4577b29cc3165ed5ad756243298d1d5c691a9f0e865c974411a9eec3430b544f8abf176b47d8a1e816d7f26b36eff819a9fe483bbf13798aef801f9ae

data/README.md

@@ -24,12 +24,12 @@ gem 'rails_error_dashboard'
 
 Username: `gandalf` · Password: `youshallnotpass`
 
-Experience the full dashboard with 250+ realistic Rails errors, LOTR-themed demo data, and all features enabled.
+Experience the full dashboard with 480+ realistic Rails errors, LOTR-themed demo data, cause chains, enriched context, auto-reopened errors, and all features enabled.
 
 ---
 
 ### ⚠️ BETA SOFTWARE
-This Rails Engine is in beta and under active development. While functional and tested (1,300+ tests passing, including browser-based system tests), the API may change before v1.0.0. Use in production at your own discretion.
+This Rails Engine is in beta and under active development. While functional and tested (1,800+ tests passing, including browser-based system tests), the API may change before v1.0.0. Use in production at your own discretion.
 
 **Supports**: Rails 7.0 - 8.1 | Ruby 3.2 - 4.0
 
@@ -169,6 +169,22 @@ config.git_repository_url = "https://github.com/user/repo"
 
 **📖 [Complete documentation →](docs/SOURCE_CODE_INTEGRATION.md)**
 
+#### 🆕 v0.2 Quick Wins (NEW!)
+
+**11 features that make error tracking smarter, safer, and more actionable:**
+
+- **Exception Cause Chains** — Automatically captures the full `cause` chain (e.g., `SocketError` → `RuntimeError`) so you see root causes, not just wrappers
+- **Enriched Context** — Every HTTP error captures `http_method`, `hostname`, `content_type`, and `request_duration_ms` automatically
+- **Custom Fingerprint** — Override error grouping with a lambda: group `RecordNotFound` by controller, or any custom logic
+- **CurrentAttributes Integration** — Zero-config capture of `Current.user`, `Current.account`, `Current.request_id`
+- **Environment Info** — Ruby version, Rails version, gem versions, server, and database adapter captured at error time
+- **Sensitive Data Filtering** — Passwords, tokens, secrets, and API keys auto-filtered from error context before storage
+- **Auto-Reopen** — Resolved errors automatically reopen when they recur, with a "Reopened" badge in the UI
+- **Notification Throttling** — Severity filters, per-error cooldown, and milestone threshold alerts prevent alert fatigue
+- **BRIN Indexes** — PostgreSQL BRIN index on `occurred_at` for dramatically faster time-range queries (72KB vs 676MB)
+- **Structured Backtrace** — Uses `backtrace_locations` for richer backtrace data with proper path/line/method fields
+- **Reduced Dependencies** — Core gem now requires only `rails` + `pagy`; `browser`, `chartkick`, `httparty`, `turbo-rails` are optional
+
 #### 🔌 Plugin System
 Extensible architecture with event hooks (`on_error_logged`, `on_error_resolved`, `on_threshold_exceeded`). Built-in examples for Jira integration, metrics tracking, audit logging. Easy to create custom plugins - just drop a file in `config/initializers/error_dashboard_plugins/`.
 
@@ -640,7 +656,7 @@ Clean, maintainable, testable architecture you can understand and modify.
 
 ## 🧪 Testing
 
-1,300+ tests covering unit, integration, and browser-based system tests.
+1,800+ tests covering unit, integration, and browser-based system tests.
 
 ### Running Tests
 
@@ -733,7 +749,7 @@ Rails Error Dashboard is available as open source under the terms of the [MIT Li
 <details>
 <summary><strong>Is this production-ready?</strong></summary>
 
-This is currently in **beta** but actively tested with 935+ passing tests across Rails 7.0-8.0 and Ruby 3.2-3.4. Many users are running it in production. See [production requirements](docs/FEATURES.md#production-readiness).
+This is currently in **beta** but actively tested with 1,800+ passing tests across Rails 7.0-8.1 and Ruby 3.2-4.0. Many users are running it in production. See [production requirements](docs/FEATURES.md#production-readiness).
 </details>
 
 <details>

data/app/controllers/rails_error_dashboard/errors_controller.rb

@@ -19,6 +19,7 @@ module RailsErrorDashboard
       assignee_name
       priority_level
       hide_snoozed
+      reopened
       sort_by
       sort_direction
     ].freeze

data/app/jobs/rails_error_dashboard/async_error_logging_job.rb

@@ -10,9 +10,19 @@ module RailsErrorDashboard
     # @param exception_data [Hash] Serialized exception data
     # @param context [Hash] Error context (request, user, etc.)
     def perform(exception_data, context)
+      # Normalize string keys (ActiveJob may deserialize with string keys)
+      exception_data = exception_data.symbolize_keys if exception_data.respond_to?(:symbolize_keys)
+      context = context.symbolize_keys if context.respond_to?(:symbolize_keys)
+
       # Reconstruct the exception from serialized data
       exception = reconstruct_exception(exception_data)
 
+      # Pass pre-extracted cause chain via context so LogError can use it
+      # (reconstructed exceptions don't have Ruby's built-in cause set)
+      if exception_data[:cause_chain]
+        context[:_serialized_cause_chain] = exception_data[:cause_chain]
+      end
+
       # Log the error synchronously in the background job
       # Call .new().call to bypass async check (we're already async)
       Commands::LogError.new(exception, context).call

data/app/jobs/rails_error_dashboard/baseline_alert_job.rb

@@ -73,11 +73,7 @@ module RailsErrorDashboard
     def send_slack_notification(error_log, anomaly_data, config)
       payload = Services::BaselineAlertPayloadBuilder.slack_payload(error_log, anomaly_data)
 
-      HTTParty.post(
-        config.slack_webhook_url,
-        body: payload.to_json,
-        headers: { "Content-Type" => "application/json" }
-      )
+      post_json(config.slack_webhook_url, payload)
     rescue => e
       Rails.logger.error("Failed to send baseline alert to Slack: #{e.message}")
     end
@@ -93,11 +89,7 @@ module RailsErrorDashboard
     def send_discord_notification(error_log, anomaly_data, config)
       payload = Services::BaselineAlertPayloadBuilder.discord_payload(error_log, anomaly_data)
 
-      HTTParty.post(
-        config.discord_webhook_url,
-        body: payload.to_json,
-        headers: { "Content-Type" => "application/json" }
-      )
+      post_json(config.discord_webhook_url, payload)
     rescue => e
       Rails.logger.error("Failed to send baseline alert to Discord: #{e.message}")
     end
@@ -106,16 +98,28 @@ module RailsErrorDashboard
       payload = Services::BaselineAlertPayloadBuilder.webhook_payload(error_log, anomaly_data)
 
       config.webhook_urls.each do |url|
-        HTTParty.post(
-          url,
-          body: payload.to_json,
-          headers: { "Content-Type" => "application/json" }
-        )
+        post_json(url, payload)
       end
     rescue => e
       Rails.logger.error("Failed to send baseline alert to webhook: #{e.message}")
     end
 
+    def post_json(url, payload)
+      if defined?(HTTParty)
+        HTTParty.post(url, body: payload.to_json,
+          headers: { "Content-Type" => "application/json" }, timeout: 10)
+      else
+        uri = URI(url)
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = uri.scheme == "https"
+        http.open_timeout = 5
+        http.read_timeout = 10
+        request = Net::HTTP::Post.new(uri.path, { "Content-Type" => "application/json" })
+        request.body = payload.to_json
+        http.request(request)
+      end
+    end
+
     def send_pagerduty_notification(error_log, _anomaly_data, _config)
       Rails.logger.info(
         "Baseline alert PagerDuty notification for #{error_log.error_type}"

data/app/jobs/rails_error_dashboard/discord_error_notification_job.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require "httparty"
-
 module RailsErrorDashboard
   # Job to send error notifications to Discord via webhook
   class DiscordErrorNotificationJob < ApplicationJob
@@ -14,16 +12,28 @@ module RailsErrorDashboard
       return unless webhook_url.present?
 
       payload = Services::DiscordPayloadBuilder.call(error_log)
-
-      HTTParty.post(
-        webhook_url,
-        body: payload.to_json,
-        headers: { "Content-Type" => "application/json" },
-        timeout: 10  # CRITICAL: 10 second timeout to prevent hanging
-      )
+      post_json(webhook_url, payload)
     rescue StandardError => e
       Rails.logger.error("[RailsErrorDashboard] Failed to send Discord notification: #{e.message}")
       Rails.logger.error(e.backtrace&.first(5)&.join("\n")) if e.backtrace
     end
+
+    private
+
+    def post_json(url, payload)
+      if defined?(HTTParty)
+        HTTParty.post(url, body: payload.to_json,
+          headers: { "Content-Type" => "application/json" }, timeout: 10)
+      else
+        uri = URI(url)
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = uri.scheme == "https"
+        http.open_timeout = 5
+        http.read_timeout = 10
+        request = Net::HTTP::Post.new(uri.path, { "Content-Type" => "application/json" })
+        request.body = payload.to_json
+        http.request(request)
+      end
+    end
   end
 end

data/app/jobs/rails_error_dashboard/pagerduty_error_notification_job.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require "httparty"
-
 module RailsErrorDashboard
   # Job to send critical error notifications to PagerDuty
   # Only triggers for critical severity errors
@@ -20,20 +18,48 @@ module RailsErrorDashboard
       return unless routing_key.present?
 
       payload = Services::PagerdutyPayloadBuilder.call(error_log, routing_key: routing_key)
+      response = post_json(PAGERDUTY_EVENTS_API, payload)
 
-      response = HTTParty.post(
-        PAGERDUTY_EVENTS_API,
-        body: payload.to_json,
-        headers: { "Content-Type" => "application/json" },
-        timeout: 10  # CRITICAL: 10 second timeout to prevent hanging
-      )
-
-      unless response.success?
-        Rails.logger.error("[RailsErrorDashboard] PagerDuty API error: #{response.code} - #{response.body}")
+      unless response_success?(response)
+        Rails.logger.error("[RailsErrorDashboard] PagerDuty API error: #{response_code(response)} - #{response_body(response)}")
       end
     rescue StandardError => e
       Rails.logger.error("[RailsErrorDashboard] Failed to send PagerDuty notification: #{e.message}")
       Rails.logger.error(e.backtrace&.first(5)&.join("\n")) if e.backtrace
     end
+
+    private
+
+    def post_json(url, payload)
+      if defined?(HTTParty)
+        HTTParty.post(url, body: payload.to_json,
+          headers: { "Content-Type" => "application/json" }, timeout: 10)
+      else
+        uri = URI(url)
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = uri.scheme == "https"
+        http.open_timeout = 5
+        http.read_timeout = 10
+        request = Net::HTTP::Post.new(uri.path, { "Content-Type" => "application/json" })
+        request.body = payload.to_json
+        http.request(request)
+      end
+    end
+
+    def response_success?(response)
+      if response.respond_to?(:success?)
+        response.success?
+      else
+        response.is_a?(Net::HTTPSuccess)
+      end
+    end
+
+    def response_code(response)
+      response.respond_to?(:code) ? response.code : response&.code
+    end
+
+    def response_body(response)
+      response.respond_to?(:body) ? response.body : response&.body
+    end
   end
 end

data/app/jobs/rails_error_dashboard/retention_cleanup_job.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module RailsErrorDashboard
+  # Background job to enforce the retention_days configuration.
+  # Deletes error logs (and their associated records) older than the configured threshold.
+  # Uses find_each + destroy to respect dependent: :destroy on associations.
+  #
+  # Schedule this job daily via your preferred scheduler (SolidQueue, Sidekiq, cron).
+  #
+  # @example Schedule in initializer
+  #   RailsErrorDashboard.configure do |config|
+  #     config.retention_days = 90
+  #   end
+  class RetentionCleanupJob < ApplicationJob
+    queue_as :default
+
+    # @return [Integer] number of errors deleted
+    def perform
+      retention_days = RailsErrorDashboard.configuration.retention_days
+      return 0 if retention_days.blank?
+
+      cutoff = retention_days.days.ago
+      deleted_count = 0
+
+      # Use find_each to process in batches (default 1000)
+      # destroy triggers dependent: :destroy on associations (occurrences, comments, cascades)
+      ErrorLog.where("occurred_at < ?", cutoff).find_each do |error_log|
+        error_log.destroy
+        deleted_count += 1
+      end
+
+      if deleted_count > 0
+        RailsErrorDashboard::Logger.info(
+          "[RailsErrorDashboard] Retention cleanup: deleted #{deleted_count} errors older than #{retention_days} days"
+        )
+      end
+
+      deleted_count
+    rescue => e
+      RailsErrorDashboard::Logger.error("[RailsErrorDashboard] Retention cleanup failed: #{e.class} - #{e.message}")
+      0
+    end
+  end
+end

data/app/jobs/rails_error_dashboard/webhook_error_notification_job.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require "httparty"
-
 module RailsErrorDashboard
   # Job to send error notifications to custom webhook URLs
   # Supports multiple webhooks for different integrations
@@ -30,23 +28,47 @@ module RailsErrorDashboard
     private
 
     def send_webhook(url, payload, error_log)
-      response = HTTParty.post(
-        url,
-        body: payload.to_json,
-        headers: {
-          "Content-Type" => "application/json",
-          "User-Agent" => "RailsErrorDashboard/1.0",
-          "X-Error-Dashboard-Event" => "error.created",
-          "X-Error-Dashboard-ID" => error_log.id.to_s
-        },
-        timeout: 10  # CRITICAL: 10 second timeout to prevent hanging
-      )
-
-      unless response.success?
-        Rails.logger.warn("[RailsErrorDashboard] Webhook failed for #{url}: #{response.code}")
+      headers = {
+        "Content-Type" => "application/json",
+        "User-Agent" => "RailsErrorDashboard/1.0",
+        "X-Error-Dashboard-Event" => "error.created",
+        "X-Error-Dashboard-ID" => error_log.id.to_s
+      }
+
+      response = post_json(url, payload, headers)
+
+      unless response_success?(response)
+        Rails.logger.warn("[RailsErrorDashboard] Webhook failed for #{url}: #{response_code(response)}")
       end
     rescue StandardError => e
       Rails.logger.error("[RailsErrorDashboard] Webhook error for #{url}: #{e.message}")
     end
+
+    def post_json(url, payload, headers)
+      if defined?(HTTParty)
+        HTTParty.post(url, body: payload.to_json, headers: headers, timeout: 10)
+      else
+        uri = URI(url)
+        http = Net::HTTP.new(uri.host, uri.port)
+        http.use_ssl = uri.scheme == "https"
+        http.open_timeout = 5
+        http.read_timeout = 10
+        request = Net::HTTP::Post.new(uri.path, headers)
+        request.body = payload.to_json
+        http.request(request)
+      end
+    end
+
+    def response_success?(response)
+      if response.respond_to?(:success?)
+        response.success?
+      else
+        response.is_a?(Net::HTTPSuccess)
+      end
+    end
+
+    def response_code(response)
+      response.respond_to?(:code) ? response.code : response&.code
+    end
   end
 end

data/app/models/rails_error_dashboard/error_log.rb

@@ -4,6 +4,16 @@ module RailsErrorDashboard
   class ErrorLog < ErrorLogsRecord
     self.table_name = "rails_error_dashboard_error_logs"
 
+    # Transient flag: set to true when a resolved/wont_fix error is reopened by FindOrIncrementError.
+    # Not persisted — used by LogError to decide notification behavior.
+    attr_accessor :just_reopened
+
+    # Was this error previously resolved and then reopened due to recurrence?
+    # Uses the persisted `reopened_at` column (set by FindOrIncrementError).
+    def reopened?
+      respond_to?(:reopened_at) && reopened_at.present?
+    end
+
     # Priority level constants
     # Using industry standard: P0 = Critical (highest), P3 = Low (lowest)
     PRIORITY_LEVELS = {

data/app/models/rails_error_dashboard/error_logs_record.rb

@@ -5,17 +5,22 @@
 # By default, this connects to the same database as the main application.
 #
 # To enable a separate error dashboard database:
-# 1. Set use_separate_database: true in the gem configuration
-# 2. Set database: :error_dashboard (or your custom name) in the gem configuration
-# 3. Configure error_dashboard settings in config/database.yml
-# 4. Run: rails db:create
-# 5. Run: rails db:migrate
+# 1. Set config.use_separate_database = true in the gem configuration
+# 2. Set config.database = :error_dashboard in the gem configuration
+# 3. Add an "error_dashboard:" entry in config/database.yml
+# 4. Run: rails db:create:error_dashboard
+# 5. Run: rails db:migrate:error_dashboard
+#
+# For multi-app setups, point all apps' database.yml "error_dashboard:" entry
+# to the same physical database. Each app is identified by config.application_name.
+#
+# Run "rails error_dashboard:verify" to check your setup.
 #
 # Benefits of separate database:
 # - Performance isolation (error logging doesn't slow down user requests)
 # - Independent scaling (can put error DB on separate server)
+# - Multi-app support (centralized error tracking across multiple Rails apps)
 # - Different retention policies (archive old errors without affecting main data)
-# - Security isolation (different access controls for error logs)
 #
 # Trade-offs:
 # - No foreign keys between error_logs and users tables

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

@@ -1148,6 +1148,22 @@ body.dark-mode .source-file-path {
   color: var(--ctp-text) !important; /* Bright text for dark mode */
 }
 
+/* Backtrace frame number styling */
+.backtrace-frame-number {
+  display: inline-block;
+  min-width: 2em;
+  text-align: right;
+  margin-right: 0.5em;
+  color: #9ca3af;
+  font-family: 'SF Mono', 'Monaco', 'Inconsolata', 'Fira Code', monospace;
+  font-size: 0.85em;
+  user-select: none;
+}
+
+body.dark-mode .backtrace-frame-number {
+  color: var(--ctp-overlay1);
+}
+
 /* Backtrace method name styling - override Bootstrap text-info */
 span.backtrace-method-name {
   color: #0066cc !important; /* Darker blue for better readability in light mode */

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

@@ -87,6 +87,9 @@
     <% else %>
       <i class="bi bi-exclamation-circle-fill text-danger" data-bs-toggle="tooltip" title="Unresolved"></i>
     <% end %>
+    <% if error.reopened? %>
+      <i class="bi bi-arrow-counterclockwise text-warning ms-1" data-bs-toggle="tooltip" title="Reopened"></i>
+    <% end %>
   </td>
   <td onclick="event.stopPropagation();">
     <%= link_to error_path(error), class: "btn btn-sm btn-outline-primary" do %>

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

@@ -1,5 +1,5 @@
 <div class="row g-4">
-  <div class="col-md-3">
+  <div class="col">
     <div class="card stat-card">
       <div class="card-body">
         <div class="stat-label mb-2">Today</div>
@@ -7,7 +7,7 @@
       </div>
     </div>
   </div>
-  <div class="col-md-3">
+  <div class="col">
     <div class="card stat-card">
       <div class="card-body">
         <div class="stat-label mb-2">This Week</div>
@@ -15,7 +15,7 @@
       </div>
     </div>
   </div>
-  <div class="col-md-3">
+  <div class="col">
     <div class="card stat-card">
       <div class="card-body">
         <div class="stat-label mb-2">Unresolved</div>
@@ -23,7 +23,7 @@
       </div>
     </div>
   </div>
-  <div class="col-md-3">
+  <div class="col">
     <div class="card stat-card">
       <div class="card-body">
         <div class="stat-label mb-2">Resolved</div>
@@ -31,4 +31,12 @@
       </div>
     </div>
   </div>
+  <div class="col">
+    <div class="card stat-card">
+      <div class="card-body">
+        <div class="stat-label mb-2">Reopened</div>
+        <div class="stat-value text-warning"><%= stats[:reopened] %></div>
+      </div>
+    </div>
+  </div>
 </div>

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

@@ -1,7 +1,7 @@
 <% content_for :page_title, "Errors" %>
 
-<!-- Subscribe to Turbo Stream updates (only if ActionCable is available) -->
-<% if defined?(ActionCable) %>
+<!-- Subscribe to Turbo Stream updates (only if Turbo Streams is available) -->
+<% if defined?(Turbo::StreamsHelper) && defined?(ActionCable) && respond_to?(:turbo_stream_from) %>
   <%= turbo_stream_from "error_list" %>
 <% end %>
 
@@ -74,8 +74,8 @@
     </div>
   <% end %>
 
-  <!-- 7-Day Error Trend -->
-  <% if @stats[:errors_trend_7d]&.any? %>
+  <!-- 7-Day Error Trend (requires chartkick gem) -->
+  <% if @stats[:errors_trend_7d]&.any? && respond_to?(:line_chart) %>
     <div class="row g-4 mb-4">
       <div class="col-md-8">
         <div class="card">
@@ -186,9 +186,11 @@
       <!-- Quick Filter Buttons -->
       <div class="d-flex gap-2 mb-3">
         <%= link_to "All Errors", errors_path,
-            class: "btn btn-sm #{params[:assigned_to].blank? ? 'btn-primary' : 'btn-outline-primary'}" %>
+            class: "btn btn-sm #{params[:assigned_to].blank? && params[:reopened].blank? ? 'btn-primary' : 'btn-outline-primary'}" %>
         <%= link_to "Unassigned", errors_path(assigned_to: '__unassigned__'),
             class: "btn btn-sm #{params[:assigned_to] == '__unassigned__' ? 'btn-primary' : 'btn-outline-primary'}" %>
+        <%= link_to "Reopened", errors_path(reopened: 'true'),
+            class: "btn btn-sm #{params[:reopened] == 'true' ? 'btn-primary' : 'btn-outline-primary'}" %>
       </div>
 
       <%= form_with url: errors_path, method: :get, class: "row g-3", data: { turbo: false } do %>