opentelemetry-instrumentation-rack 0.29.0 → 0.30.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa4c2bf498d66000899c1a358e2bbe5f9f696507a8b0e8a06ad6fd952f3a5f14
-  data.tar.gz: 2fcb1dcbe88d67b34bc2547ba0299cd67f78f883a50ce8c65b08105d8bf5d594
+  metadata.gz: 3df8f873c474614c5e6b28b1543627ed7947af99f2b21bf51dd86d421527b988
+  data.tar.gz: e00eff8d8c73b6618982c629259f5ece9a7276b9b32cb7bf561923fed909c7f5
 SHA512:
-  metadata.gz: 685050b61fdf043457ebac51882b6936760df2be76982ba6e35a92d235e4aee1f3701fb106f3f6cbf8edd764443a809e5e101c759611df83d58fef70d4503735
-  data.tar.gz: 9d1dff410595600dbcd09423e946d099313a509760b3852bdb3762485aa6441d3d9e27d66d4d55db5bf92c933d84bb9b63cdd072801bc99f74ad072c3e13462d
+  metadata.gz: 24c2633dd344072d689ee4ee9a91773d4c08ea98d73265628512497aa9cdcf1a1b6bf92731070ff156c376039a19f68101f632452d91787570d14cfea4249d5a
+  data.tar.gz: 63afe0d1f08412326d0fd8d1242013257ed7ef0c177e51bd9f96fc7886f3d65860b2cf466964ed8da456b8d56d280bfaf258757782e1a59257a39e661489b778

data/CHANGELOG.md

@@ -1,9 +1,13 @@
 # Release History: opentelemetry-instrumentation-rack
 
+### v0.30.0 / 2026-03-17
+
+* BREAKING CHANGE: Default to stable HTTP semantic conventions (#2051)
+* ADDED: Default to stable HTTP semantic conventions (#2051)
+
 ### v0.29.0 / 2025-10-22
 
 * BREAKING CHANGE: Min Ruby Version 3.2
-
 * ADDED: Min Ruby Version 3.2
 
 ### v0.28.2 / 2025-10-07
@@ -29,7 +33,6 @@
 ### v0.26.0 / 2025-01-16
 
 * BREAKING CHANGE: Set minimum supported version to Ruby 3.1
-
 * ADDED: Set minimum supported version to Ruby 3.1
 
 ### v0.25.0 / 2024-10-23
@@ -63,7 +66,6 @@
 ### v0.24.0 / 2024-01-06
 
 * BREAKING CHANGE: Use Rack Events By Default
-
 * ADDED: Use Rack Events By Default
 * FIXED: Backport Rack proxy event to middleware
 
@@ -91,7 +93,6 @@
 
 * BREAKING CHANGE: Remove retain_middleware_names Rack Option
 * BREAKING CHANGE: Drop support for EoL Ruby 2.7
-
 * ADDED: Remove retain_middleware_names Rack Option
 * ADDED: Drop support for EoL Ruby 2.7
 * ADDED: Use Rack::Events for instrumentation
@@ -130,7 +131,7 @@
 
 The default was to set the span name as the path of the request, we have
 corrected this as it was not adhering to the spec requirement using low
-cardinality span names.  You can restore the previous behaviour of high
+cardinality span names.  You can restore the previous behavior of high
 cardinality span names by passing in a url quantization function that
 forwards the uri path.  More details on this is available in the readme.
 
@@ -149,7 +150,6 @@ forwards the uri path.  More details on this is available in the readme.
 ### v0.19.0 / 2021-06-23
 
 * BREAKING CHANGE: Total order constraint on span.status=
-
 * ADDED: Add Tracer.non_recording_span to API
 * FIXED: Total order constraint on span.status=
 
@@ -165,7 +165,6 @@ forwards the uri path.  More details on this is available in the readme.
 ### v0.16.0 / 2021-03-17
 
 * BREAKING CHANGE: Pass env to url quantization rack config to allow more flexibility
-
 * ADDED: Pass env to url quantization rack config to allow more flexibility
 * ADDED: Add rack instrumentation config option to accept callable to filter requests to trace
 * FIXED: Example scripts now reference local common lib
@@ -178,7 +177,6 @@ forwards the uri path.  More details on this is available in the readme.
 ### v0.14.0 / 2021-02-03
 
 * BREAKING CHANGE: Replace getter and setter callables and remove rack specific propagators
-
 * ADDED: Replace getter and setter callables and remove rack specific propagators
 * ADDED: Add untraced endpoints config to rack middleware
 
@@ -205,7 +203,6 @@ forwards the uri path.  More details on this is available in the readme.
 ### v0.9.0 / 2020-11-27
 
 * BREAKING CHANGE: Add timeout for force_flush and shutdown
-
 * ADDED: Instrument rails
 * ADDED: Add timeout for force_flush and shutdown
 
@@ -213,7 +210,6 @@ forwards the uri path.  More details on this is available in the readme.
 
 * BREAKING CHANGE: Move context/span methods to Trace module
 * BREAKING CHANGE: Remove 'canonical' from status codes
-
 * FIXED: Move context/span methods to Trace module
 * FIXED: Remove 'canonical' from status codes
 

data/README.md

@@ -104,16 +104,12 @@ The `opentelemetry-instrumentation-rack` gem is distributed under the Apache 2.0
 
 ## HTTP semantic convention stability
 
-In the OpenTelemetry ecosystem, HTTP semantic conventions have now reached a stable state. However, the initial Rack instrumentation was introduced before this stability was achieved, which resulted in HTTP attributes being based on an older version of the semantic conventions.
-
-To facilitate the migration to stable semantic conventions, you can use the `OTEL_SEMCONV_STABILITY_OPT_IN` environment variable. This variable allows you to opt-in to the new stable conventions, ensuring compatibility and future-proofing your instrumentation.
+This instrumentation by default emits the stable HTTP semantic conventions. The `OTEL_SEMCONV_STABILITY_OPT_IN` environment variable can be used to opt-in to the old or duplicate (both old and stable) semantic conventions.
 
 When setting the value for `OTEL_SEMCONV_STABILITY_OPT_IN`, you can specify which conventions you wish to adopt:
 
-- `http` - Emits the stable HTTP and networking conventions and ceases emitting the old conventions previously emitted by the instrumentation.
-- `http/dup` - Emits both the old and stable HTTP and networking conventions, enabling a phased rollout of the stable semantic conventions.
-- Default behavior (in the absence of either value) is to continue emitting the old HTTP and networking conventions the instrumentation previously emitted.
-
-During the transition from old to stable conventions, Rack instrumentation code comes in three patch versions: `dup`, `old`, and `stable`. These versions are identical except for the attributes they send. Any changes to Rack instrumentation should consider all three patches.
+- `http` - Emits the stable HTTP and networking conventions.
+- `http/dup` - **DEPRECATED: Will be removed on April 15, 2026.** Emits both the old and stable HTTP and networking conventions.
+- `old` - **DEPRECATED: Will be removed on April 15, 2026.** Emits the old HTTP and networking conventions.
 
 For additional information on migration, please refer to our [documentation](https://opentelemetry.io/docs/specs/semconv/non-normative/http-migration/).

data/lib/opentelemetry/instrumentation/rack/instrumentation.rb

@@ -76,14 +76,20 @@ module OpenTelemetry
           values = stability_opt_in.split(',').map(&:strip)
 
           if values.include?('http/dup')
+            emit_old_semconv_deprecation_warning('http/dup')
             'dup'
-          elsif values.include?('http')
-            'stable'
-          else
+          elsif values.include?('old')
+            emit_old_semconv_deprecation_warning('old')
             'old'
+          else
+            'stable'
           end
         end
 
+        def emit_old_semconv_deprecation_warning(option)
+          OpenTelemetry.logger.warn("The `#{option}` option for OTEL_SEMCONV_STABILITY_OPT_IN is deprecated and will be removed on April 15, 2026. Please migrate to the stable HTTP semantic conventions.")
+        end
+
         def require_dependencies_old
           require_relative 'middlewares/old/event_handler' if defined?(::Rack::Events)
           require_relative 'middlewares/old/tracer_middleware'

data/lib/opentelemetry/instrumentation/rack/middlewares/dup/event_handler.rb

@@ -90,7 +90,7 @@ module OpenTelemetry
             # @note does nothing if the span is a non-recording span
             # @param [Rack::Request] The current HTTP request
             # @param [Rack::Response] The current HTTP response
-            # @param [Exception] An unxpected error raised by the application
+            # @param [Exception] An unexpected error raised by the application
             def on_error(request, _, error)
               span = OpenTelemetry::Instrumentation::Rack.current_span
               return unless span.recording?

data/lib/opentelemetry/instrumentation/rack/middlewares/old/event_handler.rb

@@ -90,7 +90,7 @@ module OpenTelemetry
             # @note does nothing if the span is a non-recording span
             # @param [Rack::Request] The current HTTP request
             # @param [Rack::Response] The current HTTP response
-            # @param [Exception] An unxpected error raised by the application
+            # @param [Exception] An unexpected error raised by the application
             def on_error(request, _, error)
               span = OpenTelemetry::Instrumentation::Rack.current_span
               return unless span.recording?

data/lib/opentelemetry/instrumentation/rack/middlewares/stable/event_handler.rb

@@ -90,7 +90,7 @@ module OpenTelemetry
             # @note does nothing if the span is a non-recording span
             # @param [Rack::Request] The current HTTP request
             # @param [Rack::Response] The current HTTP response
-            # @param [Exception] An unxpected error raised by the application
+            # @param [Exception] An unexpected error raised by the application
             def on_error(request, _, error)
               span = OpenTelemetry::Instrumentation::Rack.current_span
               return unless span.recording?

data/lib/opentelemetry/instrumentation/rack/version.rb

@@ -7,7 +7,7 @@
 module OpenTelemetry
   module Instrumentation
     module Rack
-      VERSION = '0.29.0'
+      VERSION = '0.30.0'
     end
   end
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: opentelemetry-instrumentation-rack
 version: !ruby/object:Gem::Version
-  version: 0.29.0
+  version: 0.30.0
 platform: ruby
 authors:
 - OpenTelemetry Authors
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-22 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: opentelemetry-instrumentation-base
@@ -52,11 +51,10 @@ homepage: https://github.com/open-telemetry/opentelemetry-ruby-contrib
 licenses:
 - Apache-2.0
 metadata:
-  changelog_uri: https://rubydoc.info/gems/opentelemetry-instrumentation-rack/0.29.0/file/CHANGELOG.md
+  changelog_uri: https://rubydoc.info/gems/opentelemetry-instrumentation-rack/0.30.0/file/CHANGELOG.md
   source_code_uri: https://github.com/open-telemetry/opentelemetry-ruby-contrib/tree/main/instrumentation/rack
   bug_tracker_uri: https://github.com/open-telemetry/opentelemetry-ruby-contrib/issues
-  documentation_uri: https://rubydoc.info/gems/opentelemetry-instrumentation-rack/0.29.0
-post_install_message:
+  documentation_uri: https://rubydoc.info/gems/opentelemetry-instrumentation-rack/0.30.0
 rdoc_options: []
 require_paths:
 - lib
@@ -71,8 +69,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
-signing_key:
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Rack instrumentation for the OpenTelemetry framework
 test_files: []