rails_orbit 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 324f351194399de6bab396eda353654d014715422f8dd0b552d9a2df150240f8
-  data.tar.gz: 26243ec5f12b9425e94ba3201685ecc3d554af0b5e617b67927f49362bb6c3b1
+  metadata.gz: f45fb851da082bb63b955526d1adf53dacbbc76938550fb52bf38fb0b7a328b5
+  data.tar.gz: 91a250041985e6af4d89e92dbad0597536c3889e33c074ee19082e7cb6bac950
 SHA512:
-  metadata.gz: 869988c024f9969d5d24019062d54670a2dc4d6b4c0c1e3bc1e8248defabf6423dd23226467ab8bcb7f020398c9f829d85802b77c5435616115d94ffdb1b0271
-  data.tar.gz: 20cc91a576016168bbd8f66a2eadee06beb2c3940dd5ee6e30b158b2b52f3f74605c7f444960ce095e27e420ffd36ddb2eaf3f3db6495a41301a99b888fb0499
+  metadata.gz: 5c4df5011c201fc5f641199f5a752d8ab93e340bafc59daa5b20273660ec041f17083dcb9d1b788397ed4803ccd47f00b5ff8ca39208a9443d044c683f3173f8
+  data.tar.gz: e2a4ec065bc47db14bfecdcf757c89ff243cefc1b5a3a3a8b1ab9f4d80f20496c7792a858189d519b95812c02872d7a761f71580e644c3c653036297ff3c6cc7

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.2.0] - 2026-06-10
+
+- Errors page now shows the `file:line in method` where each exception originated, taken from the first application frame of its most recent occurrence
+- Errors page now shows an expandable full backtrace with application frames highlighted and gem frames shortened
+- Dashboard CSS/JS asset URLs are versioned so browsers fetch fresh assets after an upgrade instead of serving a stale cached copy
+- Dashboard icons now carry intrinsic dimensions so they stay correctly sized even if the stylesheet loads late
+
 ## [0.1.0] - 2026-03-24
 
 - Initial release

data/README.md

@@ -52,6 +52,12 @@ export ORBIT_PASSWORD=secret
 
 Visit `/orbit` in your browser. That is it.
 
+### Screenshot
+
+Overview with the range picker and interactive charts (example from a demo workload):
+
+![Orbit dashboard overview: jobs, cache, errors, time range, and charts](docs/images/demo_dashboard.png)
+
 ### Useful Commands
 
 ```bash
@@ -103,6 +109,8 @@ Exceptions grouped by class for faster triage:
 
 - Each exception class shows occurrence count and "last seen" time
 - Up to 5 recent messages displayed per group
+- **Error location** — the exact `file:line in method` where each exception originated, taken from the first application frame of its most recent occurrence
+- **Full traceback** — expand any error to see the complete backtrace, with application frames highlighted and gem frames de-emphasized and shortened
 - Resolved status shown if solid_errors supports it
 - Scoped to the selected date range
 

data/app/assets/stylesheets/rails_orbit/application.css

@@ -467,6 +467,69 @@
   color: var(--orbit-text-muted);
 }
 
+/* ── Error message, location & traceback ─────────────────── */
+.orbit-error__message {
+  color: var(--orbit-text);
+  word-break: break-word;
+}
+.orbit-error__location {
+  display: flex;
+  align-items: center;
+  gap: 0.35rem;
+  margin-top: 0.3rem;
+  font-family: var(--orbit-mono);
+  font-size: 0.72rem;
+  color: var(--orbit-text-muted);
+  word-break: break-all;
+}
+.orbit-error__location-icon {
+  width: 0.72rem;
+  height: 0.72rem;
+  flex-shrink: 0;
+  color: var(--orbit-text-muted);
+}
+.orbit-error__path { color: var(--orbit-primary); }
+.orbit-error__line { color: var(--orbit-warning); font-weight: 600; }
+.orbit-error__method { color: var(--orbit-text-muted); }
+
+.orbit-trace {
+  margin-top: 0.4rem;
+}
+.orbit-trace__summary {
+  display: inline-block;
+  cursor: pointer;
+  font-size: 0.68rem;
+  color: var(--orbit-text-muted);
+  user-select: none;
+  padding: 0.1rem 0;
+}
+.orbit-trace__summary:hover { color: var(--orbit-text); }
+.orbit-trace__frames {
+  list-style: none;
+  margin: 0.4rem 0 0;
+  padding: 0.5rem 0.75rem;
+  background: var(--orbit-surface);
+  border: 1px solid var(--orbit-border);
+  border-radius: var(--orbit-radius);
+  max-height: 18rem;
+  overflow: auto;
+}
+.orbit-trace__frame {
+  font-family: var(--orbit-mono);
+  font-size: 0.7rem;
+  line-height: 1.7;
+  color: var(--orbit-text-muted);
+  word-break: break-all;
+  opacity: 0.65;
+}
+.orbit-trace__frame--app {
+  color: var(--orbit-text);
+  opacity: 1;
+}
+.orbit-trace__frame--app .orbit-trace__file { color: var(--orbit-primary); }
+.orbit-trace__line { color: var(--orbit-warning); }
+.orbit-trace__method { color: var(--orbit-text-muted); }
+
 /* ── Empty state ─────────────────────────────────────────── */
 .orbit-empty {
   text-align: center;

data/app/controllers/rails_orbit/dashboard_controller.rb

@@ -1,5 +1,7 @@
 module RailsOrbit
   class DashboardController < ApplicationController
+    MAX_ERRORS_PER_GROUP = 5
+
     before_action :set_time_range
 
     def overview
@@ -57,25 +59,61 @@ module RailsOrbit
     end
 
     def errors
-      if defined?(SolidErrors)
-        all_errors = SolidErrors::Error.where(created_at: @time_range.since..).order(created_at: :desc).limit(200)
-        @grouped_errors = all_errors.group_by(&:exception_class).map do |klass, records|
-          {
-            exception_class: klass,
-            count:           records.size,
-            last_seen:       records.first.created_at,
-            resolved:        records.first.respond_to?(:resolved_at) && records.first.resolved_at.present?,
-            records:         records.first(5),
-          }
-        end.sort_by { |g| -g[:count] }
-      else
+      unless defined?(SolidErrors)
         @grouped_errors = []
         flash.now[:warning] = "solid_errors is not installed or not configured."
+        return
       end
+
+      all_errors = SolidErrors::Error
+        .where(created_at: @time_range.since..)
+        .order(created_at: :desc)
+        .limit(200)
+        .to_a
+
+      groups    = all_errors.group_by(&:exception_class)
+      displayed = groups.values.flat_map { |records| records.first(MAX_ERRORS_PER_GROUP) }
+      traces    = backtraces_for(displayed)
+
+      @grouped_errors = groups.map do |klass, records|
+        {
+          exception_class: klass,
+          count:           records.size,
+          last_seen:       records.first.created_at,
+          resolved:        records.first.respond_to?(:resolved_at) && records.first.resolved_at.present?,
+          records:         records.first(MAX_ERRORS_PER_GROUP).map { |error| present_error(error, traces[error.id]) },
+        }
+      end.sort_by { |g| -g[:count] }
     end
 
     private
 
+    def present_error(error, backtrace)
+      {
+        message:    error.message,
+        created_at: error.created_at,
+        location:   backtrace&.top_location,
+        frames:     backtrace&.frames || [],
+      }
+    end
+
+    # Parses the latest occurrence's backtrace for each displayed error, keyed
+    # by error id. Done in two bounded queries (one row per error) to avoid an
+    # N+1, and degrades gracefully if this solid_errors version has no
+    # occurrences table.
+    def backtraces_for(errors)
+      return {} if errors.empty? || !defined?(SolidErrors::Occurrence)
+
+      ids        = errors.map(&:id)
+      latest_ids = SolidErrors::Occurrence.where(error_id: ids).group(:error_id).maximum(:id).values
+      return {} if latest_ids.empty?
+
+      SolidErrors::Occurrence
+        .where(id: latest_ids)
+        .pluck(:error_id, :backtrace)
+        .to_h { |error_id, raw| [error_id, RailsOrbit::Backtrace.parse(raw)] }
+    end
+
     def set_time_range
       @time_range = TimeRange.new(params[:range])
       @range_key  = @time_range.key

data/app/helpers/rails_orbit/icon_helper.rb

@@ -8,6 +8,7 @@ module RailsOrbit
       orbit:     '<svg class="orbit-nav__logo" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="12" cy="12" r="3"/><circle cx="12" cy="12" r="8" stroke-dasharray="4 3"/></svg>',
       delta_up:  '<svg class="orbit-delta__icon" viewBox="0 0 12 12" fill="currentColor"><path d="M6 2L10 7H2z"/></svg>',
       delta_down:'<svg class="orbit-delta__icon" viewBox="0 0 12 12" fill="currentColor"><path d="M6 10L2 5h8z"/></svg>',
+      file:      '<svg class="%{css_class}" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><polyline points="14 2 14 8 20 8"/></svg>',
     }.freeze
 
     def orbit_icon(name, css_class: "orbit-icon")

data/app/views/layouts/rails_orbit/application.html.erb

@@ -4,8 +4,8 @@
     <meta charset="utf-8">
     <meta name="viewport" content="width=device-width, initial-scale=1">
     <title><%= RailsOrbit.configuration.dashboard_title %></title>
-    <%= stylesheet_link_tag "/assets/rails_orbit/application.css", media: "all" %>
-    <%= javascript_include_tag "/assets/rails_orbit/application.js", defer: true %>
+    <%= stylesheet_link_tag "/assets/rails_orbit/application.css?v=#{RailsOrbit::VERSION}", media: "all" %>
+    <%= javascript_include_tag "/assets/rails_orbit/application.js?v=#{RailsOrbit::VERSION}", defer: true %>
     <%= csrf_meta_tags %>
   </head>
   <body class="orbit-body">

data/app/views/rails_orbit/dashboard/errors.html.erb

@@ -24,15 +24,47 @@
           <table class="orbit-table orbit-table--compact">
             <thead>
               <tr>
-                <th>Message</th>
+                <th>Message &amp; Location</th>
                 <th class="orbit-table__right">Occurred At</th>
               </tr>
             </thead>
             <tbody>
               <% group[:records].each do |error| %>
                 <tr>
-                  <td><%= truncate(error.message, length: 140) %></td>
-                  <td class="orbit-table__right orbit-table__mono"><%= error.created_at.strftime("%b %d %H:%M:%S") %></td>
+                  <td>
+                    <div class="orbit-error__message"><%= truncate(error[:message], length: 140) %></div>
+
+                    <% if (loc = error[:location]) %>
+                      <div class="orbit-error__location" title="<%= loc.to_s %>">
+                        <%= orbit_icon(:file, css_class: "orbit-error__location-icon") %>
+                        <% if loc.parsed? %>
+                          <span class="orbit-error__path"><%= loc.display_path %></span><span class="orbit-error__line">:<%= loc.line %></span><% if loc.method_name %>
+                            <span class="orbit-error__method">in <%= loc.method_name %></span><% end %>
+                        <% else %>
+                          <span class="orbit-error__path"><%= loc.raw %></span>
+                        <% end %>
+                      </div>
+                    <% end %>
+
+                    <% if error[:frames].any? %>
+                      <details class="orbit-trace">
+                        <summary class="orbit-trace__summary"><%= pluralize(error[:frames].size, "frame") %> · view traceback</summary>
+                        <ol class="orbit-trace__frames">
+                          <% error[:frames].each do |frame| %>
+                            <li class="orbit-trace__frame<%= " orbit-trace__frame--app" if frame.application? %>">
+                              <% if frame.parsed? %>
+                                <span class="orbit-trace__file"><%= frame.display_path %></span><span class="orbit-trace__line">:<%= frame.line %></span><% if frame.method_name %>
+                                  <span class="orbit-trace__method">in <%= frame.method_name %></span><% end %>
+                              <% else %>
+                                <span class="orbit-trace__file"><%= frame.raw %></span>
+                              <% end %>
+                            </li>
+                          <% end %>
+                        </ol>
+                      </details>
+                    <% end %>
+                  </td>
+                  <td class="orbit-table__right orbit-table__mono"><%= error[:created_at].strftime("%b %d %H:%M:%S") %></td>
                 </tr>
               <% end %>
             </tbody>

data/lib/rails_orbit/backtrace.rb

@@ -0,0 +1,122 @@
+module RailsOrbit
+  # Parses a raw exception backtrace (the newline-joined Ruby backtrace that
+  # solid_errors stores on each occurrence) into structured frames, flagging
+  # which frames belong to the host application versus third-party gems.
+  #
+  # It reads no source files — only file, line, and method are extracted — so
+  # the dashboard stays fast and works even when the rendering server does not
+  # have the source on disk. It also depends only on the raw text, never on
+  # solid_errors' own Backtrace/BacktraceLine classes, so it is unaffected by
+  # internal changes in that gem.
+  class Backtrace
+    # Matches "path/to/file.rb:42:in `method'" or ":in 'method'" (Ruby 3.4+),
+    # with the method portion optional. A leading "X:" Windows drive is allowed.
+    LINE_FORMAT = /\A((?:[A-Za-z]:)?[^:]+):(\d+)(?::in [`']([^']+)')?\z/
+
+    # A single backtrace frame. `parsed?` is false for lines we could not parse
+    # (kept verbatim in `raw` so nothing is silently dropped).
+    Frame = Struct.new(:file, :line, :method_name, :application, :raw, keyword_init: true) do
+      def application?
+        application
+      end
+
+      def parsed?
+        !file.nil?
+      end
+
+      def display_path
+        return raw unless parsed?
+
+        application ? Backtrace.relative_to_app(file) : Backtrace.shorten_gem(file)
+      end
+
+      def to_s
+        return raw unless parsed?
+
+        suffix = method_name ? " in #{method_name}" : ""
+        "#{display_path}:#{line}#{suffix}"
+      end
+    end
+
+    def self.parse(raw)
+      frames = String(raw).split("\n").filter_map { |line| parse_line(line) }
+      new(frames)
+    end
+
+    def self.parse_line(line)
+      stripped = line.to_s.strip
+      return nil if stripped.empty?
+
+      if (match = stripped.match(LINE_FORMAT))
+        file = match[1]
+        Frame.new(
+          file: file,
+          line: match[2].to_i,
+          method_name: match[3],
+          application: application_file?(file),
+          raw: stripped
+        )
+      else
+        Frame.new(file: nil, line: nil, method_name: nil, application: false, raw: stripped)
+      end
+    end
+
+    # A frame is "application" code when it lives under the app root but not in
+    # vendored gems. Gem frames and stdlib frames are not application frames.
+    def self.application_file?(file)
+      root = app_root
+      return false unless root && file.start_with?(root)
+
+      !file.start_with?(File.join(root, "vendor"))
+    end
+
+    def self.relative_to_app(file)
+      root = app_root
+      return file unless root && file.start_with?(root)
+
+      file.sub(/\A#{Regexp.escape(root)}\/?/, "")
+    end
+
+    # Trims the gem install prefix so "/.../gems/foo-1.0/lib/x.rb" reads as
+    # "foo-1.0/lib/x.rb". Falls back to the full path if no prefix matches.
+    def self.shorten_gem(file)
+      gem_paths.each do |path|
+        return file.sub(/\A#{Regexp.escape(path)}\/?(?:gems\/)?/, "") if file.start_with?(path)
+      end
+      file
+    end
+
+    def self.app_root
+      return unless defined?(Rails) && Rails.respond_to?(:root) && Rails.root
+
+      Rails.root.to_s
+    end
+
+    def self.gem_paths
+      return [] unless defined?(Gem)
+
+      Gem.path.map(&:to_s)
+    end
+
+    attr_reader :frames
+
+    def initialize(frames)
+      @frames = frames
+    end
+
+    def application_frames
+      @application_frames ||= frames.select(&:application?)
+    end
+
+    # The most relevant "where did this happen" frame: the first application
+    # frame, or the first parseable frame if the trace is entirely framework/gem
+    # code, or nil when there is nothing usable.
+    def top_location
+      application_frames.first || frames.find(&:parsed?)
+    end
+
+    def empty?
+      frames.empty?
+    end
+  end
+end

data/lib/rails_orbit/version.rb

@@ -1,3 +1,3 @@
 module RailsOrbit
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/rails_orbit.rb

@@ -1,6 +1,7 @@
 require "rails_orbit/version"
 require "rails_orbit/configuration"
 require "rails_orbit/time_range"
+require "rails_orbit/backtrace"
 require "rails_orbit/database_setup"
 require "rails_orbit/metric_writer"
 require "rails_orbit/instrumentation"

data/public/assets/rails_orbit/application.css

@@ -467,6 +467,69 @@
   color: var(--orbit-text-muted);
 }
 
+/* ── Error message, location & traceback ─────────────────── */
+.orbit-error__message {
+  color: var(--orbit-text);
+  word-break: break-word;
+}
+.orbit-error__location {
+  display: flex;
+  align-items: center;
+  gap: 0.35rem;
+  margin-top: 0.3rem;
+  font-family: var(--orbit-mono);
+  font-size: 0.72rem;
+  color: var(--orbit-text-muted);
+  word-break: break-all;
+}
+.orbit-error__location-icon {
+  width: 0.72rem;
+  height: 0.72rem;
+  flex-shrink: 0;
+  color: var(--orbit-text-muted);
+}
+.orbit-error__path { color: var(--orbit-primary); }
+.orbit-error__line { color: var(--orbit-warning); font-weight: 600; }
+.orbit-error__method { color: var(--orbit-text-muted); }
+
+.orbit-trace {
+  margin-top: 0.4rem;
+}
+.orbit-trace__summary {
+  display: inline-block;
+  cursor: pointer;
+  font-size: 0.68rem;
+  color: var(--orbit-text-muted);
+  user-select: none;
+  padding: 0.1rem 0;
+}
+.orbit-trace__summary:hover { color: var(--orbit-text); }
+.orbit-trace__frames {
+  list-style: none;
+  margin: 0.4rem 0 0;
+  padding: 0.5rem 0.75rem;
+  background: var(--orbit-surface);
+  border: 1px solid var(--orbit-border);
+  border-radius: var(--orbit-radius);
+  max-height: 18rem;
+  overflow: auto;
+}
+.orbit-trace__frame {
+  font-family: var(--orbit-mono);
+  font-size: 0.7rem;
+  line-height: 1.7;
+  color: var(--orbit-text-muted);
+  word-break: break-all;
+  opacity: 0.65;
+}
+.orbit-trace__frame--app {
+  color: var(--orbit-text);
+  opacity: 1;
+}
+.orbit-trace__frame--app .orbit-trace__file { color: var(--orbit-primary); }
+.orbit-trace__line { color: var(--orbit-warning); }
+.orbit-trace__method { color: var(--orbit-text-muted); }
+
 /* ── Empty state ─────────────────────────────────────────── */
 .orbit-empty {
   text-align: center;

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rails_orbit
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - dev-ham
+autorequire:
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-06-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -223,6 +224,7 @@ files:
 - lib/generators/rails_orbit/templates/create_orbit_metrics.rb.erb
 - lib/generators/rails_orbit/templates/initializer.rb
 - lib/rails_orbit.rb
+- lib/rails_orbit/backtrace.rb
 - lib/rails_orbit/configuration.rb
 - lib/rails_orbit/database_setup.rb
 - lib/rails_orbit/engine.rb
@@ -244,6 +246,7 @@ metadata:
   changelog_uri: https://github.com/dev-ham/rails_orbit/blob/main/CHANGELOG.md
   bug_tracker_uri: https://github.com/dev-ham/rails_orbit/issues
   rubygems_mfa_required: 'true'
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -258,7 +261,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 3.3.27
+signing_key:
 specification_version: 4
 summary: Observability dashboard for solid_queue, solid_cache, and solid_errors
 test_files: []