QuickDevGuide

Home › OpenTelemetry (Observability)

Manual Tracing in .NET (ActivitySource) — OpenTelemetry (Observability)

In .NET, OpenTelemetry tracing is built on System.Diagnostics: an Activity is a span and an ActivitySource is a tracer. No OTel package is needed in your library code — only the app wires up exporters. OTel concept .NET API Tracer new ActivitySource("Orders.Service") Start span source.StartActivity("ReserveStock", ActivityKind.Internal) Attribute activity?.SetTag("order.id", id) Event activity?.AddEvent(new ActivityEvent("cache.miss")) Status activity?.SetStatus(ActivityStatusCode.Error, "msg") Exception activity?.AddException(ex) (.NET 9) or record an event Current span Activity.Current StartActivity returns null when nobody is listening or the span isn't sampled — always use ?.. Register the source with .AddSource("Orders.").

Key Takeaways