open-telemetry / opentelemetry-dotnet

State Management - open-telemetry/opentelemetry-dotnet

State management in the OpenTelemetry .NET project involves handling and managing the state of the application’s telemetry data, such as metrics, logs, and traces. Here are the possible options for state management in this project, along with examples for each option:

  1. OpenTelemetry .NET SDK: The OpenTelemetry .NET SDK provides a way to manage the state of telemetry data within the application. It includes APIs and implementations for tracing, metrics, and logs. Here’s an example of using the tracing API:
using OpenTelemetry.Api;
using OpenTelemetry.Context.Propagation;
using OpenTelemetry.Trace;

// Create a tracer provider
var tracerProvider = Sdk.CreateTracerProviderBuilder()
.AddSource("MyCompany.MyProject")
.Build();

// Create a tracer
var tracer = tracerProvider.GetTracer("MyCompany.MyProject");

// Create a new span
using (var span = tracer.StartSpan("MyOperation"))
{
// Do some work...
}
  1. OpenTelemetry Protocol (OTLP) Exporters: The OpenTelemetry .NET project includes exporters for the OpenTelemetry Protocol, which provides a general-purpose telemetry data delivery protocol. Here’s an example of using the OTLP gRPC exporter:
using OpenTelemetry.Exporter;
using OpenTelemetry.Trace;

// Create an OTLP gRPC exporter
var exporter = new OtlpGrpcExporter()
{
Endpoint = new Uri("https://localhost:55681")
};

// Create a tracer provider with the OTLP gRPC exporter
var tracerProvider = Sdk.CreateTracerProviderBuilder()
.AddSource("MyCompany.MyProject")
.AddConsoleExporter()
.AddOtlpGrpcExporter(exporter)
.Build();
  1. Automatic Instrumentation: The OpenTelemetry .NET Automatic Instrumentation provides a way to automatically instrument popular .NET frameworks and libraries, without requiring code changes. Here’s an example of using the automatic instrumentation with ASP.NET Core:
using OpenTelemetry.Instrumentation.AspNetCore;

public void ConfigureServices(IServiceCollection services)
{
// Add OpenTelemetry automatic instrumentation for ASP.NET Core
services.AddOpenTelemetryTracing((builder) =>
{
builder
.SetResourceBuilder(ResourceBuilder.CreateDefault().AddService("MyCompany.MyProject"))
.AddAspNetCoreInstrumentation();
});

// Add other services...
}

Sources: