Deprecate enable_tracing in favor of traces_sample_rate

CHANGELOG.md

@@ -1,3 +1,9 @@
+## Unreleased
+
+### Miscellaneous
+
+- Deprecate `enable_tracing` in favor of `traces_sample_rate = 1.0` [#2535](https://github.com/getsentry/sentry-ruby/pull/2535)
+
 ## 5.22.4
 
 ### Bug Fixes

sentry-rails/lib/generators/sentry_generator.rb

@@ -16,7 +16,7 @@ def copy_initializer_file
       Sentry.init do |config|
         config.breadcrumbs_logger = [:active_support_logger]
         config.dsn = #{dsn}
-        config.enable_tracing = true
+        config.traces_sample_rate = 1.0
       end
     RUBY
   end

sentry-rails/spec/sentry/generator_spec.rb

@@ -55,7 +55,7 @@
       Sentry.init do |config|
         config.breadcrumbs_logger = [:active_support_logger]
         config.dsn = ENV['SENTRY_DSN']
-        config.enable_tracing = true
+        config.traces_sample_rate = 1.0
       end
     RUBY
   end
@@ -87,7 +87,7 @@
         Sentry.init do |config|
           config.breadcrumbs_logger = [:active_support_logger]
           config.dsn = 'foobarbaz'
-          config.enable_tracing = true
+          config.traces_sample_rate = 1.0
         end
       RUBY
     end

sentry-ruby/lib/sentry/configuration.rb

@@ -264,6 +264,7 @@
 
     # Easier way to use performance tracing
     # If set to true, will set traces_sample_rate to 1.0
+    # @deprecated It will be removed in the next major release.
     # @return [Boolean, nil]
     attr_reader :enable_tracing
 
@@ -542,6 +543,12 @@
     end
 
     def enable_tracing=(enable_tracing)
+      unless enable_tracing.nil?
+        log_warn <<~MSG
+          `enable_tracing` is now deprecated in favor of `traces_sample_rate = 1.0`.
+        MSG
+      end
+
       @enable_tracing = enable_tracing
       @traces_sample_rate ||= 1.0 if enable_tracing
     end

sentry-ruby/spec/sentry/configuration_spec.rb

@@ -123,6 +123,17 @@
 
           expect(subject.tracing_enabled?).to eq(false)
         end
+
+        it "prints deprecation message when being assigned" do
+          string_io = StringIO.new
+          subject.logger = Logger.new(string_io)
+
+          subject.enable_tracing = true
+
+          expect(string_io.string).to include(
+            "WARN -- sentry: `enable_tracing` is now deprecated in favor of `traces_sample_rate = 1.0`."
+          )
+        end
       end
     end
 

sentry-ruby/spec/sentry/metrics/aggregator_spec.rb

@@ -11,7 +11,7 @@
   before do
     perform_basic_setup do |config|
       config.metrics.enabled = true
-      config.enable_tracing = true
+      config.traces_sample_rate = 1.0
       config.release = 'test-release'
       config.environment = 'test'
       config.logger = Logger.new(string_io)
@@ -194,7 +194,7 @@
       before do
         perform_basic_setup do |config|
           config.metrics.enabled = true
-          config.enable_tracing = true
+          config.traces_sample_rate = 1.0
           config.release = 'test-release'
           config.environment = 'test'
           config.logger = Logger.new(string_io)

sentry-ruby/spec/sentry/metrics_spec.rb

@@ -116,7 +116,7 @@
 
       before do
         perform_basic_setup do |config|
-          config.enable_tracing = true
+          config.traces_sample_rate = 1.0
           config.metrics.enabled = true
         end