launchdarkly-observability 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 91b79fd36f2555837a614b0a9a6c421a20e7f5b4774bce3b288cf1cd42fd0f67
-  data.tar.gz: f1bd602a0f046ca3742087b77bf168299703fd65897ab4c976d8156d696f2cfb
+  metadata.gz: 2baa5acc1de9a83e4ca42ea6ad84dcd561e33385a65e710a7617bae21a81dbca
+  data.tar.gz: 526f1bc59cc2d878c01a23fb34218ca3125398d57dabfdc570b1324365980ab2
 SHA512:
-  metadata.gz: 53230ecfe588cb957cc24d1f532f5a5eea7d272479a592bad5e0b1ff2643f17a420381f2225d3f7739e246697595108b168cf9a28ee48f0d936ac8cdfaaa5acd
-  data.tar.gz: 2a015964b7cd9386327063f3dc2cc41dbb44724f7abf4d6c6228c85e395103bfc04fe3ab49f976b11c69bec18c4be57b8de912463d09a579144da3fae727fe6f
+  metadata.gz: daa9be90cce223d086aa59791bd6d4e42fdb84b5a82afb54de62327bf19bebb02bd004e45e2066c1058e6ede1bcfd8715368b128a1b258b2cb2601810c9d2af3
+  data.tar.gz: 86f0cd398ec94b9edb14b5aeb7efa6dd068d6f0335b38417acb386394fe4edc8b598e7e42ec667da7f8b2718a376a59797ca7f504abbe7e14dc2d3b43ef2347a

data/CHANGELOG.md

@@ -5,6 +5,13 @@ 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.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/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.1' # 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.1
 platform: ruby
 authors:
 - LaunchDarkly
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-03-27 00:00:00.000000000 Z
+date: 2026-06-02 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