Support for SamplerDetectors and EnvVarSamplerDetector

docs/trace/extending-the-sdk/MySamplerDetector.cs

@@ -0,0 +1,25 @@
+// <copyright file="MySamplerDetector.cs" company="OpenTelemetry Authors">
+// Copyright The OpenTelemetry Authors
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// </copyright>
+
+using OpenTelemetry.Trace;
+
+internal class MySamplerDetector : ISamplerDetector
+{
+    public Sampler Detect()
+    {
+        return new MySampler();
+    }
+}

docs/trace/extending-the-sdk/Program.cs

@@ -28,7 +28,7 @@ public class Program
     public static void Main()
     {
         using var tracerProvider = Sdk.CreateTracerProviderBuilder()
-            .SetSampler(new MySampler())
+            .ConfigureSampler(x => x.Clear().RegisterDetector(new MySamplerDetector()))
             .AddSource("OTel.Demo")
             .SetResourceBuilder(ResourceBuilder.CreateEmpty().AddDetector(new MyResourceDetector()))
             .AddProcessor(new MyProcessor("ProcessorA"))

docs/trace/extending-the-sdk/README.md

@@ -295,10 +295,10 @@ cases, it is recommended to use that option as it offers higher performance.
 
 OpenTelemetry .NET SDK has provided the following built-in samplers:
 
-* [AlwaysOffSampler](../../../src/OpenTelemetry/Trace/AlwaysOffSampler.cs)
-* [AlwaysOnSampler](../../../src/OpenTelemetry/Trace/AlwaysOnSampler.cs)
-* [ParentBasedSampler](../../../src/OpenTelemetry/Trace/ParentBasedSampler.cs)
-* [TraceIdRatioBasedSampler](../../../src/OpenTelemetry/Trace/TraceIdRatioBasedSampler.cs)
+* [AlwaysOffSampler](../../../src/OpenTelemetry/Trace/Sampling/AlwaysOffSampler.cs)
+* [AlwaysOnSampler](../../../src/OpenTelemetry/Trace/Sampling/AlwaysOnSampler.cs)
+* [ParentBasedSampler](../../../src/OpenTelemetry/Trace/Sampling/ParentBasedSampler.cs)
+* [TraceIdRatioBasedSampler](../../../src/OpenTelemetry/Trace/Sampling/TraceIdRatioBasedSampler.cs)
 
 Custom samplers can be implemented to cover more scenarios:
 
@@ -335,6 +335,22 @@ Custom resource detectors can be implemented:
 
 A demo ResourceDetector is shown [here](./MyResourceDetector.cs).
 
+## Sampler Detector
+
+OpenTelemetry .NET SDK provides a sampler detector for detecting sampler
+from the `OTEL_TRACES_SAMPLER` and `OTEL_TRACES_SAMPLER_ARG`environment variables
+for following samplers: `always_on`, `always_off`, `traceidratio`,
+`parentbased_always_on`, `parentbased_always_off`, `parentbased_traceidratio`.
+
+Custom sampler detectors can be implemented:
+
+* SamplerDetectors should inherit from
+  `OpenTelemetry.Trace.ISamplerDetector`, (which belongs to the
+  [OpenTelemetry](../../../src/OpenTelemetry/README.md) package), and implement
+  the `Detect` method.
+
+A demo SamplerDetector is shown [here](./MySamplerDetector.cs).
+
 ## References
 
 * [Exporter

docs/trace/reporting-exceptions/Program.cs

@@ -30,7 +30,7 @@ public static void Main()
     {
         using var tracerProvider = Sdk.CreateTracerProviderBuilder()
             .AddSource("MyCompany.MyProduct.MyLibrary")
-            .SetSampler(new AlwaysOnSampler())
+            .ConfigureSampler(x => x.SetDefaultSampler(new AlwaysOnSampler()))
             .SetErrorStatusOnException()
             .AddConsoleExporter()
             .Build();

examples/AspNetCore/Program.cs

@@ -46,7 +46,8 @@
 {
     options
         .ConfigureResource(configureResource)
-        .SetSampler(new AlwaysOnSampler())
+        .ConfigureSampler(x => x.Clear().SetDefaultSampler(new AlwaysOnSampler()))
+
         .AddHttpClientInstrumentation()
         .AddAspNetCoreInstrumentation();
 

src/OpenTelemetry/.publicApi/net462/PublicAPI.Unshipped.txt

@@ -19,6 +19,16 @@ OpenTelemetry.Logs.OpenTelemetryLoggerOptionsExtensions
 OpenTelemetry.Logs.OpenTelemetryLoggerProvider.AddProcessor(OpenTelemetry.BaseProcessor<OpenTelemetry.Logs.LogRecord!>! processor) -> OpenTelemetry.Logs.OpenTelemetryLoggerProvider!
 OpenTelemetry.Logs.OpenTelemetryLoggerProvider.ForceFlush(int timeoutMilliseconds = -1) -> bool
 OpenTelemetry.Logs.OpenTelemetryLoggerProvider.OpenTelemetryLoggerProvider() -> void
+OpenTelemetry.Trace.ISamplerDetector
+OpenTelemetry.Trace.SamplerBuilder
+OpenTelemetry.Trace.SamplerBuilderExtensions
+static OpenTelemetry.Trace.TracerProviderBuilderExtensions.ConfigureSampler(this OpenTelemetry.Trace.TracerProviderBuilder! tracerProviderBuilder, System.Action<OpenTelemetry.Trace.SamplerBuilder!>! configure) -> OpenTelemetry.Trace.TracerProviderBuilder!
+static OpenTelemetry.Trace.TracerProviderBuilderExtensions.SetSamplerBuilder(this OpenTelemetry.Trace.TracerProviderBuilder! tracerProviderBuilder, OpenTelemetry.Trace.SamplerBuilder! samplerBuilder) -> OpenTelemetry.Trace.TracerProviderBuilder!
+~OpenTelemetry.Trace.ISamplerDetector.Detect() -> OpenTelemetry.Trace.Sampler
+~OpenTelemetry.Trace.SamplerBuilder.Build() -> OpenTelemetry.Trace.Sampler
+~OpenTelemetry.Trace.SamplerBuilder.Clear() -> OpenTelemetry.Trace.SamplerBuilder
+~OpenTelemetry.Trace.SamplerBuilder.RegisterDetector(OpenTelemetry.Trace.ISamplerDetector samplerDetector) -> OpenTelemetry.Trace.SamplerBuilder
+~OpenTelemetry.Trace.SamplerBuilder.SetDefaultSampler(OpenTelemetry.Trace.Sampler sampler) -> OpenTelemetry.Trace.SamplerBuilder
 ~OpenTelemetry.Trace.SamplingResult.TraceStateString.get -> string
 ~OpenTelemetry.Trace.SamplingResult.SamplingResult(OpenTelemetry.Trace.SamplingDecision decision, string traceStateString) -> void
 ~OpenTelemetry.Trace.SamplingResult.SamplingResult(OpenTelemetry.Trace.SamplingDecision decision, System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<string, object>> attributes, string traceStateString) -> void
@@ -50,3 +60,6 @@ static Microsoft.Extensions.DependencyInjection.TracerProviderBuilderServiceColl
 static OpenTelemetry.Trace.TracerProviderBuilderExtensions.ConfigureResource(this OpenTelemetry.Trace.TracerProviderBuilder! tracerProviderBuilder, System.Action<OpenTelemetry.Resources.ResourceBuilder!>! configure) -> OpenTelemetry.Trace.TracerProviderBuilder!
 OpenTelemetry.Metrics.MetricType.LongSumNonMonotonic = 138 -> OpenTelemetry.Metrics.MetricType
 OpenTelemetry.Metrics.MetricType.DoubleSumNonMonotonic = 141 -> OpenTelemetry.Metrics.MetricType
+~static OpenTelemetry.Trace.SamplerBuilder.CreateDefault() -> OpenTelemetry.Trace.SamplerBuilder
+~static OpenTelemetry.Trace.SamplerBuilder.CreateEmpty() -> OpenTelemetry.Trace.SamplerBuilder
+~static OpenTelemetry.Trace.SamplerBuilderExtensions.RegisterEnvironmentVariableDetector(this OpenTelemetry.Trace.SamplerBuilder samplerBuilder) -> OpenTelemetry.Trace.SamplerBuilder

src/OpenTelemetry/.publicApi/net6.0/PublicAPI.Unshipped.txt

@@ -19,6 +19,16 @@ OpenTelemetry.Logs.OpenTelemetryLoggerOptionsExtensions
 OpenTelemetry.Logs.OpenTelemetryLoggerProvider.AddProcessor(OpenTelemetry.BaseProcessor<OpenTelemetry.Logs.LogRecord!>! processor) -> OpenTelemetry.Logs.OpenTelemetryLoggerProvider!
 OpenTelemetry.Logs.OpenTelemetryLoggerProvider.ForceFlush(int timeoutMilliseconds = -1) -> bool
 OpenTelemetry.Logs.OpenTelemetryLoggerProvider.OpenTelemetryLoggerProvider() -> void
+OpenTelemetry.Trace.ISamplerDetector
+OpenTelemetry.Trace.SamplerBuilder
+OpenTelemetry.Trace.SamplerBuilderExtensions
+static OpenTelemetry.Trace.TracerProviderBuilderExtensions.ConfigureSampler(this OpenTelemetry.Trace.TracerProviderBuilder! tracerProviderBuilder, System.Action<OpenTelemetry.Trace.SamplerBuilder!>! configure) -> OpenTelemetry.Trace.TracerProviderBuilder!
+static OpenTelemetry.Trace.TracerProviderBuilderExtensions.SetSamplerBuilder(this OpenTelemetry.Trace.TracerProviderBuilder! tracerProviderBuilder, OpenTelemetry.Trace.SamplerBuilder! samplerBuilder) -> OpenTelemetry.Trace.TracerProviderBuilder!
+~OpenTelemetry.Trace.ISamplerDetector.Detect() -> OpenTelemetry.Trace.Sampler
+~OpenTelemetry.Trace.SamplerBuilder.Build() -> OpenTelemetry.Trace.Sampler
+~OpenTelemetry.Trace.SamplerBuilder.Clear() -> OpenTelemetry.Trace.SamplerBuilder
+~OpenTelemetry.Trace.SamplerBuilder.RegisterDetector(OpenTelemetry.Trace.ISamplerDetector samplerDetector) -> OpenTelemetry.Trace.SamplerBuilder
+~OpenTelemetry.Trace.SamplerBuilder.SetDefaultSampler(OpenTelemetry.Trace.Sampler sampler) -> OpenTelemetry.Trace.SamplerBuilder
 ~OpenTelemetry.Trace.SamplingResult.TraceStateString.get -> string
 ~OpenTelemetry.Trace.SamplingResult.SamplingResult(OpenTelemetry.Trace.SamplingDecision decision, string traceStateString) -> void
 ~OpenTelemetry.Trace.SamplingResult.SamplingResult(OpenTelemetry.Trace.SamplingDecision decision, System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<string, object>> attributes, string traceStateString) -> void
@@ -50,3 +60,6 @@ static Microsoft.Extensions.DependencyInjection.TracerProviderBuilderServiceColl
 static OpenTelemetry.Trace.TracerProviderBuilderExtensions.ConfigureResource(this OpenTelemetry.Trace.TracerProviderBuilder! tracerProviderBuilder, System.Action<OpenTelemetry.Resources.ResourceBuilder!>! configure) -> OpenTelemetry.Trace.TracerProviderBuilder!
 OpenTelemetry.Metrics.MetricType.LongSumNonMonotonic = 138 -> OpenTelemetry.Metrics.MetricType
 OpenTelemetry.Metrics.MetricType.DoubleSumNonMonotonic = 141 -> OpenTelemetry.Metrics.MetricType
+~static OpenTelemetry.Trace.SamplerBuilder.CreateDefault() -> OpenTelemetry.Trace.SamplerBuilder
+~static OpenTelemetry.Trace.SamplerBuilder.CreateEmpty() -> OpenTelemetry.Trace.SamplerBuilder
+~static OpenTelemetry.Trace.SamplerBuilderExtensions.RegisterEnvironmentVariableDetector(this OpenTelemetry.Trace.SamplerBuilder samplerBuilder) -> OpenTelemetry.Trace.SamplerBuilder

src/OpenTelemetry/.publicApi/netstandard2.0/PublicAPI.Unshipped.txt

@@ -19,6 +19,16 @@ OpenTelemetry.Logs.OpenTelemetryLoggerProvider.AddProcessor(OpenTelemetry.BasePr
 OpenTelemetry.Logs.OpenTelemetryLoggerProvider.ForceFlush(int timeoutMilliseconds = -1) -> bool
 OpenTelemetry.Logs.OpenTelemetryLoggerProvider.OpenTelemetryLoggerProvider() -> void
 OpenTelemetry.Logs.OpenTelemetryLoggerOptions.ConfigureResource(System.Action<OpenTelemetry.Resources.ResourceBuilder!>! configure) -> OpenTelemetry.Logs.OpenTelemetryLoggerOptions!
+OpenTelemetry.Trace.ISamplerDetector
+OpenTelemetry.Trace.SamplerBuilder
+OpenTelemetry.Trace.SamplerBuilderExtensions
+static OpenTelemetry.Trace.TracerProviderBuilderExtensions.ConfigureSampler(this OpenTelemetry.Trace.TracerProviderBuilder! tracerProviderBuilder, System.Action<OpenTelemetry.Trace.SamplerBuilder!>! configure) -> OpenTelemetry.Trace.TracerProviderBuilder!
+static OpenTelemetry.Trace.TracerProviderBuilderExtensions.SetSamplerBuilder(this OpenTelemetry.Trace.TracerProviderBuilder! tracerProviderBuilder, OpenTelemetry.Trace.SamplerBuilder! samplerBuilder) -> OpenTelemetry.Trace.TracerProviderBuilder!
+~OpenTelemetry.Trace.ISamplerDetector.Detect() -> OpenTelemetry.Trace.Sampler
+~OpenTelemetry.Trace.SamplerBuilder.Build() -> OpenTelemetry.Trace.Sampler
+~OpenTelemetry.Trace.SamplerBuilder.Clear() -> OpenTelemetry.Trace.SamplerBuilder
+~OpenTelemetry.Trace.SamplerBuilder.RegisterDetector(OpenTelemetry.Trace.ISamplerDetector samplerDetector) -> OpenTelemetry.Trace.SamplerBuilder
+~OpenTelemetry.Trace.SamplerBuilder.SetDefaultSampler(OpenTelemetry.Trace.Sampler sampler) -> OpenTelemetry.Trace.SamplerBuilder
 ~OpenTelemetry.Trace.SamplingResult.TraceStateString.get -> string
 ~OpenTelemetry.Trace.SamplingResult.SamplingResult(OpenTelemetry.Trace.SamplingDecision decision, string traceStateString) -> void
 ~OpenTelemetry.Trace.SamplingResult.SamplingResult(OpenTelemetry.Trace.SamplingDecision decision, System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<string, object>> attributes, string traceStateString) -> void
@@ -50,3 +60,6 @@ static Microsoft.Extensions.DependencyInjection.TracerProviderBuilderServiceColl
 static OpenTelemetry.Trace.TracerProviderBuilderExtensions.ConfigureResource(this OpenTelemetry.Trace.TracerProviderBuilder! tracerProviderBuilder, System.Action<OpenTelemetry.Resources.ResourceBuilder!>! configure) -> OpenTelemetry.Trace.TracerProviderBuilder!
 OpenTelemetry.Metrics.MetricType.LongSumNonMonotonic = 138 -> OpenTelemetry.Metrics.MetricType
 OpenTelemetry.Metrics.MetricType.DoubleSumNonMonotonic = 141 -> OpenTelemetry.Metrics.MetricType
+~static OpenTelemetry.Trace.SamplerBuilder.CreateDefault() -> OpenTelemetry.Trace.SamplerBuilder
+~static OpenTelemetry.Trace.SamplerBuilder.CreateEmpty() -> OpenTelemetry.Trace.SamplerBuilder
+~static OpenTelemetry.Trace.SamplerBuilderExtensions.RegisterEnvironmentVariableDetector(this OpenTelemetry.Trace.SamplerBuilder samplerBuilder) -> OpenTelemetry.Trace.SamplerBuilder

src/OpenTelemetry/.publicApi/netstandard2.1/PublicAPI.Unshipped.txt

@@ -19,6 +19,16 @@ OpenTelemetry.Logs.OpenTelemetryLoggerOptionsExtensions
 OpenTelemetry.Logs.OpenTelemetryLoggerProvider.AddProcessor(OpenTelemetry.BaseProcessor<OpenTelemetry.Logs.LogRecord!>! processor) -> OpenTelemetry.Logs.OpenTelemetryLoggerProvider!
 OpenTelemetry.Logs.OpenTelemetryLoggerProvider.ForceFlush(int timeoutMilliseconds = -1) -> bool
 OpenTelemetry.Logs.OpenTelemetryLoggerProvider.OpenTelemetryLoggerProvider() -> void
+OpenTelemetry.Trace.ISamplerDetector
+OpenTelemetry.Trace.SamplerBuilder
+OpenTelemetry.Trace.SamplerBuilderExtensions
+static OpenTelemetry.Trace.TracerProviderBuilderExtensions.ConfigureSampler(this OpenTelemetry.Trace.TracerProviderBuilder! tracerProviderBuilder, System.Action<OpenTelemetry.Trace.SamplerBuilder!>! configure) -> OpenTelemetry.Trace.TracerProviderBuilder!
+static OpenTelemetry.Trace.TracerProviderBuilderExtensions.SetSamplerBuilder(this OpenTelemetry.Trace.TracerProviderBuilder! tracerProviderBuilder, OpenTelemetry.Trace.SamplerBuilder! samplerBuilder) -> OpenTelemetry.Trace.TracerProviderBuilder!
+~OpenTelemetry.Trace.ISamplerDetector.Detect() -> OpenTelemetry.Trace.Sampler
+~OpenTelemetry.Trace.SamplerBuilder.Build() -> OpenTelemetry.Trace.Sampler
+~OpenTelemetry.Trace.SamplerBuilder.Clear() -> OpenTelemetry.Trace.SamplerBuilder
+~OpenTelemetry.Trace.SamplerBuilder.RegisterDetector(OpenTelemetry.Trace.ISamplerDetector samplerDetector) -> OpenTelemetry.Trace.SamplerBuilder
+~OpenTelemetry.Trace.SamplerBuilder.SetDefaultSampler(OpenTelemetry.Trace.Sampler sampler) -> OpenTelemetry.Trace.SamplerBuilder
 ~OpenTelemetry.Trace.SamplingResult.TraceStateString.get -> string
 ~OpenTelemetry.Trace.SamplingResult.SamplingResult(OpenTelemetry.Trace.SamplingDecision decision, string traceStateString) -> void
 ~OpenTelemetry.Trace.SamplingResult.SamplingResult(OpenTelemetry.Trace.SamplingDecision decision, System.Collections.Generic.IEnumerable<System.Collections.Generic.KeyValuePair<string, object>> attributes, string traceStateString) -> void
@@ -50,3 +60,6 @@ static Microsoft.Extensions.DependencyInjection.TracerProviderBuilderServiceColl
 static OpenTelemetry.Trace.TracerProviderBuilderExtensions.ConfigureResource(this OpenTelemetry.Trace.TracerProviderBuilder! tracerProviderBuilder, System.Action<OpenTelemetry.Resources.ResourceBuilder!>! configure) -> OpenTelemetry.Trace.TracerProviderBuilder!
 OpenTelemetry.Metrics.MetricType.LongSumNonMonotonic = 138 -> OpenTelemetry.Metrics.MetricType
 OpenTelemetry.Metrics.MetricType.DoubleSumNonMonotonic = 141 -> OpenTelemetry.Metrics.MetricType
+~static OpenTelemetry.Trace.SamplerBuilder.CreateDefault() -> OpenTelemetry.Trace.SamplerBuilder
+~static OpenTelemetry.Trace.SamplerBuilder.CreateEmpty() -> OpenTelemetry.Trace.SamplerBuilder
+~static OpenTelemetry.Trace.SamplerBuilderExtensions.RegisterEnvironmentVariableDetector(this OpenTelemetry.Trace.SamplerBuilder samplerBuilder) -> OpenTelemetry.Trace.SamplerBuilder

src/OpenTelemetry/CHANGELOG.md

@@ -11,6 +11,18 @@
 * Added support for `UpDownCounter` and `ObservableUpDownCounter` instruments.
   ([#3606](https://github.com/open-telemetry/opentelemetry-dotnet/pull/3606))
 
+* Added support for `UpDownCounter` and `ObservableUpDownCounter` instruments.
+  ([#3606](https://github.com/open-telemetry/opentelemetry-dotnet/pull/3606))
+
+* Added support for detecting, by default, sampler from the `OTEL_TRACES_SAMPLER`
+  and `OTEL_TRACES_SAMPLER_ARG`environment variables for following samplers:
+  `always_on`, `always_off`, `traceidratio`, `parentbased_always_on`,
+  `parentbased_always_off`, `parentbased_traceidratio`.
+  ([#3635](https://github.com/open-telemetry/opentelemetry-dotnet/pull/3635/))
+
+* Added support for implementing custom `SamplerDetector`.
+  ([#3635](https://github.com/open-telemetry/opentelemetry-dotnet/pull/3635/))
+
 ## 1.4.0-alpha.2
 
 Released 2022-Aug-18

src/OpenTelemetry/Trace/Builder/TracerProviderBuilderBase.cs

@@ -203,11 +203,25 @@ internal TracerProviderBuilder SetResourceBuilder(ResourceBuilder resourceBuilde
             return this.ConfigureState((sp, state) => state.SetResourceBuilder(resourceBuilder));
         }
 
+        internal TracerProviderBuilder ConfigureSampler(Action<SamplerBuilder> configure)
+        {
+            Guard.ThrowIfNull(configure);
+
+            return this.ConfigureState((sp, state) => state.ConfigureSampler(configure));
+        }
+
+        internal TracerProviderBuilder SetSamplerBuilder(SamplerBuilder samplerBuilder)
+        {
+            Guard.ThrowIfNull(samplerBuilder);
+
+            return this.ConfigureState((sp, state) => state.SetSamplerBuilder(samplerBuilder));
+        }
+
         internal TracerProviderBuilder SetSampler<T>()
             where T : Sampler
         {
             this.TryAddSingleton<T>();
-            this.ConfigureState((sp, state) => state.SetSampler(sp.GetRequiredService<T>()));
+            this.ConfigureState((sp, state) => state.ConfigureSampler(x => x.SetDefaultSampler(sp.GetRequiredService<T>())));
 
             return this;
         }
@@ -216,7 +230,7 @@ internal TracerProviderBuilder SetSampler(Sampler sampler)
         {
             Guard.ThrowIfNull(sampler);
 
-            return this.ConfigureState((sp, state) => state.SetSampler(sampler));
+            return this.ConfigureState((sp, state) => state.ConfigureSampler(x => x.SetDefaultSampler(sampler)));
         }
 
         /// <summary>

src/OpenTelemetry/Trace/Builder/TracerProviderBuilderExtensions.cs

@@ -82,6 +82,42 @@ public static TracerProviderBuilder SetSampler<T>(this TracerProviderBuilder tra
             return tracerProviderBuilder;
         }
 
+        /// <summary>
+        /// Modify the <see cref="SamplerBuilder"/> from which the Sampler associated with
+        /// this provider is built from in-place.
+        /// </summary>
+        /// <param name="tracerProviderBuilder"><see cref="TracerProviderBuilder"/>.</param>
+        /// <param name="configure">An action which modifies the provided <see cref="SamplerBuilder"/> in-place.</param>
+        /// <returns>Returns <see cref="TracerProviderBuilder"/> for chaining.</returns>
+        public static TracerProviderBuilder ConfigureSampler(this TracerProviderBuilder tracerProviderBuilder, Action<SamplerBuilder> configure)
+        {
+            if (tracerProviderBuilder is TracerProviderBuilderBase tracerProviderBuilderBase)
+            {
+                tracerProviderBuilderBase.ConfigureSampler(configure);
+            }
+
+            return tracerProviderBuilder;
+        }
+
+        /// <summary>
+        /// Sets the <see cref="SamplerBuilder"/> from which the Sampler associated with
+        /// this provider is built from. Overwrites currently set SamplerBuilder.
+        /// You should usually use <see cref="ConfigureSampler(TracerProviderBuilder, Action{SamplerBuilder})"/> instead
+        /// (call <see cref="SamplerBuilder.Clear"/> if desired).
+        /// </summary>
+        /// <param name="tracerProviderBuilder"><see cref="TracerProviderBuilder"/>.</param>
+        /// <param name="samplerBuilder"><see cref="SamplerBuilder"/> from which Resource will be built.</param>
+        /// <returns>Returns <see cref="TracerProviderBuilder"/> for chaining.</returns>
+        public static TracerProviderBuilder SetSamplerBuilder(this TracerProviderBuilder tracerProviderBuilder, SamplerBuilder samplerBuilder)
+        {
+            if (tracerProviderBuilder is TracerProviderBuilderBase tracerProviderBuilderBase)
+            {
+                tracerProviderBuilderBase.SetSamplerBuilder(samplerBuilder);
+            }
+
+            return tracerProviderBuilder;
+        }
+
         /// <summary>
         /// Sets the <see cref="ResourceBuilder"/> from which the Resource associated with
         /// this provider is built from. Overwrites currently set ResourceBuilder.