brainzlab 0.1.27 → 0.1.28

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6b57a1a89ace36a6d6529526de7fbe3830959bd18d874052689a02baf21d2aae
-  data.tar.gz: cc0b0e99695dbd64ff561206df0e6e45ac619f666a04424e6b99633577c77e13
+  metadata.gz: d9fdb52091b2fd8dc2da465cda4b4dc3f37f9b0bef3319f6b1bc6795a1a49c5d
+  data.tar.gz: 866b90f99c3f099618cb0cb981da3e75068824b89998adecad0edd5f89f9db68
 SHA512:
-  metadata.gz: 190513dceb2037e41a274b6e930735c8d918b674effbed07cb8077321eb9ebf6ffac328acaa050d18d80f4e488db58ccf8b60ac96687eb650a98c055804ad9e5
-  data.tar.gz: 6a51f042aedafa0e7995e6f17e2c17b2551fbd0415fb5b3b60d54980974e9c03f11b59ce3a696368042ac99faaa1387163122d7bcb4b01e9de0c7d7fc1cc02c2
+  metadata.gz: 3268bd499dfa2ae01e25bc18d57110ba45516d2a6971bca24158be6fd43d8c928ffb51f816946b7c3c084a8928d61c54b8507760deb78dec5a6f2288b5299db1
+  data.tar.gz: c7fd19b498c1d193f885ff0c0bddd86047006101195fe3a7f1a545ba3fa4e251691ce30ddf9589fbdd5b63dd5d98ab100527612b4c34e83c38d1fde8189b5211

data/lib/brainzlab/configuration.rb

@@ -42,6 +42,7 @@ module BrainzLab
                   :pulse_buffer_size,
                   :pulse_flush_interval,
                   :pulse_sample_rate,
+                  :pulse_sample_tier,
                   :pulse_excluded_paths,
                   :flux_enabled,
                   :flux_url,
@@ -254,7 +255,12 @@ module BrainzLab
       @pulse_auto_provision = true
       @pulse_buffer_size = 50
       @pulse_flush_interval = 5
-      @pulse_sample_rate = nil
+      # Trace sampling. Explicit rate (0.0–1.0) wins; otherwise derived from the
+      # tier. Defaults to the "internal" tier so the Brainz fleet samples ~10%
+      # (error traces are always kept). Client-facing apps set
+      # BRAINZLAB_PULSE_TIER=client (or PULSE_SAMPLE_RATE) to keep everything.
+      @pulse_sample_rate = (v = ENV['PULSE_SAMPLE_RATE'] || ENV['BRAINZLAB_PULSE_SAMPLE_RATE']).nil? || v.to_s.strip.empty? ? nil : v.to_f
+      @pulse_sample_tier = (ENV['BRAINZLAB_PULSE_TIER'] || 'internal').to_s.strip.downcase
       @pulse_excluded_paths = %w[/health /ping /up /assets]
 
       # Flux settings
@@ -509,6 +515,23 @@ module BrainzLab
       pulse_api_key || secret_key
     end
 
+    # Per-tier default trace sample rates. Internal (the Brainz fleet's own
+    # telemetry) samples aggressively; client/critical keep everything. Error
+    # traces are always kept regardless (see Pulse::Tracer).
+    PULSE_TIER_SAMPLE_RATES = {
+      'internal' => 0.1,
+      'standard' => 0.5,
+      'client'   => 1.0,
+      'critical' => 1.0
+    }.freeze
+
+    # Effective 0.0–1.0 trace sample rate: explicit rate wins, else the tier's
+    # default, else 1.0 (sample everything) for unknown tiers.
+    def effective_pulse_sample_rate
+      rate = pulse_sample_rate || PULSE_TIER_SAMPLE_RATES.fetch(pulse_sample_tier, 1.0)
+      rate.to_f.clamp(0.0, 1.0)
+    end
+
     def flux_valid?
       key = flux_ingest_key || flux_api_key || secret_key
       !key.nil? && !key.empty?

data/lib/brainzlab/pulse/tracer.rb

@@ -17,6 +17,7 @@ module BrainzLab
       end
 
       def start_trace(name, kind: 'custom', **attributes)
+        sample_rate = @config.effective_pulse_sample_rate
         trace = {
           trace_id: SecureRandom.uuid,
           name: name,
@@ -25,6 +26,10 @@ module BrainzLab
           environment: @config.environment,
           commit: @config.commit,
           host: @config.host,
+          sample_rate: sample_rate,
+          # Per-trace sampling decision (atomic, so spans never orphan). Errors
+          # override this at finish_trace and are always kept.
+          sampled: sample_rate >= 1.0 || rand < sample_rate,
           **attributes
         }
 
@@ -38,6 +43,14 @@ module BrainzLab
         trace = current_trace
         return unless trace
 
+        # Drop unsampled successful traces entirely (skip payload build + send);
+        # error traces are always kept regardless of the sampling decision.
+        unless error || trace.fetch(:sampled, true)
+          Thread.current[:brainzlab_pulse_trace] = nil
+          Thread.current[:brainzlab_pulse_spans] = nil
+          return
+        end
+
         ended_at = Time.now.utc
         duration_ms = ((ended_at - trace[:started_at]) * 1000).round(2)
 

data/lib/brainzlab/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BrainzLab
-  VERSION = '0.1.27'
+  VERSION = '0.1.28'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: brainzlab
 version: !ruby/object:Gem::Version
-  version: 0.1.27
+  version: 0.1.28
 platform: ruby
 authors:
 - BrainzLab
@@ -246,7 +246,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Ruby SDK for BrainzLab observability
 test_files: []