errorgap 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 75cf1e4a725d5e1c7f484a577814d71403fbdc4e6c6cd4bcec3d0eca30f00478
-  data.tar.gz: 98d336466f4eceedc7ad6fc03fff038704d10872e30c6b7f5376528e424dd73b
+  metadata.gz: '0841cbcd204e3167a443244774a3f05a4b692dc6b706b76db7cd3af7943296b1'
+  data.tar.gz: ec4b272a9c9102c7fc9643c6d66042ded9ee1e7ed9457f5bd59ea05f835293f2
 SHA512:
-  metadata.gz: 44e3afd205bce67d34e40e6b71a5c67b43615dc04acc299f7188f0e01d514844e7b836523a0dcae0e95388b7b38875c76f2ffc012d3a83b316450182b5a2fb36
-  data.tar.gz: b8b2d440abe90925b5750cf6526b34449d00d913d5bd47a8d74339ce8ba9c5622abe55949b66465ad1f1f0b0972ee26446c258086a98280c94dcdff36b66a229
+  metadata.gz: '07229bfc0552894549309bb7b0c54363d59d70d09714cf66ccfc0f71d534c78030e55afceb32129e93d55eee0f1fb17a6b81eb2914986db367708fdfcf66c54d'
+  data.tar.gz: 96adaebf03ed7d0ef8f5f127ea1ccefafb6e70690235f6029e52b8fb3c7b4bf96d9e2ff263d41941b168a3b95cc9a8c87805ddffe43a2dfd4178328d05b15bd3

data/CHANGELOG.md

@@ -5,6 +5,18 @@ 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.7.0] - 2026-10-03
+
+### Added
+
+- **Releases.** `config.release` (default `ENV["ERRORGAP_RELEASE"]`) is sent
+  as `context.release` on every notice, tying errors to the deploy that
+  shipped them.
+- **Browser trace links.** The Rack middleware reads the `x-errorgap-trace`
+  header sent by `@errorgap/browser` 0.3+ and records it as the transaction's
+  `trace_id`, so errorgap links a browser API call to the server request that
+  answered it. Only well-formed UUIDs are accepted.
+
 ## [0.6.0] - 2026-10-03
 
 ### Added

data/README.md

@@ -31,9 +31,18 @@ Errorgap.configure do |config|
   # Skip reporting entirely (errors and APM) in these environments.
   # Also configurable via ERRORGAP_IGNORE_ENVIRONMENTS="test,development".
   config.ignore_environments = %w[test development]
+
+  # The deployed version or commit (defaults to ERRORGAP_RELEASE). Errors carry
+  # it, so errorgap ties each one to the deploy that shipped it.
+  config.release = ENV["GIT_SHA"]
 end
 ```
 
+When the errorgap browser SDK is on the page, its API calls send an
+`x-errorgap-trace` header; the Rack middleware records it on the request's
+transaction, so the browser's Performance view links each call to the server
+request that answered it.
+
 ## Manual Notification
 
 ```ruby

data/lib/errorgap/configuration.rb

@@ -16,7 +16,8 @@ module Errorgap
                   :apm_sample_rate,
                   :logs_enabled,
                   :minimum_log_level,
-                  :max_breadcrumbs
+                  :max_breadcrumbs,
+                  :release
 
     def initialize
       @endpoint = ENV.fetch("ERRORGAP_ENDPOINT", "http://127.0.0.1:3030")
@@ -33,6 +34,9 @@ module Errorgap
       @logs_enabled = true
       @minimum_log_level = "info"
       @max_breadcrumbs = 25
+      # The deployed version or commit: errors are attributed to the deploy
+      # that shipped them.
+      @release = ENV["ERRORGAP_RELEASE"].to_s.strip.empty? ? nil : ENV["ERRORGAP_RELEASE"].strip
     end
 
     def validate!

data/lib/errorgap/notice.rb

@@ -61,6 +61,7 @@ module Errorgap
         environment: @configuration.environment,
         root_directory: @configuration.root_directory
       }
+      context[:release] = @configuration.release if @configuration.release
       causes = collect_causes
       context[:causes] = causes unless causes.empty?
       context[:breadcrumbs] = @breadcrumbs unless @breadcrumbs.empty?

data/lib/errorgap/rack_middleware.rb

@@ -35,6 +35,15 @@ module Errorgap
       raise
     end
 
+    UUID = /\A\h{8}-\h{4}-\h{4}-\h{4}-\h{12}\z/
+
+    # The x-errorgap-trace header a browser SDK sent with this call, linking
+    # the browser's view of it to this transaction. Only a well-formed UUID.
+    def browser_trace_id(env)
+      value = env["HTTP_X_ERRORGAP_TRACE"].to_s.strip
+      value.match?(UUID) ? value.downcase : nil
+    end
+
     def apm_enabled?
       Errorgap.configuration.apm_enabled
     end
@@ -43,6 +52,7 @@ module Errorgap
       spans = SpanCollector.flush
       txn = Transaction.new(
         id: transaction_id,
+        trace_id: browser_trace_id(env),
         kind: "web",
         method: env["REQUEST_METHOD"],
         path: route_pattern(env),

data/lib/errorgap/transaction.rb

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

data/lib/errorgap/version.rb

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

metadata

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