forge_ops_tracker 0.21.0 → 0.22.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c51ad9b51fd30d2f2524c60fabb955dbd2840a756138a4cf4b9cda47dbd56b49
-  data.tar.gz: 8a4b895fa3ba817ea0d352cfaaedfd5dc083e4abf69fb25020a523b890ded319
+  metadata.gz: e7d188230dabf677fd36901f2dc5fa06087a101a2a6a1cac1254926f8908692b
+  data.tar.gz: adf0303ee68a7f629efb58fed79b03d9b44f94f8a1be3f3b66c8192ef1a02f91
 SHA512:
-  metadata.gz: 22e8833e29f4de32284cb8203d135dff386a50845de5235c52ab3a39a5574448a2e14e4e85cada210f1b2a44f0367193d1d6d96e97764f0cb3650b1d31a600af
-  data.tar.gz: 31f1973e9840e5b7396ce7a96fc757288468cb50f65b7ba6de5f8bef6625a7211eb340e0fe6043f644602532a708cfb2d6c2c3453c879c9306e40e2fd7eecfe5
+  metadata.gz: ca4daee44d94287061c5ca2acd2eb99e723e5e2b8703b318a13d9a756a1f378cfea3fdaf750bd29eacfb03dc8457167a7f5e81b05b772138c2325d4dde3a2802
+  data.tar.gz: 2d4b2b0fc99fd80bf9b3dc1e8c97d958ed140e830a8a9969f990b6b92f1538960cbb951212fb341b5c4af5d4b284f8990ec5fba3148aaa588126a6aa17761b93

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.22.0 (2026-10-28)
+
+- `config.trace_ignore_paths`: requests whose path starts with one of these prefixes are never traced, however
+  slow, for health checks or anything else not worth a trace.
+
 ## 0.21.0 (2026-10-23)
 
 - PII scrubbing catches card numbers however they're grouped (bare, 4-4-4-4, Amex's 4-6-5, or next to a

data/README.md

@@ -446,6 +446,7 @@ A fast, successful request never sends anything.
 ForgeOpsTracker.configure do |config|
   config.track_tracing = false             # opt out of recording spans entirely
   config.trace_capture_threshold_ms = 500  # default 1000
+  config.trace_ignore_paths = [ "/health" ] # never trace requests under these path prefixes
 end
 ```
 

data/lib/forge_ops_tracker/configuration.rb

@@ -16,7 +16,7 @@ module ForgeOpsTracker
     attr_accessor :track_failures, :failure_event_flush_interval
     attr_accessor :metric_flush_interval, :infrastructure_metric_flush_interval
     attr_accessor :gauge_poll_interval
-    attr_accessor :track_tracing, :trace_capture_threshold_ms
+    attr_accessor :track_tracing, :trace_capture_threshold_ms, :trace_ignore_paths
     attr_accessor :explain_slow_queries, :explain_threshold_ms
     attr_accessor :propagate_traces, :trace_propagation_targets
     attr_accessor :detect_changes, :track_env_var_names
@@ -129,6 +129,10 @@ module ForgeOpsTracker
       # PerformanceSample-derived threshold elsewhere in this gem: those describe a trend across
       # many requests, this describes a single one being outright slow.
       @trace_capture_threshold_ms = 1_000
+      # Requests whose path starts with one of these are never traced at all. For an app that
+      # reports to itself (ForgeOps on ForgeOps), its own ingestion endpoints: storing a slow trace
+      # is a slow request, whose trace would be sent back to be stored, and so on.
+      @trace_ignore_paths = []
       # Opt-in: for a SELECT on PostgreSQL that took at least explain_threshold_ms, ask Postgres for
       # its plan (plain EXPLAIN, never EXPLAIN ANALYZE, so the query is never run again) and send
       # it, masked, so ForgeOps can show why the query was slow. Off by default because it runs one

data/lib/forge_ops_tracker/middleware/span_tracing.rb

@@ -34,6 +34,7 @@ module ForgeOpsTracker
 
       def call(env)
         return app.call(env) unless configuration.track_tracing && configuration.enabled?
+        return app.call(env) if ignored_path?(env)
 
         state = RequestState.for(env)
         buffer = SpanBuffer.new(trace_id: state.trace_id, parent_span_id: state.parent_span_id)
@@ -49,6 +50,11 @@ module ForgeOpsTracker
       private
         attr_reader :app, :configuration
 
+        def ignored_path?(env)
+          path = env["PATH_INFO"].to_s
+          Array(configuration.trace_ignore_paths).any? { |prefix| path.start_with?(prefix) }
+        end
+
         def send_trace?(buffer, state)
           return true if buffer.slow?(configuration.trace_capture_threshold_ms)
 

data/lib/forge_ops_tracker/version.rb

@@ -1,3 +1,3 @@
 module ForgeOpsTracker
-  VERSION = "0.21.0"
+  VERSION = "0.22.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: forge_ops_tracker
 version: !ruby/object:Gem::Version
-  version: 0.21.0
+  version: 0.22.0
 platform: ruby
 authors:
 - ForgeOps