Observability
Linux perf, eBPF internals, PGO, and the limits of sampling
A flame graph shows 8% of total fleet CPU in a third-party profiler’s own stack-walking code. The profiler is profiling itself. This is not a bug — it is a symptom of deep stacks and misconfigured symbol resolution, two of the senior-level edge cases that production profiling routinely surfaces.
Linux perf: the kernel foundation
Linux’s perf subsystem is the foundation under most profilers. The kernel exposes perf_event_open(2), which lets user space request sampling on CPU cycles, hardware events, cache misses, or software events. When the configured number of events fires, the kernel captures the current PID, the user-space stack pointer, and writes them to a ring buffer. User space reads the buffer and reconstructs stacks.
Kernel-side cost: ~1-5 microseconds per sample including the stack walk. Modern Linux (5.x+) supports BPF programs attached to perf events, letting user space customise what is captured — filter by PID, attach metadata, do statistical processing in-kernel. This is the engine under Pyroscope eBPF, Parca, BCC’s profile.bt, and any eBPF-based continuous profiler.
The security implication: perf_event_open requires capabilities (CAP_PERFMON in newer kernels, or root historically). Production deployments use kernel-side cgroup permissions to restrict what each container can observe.
eBPF and JIT stack-unwinding nuances
The kernel can walk user-space stacks easily for compiled binaries (Go, Rust, C++) — frame pointers or DWARF unwind info on the stack. For JIT runtimes (V8, JVM, .NET CLR), the stack contains JIT-compiled code addresses that do not correspond to stable symbols.
Profilers handle this with perf maps: JITs emit /tmp/perf-PID.map files mapping address ranges to function names, which the profiler ingests. JVM async-profiler bypasses this by hooking into AsyncGetCallTrace — a JVM API that returns Java stack frames directly. V8 supports --perf-prof / --perf-basic-prof flags.
The challenges:
- Maps can lag behind recompilations — hot functions get re-JIT’d and the old map entry is stale.
- Stack unwinding can fail through certain JIT frames, leaving gaps.
- Production profilers handle 90-95% of stacks accurately; the rest show as
[unknown].
Mysterious [unknown] gaps in a flame graph almost always indicate a JIT-frame unwinding issue, not a bug in the application code.
Off-CPU profiling: the scheduler hook
Brendan Gregg’s 2013 work on off-CPU analysis identified the gap that CPU profiles leave. eBPF made off-CPU profiling cheap by hooking the kernel scheduler’s switch events (sched_switch tracepoint). When the scheduler removes a thread from CPU (it blocks on I/O, sleeps, waits on a lock), the kernel’s BPF program captures the thread’s stack and records the timestamp. When the thread comes back on CPU, elapsed time is attributed to the captured stack.
Production usage: off-CPU profiling is essential for I/O-bound services (databases, network gateways) where CPU profiles show ~5% of time and the real work happens waiting. Cost: comparable to CPU profiling (~2-5%) when sampling; unsampled (every scheduler switch) can be expensive on highly-switching workloads. Production deployments cap to ~99 Hz for off-CPU as well.
Profile-guided optimisation (PGO)
Profilers do not just diagnose — they feed back into compilation. PGO workflow:
- Compile a binary with instrumentation (or use sampling profiles from CPU profiler).
- Run the binary under representative load to collect a profile.
- Recompile with the profile as compiler input.
The compiler now knows which branches are hot vs cold, which functions to inline aggressively, how to lay out basic blocks for CPU cache locality. Real-world PGO improvements: Go 1.21+ PGO gives 2-7% speedup on typical workloads (Go’s CPU pprof profile is directly consumable as PGO input). Chrome saw 10%+ from PGO + LTO. PostgreSQL benchmarks 5-15%.
Continuous profiling backends increasingly support exporting profiles in PGO-compatible formats, enabling automated “profile → recompile → validate” pipelines in CI.
Sampling biases and blind spots
Sampling has limits that senior engineers must know:
Short hot paths: functions whose entire runtime is shorter than the sample interval (10 ms at 100 Hz) can be missed. A function called 1 million times for 5 microseconds each (5 s total CPU) might never be sampled — each call ends before the timer fires. Mitigation: longer profiling windows, higher sample rates, or instrumentation for that specific path.
NUMA / multi-CPU asymmetry: profilers usually sample uniformly across CPUs. If work is unevenly distributed (common on NUMA systems or with thread affinity set wrong), the hot CPU’s bottleneck dominates and the profile looks skewed. Use per-CPU profile views to see imbalance.
Statistical accuracy at low sample counts: at 100 Hz for 10 seconds you have 1,000 samples. A function using 1% CPU appears in ~10 samples — enough to notice, insufficient for precise estimates. Standard error is ~30% for functions under 10% CPU. For sub-1% regressions, a longer capture (60-300 s) or differential profile is required.
- Flame graph paper
- Brendan Gregg, ACM Queue 2016
- perf_event_open kernel cost
- ~1-5 μs / sample
- Go PGO speedup (real workloads)
- 2-7%
- JIT stack-unwind success rate
- ~90-95% typical
- Off-CPU sampling cap in production
- ~99 Hz
- Pyroscope 2.0 release
- April 2026
- OTel profile signal status
- Beta as of 2026
| Edge case | Symptom | Mitigation |
|---|---|---|
| Very short hot functions | Function never appears in samples | Longer capture, higher rate, or instrumention |
| JIT frame unwinding failure | [unknown] frames in flame graph | Enable JIT perf maps or use native profiler |
| Deep middleware stacks | Profiler overhead 3-4x higher than claimed | Cap max-depth to 64; trim middleware chain |
| NUMA CPU imbalance | Hotspot on one NUMA node invisible in fleet-avg | Use per-CPU profile views |
A Go service that uses heavy cgo (C bindings) shows unexpectedly high profiler overhead at the default sample rate. What is the likely cause?
A function is called 1 million times per second for 5 μs each (5 CPU-seconds per second). At 100 Hz sampling, how reliably will it appear in the profile?
- 01How does perf_event_open work mechanically, and why does it require special capabilities?
- 02Explain how PGO works and why it is applicable only to specific workloads.
- 03A flame graph shows [unknown] frames in the middle of a Java service's call chain. Walk through the diagnosis and fix.
All profilers sit on the Linux perf_event_open kernel interface, with BPF programs doing in-kernel aggregation and filtering. JIT runtimes (JVM, V8, .NET) require extra support — perf maps or native hooks like AsyncGetCallTrace — because their code addresses are not statically mapped to function names; absent this, stacks show as [unknown]. Off-CPU profiling uses the sched_switch kernel hook to capture stacks at the moment a thread is descheduled, attributing wait time to the blocking call site. PGO feeds CPU profiles back to the compiler for 2-7% speedups. Sampling blind spots include very-short-lived hot functions (shorter than the sample interval), NUMA imbalance, and deep middleware chains that inflate per-sample overhead. Knowing these limits is what separates a senior engineer who trusts a flame graph from one who knows when to mistrust it.
appears again in167
- The journey of a request: seven stops from socket to responsejunior
- Accept and parse: from kernel queue to a typed requestmiddle
- Routing and middleware: choosing what runs, and in what ordermiddle
- Handler and response: from business logic to bytes on the wiremiddle
- Streaming and backpressure: when the client reads slower than you writesenior
- Timeouts and tail latency: budgets, deadlines, and the fan-out trapsenior
- Middleware and DI: the two patterns that shape every backendjunior
- Writing middleware: signatures, next(), and the three framework modelsmiddle
- Inversion of control: how dependencies reach a classmiddle
- DI scopes and lifecycles: singleton, request, transientmiddle
- DI as a testing seam: fakes, mocks, and the boundary that matterssenior
- DI containers in production: resolution graphs, circular deps, and when not tosenior
- Blocking vs non-blocking I/O: two ways to waitjunior
- The event loop: one thread, ordered phasesmiddle
- What blocks the loop: CPU work and sync callsmiddle
- Offloading CPU work: worker threads and the libuv poolmiddle
- Backpressure and bounded concurrencysenior
- Throughput under load: tail latency and saturationsenior
- Why pool: the cost of creating a connectionjunior
- Pool sizing: why bigger is not fastermiddle
- Acquisition and timeouts: the wait queue is the real latency dialmiddle
- Retry strategies: backoff, jitter, and thundering herdmiddle
- Observability, production failures, and global-scale designsenior
- Tasks, microtasks, and scheduler.yield()middle
- Timer accuracy, throttling, and idle workmiddle
- Node.js event loop: phases, nextTick, and loop lagsenior
- Rendering strategies: SSG, SSR, ISR, streaming, and hydrationjunior
- SSG, SSR, ISR, streaming, and RSC — how each worksmiddle
- Hydration cost: selective, progressive, islands, resumabilitymiddle
- Core Web Vitals: what LCP, INP, and CLS measurejunior
- LCP: four phases, one dominant costmiddle
- INP: input delay, processing, presentationmiddle
- Lab vs field: why the two disagree and how to use eachmiddle
- Metric tradeoffs, RUM attribution, and the CI+field loopsenior
- The full picture: URL to LCP to INP as a relay racejunior
- Eight layers traced: from the service worker to the second navigationmiddle
- Five canonical breaks: where production reliably diessenior
- The three-track method: reading traces and building a monitored systemsenior
- What an index is and how it speeds up queriesjunior
- The leading-column rule and composite index designmiddle
- Partial, expression, and covering indexesmiddle
- Index types: GIN, GiST, BRIN, Hash, Bloom, and HOT updatesmiddle
- Index-only scans, the Visibility Map, and INCLUDEsenior
- Production failure modes and the index audit playbooksenior
- Index design exercise: full-text search strategysenior
- EXPLAIN and execution plans: what the planner decides and whyjunior
- Scan types: Seq, Index, Bitmap, Index-Onlymiddle
- Join algorithms and the row-estimate cascademiddle
- pg_statistic, ANALYZE, and production observabilitymiddle
- Extended statistics: fixing correlated-column estimate failuressenior
- Plan cache, cost-constant tuning, and planner internalssenior
- Production failure modes and plan stabilitysenior
- Connection pools: amortising the cost of a Postgres backendjunior
- PgBouncer session, transaction, and statement modesmiddle
- Pool sizing: the (cores × 2) + spindles formula and the two-layer stackmiddle
- Pool exhaustion and idle-in-transaction: the 3 AM failure modemiddle
- Migrating to transaction mode: rollout playbook and PgBouncer 1.21 prepared statementsmiddle
- The Postgres process model and why raising max_connections degrades throughputsenior
- Pooler landscape 2026, serverless connection storms, and the full failure-mode taxonomysenior
- ADD COLUMN: instant in PG 11+ vs rewrite in older Postgresjunior
- The lock-queue failure mode: why instant DDL can freeze the databasemiddle
- Safe DDL patterns: NOT VALID, CONCURRENTLY, and unsafe-op fixesmiddle
- Migration failure taxonomy and production disciplinesenior
- Shard-key selection: hash, range, list, and directory strategiesmiddle
- Co-location and Citus: the invariant that makes sharding usablemiddle
- The hot-shard failure mode: detection, isolation, and durable policymiddle
- Online resharding, 2PC, and the operational cost of shardingsenior
- The seven acts: from CREATE TABLE to Citusjunior
- Acts 1–3 in depth: schema, indexes, and planner statisticsmiddle
- Acts 4–6 in depth: MVCC bloat, connection pooling, and safe migrationsmiddle
- Act 7 in depth: sharding, co-location, and the seven-tier tradeoff cascademiddle
- Observability, anti-patterns, and production triagesenior
- Bits on the wirejunior
- Latency mathmiddle
- Bufferbloat and congestionsenior
- The physical frontiersenior
- Sequence numbers and connection statemiddle
- Flow control and congestion controlmiddle
- BBR, production observability, and beyond TCPsenior
- CDN: putting content next doorjunior
- Anycast and GeoDNS: routing to the nearest edgemiddle
- Tiered cache and Cache-Controlmiddle
- Vary header and cache keysmiddle
- Stale-while-revalidate and cache stampedesenior
- Edge workers and edge-side compositionsenior
- CDN operations and observabilitysenior
- WebSocket: the HTTP upgrade handshakejunior
- WebSocket vs SSE vs long-polling: choosing the right transportmiddle
- WebSocket backpressure: when clients can''''t keep upmiddle
- Reconnection: jittered backoff, thundering herd, message resumptionsenior
- WebSocket at scale: HTTP/2 multiplexing, permessage-deflate, C10Msenior
- WebSocket in production: proxies, security, and distributed architecturesenior
- What reverse proxies dojunior
- Balancing algorithms: round-robin to power-of-two-choicesmiddle
- L4 vs L7 load balancing and client-IP preservationmiddle
- Health checks, connection draining, and slow startmiddle
- Retry storms, circuit breakers, and load sheddingsenior
- Resilient LB architecture: anycast, zone-aware routing, and observabilitysenior
- Why QUIC and not TCP+TLSjunior
- QUIC streams and head-of-line blockingjunior
- Integrated handshake and 1-RTTmiddle
- Connection IDs and network migrationmiddle
- Loss detection and congestion controlmiddle
- 0-RTT resumption and packet encryptionsenior
- Deployment tradeoffs and CPU costsenior
- DDoS: what it is and why it worksjunior
- Amplification attacks and state exhaustionmiddle
- Rate limiting: algorithms and architecturemiddle
- WAFs, firewalls, mTLS, and HSTSmiddle
- DNS cache poisoning and BGP hijackingsenior
- Defense-in-depth architecture and attack economicssenior
- The twelve layers: one URL, seven actorsjunior
- DNS, TCP, TLS in sequence: where the milliseconds gomiddle
- Critical render path and Core Web Vitalsmiddle
- Proxy intercepts and security gates: rate limiters, WAF, mTLSmiddle
- Alternate paths: QUIC 0-RTT, WebSocket upgrade, connection migrationmiddle
- Observability: distributed traces, USE/RED, and samplingsenior
- Resilience: cascading retries, circuit breakers, and error budgetssenior
- Why profile first: measure where time actually goesjunior
- Amdahl''''s law and self-time: the ceiling on every speedup you can shipmiddle
- The measurement loop: microbench, macrobench, prod profile, observer effectmiddle
- Reading flame graphs: shapes, per-language profilers, and the 60-second scanmiddle
- Statistical baselines: why one run is not a measurementmiddle
- Profiler history and microbenchmark pitfalls: Knuth to GWPsenior
- Hardware counters, cold-start profiles, and profile securitysenior
- Continuous profiling at scale: costs, CI gates, trace correlation, and anti-patternssenior
- What makes a hot path: symptom vs causejunior
- Five shapes of hotspot: CPU, alloc, cache, lock, syscallmiddle
- Reading parent and child chains: where to apply the fixmiddle
- JIT deopt, the fix-and-verify loop, and PR-time profilingmiddle
- Hardware counters and Intel TMA: sub-category diagnosissenior
- False sharing and native-bridge hot pathssenior
- Hot paths in production: security, tail latency, and tooling lineagesenior
- Memory hierarchy: why the same O(N) loop can be 17x slowerjunior
- Row-major vs column-major: access order and the 9x gapjunior
- Branch prediction and branchless codemiddle
- Hardware prefetcher, TLB, and memory-level parallelismsenior
- GC basics: what the runtime taxes you forjunior
- GC algorithms: generational, concurrent, and per-runtimemiddle
- GC tradeoffs: pause, throughput, heap — and object poolingmiddle
- GC tuning: pacing, heap shape, and allocation observabilitymiddle
- GC internals: tri-color invariant, write barriers, and per-runtime deep-divessenior
- GC in production: observability, security, edge cases, and fleet governancesenior
- N+1: one logical operation, many round-tripsjunior
- Fix families: JOIN, IN, preload, and DataLoadermiddle
- Detecting N+1: query logs, APM traces, and CI gatesmiddle
- DataLoader: batching across resolver treesmiddle
- Cross-protocol N+1: HTTP fan-out and Redis MGETmiddle
- N+1 at scale: pool exhaustion, plan changes, and denormalisationsenior
- Batching: amortize fixed cost per operationjunior
- The batching window: size and wait timemiddle
- Batching in Kafka and Postgresmiddle
- io_uring and observability of batchingmiddle
- From Nagle to io_uring: evolution of batchingmiddle
- Backpressure, failure isolation, and batch security in productionsenior
- What a bundle actually costs: download, parse, compile, executejunior
- Core Web Vitals: LCP, INP, and CLSmiddle
- Code splitting: route-level, component-level, vendor splittingmiddle
- Tree shaking and compression: removing what you don''''t usemiddle
- Third-party scripts: the silent budget killermiddle
- CI enforcement and RUM: making budgets stickmiddle
- V8 JIT pipeline, HTTP priorities, and bundle securitysenior
- The performance loop: discipline, not a projectjunior
- Classify and fix: matching bottleneck families to remediesmiddle
- Observability stack and CI gates: catching regressions before they shipmiddle
- Incident to enforcement: SLO burn to verified fix in 35 minutesmiddle
- Culture, economics, and org-scale performancesenior