Feedback: 'OpenTelemetry'

[stevedowling]

Feedback for 'OpenTelemetry' https://docs.particular.net/nservicebus/operations/opentelemetry

Location in GitHub: https://github.com/Particular/docs.particular.net/blob/master/nservicebus/operations/opentelemetry.md

There are two ways to setup OpenTelemetry, using the SDK, or using .NET Core host builder extension methods. In this page, the first example uses the SDK:

var meterProviderProvider = Sdk.CreateMeterProviderBuilder()
    .AddMeter("NServiceBus.Core.Pipeline.Incoming")
    // ... Add other meters
    // ... Add exporters
    .Build();

While there is a further example further down the page uses the service provider extension:

services.AddOpenTelemetry()
    .ConfigureResource(builder =>
        builder.AddService("MyService", serviceInstanceId: serviceInstanceId.ToString()));

A user coming to this page to implement OpenTelemetry is likely to want to know which meters and telemetry are available from NServiceBus. How to implement them in .NET is available in Microsoft and OpenTelemetry documentation. Having different methods could add confusion and bloats the page.

Suggestion: Remove snippet from docs and allow user to view samples