rails_error_dashboard 0.15.0 → 0.16.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e4e3190d52a36d5c36abb07855ac5090194c0e7d3e426f38565724d60c4d54c2
-  data.tar.gz: 22c63cf4f49ee2f97b6898b3ab19e81bdf45f5c382a29c6c771c5d462d760dec
+  metadata.gz: 84ad49626b8dddc0665ed515f3fc8e3357adadddcb5991679324cffa40d2aa2e
+  data.tar.gz: af06a63fb80ded2960e23f6e6c25ace1a741b85e13f014ae4bfbfd4b4b16980a
 SHA512:
-  metadata.gz: fd736e679c40f293b58ad44b47f3215d001e45cd13c322d18f4033d178c8bc91242c018ccff8b676797d3282e1aa321e2ab15cc96050eabdd8bb3df42f6b7f63
-  data.tar.gz: '0696afc78d045942b741eaa166054455bd36b2962fb097cd67b7db8817c749243e3c70de3737c2e04aedd4b7cb52cd18ffb4d360a0b1d4805ff69e1ca4059716'
+  metadata.gz: c3154ebfa3b1d46d497a86cfca33dca5a09ed98127a699e7a9eb17ce3d05380f807172b377a2a824fbffff806e6f1e9a6c6ba96e8cb61802368e81ffc56ea93a
+  data.tar.gz: 571ca72a5e588371357a427c02a2ebed3bf565cf70f03b8c8e5877245e060bd7d8ddff873ae50235ac1c4103c6944d4f5e852c221766f7292225b4af8406ceca

data/README.md

@@ -394,7 +394,7 @@ config.git_repository_url = "https://github.com/user/repo"  # enables SHA links
 <details>
 <summary><strong>Source Code Integration + Git Blame</strong></summary>
 
-View actual source code directly in error backtraces with +/-7 lines of context. Git blame shows who last modified the code, when, and the commit message. Repository links jump to GitHub/GitLab/Bitbucket at the exact line.
+View actual source code directly in error backtraces, 5 lines before and after the error line by default. Git blame shows who last modified the code, when, and the commit message. Repository links jump to the exact line on GitHub, GitLab, Bitbucket or Codeberg.
 
 ```ruby
 config.enable_source_code_integration = true
@@ -577,14 +577,18 @@ config.enable_crash_capture = true
 <details>
 <summary><strong>Plugin System</strong></summary>
 
-Event-driven extensibility with hooks for `on_error_logged`, `on_error_resolved`, `on_threshold_exceeded`. Built-in examples for Jira integration, metrics tracking, and audit logging.
+Event-driven extensibility with hooks such as `on_error_logged`, `on_error_reopened` and `on_error_resolved` (eleven in all). Built-in examples for Jira integration, metrics tracking, and audit logging.
 
 ```ruby
 class MyPlugin < RailsErrorDashboard::Plugin
+  def name = "My Plugin"
+
   def on_error_logged(error_log)
     # Your custom logic
   end
 end
+
+RailsErrorDashboard.register_plugin(MyPlugin.new)
 ```
 
 [Plugin System guide →](docs/PLUGIN_SYSTEM.md)
@@ -786,7 +790,7 @@ Rails 7.0–8.1 and Ruby 3.2–4.0.
 ### Advanced
 - **[Multi-App Support](docs/MULTI_APP_PERFORMANCE.md)** — Track multiple applications
 - **[Plugin System](docs/PLUGIN_SYSTEM.md)** — Build custom integrations
-- **[API Reference](docs/API_REFERENCE.md)** — Complete API documentation
+- **[API Reference](docs/API_REFERENCE.md)** — The dashboard's HTTP routes and the Ruby API
 - **[Customization](docs/CUSTOMIZATION.md)** — Customize everything
 - **[Database Options](docs/guides/DATABASE_OPTIONS.md)** — Separate database setup
 - **[Database Optimization](docs/guides/DATABASE_OPTIMIZATION.md)** — Performance tuning

data/app/controllers/rails_error_dashboard/errors_controller.rb

@@ -119,6 +119,11 @@ module RailsErrorDashboard
       @related_errors = @error.related_errors(limit: 5, application_id: @current_application_id)
       @error_markdown = Services::MarkdownErrorFormatter.call(@error, related_errors: @related_errors)
 
+      # ?occurrence=ID: the context cards show that occurrence's stored context
+      @occurrence_context = find_occurrence_context(@error)
+      @snapshot = @occurrence_context ? ValueObjects::OccurrenceSnapshot.build(@error, @occurrence_context) : @error
+      @captured_occurrences = captured_occurrences(@error)
+
       # Fetch platform issue state and comments if linked
       @platform_issue = fetch_platform_issue(@error)
       @platform_comments = fetch_platform_comments(@error)
@@ -279,8 +284,6 @@ module RailsErrorDashboard
       @errors_by_hour = analytics[:errors_by_hour]
       @top_users = analytics[:top_users]
       @resolution_rate = analytics[:resolution_rate]
-      @mobile_errors = analytics[:mobile_errors]
-      @api_errors = analytics[:api_errors]
 
       # Get recurring issues data (pass application filter)
       recurring = Queries::RecurringIssues.call(days, application_id: @current_application_id)
@@ -901,6 +904,30 @@ module RailsErrorDashboard
       red_t("red.errors.row.status.#{status}", default: status.to_s.tr("_", " "))
     end
 
+    # Looked up through the error, so another error's occurrence id finds
+    # nothing. nil (the page shows the latest snapshot) when there is no id, it
+    # is foreign or unknown, or its context is no longer kept.
+    def find_occurrence_context(error)
+      return if params[:occurrence].blank?
+      # An app that updated the gem but has not migrated yet
+      return unless ErrorOccurrenceContext.table_exists?
+
+      error.occurrence_contexts.find_by(error_occurrence_id: params[:occurrence])
+    end
+
+    # This error's occurrences that still have a stored context, newest first.
+    # The context table is read for its occurrence ids only, so listing them
+    # never loads the stored payloads.
+    def captured_occurrences(error)
+      return [] unless ErrorOccurrenceContext.table_exists?
+
+      error.error_occurrences
+        .where(id: ErrorOccurrenceContext.where(error_log_id: error.id).select(:error_occurrence_id))
+        .order(occurred_at: :desc, id: :desc)
+        .select(:id, :occurred_at, :app_version, :git_sha)
+        .to_a
+    end
+
     def fetch_platform_issue(error)
       return nil unless error.external_issue_url.present? && error.external_issue_number.present?
       return nil unless RailsErrorDashboard.configuration.enable_issue_tracking

data/app/controllers/rails_error_dashboard/webhooks_controller.rb

@@ -14,7 +14,12 @@ module RailsErrorDashboard
   class WebhooksController < ActionController::Base
     skip_before_action :verify_authenticity_token
 
+    PROVIDERS = %w[github gitlab codeberg linear].freeze
+
     before_action :verify_webhook_enabled
+    # Before the signature check: an unknown provider is a wrong URL, and a 401
+    # would send the sender looking at a secret that is fine
+    before_action :verify_provider
     before_action :verify_signature
 
     def receive
@@ -32,9 +37,6 @@ module RailsErrorDashboard
         handle_codeberg(payload)
       when "linear"
         handle_linear(payload)
-      else
-        head :not_found
-        return
       end
 
       head :ok
@@ -52,16 +54,15 @@ module RailsErrorDashboard
       end
     end
 
+    def verify_provider
+      head :not_found unless PROVIDERS.include?(params[:provider])
+    end
+
     def verify_signature
       provider = params[:provider]
+      # Present: verify_webhook_enabled answers 404 without it
       secret = RailsErrorDashboard.configuration.issue_webhook_secret
 
-      unless secret.present?
-        Rails.logger.warn("[RailsErrorDashboard] Webhook received but no issue_webhook_secret configured")
-        head :unauthorized
-        return
-      end
-
       body = request.body.read
       request.body.rewind
 

data/app/helpers/rails_error_dashboard/backtrace_helper.rb

@@ -292,15 +292,19 @@ module RailsErrorDashboard
 
     # Determine which commit SHA to use based on strategy
     def determine_commit_sha(error_log)
-      strategy = RailsErrorDashboard.configuration.git_branch_strategy || :commit_sha
+      # A String (from ENV, say) means the same as the Symbol
+      strategy = (RailsErrorDashboard.configuration.git_branch_strategy || :commit_sha).to_s.to_sym
 
       case strategy
       when :commit_sha
         # Use the SHA from when the error occurred (most accurate)
         error_log.respond_to?(:git_sha) ? error_log.git_sha : nil
       when :current_branch
-        # Use current branch HEAD
-        get_current_git_sha
+        # The commit this process is running: config.git_sha, the deploy ENV
+        # variables, then the .git HEAD read once at boot. Never `git rev-parse`
+        # here: this renders on a host request thread, and a subprocess with
+        # no timeout is the pattern the capture path already removed.
+        Commands::LogError.capture_git_sha
       when :main
         # Use main/master branch
         nil # Will default to "main" in GithubLinkGenerator
@@ -308,16 +312,5 @@ module RailsErrorDashboard
         nil
       end
     end
-
-    # Get current git SHA from repository
-    def get_current_git_sha
-      return @current_git_sha if defined?(@current_git_sha)
-
-      @current_git_sha = begin
-        `git rev-parse HEAD 2>/dev/null`.strip.presence
-      rescue StandardError
-        nil
-      end
-    end
   end
 end

data/app/helpers/rails_error_dashboard/overview_helper.rb

@@ -67,6 +67,8 @@ module RailsErrorDashboard
         "success"
       when :warning
         "warning"
+      when :not_rated
+        "secondary"
       else
         "danger"
       end
@@ -82,6 +84,8 @@ module RailsErrorDashboard
         red_t("red.common.health_status.healthy")
       when :warning
         red_t("red.common.health_status.warning")
+      when :not_rated
+        red_t("red.common.health_status.not_rated")
       else
         red_t("red.common.health_status.critical")
       end

data/app/jobs/rails_error_dashboard/retention_cleanup_job.rb

@@ -44,6 +44,11 @@ module RailsErrorDashboard
     def self.delete_with_dependents(scope)
       ids = scope.select(:id)
 
+      # Each occurrence's stored context. Named here for the same reason as the
+      # event counts below: delete_all fires no :dependent callback.
+      if ErrorOccurrenceContext.table_exists?
+        ErrorOccurrenceContext.where(error_log_id: ids).in_batches(of: 1000).delete_all
+      end
       ErrorOccurrence.where(error_log_id: ids).in_batches(of: 1000).delete_all
       # Hour buckets for storm-shed events. Listed explicitly because delete_all
       # does not fire the has_many :dependent callback on ErrorLog -- without

data/app/models/rails_error_dashboard/error_log.rb

@@ -36,6 +36,8 @@ module RailsErrorDashboard
 
     # Association for tracking individual error occurrences
     has_many :error_occurrences, class_name: "RailsErrorDashboard::ErrorOccurrence", dependent: :destroy
+    # Deleted before the occurrences, without loading their payloads
+    has_many :occurrence_contexts, class_name: "RailsErrorDashboard::ErrorOccurrenceContext", dependent: :delete_all
 
     # Hour buckets for storm-shed events. delete_all, not destroy: these rows
     # are pure counters with no callbacks, and a group can own one per hour.
@@ -179,6 +181,14 @@ module RailsErrorDashboard
       Services::SeverityClassifier.critical?(error_type)
     end
 
+    # Whether the backtrace this row shows was sent by a client through
+    # ManualErrorReporter. Its frames describe code that ran on the client, so
+    # View Source, git blame and the Markdown formatter read no file for them.
+    # nil (a row from before the column, or an app not yet migrated) is server.
+    def client_backtrace?
+      has_attribute?(:backtrace_source) && backtrace_source == "client"
+    end
+
     # Check if error is recent (< 1 hour)
     def recent?
       occurred_at >= 1.hour.ago
@@ -339,14 +349,7 @@ module RailsErrorDashboard
         []
       end
 
-      lines.first(20).map do |line|
-        # Extract file path and method name, ignore line numbers
-        if line =~ %r{([^/]+\.rb):.*?in `(.+)'$}
-          "#{Regexp.last_match(1)}:#{Regexp.last_match(2)}"
-        elsif line =~ %r{([^/]+\.rb)}
-          Regexp.last_match(1)
-        end
-      end.compact.uniq
+      lines.first(20).map { |line| Services::BacktraceProcessor.frame_key(line) }.compact.uniq
     end
 
     # Calculate backtrace signature — delegates to Service

data/app/models/rails_error_dashboard/error_occurrence.rb

@@ -10,6 +10,7 @@ module RailsErrorDashboard
     self.table_name = "rails_error_dashboard_error_occurrences"
 
     belongs_to :error_log, class_name: "RailsErrorDashboard::ErrorLog"
+    has_one :context, class_name: "RailsErrorDashboard::ErrorOccurrenceContext", dependent: :delete
 
     # Only define user association if User model exists
     if defined?(::User)

data/app/models/rails_error_dashboard/error_occurrence_context.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module RailsErrorDashboard
+  # The moment-of-failure context of one occurrence: breadcrumbs, system
+  # health, local and instance variables, the same JSON strings the error row
+  # holds for its latest capture. Commands::RecordOccurrenceContext writes them
+  # and keeps the newest config.occurrence_context_limit per error.
+  class ErrorOccurrenceContext < ErrorLogsRecord
+    self.table_name = "rails_error_dashboard_error_occurrence_contexts"
+
+    belongs_to :error_occurrence, class_name: "RailsErrorDashboard::ErrorOccurrence"
+    belongs_to :error_log, class_name: "RailsErrorDashboard::ErrorLog"
+  end
+end

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

@@ -2514,7 +2514,9 @@ document.addEventListener('DOMContentLoaded', function() {
       case 'toggle-next':
         var nextEl = actionEl.nextElementSibling;
         if (nextEl) {
-          var isHidden = nextEl.style.display === 'none' || nextEl.style.display === '';
+          // The computed display: an open element usually has no inline display
+          // at all, and reading '' as hidden made the first click a no-op.
+          var isHidden = window.getComputedStyle(nextEl).display === 'none';
           nextEl.style.display = isHidden ? (actionEl.dataset.redDisplay || 'block') : 'none';
           var chev = actionEl.querySelector('.chev');
           if (chev) {

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

@@ -0,0 +1,45 @@
+      <!-- Captured occurrences: the ones whose context is still stored -->
+      <% if occurrences.any? %>
+        <div class="card mb-4" id="section-captured-occurrences">
+          <div class="card-header">
+            <h5 class="mb-0">
+              <i class="bi bi-camera"></i> <%= red_t("red.errors.captured_occurrences.title") %>
+            </h5>
+            <small class="text-muted"><%= red_t("red.errors.captured_occurrences.hint") %></small>
+          </div>
+          <div class="card-body p-0">
+            <div class="table-responsive">
+              <table class="table table-hover mb-0">
+                <thead class="table-light">
+                  <tr>
+                    <th><%= red_t("red.errors.captured_occurrences.column_occurrence") %></th>
+                    <th><%= red_t("red.errors.captured_occurrences.column_occurred_at") %></th>
+                    <th><%= red_t("red.errors.captured_occurrences.column_version") %></th>
+                    <th></th>
+                  </tr>
+                </thead>
+                <tbody>
+                  <% occurrences.each do |occurrence| %>
+                    <tr>
+                      <td>
+                        <code>#<%= occurrence.id %></code>
+                        <% if occurrence.id == current_id %>
+                          <span class="badge bg-info text-dark ms-1"><%= red_t("red.errors.captured_occurrences.viewing") %></span>
+                        <% end %>
+                      </td>
+                      <td><%= local_time(occurrence.occurred_at) %></td>
+                      <td>
+                        <% version = occurrence.app_version.presence || occurrence.git_sha.to_s.first(7).presence %>
+                        <small class="text-muted"><%= version || red_t("red.common.not_available") %></small>
+                      </td>
+                      <td class="text-end">
+                        <%= link_to red_t("red.errors.captured_occurrences.view"), error_path(error, occurrence: occurrence.id, **app_context), class: "btn btn-sm btn-outline-primary" %>
+                      </td>
+                    </tr>
+                  <% end %>
+                </tbody>
+              </table>
+            </div>
+          </div>
+        </div>
+      <% end %>

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

@@ -3,7 +3,7 @@
           would be served to every other one. %>
       <%# Plus the source-integration configuration and a TTL, and not at all
           while coverage is live: see BacktraceHelper#source_view_cache_key. %>
-      <% cache_if source_view_cacheable?, [error, 'error_details_v3', red_locale, source_view_cache_key], **source_view_cache_options do %>
+      <% cache_if source_view_cacheable?, [error, 'error_details_v3', red_locale, source_view_cache_key, error.client_backtrace?], **source_view_cache_options do %>
       <div class="card mb-4" id="section-error-info">
         <div class="card-header bg-danger text-white">
           <div class="d-flex justify-content-between align-items-center">
@@ -108,6 +108,8 @@
           <% if error.backtrace.present? %>
             <% frames = parse_backtrace(error.backtrace) %>
             <% app_frames = filter_app_code(frames) %>
+            <%# A client's frames describe code that ran on the client: no file is read for them %>
+            <% source_viewable = RailsErrorDashboard.configuration.enable_source_code_integration && !error.client_backtrace? %>
             <% framework_frames = filter_framework_code(frames) %>
 
             <% if app_frames.any? %>
@@ -122,6 +124,11 @@
                   </div>
                 </div>
                 <div class="card-body p-0">
+                  <% if RailsErrorDashboard.configuration.enable_source_code_integration && error.client_backtrace? %>
+                    <div class="alert alert-info m-3 mb-0" id="client-backtrace-note" style="font-size: 12px;">
+                      <i class="bi bi-phone"></i> <%= red_t("red.errors.info.backtrace.client_report_note") %>
+                    </div>
+                  <% end %>
                   <div class="code-block p-3" style="max-height: none; overflow-y: visible; overflow-x: auto;">
                     <% app_frames.each_with_index do |frame, index| %>
                       <div class="backtrace-frame-wrapper mb-2">
@@ -133,7 +140,7 @@
                               <%= frame_icon(frame[:category]) %> <%= frame[:short_path] %>:<%= frame[:line_number] %>
                             </span> in <span class="backtrace-method-name">`<%= frame[:method_name] %>'</span>
                           </div>
-                          <% if RailsErrorDashboard.configuration.enable_source_code_integration && frame[:category] == :app %>
+                          <% if source_viewable && frame[:category] == :app %>
                             <button class="btn btn-sm btn-outline-secondary" type="button"
                                     data-bs-toggle="collapse"
                                     data-bs-target="#source-code-<%= index %>"
@@ -145,7 +152,7 @@
                         </div>
 
                         <!-- Collapsible source code (only for app frames) -->
-                        <% if RailsErrorDashboard.configuration.enable_source_code_integration && frame[:category] == :app %>
+                        <% if source_viewable && frame[:category] == :app %>
                           <div class="collapse" id="source-code-<%= index %>">
                             <%= render "source_code", frame: frame, error: error, index: index %>
                           </div>

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

@@ -0,0 +1,12 @@
+<% if occurrence_context %>
+  <%# Only the context cards follow ?occurrence=; the rest of the page is the error row's latest capture %>
+  <div class="alert alert-info mb-3" id="occurrence-banner" style="display: flex; justify-content: space-between; align-items: center; gap: var(--space-3); padding: var(--space-3) var(--space-4);">
+    <div style="font-size: 12px;">
+      <i class="bi bi-clock-history"></i>
+      <strong><%= red_t("red.errors.show.occurrence.title", id: occurrence_context.error_occurrence_id) %></strong>
+      &middot; <%= local_time(occurrence_context.error_occurrence&.occurred_at || occurrence_context.created_at) %>
+      <div><%= red_t("red.errors.show.occurrence.body") %></div>
+    </div>
+    <%= link_to red_t("red.errors.show.occurrence.show_latest"), error_path(error, **app_context), class: "btn btn-sm" %>
+  </div>
+<% end %>

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

@@ -201,14 +201,17 @@
                     morphology applied to an identifier — it renders "iOS" as
                     "IOS" in some engines and mangles the Turkish dotless i. %>
                 <span style="font-size: 13px; font-weight: 600;"><%= platform %></span>
-                <span class="badge bg-<%= health_status_color(health[:health_status]) %>"><%= health_status_text(health[:health_status]) %></span>
-              </div>
-              <div style="margin-bottom: var(--space-2);">
-                <div style="font-size: 20px; font-weight: 700; font-variant-numeric: tabular-nums;"><%= red_t("red.errors.overview_page.stability_score_html", score: content_tag(:span, health[:stability_score])) %></div>
-              </div>
-              <div class="progress" style="height: 4px; margin-bottom: var(--space-3);">
-                <div class="progress-bar" style="width: <%= health[:stability_score] %>%; background: var(--status-<%= health[:health_status] == :healthy ? 'success' : health[:health_status] == :warning ? 'warning' : 'critical' %>);"></div>
+                <span class="badge bg-<%= health_status_color(health[:health_status]) %>"<% if health[:health_status] == :not_rated %> title="<%= red_t("red.common.health_status.not_rated_hint") %>"<% end %>><%= health_status_text(health[:health_status]) %></span>
               </div>
+              <%# A lone platform has no score: a rating compares platforms %>
+              <% if health[:stability_score] %>
+                <div style="margin-bottom: var(--space-2);">
+                  <div style="font-size: 20px; font-weight: 700; font-variant-numeric: tabular-nums;"><%= red_t("red.errors.overview_page.stability_score_html", score: content_tag(:span, health[:stability_score])) %></div>
+                </div>
+                <div class="progress" style="height: 4px; margin-bottom: var(--space-3);">
+                  <div class="progress-bar" style="width: <%= health[:stability_score] %>%; background: var(--status-<%= health[:health_status] == :healthy ? 'success' : health[:health_status] == :warning ? 'warning' : 'critical' %>);"></div>
+                </div>
+              <% end %>
               <div style="font-size: 12px; color: var(--text-tertiary);">
                 <%= red_t("red.errors.overview_page.platform_summary", total: health[:total_errors], critical: health[:critical_errors], unresolved: health[:unresolved_errors]) %>
               </div>

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

@@ -36,7 +36,7 @@
     <div class="row mb-4">
       <% @platform_health.each do |platform, health| %>
         <div class="col-md-6 col-lg-3 mb-3">
-          <div class="card h-100 <%= health[:health_status] == :healthy ? 'border-success' : health[:health_status] == :warning ? 'border-warning' : 'border-danger' %>">
+          <div class="card h-100 <%= { healthy: 'border-success', warning: 'border-warning', not_rated: 'border-secondary' }.fetch(health[:health_status], 'border-danger') %>">
             <div class="card-body">
               <h5 class="card-title text-capitalize">
                 <%= platform || red_t("red.common.unknown") %>
@@ -44,23 +44,28 @@
                   <span class="badge bg-success float-end"><%= red_t("red.analytics.platform_comparison.health_card.healthy") %></span>
                 <% elsif health[:health_status] == :warning %>
                   <span class="badge bg-warning float-end"><%= red_t("red.analytics.platform_comparison.health_card.warning") %></span>
+                <% elsif health[:health_status] == :not_rated %>
+                  <span class="badge bg-secondary float-end" title="<%= red_t("red.common.health_status.not_rated_hint") %>"><%= red_t("red.common.health_status.not_rated") %></span>
                 <% else %>
                   <span class="badge bg-danger float-end"><%= red_t("red.analytics.platform_comparison.health_card.critical") %></span>
                 <% end %>
               </h5>
 
-              <div class="mb-3">
-                <div class="d-flex justify-content-between align-items-center mb-1">
-                  <small class="text-muted"><%= red_t("red.analytics.platform_comparison.health_card.stability_score") %></small>
-                  <strong><%= health[:stability_score] %>/100</strong>
-                </div>
-                <div class="progress" style="height: 8px;">
-                  <div class="progress-bar <%= health[:stability_score] >= 80 ? 'bg-success' : health[:stability_score] >= 60 ? 'bg-warning' : 'bg-danger' %>"
-                       role="progressbar"
-                       style="width: <%= health[:stability_score] %>%">
+              <%# A lone platform has no score: a rating compares platforms %>
+              <% if health[:stability_score] %>
+                <div class="mb-3">
+                  <div class="d-flex justify-content-between align-items-center mb-1">
+                    <small class="text-muted"><%= red_t("red.analytics.platform_comparison.health_card.stability_score") %></small>
+                    <strong><%= health[:stability_score] %>/100</strong>
+                  </div>
+                  <div class="progress" style="height: 8px;">
+                    <div class="progress-bar <%= health[:stability_score] >= 80 ? 'bg-success' : health[:stability_score] >= 60 ? 'bg-warning' : 'bg-danger' %>"
+                         role="progressbar"
+                         style="width: <%= health[:stability_score] %>%">
+                    </div>
                   </div>
                 </div>
-              </div>
+              <% end %>
 
               <div class="small">
                 <div class="d-flex justify-content-between mb-1">

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

@@ -10,6 +10,7 @@
         enable_middleware: { type: :boolean },
         enable_error_subscriber: { type: :boolean },
         retention_days: { type: :retention_days },
+        occurrence_context_limit: { type: :integer, unit: :occurrences },
         max_backtrace_lines: { type: :integer, unit: :lines },
         sampling_rate: { type: :percentage }
       }
@@ -195,20 +196,20 @@
 
   <!-- Dynamically render setting groups -->
   <% setting_groups.each do |group_slug, group_config| %>
+    <%# One flag, or every flag in an array, must be on for a row to show. The
+        count and the rows both use this, so the count says what is shown. %>
+    <% shown_settings = group_config[:settings].select { |_key, meta| Array(meta[:show_if]).all? { |flag| @config.send(flag) } } %>
     <div class="card" style="margin-bottom: var(--space-4);">
       <button type="button" data-red-action="toggle-next" data-red-display="block" style="display: flex; align-items: center; justify-content: space-between; width: 100%; padding: var(--space-4) var(--space-6); background: none; border: none; cursor: pointer; border-bottom: 1px solid var(--border-primary);">
         <span style="font-size: 14px; font-weight: 600; color: var(--text-primary);"><i class="<%= group_config[:icon] %>" style="margin-right: 6px;"></i> <%= red_t("red.settings.groups.#{group_slug}") %></span>
         <div style="display: flex; align-items: center; gap: 8px;">
-          <span style="font-size: 11px; color: var(--text-tertiary);"><%= red_tp("red.settings.option_count", count: group_config[:settings].size) %></span>
+          <span style="font-size: 11px; color: var(--text-tertiary);"><%= red_tp("red.settings.option_count", count: shown_settings.size) %></span>
           <i class="bi bi-chevron-up chev" style="font-size: 12px; color: var(--text-tertiary);"></i>
         </div>
       </button>
       <div>
-        <% group_config[:settings].each do |setting_key, setting_meta| %>
+        <% shown_settings.each do |setting_key, setting_meta| %>
           <%
-            # One flag, or every flag in an array, must be on for the row to show.
-            should_show = Array(setting_meta[:show_if]).all? { |flag| @config.send(flag) }
-            next unless should_show
             value = @config.send(setting_meta[:method] || setting_key)
             # A credential is shown as Set / Not set whatever shape it has. The
             # per-row :type documents the value's shape; this one rule is what

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

@@ -98,6 +98,8 @@
     </div>
   </div>
 
+  <%= render "occurrence_banner", error: @error, occurrence_context: @occurrence_context %>
+
   <!-- Main content: tabs + sidebar -->
   <div class="red-detail-grid">
     <!-- Left: tabbed content -->
@@ -142,18 +144,19 @@
         <% end %>
 
         <%= render "error_info", error: @error %>
-        <%= render "local_variables", error: @error %>
-        <%= render "instance_variables", error: @error %>
+        <%= render "local_variables", error: @snapshot %>
+        <%= render "instance_variables", error: @snapshot %>
       </div>
 
       <!-- Tab: Context -->
       <div id="panel-context">
         <%= render "request_context", error: @error %>
-        <%= render "breadcrumbs_group", error: @error %>
+        <%= render "breadcrumbs_group", error: @snapshot %>
       </div>
 
       <!-- Tab: History -->
       <div id="panel-history">
+        <%= render "captured_occurrences", error: @error, occurrences: @captured_occurrences, current_id: @occurrence_context&.error_occurrence_id %>
         <%= render "timeline" %>
         <% unless RailsErrorDashboard.configuration.enable_issue_tracking %>
           <%= render "discussion", error: @error %>
@@ -175,7 +178,7 @@
 
     <!-- Right: sidebar -->
     <div class="error-sidebar" style="display: flex; flex-direction: column; gap: var(--space-4); min-width: 0; overflow-wrap: break-word;">
-      <%= render "sidebar_metadata", error: @error, related_errors: @related_errors %>
+      <%= render "sidebar_metadata", error: @snapshot, related_errors: @related_errors %>
 
       <%= render "llm_summary", error: @error %>
 

data/config/locales/de.yml

@@ -36,6 +36,8 @@ de:
         healthy: "✅ Fehlerfrei"
         warning: "⚠️ Warnung"
         critical: "\U0001F534 Kritisch"
+        not_rated: "Nicht bewertet"
+        not_rated_hint: "Eine Bewertung vergleicht Plattformen und braucht daher Fehler auf mindestens zwei."
       device_type:
         mobile: Mobil
         tablet: Tablet
@@ -242,6 +244,10 @@ de:
           inactive_body: aktivieren, um ausgeführte Zeilen zu sehen
           enable: Aktivieren
           disable: Deaktivieren
+        occurrence:
+          title: "Vorkommen #%{id}"
+          body: "Breadcrumbs, Systemzustand und Variablen stammen aus diesem Vorkommen. Alles andere zeigt die neueste Erfassung."
+          show_latest: "Neueste anzeigen"
         baselines:
           title: Referenzstatistiken
           anomaly_label: 'Anomalie:'
@@ -497,6 +503,14 @@ de:
           one: "+%{count} weiterer"
           other: "+%{count} weitere"
         view_errors: Fehler ansehen
+      captured_occurrences:
+        title: "Erfasste Vorkommen"
+        hint: "Breadcrumbs, Systemzustand und Variablen werden für die neuesten Vorkommen aufbewahrt (occurrence_context_limit). Öffnen Sie eines, um sie zu sehen."
+        column_occurrence: "Vorkommen"
+        column_occurred_at: "Aufgetreten"
+        column_version: "Version"
+        view: "Anzeigen"
+        viewing: "Angezeigt"
       co_occurring:
         title: Gemeinsam auftretende Fehler
         badge: Zeitliche Muster
@@ -741,6 +755,7 @@ de:
             other: "%{count} Frames"
           click_to_expand: "(zum Aufklappen klicken)"
           view_source: Quellcode ansehen
+          client_report_note: "Diese Frames stammen aus einem Client-Bericht (ManualErrorReporter). Sie beschreiben Code, der auf dem Client lief, daher öffnet RED für sie keine Quelldatei, zeigt keinen Ausschnitt und führt kein git blame aus."
           none: Kein Backtrace verfügbar
       row:
         new_badge: NEU
@@ -1101,6 +1116,9 @@ de:
         events:
           one: "%{count} Ereignis"
           other: "%{count} Ereignisse"
+        occurrences:
+          one: "%{count} Vorkommen"
+          other: "%{count} Vorkommen"
         queries:
           one: "%{count} Abfrage"
           other: "%{count} Abfragen"
@@ -1145,6 +1163,7 @@ de:
         enable_middleware: Fängt unbehandelte Exceptions ab
         enable_error_subscriber: Abonniert Rails-Fehlerereignisse
         retention_days: "Fehler löschen, die so viele Tage nicht mehr aufgetreten sind. Durchgesetzt vom RetentionCleanupJob, den das Gem selbst nicht einplant"
+        occurrence_context_limit: "Für wie viele der neuesten Vorkommen je Fehler Breadcrumbs, Systemzustand und Variablen aufbewahrt werden (0 = aus)"
         max_backtrace_lines: Maximale Backtrace-Tiefe
         sampling_rate: Anteil der erfassten Fehler
         application_name: Name dieser Anwendung (wird automatisch erkannt, wenn nicht