logbrew-sdk 0.1.12 → 0.1.14

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a0af4b97ef8e2b7c4e89c4c7541e1a512d85f4d8aa6e3d87639551145f99875c
-  data.tar.gz: eaa3d1ff11b605c3547964918cfb37714e8ea737c72748f02d08ce2b27fed221
+  metadata.gz: ba29c0ee35c6f7287dbdeadcc2f215b32270218de626d2338de40d8082be04a4
+  data.tar.gz: efade8df92a9d851cf9fce4f482ff632a50bcc79038157b048cdb792e6a4fb30
 SHA512:
-  metadata.gz: fc95d14c11974aa1c83adefa37beb10864029e9d6c5e518c9dccd99ad1901974aa6fa3885a186ad05a00ae23e12642e61f578bec7f1a78d7629dcbf0e4d022dc
-  data.tar.gz: 2154ac935379e496a6d8888058ee22964ad7cda7449ed0af86120f5099656a52f7be54042117f650e66259c848e435df8150f70f3f38ff07e856e6f1cafd3fbc
+  metadata.gz: a2e498a092d5cbaa2f09b7b9be07112e7656e33df61f73614c09cd4cd1d8d7830d3dd24b6daf1169c834847415acc19898cc0c994ca6bb6a47c972a612e13395
+  data.tar.gz: 62b25847c01ab391d7122aca956e8b591961cb2a2020b2af837d75d65c2ae508955c088663b0d78d70e0597d99f97efd0e786bc428227a3180c975567ae64a44

data/README.md

@@ -23,7 +23,7 @@ needed:
 
 ```ruby
 # Gemfile
-gem "logbrew-sdk", "~> 0.1.12"
+gem "logbrew-sdk", "~> 0.1.14"
 ```
 
 ```bash
@@ -57,13 +57,14 @@ paths. Exception messages and raw backtrace text are separate opt-ins.
 
 ActiveJob needs no extra initializer. Each enqueue and execution emits a
 producer or worker span, including bounded adapter identity, retry count, and
-queue wait. A versioned W3C carrier keeps retries and supported queue adapters
-on one trace. A retryable failure remains span evidence; only an unexpected
-terminal `StandardError` creates an unhandled `rails.active_job` issue with
-sanitized structured frames. The adapter does not capture job IDs, queue names,
-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.
+queue wait. Enqueue spans use `queue.publish`; worker spans use `queue.process`.
+A versioned W3C carrier keeps retries and supported queue adapters on one trace.
+A retryable failure remains span evidence; only an unexpected terminal
+`StandardError` creates an unhandled `rails.active_job` issue with sanitized
+structured frames. The adapter does not capture job IDs, queue names, 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,
@@ -745,7 +746,14 @@ Registration is app-owned, idempotent, and reversible with `unregister_client` a
 
 The client middleware adds one bounded `logbrew` carrier containing only a version, W3C `traceparent`, and enqueue time. Valid retries keep that carrier without creating another enqueue span. The server middleware continues a valid carrier or starts a fresh trace when it is absent or malformed, returns the caller trace state after every result, and records bounded queue-wait and execution timing. Set `max_retries` to the same default retry limit used by your Sidekiq configuration; per-job integer or disabled retry settings are honored. Retryable failures keep only error spans, while the terminal escaped failure adds one deduplicated fixed-title issue and preserves the original exception.
 
-Sidekiq spans contain only fixed source, sampled state, bounded retry count, bounded queue-wait duration, execution duration, status, and real cancellation. The integration does not capture job arguments, payload fields, job identifiers, worker names, queue values, connection data, exception messages or stacks, baggage, or tracestate. Capture failures are advisory and never replace job execution or retry behavior. Create fresh clients and instrumentation after `fork`; inherited instances fail closed without changing jobs.
+Sidekiq producer spans use `queue.publish`, and worker spans use `queue.process`.
+They contain only fixed source, sampled state, bounded retry count, bounded
+queue-wait duration, execution duration, status, and real cancellation. The
+integration does not capture job arguments, payload fields, job identifiers,
+worker names, queue values, connection data, exception messages or stacks,
+baggage, or tracestate. Capture failures are advisory and never replace job
+execution or retry behavior. Create fresh clients and instrumentation after
+`fork`; inherited instances fail closed without changing jobs.
 
 ## Persistent Worker Delivery
 

data/lib/logbrew/operation_tracing.rb

@@ -6,7 +6,11 @@ module LogBrew
     UNSAFE_METADATA = /authorization|body|broker|cache.?key|command|connection|cookie|dsn|header|host|
       \bjid\z|job.?id|key|message|param|pass#{'word'}|payload|query|sec#{'ret'}|sql|statement|
       to#{'ken'}|url|username|value/ix
-    private_constant :UNSAFE_METADATA
+    QUEUE_SEMANTICS = {
+      "enqueue" => "queue.publish", "publish" => "queue.publish", "send" => "queue.publish",
+      "receive" => "queue.receive", "perform" => "queue.process", "process" => "queue.process", "consume" => "queue.process"
+    }.freeze
+    private_constant :UNSAFE_METADATA, :QUEUE_SEMANTICS
 
     module_function
 
@@ -28,20 +32,13 @@ module LogBrew
       Validation.require_non_empty("#{kind} operation name", name)
       started_at = monotonic_time
       context = child_context
-      error = nil
-      result = nil
-
-      Trace.with_context(context) do
-        begin
-          result = yield context
-        rescue StandardError => captured
-          error = captured
-        end
+      begin
+        result = Trace.with_context(context) { yield context }
+      rescue StandardError => error
+        capture_span(client, kind, name, context, started_at, options, error)
+        raise
       end
-
-      capture_span(client, kind, name, context, started_at, options, error)
-      raise error if error
-
+      capture_span(client, kind, name, context, started_at, options, nil)
       result
     end
 
@@ -88,6 +85,7 @@ module LogBrew
         metadata["source"] = read_option(options, :source) || "#{kind}.operation"
         add_option(metadata, "#{kind}.system", read_option(options, :system))
         add_option(metadata, "#{kind}.operation", read_option(options, :operation))
+        add_option(metadata, "operation", QUEUE_SEMANTICS[read_option(options, :operation)]) if kind == "queue"
         add_option(metadata, "#{kind}.target", read_option(options, :target))
         metadata["exceptionType"] = error.class.name if error
       end

data/lib/logbrew/rails_integration.rb

@@ -431,11 +431,11 @@ module LogBrew
       private_constant :LoggerTap
 
       module BroadcastOrigin
-        def dispatch(...)
+        def dispatch(*args, &block)
           previous = Thread.current[ORIGIN_KEY]
           origin = ApplicationLogCapture.application_caller?(instance_variable_get(ROOT_IVAR))
           Thread.current[ORIGIN_KEY] = origin
-          super
+          super(*args, &block)
         ensure
           Thread.current[ORIGIN_KEY] = previous
         end

data/lib/logbrew/sidekiq.rb

@@ -28,15 +28,12 @@ module LogBrew
 
       def around(terminal_failure: false)
         Trace.with_context(@context) do
-          begin
-            result = yield
-          rescue Exception => error # rubocop:disable Lint/RescueException
-            finish(error: error, terminal_failure: terminal_failure)
-            raise
-          else
-            finish
-            result
-          end
+          result = yield
+          finish
+          result
+        rescue Exception => error # rubocop:disable Lint/RescueException
+          finish(error: error, terminal_failure: terminal_failure)
+          raise
         end
       end
 
@@ -50,7 +47,7 @@ module LogBrew
         end
 
         @instrumentation.send(:capture_span, self, error)
-        @instrumentation.send(:capture_terminal_issue, self) if error && terminal_failure && !cancellation?(error)
+        @instrumentation.send(:capture_terminal_issue, self, error) if error && terminal_failure && !cancellation?(error)
       rescue StandardError => capture_error
         @instrumentation.send(:report_capture_error, capture_error)
       end
@@ -64,6 +61,7 @@ module LogBrew
       def span_attributes(error)
         metadata = {
           "source" => @source,
+          "operation" => @source == "sidekiq.client" ? "queue.publish" : "queue.process",
           "sampled" => @context.sampled
         }
         metadata["retryCount"] = @retry_count unless @retry_count.nil?
@@ -81,20 +79,22 @@ module LogBrew
         }
       end
 
-      def issue_attributes
-        {
-          "title" => "Sidekiq job failed",
-          "level" => "error",
-          "metadata" => {
-            "source" => @source,
-            "sampled" => @context.sampled,
-            "retryCount" => @retry_count + 1
-          }
+      def issue_attributes(error)
+        exception_type = IssueDiagnostics.safe_exception_type(error)
+        frame = IssueDiagnostics.stack_frames_from_exception(error).first
+        metadata = {
+          "source" => @source,
+          "sampled" => @context.sampled,
+          "retryCount" => @retry_count + 1,
+          "errorName" => exception_type
         }
-      end
-
-      def retry_count
-        @retry_count
+        unless frame.nil?
+          metadata["errorFrameFile"] = frame.fetch("filename")
+          metadata["errorFrameLine"] = frame.fetch("line")
+        end
+        IssueDiagnostics.from_exception(
+          error, title: exception_type, mechanism_type: "sidekiq.job", handled: false, metadata: metadata
+        )
       end
 
       def failure_key
@@ -383,7 +383,7 @@ module LogBrew
         )
       end
 
-      def capture_terminal_issue(operation)
+      def capture_terminal_issue(operation, error)
         key = operation.failure_key
         reserved = @failure_mutex.synchronize do
           next false if @reported_failures.key?(key)
@@ -398,7 +398,7 @@ module LogBrew
           @client.issue(
             "ruby_sidekiq_issue_#{operation.context.span_id}",
             Time.now.utc.iso8601,
-            operation.issue_attributes
+            operation.issue_attributes(error)
           )
         rescue StandardError
           @failure_mutex.synchronize { @reported_failures.delete(key) }

data/lib/logbrew/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: logbrew-sdk
 version: !ruby/object:Gem::Version
-  version: 0.1.12
+  version: 0.1.14
 platform: ruby
 authors:
 - LogBrew
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-17 00:00:00.000000000 Z
+date: 2026-09-03 00:00:00.000000000 Z
 dependencies: []
 description: Public LogBrew Ruby SDK with typed issue diagnostics, automatic Rails
   request/error capture, and standard-library delivery.