miniapm 1.1.0 → 1.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d9e86e9f297b739658918cd083749603dc9b051f9155a3468f59dde33b8ce908
-  data.tar.gz: 55d5fb852f0c5cfc244e3344a4e97a1de2adffa2e4c2f19fb0c01617ec639d17
+  metadata.gz: 83b0d150b9b3726489be0f60b057b7f88220e159fbcb2fdff0c908f50666891b
+  data.tar.gz: 53415be3a6facc48a9baa9ccec55d5d98334ad64fb74c354b4007e519c358f71
 SHA512:
-  metadata.gz: afc6919e18594a95b783024a82ae597a8f199ce51427e846ca937224257642443a0ebdcfb6974cd55764d8179b4d4dd298846614b0d9b24817b90307caac0eea
-  data.tar.gz: 74ab8984fba2107643fd85106e655917836b670f869ff5caae4a272b021176e71b77d35efe9291c17dd29a101c1c34d0cbc867179bacd87cdb3472da3aaae609
+  metadata.gz: 24b383ee8664419cd4393cfd07532bc2ab7aee2d9d7bc922ab30db878a50623b6d844688bedbf73c605005b51b0cc2bff255cd5fcf7f741953068068bdbefe42
+  data.tar.gz: 23cdb70815eb61eae638f17b860fa3c8309443d89ed58f1f332006b53026393b6a42ce8b2c7a6e95a1650e6f2be5e59990ccccb483e1634c058f63a548e5729e

data/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.3.1] - 2026-01-04
+
+### Added
+- Filter SolidCable/SolidQueue polling queries by default to reduce noise
+- New `ignored_tables` option for ActiveRecord instrumentation (supports strings and regex)
+
 ## [1.0.0] - 2026-01-03
 
 ### Added

data/lib/miniapm/configuration.rb

@@ -136,9 +136,19 @@ module MiniAPM
   end
 
   class InstrumentationConfig
+    # Tables used for internal polling by Rails infrastructure gems
+    # These create noise in traces without providing value
+    INTERNAL_POLLING_TABLES = %w[
+      solid_cable_messages
+      solid_queue_processes
+      solid_queue_ready_executions
+      solid_queue_scheduled_executions
+      solid_queue_semaphores
+    ].freeze
+
     DEFAULTS = {
       rails: { enabled: true },
-      activerecord: { enabled: true, log_sql: false },
+      activerecord: { enabled: true, log_sql: true, ignored_tables: INTERNAL_POLLING_TABLES },
       activejob: { enabled: true },
       sidekiq: { enabled: true },
       cache: { enabled: true },

data/lib/miniapm/error_event.rb

@@ -7,7 +7,10 @@ module MiniAPM
   class ErrorEvent
     attr_reader :exception_class, :message, :backtrace, :fingerprint
     attr_reader :request_id, :user_id, :params, :timestamp
-    attr_reader :context
+    attr_reader :context, :source_context
+
+    # Number of lines to include before and after the error line
+    CONTEXT_LINES = 5
 
     def initialize(
       exception_class:,
@@ -29,6 +32,7 @@ module MiniAPM
       @params = filter_params(params)
       @timestamp = timestamp || Time.now.utc
       @context = context
+      @source_context = extract_source_context
     end
 
     def self.from_exception(exception, context = {})
@@ -44,7 +48,7 @@ module MiniAPM
     end
 
     def to_h
-      {
+      hash = {
         exception_class: @exception_class,
         message: @message,
         backtrace: @backtrace,
@@ -53,7 +57,9 @@ module MiniAPM
         user_id: @user_id,
         params: @params,
         timestamp: @timestamp.iso8601
-      }.compact
+      }
+      hash[:source_context] = @source_context if @source_context
+      hash.compact
     end
 
     private
@@ -126,5 +132,60 @@ module MiniAPM
       string = string.to_s
       string.length > max_length ? string[0, max_length] + "..." : string
     end
+
+    def extract_source_context
+      # Find first application backtrace line (not gem/stdlib)
+      app_line = @backtrace.find do |line|
+        !line.include?("/gems/") &&
+        !line.include?("/ruby/") &&
+        !line.include?("/vendor/") &&
+        !line.include?("/bundle/") &&
+        !line.start_with?("<")
+      end
+
+      return nil unless app_line
+
+      # Parse file:line from backtrace line
+      # Format: "/path/to/file.rb:123:in `method_name'" or "/path/to/file.rb:123"
+      match = app_line.match(/\A(.+?):(\d+)/)
+      return nil unless match
+
+      file_path = match[1]
+      lineno = match[2].to_i
+
+      # Handle relative paths (e.g., "app/controllers/...") by prepending Rails.root
+      unless file_path.start_with?("/")
+        if defined?(Rails) && Rails.respond_to?(:root) && Rails.root
+          file_path = File.join(Rails.root.to_s, file_path)
+        else
+          return nil
+        end
+      end
+
+      return nil unless File.exist?(file_path) && File.readable?(file_path)
+
+      begin
+        lines = File.readlines(file_path)
+        return nil if lineno < 1 || lineno > lines.length
+
+        # Calculate context range (0-indexed)
+        start_line = [lineno - CONTEXT_LINES - 1, 0].max
+        end_line = [lineno + CONTEXT_LINES - 1, lines.length - 1].min
+
+        pre_context = lines[start_line...lineno - 1].map(&:chomp)
+        context_line = lines[lineno - 1]&.chomp || ""
+        post_context = lines[lineno..end_line].map(&:chomp)
+
+        {
+          file: file_path,
+          lineno: lineno,
+          pre_context: pre_context,
+          context_line: context_line,
+          post_context: post_context
+        }
+      rescue StandardError
+        nil
+      end
+    end
   end
 end

data/lib/miniapm/instrumentations/activerecord.rb

@@ -33,6 +33,9 @@ module MiniAPM
           operation = extract_operation(sql)
           table = extract_table(sql)
 
+          # Skip queries to ignored tables (e.g., SolidCable/SolidQueue polling)
+          return if table && ignored_table?(table)
+
           name = [operation, table].compact.join(" ")
           name = operation if name.empty?
 
@@ -43,7 +46,7 @@ module MiniAPM
 
           attributes["db.sql.table"] = table if table
 
-          # Optionally log SQL (configurable, defaults to off)
+          # Log SQL (configurable, defaults to on)
           if MiniAPM.configuration.instrumentations.options(:activerecord)[:log_sql]
             attributes["db.statement"] = truncate_sql(sql)
           end
@@ -114,6 +117,13 @@ module MiniAPM
         def truncate_sql(sql, max_length: 2000)
           sql.length > max_length ? sql[0...max_length] + "..." : sql
         end
+
+        def ignored_table?(table)
+          ignored = MiniAPM.configuration.instrumentations.options(:activerecord)[:ignored_tables]
+          return false unless ignored
+
+          ignored.any? { |pattern| pattern.is_a?(Regexp) ? table.match?(pattern) : table == pattern }
+        end
       end
     end
   end

data/lib/miniapm/instrumentations/rails/controller.rb

@@ -4,32 +4,88 @@ module MiniAPM
   module Instrumentations
     module Rails
       class Controller < Base
+        # Subscriber class for view rendering that tracks span context properly
+        class ViewSubscriber
+          def initialize(type)
+            @type = type
+            @spans = {}
+          end
+
+          def start(name, id, payload)
+            return unless MiniAPM.enabled?
+            return unless Context.current_trace
+
+            template = payload[:identifier] || payload[:virtual_path] || "unknown"
+
+            # Clean up template path
+            if defined?(::Rails.root) && ::Rails.root
+              template = template.sub(::Rails.root.to_s + "/", "")
+            end
+
+            template_name = File.basename(template)
+
+            attributes = {
+              "rails.template" => template,
+              "rails.template.type" => @type
+            }
+
+            attributes["rails.layout"] = payload[:layout] if payload[:layout]
+            attributes["rails.collection.count"] = payload[:count] if payload[:count]
+
+            span = Span.new(
+              name: "#{@type} #{template_name}",
+              category: :view,
+              trace_id: Context.current_trace_id,
+              parent_span_id: Context.current_span&.span_id,
+              attributes: attributes
+            )
+
+            # Store span by event ID and push to context
+            @spans[id] = span
+            Context.push_span(span)
+          end
+
+          def finish(name, id, payload)
+            span = @spans.delete(id)
+            return unless span
+
+            # Pop from context and finish
+            Context.pop_span
+            span.finish
+            MiniAPM.record_span(span)
+          end
+        end
+
         class << self
           def install!
             return if installed?
             mark_installed!
 
-            # Subscribe to controller processing
+            # Subscribe to controller processing (still uses standard subscribe)
             subscribe("process_action.action_controller") do |event|
               handle_process_action(event)
             end
 
-            # Subscribe to view rendering
-            subscribe("render_template.action_view") do |event|
-              handle_render_template(event)
-            end
+            # Subscribe to view rendering with monotonic subscribers for proper nesting
+            ActiveSupport::Notifications.monotonic_subscribe(
+              "render_template.action_view",
+              ViewSubscriber.new("render_template")
+            )
 
-            subscribe("render_partial.action_view") do |event|
-              handle_render_partial(event)
-            end
+            ActiveSupport::Notifications.monotonic_subscribe(
+              "render_partial.action_view",
+              ViewSubscriber.new("render_partial")
+            )
 
-            subscribe("render_collection.action_view") do |event|
-              handle_render_collection(event)
-            end
+            ActiveSupport::Notifications.monotonic_subscribe(
+              "render_collection.action_view",
+              ViewSubscriber.new("render_collection")
+            )
 
-            subscribe("render_layout.action_view") do |event|
-              handle_render_layout(event)
-            end
+            ActiveSupport::Notifications.monotonic_subscribe(
+              "render_layout.action_view",
+              ViewSubscriber.new("render_layout")
+            )
           end
 
           private
@@ -64,60 +120,16 @@ module MiniAPM
             # Record exception if present
             if payload[:exception_object]
               span.record_exception(payload[:exception_object])
-            end
-          end
-
-          def handle_render_template(event)
-            record_view_span("render_template", event)
-          end
-
-          def handle_render_partial(event)
-            record_view_span("render_partial", event)
-          end
-
-          def handle_render_collection(event)
-            record_view_span("render_collection", event)
-          end
 
-          def handle_render_layout(event)
-            record_view_span("render_layout", event)
-          end
-
-          def record_view_span(type, event)
-            return unless MiniAPM.enabled?
-            return unless Context.current_trace
-
-            payload = event.payload
-            template = payload[:identifier] || payload[:virtual_path] || "unknown"
-
-            # Clean up template path
-            if defined?(::Rails.root) && ::Rails.root
-              template = template.sub(::Rails.root.to_s + "/", "")
+              # Also send to dedicated errors endpoint (with source context)
+              MiniAPM.record_error(
+                payload[:exception_object],
+                context: {
+                  request_id: payload[:request]&.request_id,
+                  params: payload[:params]
+                }
+              )
             end
-
-            template_name = File.basename(template)
-
-            attributes = {
-              "rails.template" => template,
-              "rails.template.type" => type
-            }
-
-            if payload[:layout]
-              attributes["rails.layout"] = payload[:layout]
-            end
-
-            if payload[:count]
-              attributes["rails.collection.count"] = payload[:count]
-            end
-
-            span = create_span_from_event(
-              event,
-              name: "#{type} #{template_name}",
-              category: :view,
-              attributes: attributes
-            )
-
-            record_span(span)
           end
         end
       end

data/lib/miniapm/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module MiniAPM
-  VERSION = "1.1.0"
+  VERSION = "1.3.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: miniapm
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.3.1
 platform: ruby
 authors:
 - Chris Hasinski