launchdarkly-observability 0.2.0 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 91b79fd36f2555837a614b0a9a6c421a20e7f5b4774bce3b288cf1cd42fd0f67
-  data.tar.gz: f1bd602a0f046ca3742087b77bf168299703fd65897ab4c976d8156d696f2cfb
+  metadata.gz: d46f86b88f2c7b3dfd876ef07b2135e8d11f8939c66a1071246ebb627b387f0d
+  data.tar.gz: 28d3c8ab27674a1e4ca3996c805d97136782198b2da0a96e8f64902d49ed1f4e
 SHA512:
-  metadata.gz: 53230ecfe588cb957cc24d1f532f5a5eea7d272479a592bad5e0b1ff2643f17a420381f2225d3f7739e246697595108b168cf9a28ee48f0d936ac8cdfaaa5acd
-  data.tar.gz: 2a015964b7cd9386327063f3dc2cc41dbb44724f7abf4d6c6228c85e395103bfc04fe3ab49f976b11c69bec18c4be57b8de912463d09a579144da3fae727fe6f
+  metadata.gz: cd64fc216a9af53ec0c78bc4af429edf051e0da37b8568e4611d78bd0863711d2ca0b94fb8de97c39b30de4f0828c4eb2a874ce5148e0491f0ba320f716ad96f
+  data.tar.gz: 40114279e622a08632d68b63f5faebb4f77230cfe72f8a7a723b2a27898f81bf1c7a2179204068ebb3c178451339f8de7e0ca52840a77fe8d68c9e0721151663

data/CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.2](https://github.com/launchdarkly/observability-sdk/compare/launchdarkly-observability-ruby/0.2.1...launchdarkly-observability-ruby/0.2.2) (2026-06-22)
+
+
+### Bug Fixes
+
+* **ruby:** omit nil feature_flag.context.id for invalid contexts ([#641](https://github.com/launchdarkly/observability-sdk/issues/641)) ([587e2e4](https://github.com/launchdarkly/observability-sdk/commit/587e2e40764bade29198c47e6746887f1af6d856))
+
+## [0.2.1](https://github.com/launchdarkly/observability-sdk/compare/launchdarkly-observability-ruby/0.2.0...launchdarkly-observability-ruby/0.2.1) (2026-06-02)
+
+
+### Bug Fixes
+
+* **ruby:** observability plugin compatibility — require server-sdk >= 8.11.0 and fix Rails Railtie load order ([#575](https://github.com/launchdarkly/observability-sdk/issues/575)) ([e9d8310](https://github.com/launchdarkly/observability-sdk/commit/e9d8310c0d0d53c20ee8a48f31279a386988d27a))
+
 ## [0.2.0](https://github.com/launchdarkly/observability-sdk/compare/launchdarkly-observability-ruby-0.1.0...launchdarkly-observability-ruby/0.2.0) (2026-03-27)
 
 

data/README.md

@@ -35,7 +35,7 @@ gem install launchdarkly-observability
 ### Dependencies
 
 The gem includes everything needed for traces and logs out of the box:
-- `launchdarkly-server-sdk` >= 8.0
+- `launchdarkly-server-sdk` >= 8.11.0 (plugin support was added in 8.11.0)
 - `opentelemetry-sdk` ~> 1.4
 - `opentelemetry-exporter-otlp` ~> 0.28
 - `opentelemetry-instrumentation-all` ~> 0.62

data/lib/launchdarkly_observability/hook.rb

@@ -91,12 +91,23 @@ module LaunchDarklyObservability
         FEATURE_FLAG_PROVIDER_NAME => 'LaunchDarkly'
       }
 
-      context = series_context.context
-      if context
-        attrs[FEATURE_FLAG_CONTEXT_ID] = context.fully_qualified_key
-      end
+      attrs[FEATURE_FLAG_CONTEXT_ID] = context_id_for(series_context)
 
-      attrs
+      # OpenTelemetry rejects nil attribute values and logs an error for each
+      # one. Drop nils centrally so individual call sites cannot reintroduce the
+      # "invalid attribute value type NilClass" noise (e.g. an invalid context
+      # whose fully_qualified_key is nil).
+      attrs.compact
+    end
+
+    # Returns the fully-qualified context key, or nil if unavailable.
+    #
+    # An invalid context (e.g. a non-string context kind) is still a non-nil
+    # object but yields a nil fully_qualified_key. OpenTelemetry rejects nil
+    # attribute values ("invalid attribute value type NilClass"), so callers
+    # must omit the attribute entirely when this returns nil.
+    def context_id_for(series_context)
+      series_context.context&.fully_qualified_key
     end
 
     def serialize_value(value)
@@ -127,10 +138,7 @@ module LaunchDarklyObservability
         FEATURE_FLAG_PROVIDER_NAME => 'LaunchDarkly'
       }
 
-      context = series_context.context
-      if context
-        event_attributes[FEATURE_FLAG_CONTEXT_ID] = context.fully_qualified_key
-      end
+      event_attributes[FEATURE_FLAG_CONTEXT_ID] = context_id_for(series_context)
 
       if detail.variation_index
         event_attributes[FEATURE_FLAG_RESULT_VARIANT] = detail.variation_index.to_s
@@ -146,7 +154,9 @@ module LaunchDarklyObservability
         add_reason_event_details(event_attributes, reason)
       end
 
-      span.add_event(FEATURE_FLAG_EVENT_NAME, attributes: event_attributes)
+      # See build_before_attributes: drop nil values so a missing context id (or
+      # any future optional attribute) cannot emit a nil-attribute OTel error.
+      span.add_event(FEATURE_FLAG_EVENT_NAME, attributes: event_attributes.compact)
     end
 
     def add_reason_event_details(event_attributes, reason)

data/lib/launchdarkly_observability/plugin.rb

@@ -2,6 +2,15 @@
 
 require 'launchdarkly-server-sdk'
 
+# Plugin support (LaunchDarkly::Interfaces::Plugins) was added in launchdarkly-server-sdk 8.11.0.
+# Surface an actionable error instead of a bare "uninitialized constant" if an older SDK is loaded.
+unless defined?(LaunchDarkly::Interfaces::Plugins::Plugin)
+  raise LoadError, 'launchdarkly-observability requires launchdarkly-server-sdk >= 8.11.0 ' \
+                   '(plugin support was added in 8.11.0). Your installed launchdarkly-server-sdk ' \
+                   "version is #{defined?(LaunchDarkly::VERSION) ? LaunchDarkly::VERSION : 'unknown'}. " \
+                   'Please upgrade: bundle update launchdarkly-server-sdk'
+end
+
 module LaunchDarklyObservability
   # LaunchDarkly SDK Plugin that provides observability instrumentation.
   #

data/lib/launchdarkly_observability/rails.rb

@@ -4,56 +4,16 @@ require_relative 'middleware'
 
 module LaunchDarklyObservability
   if defined?(::Rails::Railtie)
-    # Rails Railtie for automatic integration
+    # Controller and view helper modules are defined BEFORE the Railtie on purpose.
     #
-    # This Railtie automatically:
-    # - Inserts the LaunchDarkly middleware into the Rails middleware stack
-    # - Bridges Rails.logger to the OpenTelemetry Logs pipeline (if logger provider is available)
-    # - Provides helper methods for controllers and views
-    #
-    # @example The Railtie is automatically loaded when Rails is detected
-    #   # In config/initializers/launchdarkly.rb
-    #   LaunchDarklyObservability.init(project_id: ENV['LD_PROJECT_ID'])
-    #
-    class Railtie < ::Rails::Railtie
-      initializer 'launchdarkly_observability.configure_rails' do |app|
-        app.middleware.insert_before(0, LaunchDarklyObservability::Middleware)
-      end
-
-      config.after_initialize do
-        if defined?(ActionController::Base)
-          ActionController::Base.include(LaunchDarklyObservability::ControllerHelpers)
-        end
-
-        if defined?(ActionController::API)
-          ActionController::API.include(LaunchDarklyObservability::ControllerHelpers)
-        end
-
-        attach_otel_log_bridge
-      end
-
-      class << self
-        private
-
-        def attach_otel_log_bridge
-          return unless otel_logger_provider_available?
-
-          bridge = LaunchDarklyObservability::OtelLogBridge.new(OpenTelemetry.logger_provider)
-
-          if ::Rails.logger.respond_to?(:broadcast_to)
-            ::Rails.logger.broadcast_to(bridge)
-          elsif defined?(ActiveSupport::Logger) && ActiveSupport::Logger.respond_to?(:broadcast)
-            ::Rails.logger.extend(ActiveSupport::Logger.broadcast(bridge))
-          end
-        rescue StandardError => e
-          warn "[LaunchDarklyObservability] Could not attach log bridge to Rails.logger: #{e.message}"
-        end
-
-        def otel_logger_provider_available?
-          LaunchDarklyObservability.send(:otel_logger_provider_available?)
-        end
-      end
-    end
+    # The Railtie's `config.after_initialize` hook references ControllerHelpers. That
+    # hook is registered via ActiveSupport's lazy load hooks, which run immediately if
+    # the :after_initialize event has already fired. When the gem is required lazily
+    # *after* Rails has booted (e.g. from an autoloaded model during a request), the
+    # block executes synchronously while this file is still loading. If the helper
+    # modules were defined further down the file, they would not exist yet and the
+    # require would raise "uninitialized constant LaunchDarklyObservability::ControllerHelpers".
+    # Defining them first makes the require order-independent.
 
     # Controller helper methods for Rails
     #
@@ -134,6 +94,61 @@ module LaunchDarklyObservability
       end
     end
 
+    # Rails Railtie for automatic integration
+    #
+    # This Railtie automatically:
+    # - Inserts the LaunchDarkly middleware into the Rails middleware stack
+    # - Bridges Rails.logger to the OpenTelemetry Logs pipeline (if logger provider is available)
+    # - Provides helper methods for controllers and views
+    #
+    # @example The Railtie is automatically loaded when Rails is detected
+    #   # In config/initializers/launchdarkly.rb
+    #   LaunchDarklyObservability.init(project_id: ENV['LD_PROJECT_ID'])
+    #
+    class Railtie < ::Rails::Railtie
+      # Private helpers are defined before `config.after_initialize` references them.
+      # The after_initialize hook can run synchronously while this class body is still
+      # evaluating (lazy require after Rails has booted — see the note above), so any
+      # method it calls must already be defined at that point.
+      class << self
+        private
+
+        def attach_otel_log_bridge
+          return unless otel_logger_provider_available?
+
+          bridge = LaunchDarklyObservability::OtelLogBridge.new(OpenTelemetry.logger_provider)
+
+          if ::Rails.logger.respond_to?(:broadcast_to)
+            ::Rails.logger.broadcast_to(bridge)
+          elsif defined?(ActiveSupport::Logger) && ActiveSupport::Logger.respond_to?(:broadcast)
+            ::Rails.logger.extend(ActiveSupport::Logger.broadcast(bridge))
+          end
+        rescue StandardError => e
+          warn "[LaunchDarklyObservability] Could not attach log bridge to Rails.logger: #{e.message}"
+        end
+
+        def otel_logger_provider_available?
+          LaunchDarklyObservability.send(:otel_logger_provider_available?)
+        end
+      end
+
+      initializer 'launchdarkly_observability.configure_rails' do |app|
+        app.middleware.insert_before(0, LaunchDarklyObservability::Middleware)
+      end
+
+      config.after_initialize do
+        if defined?(ActionController::Base)
+          ActionController::Base.include(LaunchDarklyObservability::ControllerHelpers)
+        end
+
+        if defined?(ActionController::API)
+          ActionController::API.include(LaunchDarklyObservability::ControllerHelpers)
+        end
+
+        attach_otel_log_bridge
+      end
+    end
+
     if defined?(ActionView::Base)
       ActionView::Base.include(ViewHelpers)
     end

data/lib/launchdarkly_observability/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LaunchDarklyObservability
-  VERSION = '0.2.0' # x-release-please-version
+  VERSION = '0.2.2' # x-release-please-version
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: launchdarkly-observability
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.2
 platform: ruby
 authors:
 - LaunchDarkly
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-03-27 00:00:00.000000000 Z
+date: 2026-06-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: launchdarkly-server-sdk
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '8.0'
+        version: 8.11.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '8.0'
+        version: 8.11.0
 - !ruby/object:Gem::Dependency
   name: opentelemetry-exporter-otlp
   requirement: !ruby/object:Gem::Requirement