The Runtime Theory
Distributed SystemsIn production

Distributed Tracing Explained

Recording in progress
#tracing#observability#microservices

A trace is a tree of spans, and the tree only exists because every service forwards the same identifiers. We follow a request as it crosses service boundaries: the trace ID, the span ID, and the parent span ID travel in headers, and each service appends its own node to the tree.

Topics covered:

  • The data model: trace ID, span IDs, and parent-child edges
  • Context propagation: the W3C traceparent headers that carry the tree
  • Where spans get created: client, server, and internal spans
  • Timing: how the critical path is computed from span durations
  • Sampling: why head sampling loses trees and how tail sampling keeps them
  • Storage and query: reconstructing one trace from millions of spans

Related articles

More in Distributed Systems

08:50
distributed systems

Raft Consensus Explained

Leader election, log replication, and safety — the consensus algorithm that powers etcd, CockroachDB, and TiKV, explained from first principles.

Watch
In production
distributed systems

Data Partitioning Explained

Range, hash, and hybrid partitioning — where each key's row actually lives, how partitions are balanced, and what happens when one partition becomes a hotspot.

Details
In production
distributed systems

Distributed Locks and Leases

What a lock actually protects in a distributed system — lease-based locks with expiry, fencing tokens against stale holders, and why client crashes are the hard case.

Details
In production
distributed systems

Gossip Protocols

Membership, failure detection, and state propagation — how nodes exchange information through random peer conversations so the whole cluster converges without a coordinator.

Details
In production
distributed systems

Chaos Engineering Basics

Fault injection with a controlled blast radius — killing nodes, dropping packets, and inducing latency to verify that recovery paths actually work, not just that they exist.

Details
In production
distributed systems

Leader Election in Practice

How real systems elect leaders — ZooKeeper's Zab, etcd's Raft, and lease-based locks — plus fencing tokens and why a stale leader must be fenced before it writes.

Details
In production
distributed systems

Consistent Hashing Visualized

Watch keys land on a hash ring — what consistent hashing actually does when a cache node dies, and why ring position and virtual nodes determine how many keys move.

Details
In production
distributed systems

Distributed Transactions Explained

Two-phase commit, prepare and commit phases, and the coordinator failure window — how databases coordinate atomic writes across machines and what happens when a participant crashes.

Details
In production
distributed systems

Raft Consensus Visualized

See Raft's term clock, randomized leader election, and log replication in motion — what actually happens in etcd, CockroachDB, and TiKV when a server fails or the network splits.

Details

Depth, delivered weekly

One technical dispatch a week — articles and episode notes before they go public.

One technical dispatch per week. No noise.