errorgap 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a962a442c79c4d80123b06eb6cd8afb1e41cdce3b944101e8d9b6112343f2279
-  data.tar.gz: 61cd50f45d49df099b0ecd54cf18442c19cc31d837b275a0f7903322fbc57c1f
+  metadata.gz: 75cf1e4a725d5e1c7f484a577814d71403fbdc4e6c6cd4bcec3d0eca30f00478
+  data.tar.gz: 98d336466f4eceedc7ad6fc03fff038704d10872e30c6b7f5376528e424dd73b
 SHA512:
-  metadata.gz: e93b57a2558bde0c050d4c806ecb62c57d87ef41af342a8a3ede7071d12c3f71033d008c84dcfa250e5b5314f60ae93d4bf6b02ea546954a291b65f6f7516906
-  data.tar.gz: a456b31419bec30d07d25d3b0fd597d638008e6994c51e2e66f92a67df9bf78ad1e9ab27655ef4ee8abd2e83176b3be681796cf399d77b24bebcf24704093365
+  metadata.gz: 44e3afd205bce67d34e40e6b71a5c67b43615dc04acc299f7188f0e01d514844e7b836523a0dcae0e95388b7b38875c76f2ffc012d3a83b316450182b5a2fb36
+  data.tar.gz: b8b2d440abe90925b5750cf6526b34449d00d913d5bd47a8d74339ce8ba9c5622abe55949b66465ad1f1f0b0972ee26446c258086a98280c94dcdff36b66a229

data/CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.0] - 2026-10-03
+
+### Added
+
+- **Errors link to their request.** Every APM transaction (Rack middleware,
+  `track_transaction`, `track_job`) now has an id, sent as the transaction's
+  `id`, and errors reported while it runs carry it as
+  `context.transaction_id`. Errorgap shows the error a request actually raised
+  on its trace instead of matching by route and time, and links each
+  occurrence to its trace. The id is fiber-local, so concurrent requests never
+  share one, and is sent even when APM sampling drops the transaction.
+  `Errorgap.current_transaction_id` and `Errorgap.with_transaction_id` expose
+  it for custom instrumentation.
+
 ## [0.5.0] - 2026-07-20
 
 ### Added

data/README.md

@@ -90,6 +90,13 @@ end
 Enable with `config.apm_enabled = true` (and optionally `config.apm_sample_rate`).
 Call `Errorgap.flush` before process exit to drain async deliveries.
 
+Every transaction gets an id, and errors reported while it runs — from the
+middleware, `Errorgap.notify`, or inside `track_transaction`/`track_job` —
+carry it as `context.transaction_id`. Errorgap then shows the error a request
+actually raised on its trace, and links each occurrence to its request.
+`Errorgap.current_transaction_id` returns the id in effect (fiber-local), and
+`Errorgap.with_transaction_id { |id| ... }` scopes one around custom work.
+
 ## Rack
 
 ```ruby

data/lib/errorgap/rack_middleware.rb

@@ -7,30 +7,42 @@ module Errorgap
     end
 
     def call(env)
-      start = Process.clock_gettime(Process::CLOCK_MONOTONIC)
-      SpanCollector.start if apm_enabled?
+      return call_without_transaction(env) unless apm_enabled?
 
-      status, headers, body = @app.call(env)
-      [status, headers, body]
-    rescue Exception => exception # rubocop:disable Lint/RescueException
-      notify_once(env, exception)
-      raise
-    ensure
-      if apm_enabled?
-        elapsed_ms = (Process.clock_gettime(Process::CLOCK_MONOTONIC) - start) * 1000.0
-        record_transaction(env, status || 500, elapsed_ms)
+      # Errors raised while this request runs carry its transaction id.
+      Errorgap.with_transaction_id do |transaction_id|
+        start = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+        SpanCollector.start
+        begin
+          status, headers, body = @app.call(env)
+          [status, headers, body]
+        rescue Exception => exception # rubocop:disable Lint/RescueException
+          notify_once(env, exception)
+          raise
+        ensure
+          elapsed_ms = (Process.clock_gettime(Process::CLOCK_MONOTONIC) - start) * 1000.0
+          record_transaction(env, status || 500, elapsed_ms, transaction_id)
+        end
       end
     end
 
     private
 
+    def call_without_transaction(env)
+      @app.call(env)
+    rescue Exception => exception # rubocop:disable Lint/RescueException
+      notify_once(env, exception)
+      raise
+    end
+
     def apm_enabled?
       Errorgap.configuration.apm_enabled
     end
 
-    def record_transaction(env, status_code, elapsed_ms)
+    def record_transaction(env, status_code, elapsed_ms, transaction_id)
       spans = SpanCollector.flush
       txn = Transaction.new(
+        id: transaction_id,
         kind: "web",
         method: env["REQUEST_METHOD"],
         path: route_pattern(env),

data/lib/errorgap/transaction.rb

@@ -17,13 +17,14 @@ module Errorgap
   end
 
   Transaction = Struct.new(
-    :kind, :method, :path, :path_raw, :status_code,
+    :id, :kind, :method, :path, :path_raw, :status_code,
     :duration_ms, :environment, :occurred_at, :spans,
     :job_class, :queue,
     keyword_init: true
   ) do
     def to_h
       {
+        id: id,
         kind: kind,
         method: method,
         path: path,

data/lib/errorgap/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Errorgap
-  VERSION = "0.5.0"
+  VERSION = "0.6.0"
 end

data/lib/errorgap.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "securerandom"
+
 require_relative "errorgap/configuration"
 require_relative "errorgap/breadcrumbs"
 require_relative "errorgap/notifier"
@@ -43,6 +45,10 @@ module Errorgap
     end
 
     def notify(error, context: {}, environment: {}, session: {}, params: {}, sync: false)
+      # The request or job this error was raised in, so errorgap links the two.
+      if (transaction_id = current_transaction_id) && !context.key?(:transaction_id) && !context.key?("transaction_id")
+        context = context.merge(transaction_id: transaction_id)
+      end
       notifier.notify(
         error,
         context: context,
@@ -75,6 +81,26 @@ module Errorgap
       )
     end
 
+    TRANSACTION_ID_KEY = :errorgap_transaction_id
+
+    # The id of the APM transaction running on this fiber, if any. Notices
+    # reported while it is set carry it as `context.transaction_id`.
+    def current_transaction_id
+      Thread.current[TRANSACTION_ID_KEY]
+    end
+
+    # Run the block as one transaction: a new id is current for its duration
+    # (fiber-local, so concurrent requests never share one) and the previous
+    # one is restored after. Yields the id.
+    def with_transaction_id
+      previous = Thread.current[TRANSACTION_ID_KEY]
+      id = SecureRandom.uuid
+      Thread.current[TRANSACTION_ID_KEY] = id
+      yield id
+    ensure
+      Thread.current[TRANSACTION_ID_KEY] = previous
+    end
+
     # Deliver a prebuilt APM transaction, honoring apm_enabled and sampling.
     def notify_transaction(transaction, sync: false)
       return unless configuration.apm_enabled
@@ -92,39 +118,45 @@ module Errorgap
     # receives a SpanRecorder for manual DB/HTTP spans; any automatic
     # `sql.active_record` spans recorded during the block are merged in.
     def track_transaction(method: nil, path: nil, path_raw: nil, status_code: nil, kind: "web", environment: nil, sync: false)
-      SpanCollector.start
-      started = Process.clock_gettime(Process::CLOCK_MONOTONIC)
-      occurred = Time.now
-      begin
-        yield(SpanRecorder.new) if block_given?
-      ensure
-        elapsed_ms = (Process.clock_gettime(Process::CLOCK_MONOTONIC) - started) * 1000.0
-        transaction = Transaction.new(
-          kind: kind, method: method, path: path, path_raw: path_raw,
-          status_code: status_code, duration_ms: elapsed_ms.round(2),
-          environment: environment || configuration.environment,
-          occurred_at: occurred, spans: SpanCollector.flush
-        )
-        notify_transaction(transaction, sync: sync)
+      with_transaction_id do |transaction_id|
+        SpanCollector.start
+        started = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+        occurred = Time.now
+        begin
+          yield(SpanRecorder.new) if block_given?
+        ensure
+          elapsed_ms = (Process.clock_gettime(Process::CLOCK_MONOTONIC) - started) * 1000.0
+          transaction = Transaction.new(
+            id: transaction_id,
+            kind: kind, method: method, path: path, path_raw: path_raw,
+            status_code: status_code, duration_ms: elapsed_ms.round(2),
+            environment: environment || configuration.environment,
+            occurred_at: occurred, spans: SpanCollector.flush
+          )
+          notify_transaction(transaction, sync: sync)
+        end
       end
     end
 
     # Time a background job and deliver it as a `job` transaction.
     def track_job(job_class, queue: "default", environment: nil, sync: false)
-      SpanCollector.start
-      started = Process.clock_gettime(Process::CLOCK_MONOTONIC)
-      occurred = Time.now
-      begin
-        yield(SpanRecorder.new) if block_given?
-      ensure
-        elapsed_ms = (Process.clock_gettime(Process::CLOCK_MONOTONIC) - started) * 1000.0
-        transaction = Transaction.new(
-          kind: "job", job_class: job_class, queue: queue,
-          duration_ms: elapsed_ms.round(2),
-          environment: environment || configuration.environment,
-          occurred_at: occurred, spans: SpanCollector.flush
-        )
-        notify_transaction(transaction, sync: sync)
+      with_transaction_id do |transaction_id|
+        SpanCollector.start
+        started = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+        occurred = Time.now
+        begin
+          yield(SpanRecorder.new) if block_given?
+        ensure
+          elapsed_ms = (Process.clock_gettime(Process::CLOCK_MONOTONIC) - started) * 1000.0
+          transaction = Transaction.new(
+            id: transaction_id,
+            kind: "job", job_class: job_class, queue: queue,
+            duration_ms: elapsed_ms.round(2),
+            environment: environment || configuration.environment,
+            occurred_at: occurred, spans: SpanCollector.flush
+          )
+          notify_transaction(transaction, sync: sync)
+        end
       end
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: errorgap
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Errorgap
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-07-20 00:00:00.000000000 Z
+date: 2026-10-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake