rails_error_dashboard 0.4.0 → 0.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a69809a78e932510ab0212e0abd6021c925a28a7c5d80d69942ef1c80a7476db
-  data.tar.gz: 4e62ac66ce28cd4a3c34ac4df4ac682a42656fe157b7918d044fddd3a9779f4e
+  metadata.gz: af7cf1b00931ba21cc10e507128ce90183cd2c0c707e47b16c2833ada7108fa7
+  data.tar.gz: e59567ed413e58003c45336006239562eeffdfd11330515a1faef711b7143f46
 SHA512:
-  metadata.gz: a99bb20a9479fe2669426f6798ff368812834084a6c02a2db9739789a7b5a5a724bb08916e3891ee23a1de2d3df5539aed43f64e2791d4275c62de6c364ea5b9
-  data.tar.gz: cb6a155bf3d4a62c21f51d7a7f878d5f5676947fcd441bfda08f36877e37e795093dc756f13d4318b8dcb4cc2ecacfac1e2cfcdcaf1df86481ed5f3fd9f70578
+  metadata.gz: 7446d9a051e2fa804b5090294217c0a678123fd8b1eb8720fff4b5ef8bf0bde48f87245333119b9b1c4101e036f3665b85b33b867ba8b2666182d6e2f7768cd7
+  data.tar.gz: 9b7d7140f5acebbc5c15c218716a81e03309e7590880b9648e5ac9b35276ecccd210fbfbc4837ae8bd88a75f936b12873f81f170b9c85b9da8997d5641602126

data/README.md

@@ -22,7 +22,7 @@ gem 'rails_error_dashboard'
 
 **[rails-error-dashboard.anjan.dev](https://rails-error-dashboard.anjan.dev)** — Username: `gandalf` · Password: `youshallnotpass`
 
-> **Beta Software** — Functional and tested (2,100+ tests passing), but the API may change before v1.0. Supports Rails 7.0-8.1 and Ruby 3.2-4.0.
+> **Beta Software** — Functional and tested (2,600+ tests passing), but the API may change before v1.0. Supports Rails 7.0-8.1 and Ruby 3.2-4.0.
 
 ### Screenshots
 
@@ -53,6 +53,8 @@ gem 'rails_error_dashboard'
 | SaaS pricing tiers and usage limits | Unlimited errors, unlimited projects |
 | Vendor lock-in with proprietary APIs | 100% open source, fully portable |
 | Complex SDK setup and external services | 5-minute Rails Engine installation |
+| Pay extra for local variable capture (Sentry) | Local + instance variables included free |
+| No tool detects silently rescued exceptions | Swallowed exception detection built in |
 
 ---
 
@@ -85,10 +87,12 @@ config.enable_breadcrumbs = true
 <details>
 <summary><strong>System Health Snapshot</strong></summary>
 
-Know your app's runtime state at the moment of failure — GC stats, process memory, thread count, connection pool utilization, and Puma thread stats captured automatically.
+Know your app's runtime state at the moment of failure — GC stats, process memory, thread count, connection pool utilization, Puma thread stats, RubyVM cache health, and YJIT compilation stats captured automatically.
 
 - Sub-millisecond total snapshot, every metric individually rescue-wrapped
 - No ObjectSpace scanning, no Thread backtraces, no subprocess calls
+- RubyVM.stat: constant cache invalidations, shape cache stats
+- YJIT runtime stats: compiled iseqs, invalidation count, code region sizes
 
 ```ruby
 config.enable_system_health = true
@@ -181,6 +185,98 @@ Seven analysis engines built in:
 [Complete documentation →](docs/FEATURES.md#advanced-analytics-features)
 </details>
 
+<details>
+<summary><strong>Local Variable + Instance Variable Capture</strong></summary>
+
+See the exact values of local variables and instance variables at the moment an exception was raised — the most valuable debugging context possible.
+
+- TracePoint(`:raise`) captures locals and ivars before the stack unwinds
+- Configurable limits: max variable count, nesting depth, string truncation length
+- Sensitive data auto-filtered via Rails `filter_parameters` — passwords, tokens, and PII never stored
+- Never stores Binding objects — values extracted immediately, Binding is GC'd
+- Independent config flags: enable one or both
+
+![Local Variables](docs/images/local-variables.png)
+
+```ruby
+config.enable_local_variables = true
+config.enable_instance_variables = true
+```
+
+[Complete documentation →](docs/FEATURES.md)
+</details>
+
+<details>
+<summary><strong>Swallowed Exception Detection</strong></summary>
+
+Detect exceptions that are raised but silently rescued — the hardest bugs to find. No other error tracker does this.
+
+- Uses TracePoint(`:raise`) + TracePoint(`:rescue`) to track exception lifecycle
+- Identifies code paths where exceptions are caught but never logged or re-raised
+- Dashboard page at `/errors/swallowed_exceptions` shows detection counts, locations, and patterns
+- Memory-bounded aggregation with background flush
+- Requires Ruby 3.3+
+
+![Swallowed Exceptions](docs/images/swallowed-exceptions.png)
+
+```ruby
+config.detect_swallowed_exceptions = true
+```
+
+[Complete documentation →](docs/FEATURES.md)
+</details>
+
+<details>
+<summary><strong>On-Demand Diagnostic Dump</strong></summary>
+
+Snapshot your app's entire system state on demand — environment, GC stats, threads, connection pool, memory, job queue health, and more.
+
+- Trigger via dashboard button or `rake rails_error_dashboard:diagnostic_dump`
+- Dashboard page at `/errors/diagnostic_dumps` with full history
+- Useful for debugging intermittent production issues without reproducing them
+
+![Diagnostic Dumps](docs/images/diagnostic-dumps.png)
+
+```ruby
+config.enable_diagnostic_dump = true
+```
+
+[Complete documentation →](docs/FEATURES.md)
+</details>
+
+<details>
+<summary><strong>Rack Attack Event Tracking</strong></summary>
+
+Track Rack Attack security events (throttles, blocklists, tracks) as breadcrumbs attached to errors, with a dedicated summary page.
+
+- Captures throttle, blocklist, and track events automatically
+- Dashboard page at `/errors/rack_attack_summary` with event breakdown
+- Requires breadcrumbs to be enabled
+
+```ruby
+config.enable_rack_attack_tracking = true
+```
+
+[Complete documentation →](docs/FEATURES.md)
+</details>
+
+<details>
+<summary><strong>Process Crash Capture</strong></summary>
+
+Capture unhandled exceptions that crash the Ruby process via an `at_exit` hook — the last line of defense.
+
+- Disk-based fallback: writes crash data to disk because the database may be unavailable during shutdown
+- Imported automatically on next boot
+- Captures exception details, backtrace, uptime, GC stats, thread count, and cause chain
+- A self-hosted only feature — impossible for SaaS tools
+
+```ruby
+config.enable_crash_capture = true
+```
+
+[Complete documentation →](docs/FEATURES.md)
+</details>
+
 <details>
 <summary><strong>Plugin System</strong></summary>
 
@@ -304,7 +400,7 @@ Built with **CQRS (Command/Query Responsibility Segregation)**:
 
 ## Testing
 
-2,100+ tests covering unit, integration, and browser-based system tests.
+2,600+ tests covering unit, integration, and browser-based system tests.
 
 ```bash
 bundle exec rspec                              # Full suite
@@ -344,7 +440,7 @@ Built with [Rails](https://rubyonrails.org/) · UI by [Bootstrap 5](https://getb
 
 [![Contributors](https://contrib.rocks/image?repo=AnjanJ/rails_error_dashboard)](https://github.com/AnjanJ/rails_error_dashboard/graphs/contributors)
 
-Special thanks to [@bonniesimon](https://github.com/bonniesimon), [@gundestrup](https://github.com/gundestrup), and [@midwire](https://github.com/midwire). See [CONTRIBUTORS.md](CONTRIBUTORS.md) for the full list.
+Special thanks to [@bonniesimon](https://github.com/bonniesimon), [@gundestrup](https://github.com/gundestrup), [@midwire](https://github.com/midwire), and [@RafaelTurtle](https://github.com/RafaelTurtle). See [CONTRIBUTORS.md](CONTRIBUTORS.md) for the full list.
 
 ---
 

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/lib/rails_error_dashboard/services/system_health_snapshot.rb

@@ -34,6 +34,8 @@ module RailsErrorDashboard
           connection_pool: connection_pool_stats,
           puma: puma_stats,
           job_queue: job_queue_stats,
+          ruby_vm: ruby_vm_stats,
+          yjit: yjit_stats,
           captured_at: Time.current.iso8601
         }
       end
@@ -140,6 +142,37 @@ module RailsErrorDashboard
       rescue => e
         nil
       end
+
+      # RubyVM.stat — constant/method cache invalidation rates
+      # Keys vary by Ruby version; pass through full hash for forward-compat
+      # Ruby 3.2+: constant_cache_invalidations, constant_cache_misses,
+      #            global_cvar_state, next_shape_id, shape_cache_size
+      def ruby_vm_stats
+        return nil unless defined?(RubyVM) && RubyVM.respond_to?(:stat)
+        RubyVM.stat
+      rescue => e
+        nil
+      end
+
+      # RubyVM::YJIT.runtime_stats — JIT compilation health
+      # Cherry-picks diagnostic keys (full hash has 30+ entries)
+      def yjit_stats
+        return nil unless defined?(RubyVM::YJIT) && RubyVM::YJIT.respond_to?(:enabled?) && RubyVM::YJIT.enabled?
+        raw = RubyVM::YJIT.runtime_stats
+        {
+          inline_code_size: raw[:inline_code_size],
+          code_region_size: raw[:code_region_size],
+          compiled_iseq_count: raw[:compiled_iseq_count],
+          compiled_block_count: raw[:compiled_block_count],
+          compile_time_ns: raw[:compile_time_ns],
+          invalidation_count: raw[:invalidation_count],
+          invalidate_method_lookup: raw[:invalidate_method_lookup],
+          invalidate_constant_state_bump: raw[:invalidate_constant_state_bump],
+          object_shape_count: raw[:object_shape_count]
+        }
+      rescue => e
+        nil
+      end
     end
   end
 end

data/lib/rails_error_dashboard/version.rb

@@ -1,3 +1,3 @@
 module RailsErrorDashboard
-  VERSION = "0.4.0"
+  VERSION = "0.4.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails_error_dashboard
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.1
 platform: ruby
 authors:
 - Anjan Jagirdar
@@ -457,7 +457,7 @@ metadata:
   bug_tracker_uri: https://github.com/AnjanJ/rails_error_dashboard/issues
   funding_uri: https://buymeacoffee.com/anjanj
 post_install_message: "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n
-  \ Rails Error Dashboard v0.4.0\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n\U0001F195
+  \ Rails Error Dashboard v0.4.1\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n\U0001F195
   First time? Quick start:\n   rails generate rails_error_dashboard:install\n   rails
   db:migrate\n   # Add to config/routes.rb:\n   mount RailsErrorDashboard::Engine
   => '/error_dashboard'\n\n\U0001F504 Upgrading from v0.1.x?\n   rails db:migrate\n