diff --git a/docs/trace/customizing-the-sdk/README.md b/docs/trace/customizing-the-sdk/README.md index 37dafe0c8a5..e440446448c 100644 --- a/docs/trace/customizing-the-sdk/README.md +++ b/docs/trace/customizing-the-sdk/README.md @@ -34,13 +34,12 @@ using OpenTelemetry.Trace; var appBuilder = WebApplication.CreateBuilder(args); appBuilder.Services.AddOpenTelemetry() - .WithTracing(builder => builder.AddConsoleExporter()) - .StartWithHost(); + .WithTracing(builder => builder.AddConsoleExporter()); ``` > **Note** > The -[StartWithHost](../../../src/OpenTelemetry.Extensions.Hosting/README.md#extension-method-reference) +[AddOpenTelemetry](../../../src/OpenTelemetry.Extensions.Hosting/README.md#extension-method-reference) extension automatically starts and stops the `TracerProvider` with the host. ### Using Sdk.CreateTracerProviderBuilder @@ -442,8 +441,7 @@ appBuilder.Services.AddSingleton(); appBuilder.Services.AddOpenTelemetry() .WithTracing(builder => builder - .AddProcessor()) - .StartWithHost(); + .AddProcessor()); ``` When using the `AddOpenTelemetry` & `WithTracing` extension methods the @@ -451,7 +449,7 @@ When using the `AddOpenTelemetry` & `WithTracing` extension methods the into an existing collection (typically the collection used is the one managed by the application host). The `TracerProviderBuilder` will be able to access all services registered into that collection. For lifecycle management, the -`StartWithHost` registers an [IHostedService +`AddOpenTelemetry` registers an [IHostedService ](https://learn.microsoft.com/dotnet/api/microsoft.extensions.hosting.ihostedservice) which is used to automatically start the `TracerProvider` when the host starts and the host will automatically shutdown and dispose the `TracerProvider` when @@ -651,8 +649,7 @@ appBuilder.Services.Configure( appBuilder.Configuration.GetSection("OpenTelemetry:Jaeger")); appBuilder.Services.AddOpenTelemetry() - .WithTracing(builder => builder.AddJaegerExporter()) - .StartWithHost(); + .WithTracing(builder => builder.AddJaegerExporter()); ``` The OpenTelemetry .NET SDK supports running multiple `TracerProvider`s inside @@ -696,6 +693,5 @@ appBuilder.Services.Configure( appBuilder.Services.AddOpenTelemetry() .WithTracing(builder => builder .AddJaegerExporter(name: "JaegerPrimary", configure: null) - .AddJaegerExporter(name: "JaegerSecondary", configure: null)) - .StartWithHost(); + .AddJaegerExporter(name: "JaegerSecondary", configure: null)); ``` diff --git a/docs/trace/extending-the-sdk/README.md b/docs/trace/extending-the-sdk/README.md index 2fa99b399b8..7e8600eeb7f 100644 --- a/docs/trace/extending-the-sdk/README.md +++ b/docs/trace/extending-the-sdk/README.md @@ -635,7 +635,7 @@ this case). > **Note** > `ConfigureOpenTelemetryTracerProvider` and `ConfigureOpenTelemetryMeterProvider` do not automatically start OpenTelemetry. -The host is responsible for either calling `StartWithHost` in the +The host is responsible for either calling `AddOpenTelemetry` in the [OpenTelemetry.Extensions.Hosting](../../../src/OpenTelemetry.Extensions.Hosting/README.md) package, calling `Build` when using the `Sdk.CreateTracerProviderBuilder` and `Sdk.CreateMeterProviderBuilder` methods, or by accessing the `TracerProvider` diff --git a/docs/trace/getting-started-aspnetcore/README.md b/docs/trace/getting-started-aspnetcore/README.md index 22b03ef2d08..c9c7393f7f4 100644 --- a/docs/trace/getting-started-aspnetcore/README.md +++ b/docs/trace/getting-started-aspnetcore/README.md @@ -78,12 +78,11 @@ appBuilder.Services.AddOpenTelemetry() .AddService(serviceName: "OTel.NET Getting Started")) .WithTracing(builder => builder .AddAspNetCoreInstrumentation() - .AddConsoleExporter()) - .StartWithHost(); + .AddConsoleExporter()); ``` > **Note** -> The `StartWithHost` extension is part of the +> The `AddOpenTelemetry` extension is part of the [OpenTelemetry.Extensions.Hosting](../../../src/OpenTelemetry.Extensions.Hosting/README.md) package. diff --git a/src/OpenTelemetry.Api.ProviderBuilderExtensions/Metrics/OpenTelemetryDependencyInjectionMetricsServiceCollectionExtensions.cs b/src/OpenTelemetry.Api.ProviderBuilderExtensions/Metrics/OpenTelemetryDependencyInjectionMetricsServiceCollectionExtensions.cs index e87d2fd8a5c..77955dc9ef0 100644 --- a/src/OpenTelemetry.Api.ProviderBuilderExtensions/Metrics/OpenTelemetryDependencyInjectionMetricsServiceCollectionExtensions.cs +++ b/src/OpenTelemetry.Api.ProviderBuilderExtensions/Metrics/OpenTelemetryDependencyInjectionMetricsServiceCollectionExtensions.cs @@ -39,7 +39,7 @@ public static class OpenTelemetryDependencyInjectionMetricsServiceCollectionExte /// A will not be created automatically /// using this method. To begin collecting metrics use the /// IServiceCollection.AddOpenTelemetry extension in the - /// OpenTelemetry package. + /// OpenTelemetry.Extensions.Hosting package. /// /// /// The to add diff --git a/src/OpenTelemetry.Api.ProviderBuilderExtensions/Trace/OpenTelemetryDependencyInjectionTracingServiceCollectionExtensions.cs b/src/OpenTelemetry.Api.ProviderBuilderExtensions/Trace/OpenTelemetryDependencyInjectionTracingServiceCollectionExtensions.cs index f7ff9c2a831..af1bd6d0d9f 100644 --- a/src/OpenTelemetry.Api.ProviderBuilderExtensions/Trace/OpenTelemetryDependencyInjectionTracingServiceCollectionExtensions.cs +++ b/src/OpenTelemetry.Api.ProviderBuilderExtensions/Trace/OpenTelemetryDependencyInjectionTracingServiceCollectionExtensions.cs @@ -39,7 +39,7 @@ public static class OpenTelemetryDependencyInjectionTracingServiceCollectionExte /// A will not be created automatically /// using this method. To begin collecting metrics use the /// IServiceCollection.AddOpenTelemetry extension in the - /// OpenTelemetry package. + /// OpenTelemetry.Extensions.Hosting package. /// /// /// The to add