Production-grade engineering guides on distributed tracing, OpenTelemetry, context propagation, sampling, and request correlation — written for backend developers, SREs, and platform engineers running cloud-native microservices.
🌐 Live site: www.distributed-tracing.com
The site is a static reference covering four topic areas:
- Distributed Tracing Fundamentals & Architecture — span lifecycle, W3C TraceContext, head- vs tail-based sampling, storage backends (Jaeger/Tempo/Zipkin), security boundaries.
- SDK Implementation & Context Propagation — OpenTelemetry SDK setup, auto vs manual instrumentation, web-framework integration (FastAPI/Express/Spring Boot/gRPC), Collector pipelines, async and multi-threaded context.
- Baggage & Metadata Routing Workflows — W3C Baggage, tenant context, Kafka/gRPC propagation, header size limits, dynamic/canary/region routing.
- Trace-Based Debugging & Signal Correlation — correlating logs/metrics/traces, critical-path latency analysis, trace-based alerting, SLOs, and RED metrics.
Every guide includes runnable, production-quality code, hand-authored inline SVG diagrams, and operational notes on failure modes, scale, and security.
- Eleventy (11ty) static site generator
- Markdown content under
content/, Nunjucks layouts under_layouts/and_includes/ - Hand-authored inline SVG diagrams (no diagram runtime), system-font stack, no external assets
- Deployed to Cloudflare Pages
npm install # restore dependencies
npm run serve # local dev server at http://localhost:8080
npm run build # build the static site into _site/content/ Markdown source for every page (one index.md per URL)
_layouts/ Base page layout
_includes/ Header, footer, breadcrumb partials
css/ js/ Site styles and progressive-enhancement scripts
assets/ Icons and static assets
index.njk Homepage
sitemap.njk Generated sitemap.xml
Content © distributed-tracing.com. All rights reserved.