Distributed tracing
Trace requests door services heen met Activity.
Distributed tracing is een gratis C# Academy-les op CoddyKit. Dit is les 2 van 4. Je kunt de volledige les hieronder gratis lezen en daarna in de browser praktisch oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is. Deze les maakt deel uit van het leertraject C# Academy. Je voortgang wordt gesynchroniseerd op het web en in de CoddyKit-app. De cursus C# Academy bevat in totaal 4 lessen.
Wat is gedistribueerde tracering?
Gedistribueerde tracering volgt één aanvraag terwijl die door services en componenten reist. Elke werkeenheid wordt een span en de verbonden spans vormen een trace, die wordt weergegeven als een tijdlijn van geneste bewerkingen.
Spans en traces
Een span heeft een naam, een begin- en eindtijd, kenmerken en een status. Spans worden genest: een bovenliggende span (de HTTP-aanvraag) bevat onderliggende spans (een databasequery, een uitgaande aanroep). Eén volledige boom deelt één trace-id.
Activity is de .NET-span
In .NET is de klasse System.Diagnostics.Activity de implementatie van een OpenTelemetry-span. Je maakt activities vanuit een ActivitySource.
using System.Diagnostics;
private static readonly ActivitySource Source =
new("Checkout.Orders");Een activity starten
StartActivity start een span. Plaats deze in een using, zodat de span eindigt (en de duur ervan wordt vastgelegd) wanneer het blok wordt verlaten.
using Activity activity = Source.StartActivity("PlaceOrder");
// work happens here; span ends when disposedTags aan een span toevoegen
Tags (kenmerken) koppelen context in de vorm van sleutel-waardeparen aan een span, zoals een order-id of bedrag, zodat traces doorzoekbaar en betekenisvol worden.
activity?.SetTag("order.id", orderId);
activity?.SetTag("order.amount", amount);Gebeurtenissen en status vastleggen
Gebruik AddEvent voor annotaties op een specifiek tijdstip en SetStatus om succes of mislukking aan te geven. Daardoor worden fouten zichtbaar in je achterliggende systeem voor tracering.
activity?.AddEvent(new ActivityEvent("inventory.reserved"));
activity?.SetStatus(ActivityStatusCode.Error, "Payment declined");De ActivitySource registreren
OTel verzamelt alleen activities uit bronnen die je met AddSource registreert. Geef de tracer daarom de naam van je ActivitySource door.
builder.Services.AddOpenTelemetry()
.WithTracing(tracing => tracing
.AddSource("Checkout.Orders"));Automatische instrumentatie
Ingebouwde instrumentatie maakt automatisch spans voor binnenkomende ASP.NET Core-aanvragen en uitgaande HttpClient-aanroepen. Zo krijg je een basistrace zonder code te schrijven.
tracing
.AddAspNetCoreInstrumentation()
.AddHttpClientInstrumentation();Contextpropagatie
Om een trace over meerdere services te laten lopen, moet de trace-id ertussen worden doorgegeven. OTel voegt deze toe aan uitgaande HTTP-kopteksten (W3C traceparent) en leest hem aan de ontvangende kant uit, zodat de spans automatisch tot één trace worden samengevoegd.
Relaties tussen bovenliggende en onderliggende activities
Wanneer je een activity start terwijl een andere activity de huidige is, wordt de nieuwe via Activity.Current het onderliggende element. Door deze nesting ontstaat de traceboom zonder handmatige koppelingen.
using var parent = Source.StartActivity("PlaceOrder");
using var child = Source.StartActivity("ChargeCard");
// child is nested under parent automaticallySampling
Elke aanvraag traceren kan duur zijn. Met sampling leg je slechts een deel vast (bijvoorbeeld 10%), zodat je de kosten beheerst en toch representatieve gegevens behoudt.
Korte controle
Test gedistribueerde tracering.
Samenvatting
Gedistribueerde tracering volgt een aanvraag als verbonden spans die één trace-id delen. In .NET is Activity de span, gemaakt vanuit een geregistreerde ActivitySource via StartActivity (gebruik using om de span te beëindigen). Voeg context toe met SetTag, AddEvent en SetStatus. Automatische instrumentatie en W3C-contextpropagatie verbinden traces over services heen; sampling beheerst de kosten.
Leer C# met een AI-tutor — gratis
Schrijf echte code en voer die uit in je browser, krijg direct hulp van een AI-tutor die 24/7 beschikbaar is en ga verder waar je gebleven bent op het web of in de app.
- Cursussen
- 93
- Lessen
- 346
Veelgestelde vragen
Is de les “Distributed tracing” gratis?
Ja — de volledige tekst van “Distributed tracing” kun je hier gratis op het web lezen. Als je interactief wilt oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is, en de rest van de cursus C# Academy wilt ontgrendelen, kun je upgraden naar CoddyKit PRO. De cursus C# Academy bevat in totaal 4 lessen.
Wat leer ik in “Distributed tracing”?
Trace requests door services heen met Activity. Je oefent met C# Academy door code rechtstreeks in de browser uit te voeren. Een AI-begeleider die 24/7 beschikbaar is beantwoordt je vragen terwijl je de les doorwerkt.
Heb ik ervaring nodig om met C# Academy te beginnen?
Ervaring vooraf is niet nodig. C# Academy op CoddyKit is opgebouwd voor beginners tot gevorderden, zodat je hier of bij het begin kunt starten en in je eigen tempo kunt leren. Dit is les 2 van 4.
Hoe lang duurt de les “Distributed tracing”?
De meeste lessen van CoddyKit duren ongeveer 5–10 minuten. Elke les is kort en interactief, zodat je gestaag vooruitgaat en op het web en in de app precies verdergaat waar je was gebleven.
Kan ik code schrijven en uitvoeren in deze les over C# Academy?
Ja. Elke les over C# Academy bevat een ingebouwde code-editor, zodat je rechtstreeks in je browser echte code kunt schrijven en uitvoeren en direct feedback van AI krijgt — lokale installatie is niet nodig.