Wiki hub
Traces
End-to-end records of a single request as it moves through every service it touches — the map of how your system actually behaves.
Last updated
A trace represents the full journey of a single request as it passes through a distributed system — from the load balancer, through half a dozen microservices, to the database and back. Each unit of work within that journey is a span, and spans are linked together into a tree that shows exactly which service called which, how long each step took, and where time was actually spent.
Where a metric might tell you “p99 latency on checkout is up,” a trace shows you the one slow database call, three services deep, that’s actually responsible.
Why traces matter
- They show causality, not just correlation. Traces reconstruct the real call graph of a request, which is invaluable once a system has more than a handful of services.
- They pinpoint the bottleneck. Instead of guessing which of ten services is slow, a trace waterfall shows exactly which span dominates the total request time.
- They reveal architecture as it actually is. Auto-generated service maps from trace data are often more accurate than any architecture diagram, since they reflect real traffic.
Key concepts
- Spans and context propagation. Each span has a start time, duration, and metadata; spans are connected across service boundaries by propagating a trace context (typically via HTTP headers) so every hop can attach itself to the same trace.
- Sampling. Capturing every single trace is often too expensive at scale, so systems use head-based sampling (decide upfront) or tail-based sampling (decide after seeing the full trace, so you can keep the interesting ones — errors, outliers).
- Trace context standards. The W3C Trace Context standard defines how trace IDs propagate across services and vendors, which is what allows different tools and languages to interoperate.
- Service maps. Aggregating many traces reveals a dependency graph between services, useful for both architecture understanding and blast-radius analysis during incidents.
Where traces fit with the other pillars
Metrics tell you something is slow; traces tell you exactly where in the call chain. From a specific span, you can usually jump straight to the logs emitted during that request, and if the bottleneck turns out to be CPU-bound code rather than a network call, continuous profiling shows you the exact function responsible.
Articles in this hub
How trace and span IDs propagate across service boundaries into one coherent trace, and the W3C standard that lets vendors interoperate.
Head-based vs. Tail-based SamplingTwo opposite strategies for deciding which traces to keep — deciding instantly at the start of a request versus waiting to see the whole trace before deciding.
Service Maps and Dependency GraphsHow aggregating trace data into a visual dependency graph reveals a system's real architecture, and where that picture falls short.
Reading a Trace Waterfall for LatencyHow to read a trace's waterfall (Gantt) view to find the span actually responsible for latency, rather than the span that merely appears longest.
Auto-Instrumentation vs. Manual Instrumentation for TracingThe trade-off between framework-level tracing that requires no code changes and hand-written spans that capture business-specific context.
Popular traces tools
Open source
Grafana Labs' open-source tracing backend that stores traces in object storage and indexes only trace IDs, trading flexibility for low cost at scale.
A CNCF-graduated, open-source distributed tracing system originally built at Uber, now rebuilt on the OpenTelemetry Collector core.
An open-source, OpenTelemetry-native observability platform combining traces, metrics, and logs in one UI.
One of the earliest open-source distributed tracing systems, still widely deployed and broadly compatible.
Commercial / managed
AWS's native distributed tracing service, transitioning to OpenTelemetry-based instrumentation and now the trace storage layer behind Application Signals.
A unified commercial observability platform covering infrastructure metrics, APM/distributed tracing, log management, and continuous profiling.
An AI-assisted, full-stack observability platform built around automatic instrumentation and causal root-cause analysis.
A managed observability platform built around high-cardinality, wide structured events, marketed as the model for what its founders call 'Observability 2.0'.