brainzlab 0.1.26 → 0.1.28

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e298648a456d207e9ec5eb9be700b6aa898fc9b77666a3afd3c737d9c126705e
-  data.tar.gz: b87707b7eb15cfb9dd11ca461203d0ccd1a7199bdd0ce972327381ecb675d592
+  metadata.gz: d9fdb52091b2fd8dc2da465cda4b4dc3f37f9b0bef3319f6b1bc6795a1a49c5d
+  data.tar.gz: 866b90f99c3f099618cb0cb981da3e75068824b89998adecad0edd5f89f9db68
 SHA512:
-  metadata.gz: f834d99194f33b06a00f18016879e83fefcd92b5ac4bd589804a7629a2b123699ecf58082923920a72384502dacc1e40ced04ccfb2b36ec2cf6c2791adab2e3a
-  data.tar.gz: 3999f40f6af0bb7b952baf59a35c78acbb38f89e41638824c86dc38a0319f0d964911fd3bc096bba272738c5bc1190777ce98a633a6050f9b7103b59ef8f13c7
+  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/devtools/middleware/debug_panel.rb

@@ -118,7 +118,7 @@ module BrainzLab
 
         def update_content_length(headers, body)
           headers = headers.to_h.dup
-          headers['Content-Length'] = body.sum(&:bytesize).to_s
+          headers['content-length'] = body.sum(&:bytesize).to_s
           headers
         end
       end

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.26'
+  VERSION = '0.1.28'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: brainzlab
 version: !ruby/object:Gem::Version
-  version: 0.1.26
+  version: 0.1.28
 platform: ruby
 authors:
 - BrainzLab