Skip to main content

​
OpenTelemetry for .NET

OpenTelemetry for .NET supports a wide range of automatic and manual instrumentation options, helping you capture spans, metrics, and logs with minimal effort.

​
Installation

Add the necessary OpenTelemetry packages to your project using NuGet: 
dotnet add package OpenTelemetry 
dotnet add package OpenTelemetry.Exporter.OTLP
For full installation instructions:
👉 OpenTelemetry .NET Getting Started

​
Auto-Instrumentation

Auto-instrumentation lets you automatically trace common libraries such as HTTP clients, database drivers, and more without needing to modify your code. OpenTelemetry provides auto-instrumentation libraries for many popular languages, making it fast to get started with tracing. For .NET, you can automatically instrument supported libraries like ASP.NET Core, HTTP clients, and more. Typically, you configure it in your Program.cs: 
builder.Services.AddOpenTelemetry().WithTracing(tracing => tracing .AddAspNetCoreInstrumentation().AddHttpClientInstrumentation().AddOtlpExporter());
Learn more:
👉 Auto-Instrumentation for .NET

​
Manual Instrumentation

Manual instrumentation gives you full control over your traces, allowing you to create spans wherever needed. You can customize span names, attributes, and relationships to capture the most important parts of your application’s flow. You can manually create and manage spans in .NET using the OpenTelemetry APIs: 
var tracer = tracerProvider.GetTracer("my-service");
using (var span = tracer.StartActiveSpan("my-operation")) { // your application logic }
Learn more:
👉 Manual Instrumentation in .NET

​
Exporters

Once your application is instrumented, you need to export telemetry data. PlayerZero supports the OpenTelemetry Protocol (OTLP) over HTTP. You can configure your OpenTelemetry SDK to export traces, logs, and metrics to PlayerZero’s endpoint by setting the endpoint URL and API token. For .NET applications, configure the OTLP exporter: Key environment variables: 
OTEL_EXPORTER_OTLP_ENDPOINT=https://sdk.playerzero.app/otlp
OTEL_EXPORTER_OTLP_HEADERS=Authorization=Bearer <your-playerzero-token> 
OTEL_TRACES_EXPORTER=otlp 
OTEL_LOGS_EXPORTER=otlp 
OTEL_METRICS_EXPORTER=otlp

​
Optional: Using a Collector

Using an OpenTelemetry Collector is optional for most setups. A collector can help route telemetry to multiple destinations, perform transformations, or batch data efficiently. You might use a collector if you want to forward telemetry to both PlayerZero and another observability platform simultaneously. You can forward your telemetry through an OpenTelemetry Collector to enrich, filter, or route spans before reaching PlayerZero. For detailed language-specific instrumentation examples and full OpenTelemetry documentation, refer to the links below.
⌘I