logbrew-sdk 0.1.9 → 0.1.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 95bb6223a8ef074b3c8dd0973fe99e36734849c1b47a19f1c1ed88655888d71b
-  data.tar.gz: 4ac8224ffe4e2fae6f4262b80a3119f2574982a6c0f384c529c77c74163340fc
+  metadata.gz: e4d8cebbc9fcb274134dda84b6de6b086a4dc6cdc119b80f02c3458624ca1587
+  data.tar.gz: c35a55684af97f05ef24f3626412f471c12af7cef0bcc7468430393dfbfccfdd
 SHA512:
-  metadata.gz: f90b3564b39c4546b8a34b424b1f59e8ca5de6afaba35529e511a688712e770c92c04deb547fd7e370bfa1590688be7ce3b11ca5f04ccd7d11ecb022f37ff401
-  data.tar.gz: 3d47121b9f61ed19bbeda0e9389f3daa5137c34b88256ea9b5d3f7e47dd28b4d4c36fc7f94bf0c9e2172be0b65f72235e5e96e2923c113811e0b758158498f18
+  metadata.gz: e9f385c563b7de3bd38294d83e5aa9b3e72c57efb21cf6b22c59de8c5c0328d3a117dbbbee2bf42a91a36d98d97ece63afb2997661968a902f525c932351e5de
+  data.tar.gz: ae840cec0095218353192f4af76c00b4ec80707e4bc208c03ba6ae654e2c98158c2af8c198d68e1d279a84df944382e654312a599d7311cd8ad4a6eb519e8d8a

data/README.md

@@ -4,7 +4,7 @@
   <img src="https://raw.githubusercontent.com/LogBrewCo/sdk/main/assets/brand/logbrew-logo-transparent-512.png" alt="LogBrew logo" width="96" height="96">
 </p>
 
-Public Ruby SDK for building, validating, previewing, and flushing LogBrew event batches, with automatic Rails request, database, cache, view, error, and ActiveJob capture; standard-library `Net::HTTP` delivery; opt-in standard-library `Logger` support; and manual Rack helpers.
+Public Ruby SDK for building, validating, previewing, and flushing LogBrew event batches, with automatic Rails request, database, cache, view, error, ActiveJob, and outbound `Net::HTTP` capture; standard-library delivery; opt-in standard-library `Logger` support; and manual Rack helpers.
 
 The core package has no runtime gem dependencies. Its automatic integration
 activates only inside an application that has already loaded Rails.
@@ -23,7 +23,7 @@ needed:
 
 ```ruby
 # Gemfile
-gem "logbrew-sdk", "~> 0.1.9"
+gem "logbrew-sdk", "~> 0.1.11"
 ```
 
 ```bash
@@ -65,6 +65,11 @@ arguments, serialized payloads, exception messages, or raw backtraces by
 default. When ActiveJob uses LogBrew's Sidekiq middleware, the inner carrier
 suppresses duplicate Sidekiq spans and issues.
 
+Outbound `Net::HTTP` calls made inside an active Rails request or job trace also
+need no initializer. They propagate one W3C child and record only method,
+normalized host, status, duration, adapter source, sampled state, and exception
+type. Calls outside an active trace remain exact pass-throughs.
+
 The explicit Rails capture settings are:
 
 | Environment variable | Default | Purpose |
@@ -427,7 +432,9 @@ end
 
 ## Outbound HTTP Tracing
 
-Wrap an app-owned `Net::HTTP` connection explicitly when outbound work should become a child of the active LogBrew trace:
+The enabled Rails integration captures `Net::HTTP` automatically while a
+LogBrew trace is active. Outside Rails, wrap an app-owned connection explicitly
+when outbound work should become a child of the active trace:
 
 ```ruby
 uri = URI("https://service.example/health")
@@ -452,7 +459,15 @@ connection = Faraday.new("https://service.example") do |builder|
 end
 ```
 
-Both adapters are literal pass-throughs when `LogBrew::Trace.current` is absent. With an active parent, they propagate one W3C `traceparent`, return the caller-visible header and trace scope to their prior values, and capture one completion span per actual execution. Duplicate wrappers, nested LogBrew HTTP middleware, and SDK delivery are suppressed without process-wide hooks. Net::HTTP start blocks, response streaming, Faraday middleware ordering, responses, and exceptions retain their normal behavior; telemetry capture failures are advisory.
+Both explicit adapters are literal pass-throughs when `LogBrew::Trace.current`
+is absent. With an active parent, explicit adapters and automatic Rails
+`Net::HTTP` capture propagate one W3C `traceparent`, return caller-visible
+header and trace state, and capture one completion span per actual execution.
+Duplicate wrappers, nested LogBrew HTTP middleware, and SDK delivery are
+suppressed. Outside an enabled Rails process, the SDK does not patch
+`Net::HTTP`. Start blocks, response streaming, Faraday middleware ordering,
+responses, and exceptions retain normal behavior; capture failures are
+advisory.
 
 Outbound HTTP spans allow only method, normalized host, status code, duration, adapter source, sampled state, and exception type. They never record scheme, port, path, query, fragment, full URL, request or response headers, bodies or sizes, exception messages or stacks, authentication material, cookies, baggage, tracestate, resolved addresses, or arbitrary request options.
 

data/lib/logbrew/http_client_tracing.rb

@@ -19,6 +19,7 @@ module LogBrew
       @method = HttpClientTracing.normalize_method(method)
       @host = HttpClientTracing.normalize_host(host)
       @on_capture_error = on_capture_error
+      @timestamp = Time.now.utc.iso8601(6)
       @started_at = HttpClientTracing.monotonic_time
       @mutex = Mutex.new
       @finished = false
@@ -60,7 +61,7 @@ module LogBrew
 
       @client.span(
         "ruby_http_span_#{@context.span_id}",
-        Time.now.utc.iso8601,
+        @timestamp,
         {
           name: "http.client:#{@method}",
           traceId: @context.trace_id,
@@ -86,35 +87,12 @@ module LogBrew
     end
 
     def request(request, body = nil, &block)
-      prepared = HttpClientTracing.prepare(
+      HttpClientTracing.capture_net_http(
+        @http,
+        request,
         client: @client,
-        source: "net_http",
         on_capture_error: @on_capture_error
-      ) do
-        [request.method, address, HttpClientTracing::NetHttpHeaderSnapshot.new(request)]
-      end
-      return @http.request(request, body, &block) unless prepared
-
-      operation, header = prepared
-      begin
-        header.inject(operation.traceparent)
-      rescue StandardError => error
-        operation.capture_error(error)
-        HttpClientTracing.reset_header(header, operation)
-        return @http.request(request, body, &block)
-      end
-
-      response = nil
-      begin
-        response = operation.around { @http.request(request, body, &block) }
-      rescue StandardError => error
-        operation.finish(error: error)
-        raise
-      ensure
-        HttpClientTracing.reset_header(header, operation)
-      end
-      operation.finish(status_code: HttpClientTracing.read_status(response, :code, operation))
-      response
+      ) { @http.request(request, body, &block) }
     end
 
     def start(*arguments)
@@ -187,6 +165,34 @@ module LogBrew
       NetHttpTracingClient.new(http, client: client, on_capture_error: on_capture_error)
     end
 
+    def capture_net_http(http, request, client:, on_capture_error: nil)
+      prepared = prepare(client: client, source: "net_http", on_capture_error: on_capture_error) do
+        [request.method, http.address, NetHttpHeaderSnapshot.new(request)]
+      end
+      return yield unless prepared
+
+      operation, header = prepared
+      begin
+        header.inject(operation.traceparent)
+      rescue StandardError => error
+        operation.capture_error(error)
+        reset_header(header, operation)
+        return yield
+      end
+
+      response = nil
+      begin
+        response = operation.around { yield }
+      rescue StandardError => error
+        operation.finish(error: error)
+        raise
+      ensure
+        reset_header(header, operation)
+      end
+      operation.finish(status_code: read_status(response, :code, operation))
+      response
+    end
+
     def prepare(client:, source:, on_capture_error: nil)
       parent = Trace.current
       return nil unless parent

data/lib/logbrew/rails.rb

@@ -77,6 +77,7 @@ module LogBrew
       runtime = LogBrew::Rails.install(application: application)
       if runtime.configuration.enabled?
         LogBrew::Rails.const_get(:RequestOperations).install(::ActiveSupport::Notifications)
+        LogBrew::Rails.const_get(:OutboundHttp).install
       end
       ::ActiveSupport.on_load(:active_job) do
         prepend LogBrew::Rails::ActiveJobExtension unless ancestors.include?(LogBrew::Rails::ActiveJobExtension)

data/lib/logbrew/rails_integration.rb

@@ -398,6 +398,30 @@ module LogBrew
       end
     end
 
+    # Adds bounded child spans to Net::HTTP calls made inside an active Rails trace.
+    module OutboundHttp
+      module Request
+        def request(request, body = nil, &block)
+          runtime = LogBrew::Rails.runtime
+          client = LogBrew::Trace.current && runtime&.client
+          return super unless client
+
+          LogBrew::HttpClientTracing.capture_net_http(
+            self,
+            request,
+            client: client,
+            on_capture_error: ->(error) { runtime.report_error("outbound_http_capture", error) }
+          ) { super(request, body, &block) }
+        end
+      end
+
+      module_function
+
+      def install
+        Net::HTTP.prepend(Request) unless Net::HTTP.ancestors.include?(Request)
+      end
+    end
+
     # One privacy-bounded producer or worker operation for ActiveJob.
     class ActiveJobOperation
       attr_reader :context

data/lib/logbrew/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LogBrew
-  VERSION = "0.1.9"
+  VERSION = "0.1.11"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: logbrew-sdk
 version: !ruby/object:Gem::Version
-  version: 0.1.9
+  version: 0.1.11
 platform: ruby
 authors:
 - LogBrew