Networking & Protocols
Tiered cache and Cache-Control
Your CDN is in front of the origin, but the origin alarm is still firing on every deploy. New users miss the cache, every edge POP fetches from origin simultaneously, and suddenly 200 edge servers generate 200 parallel origin requests for the same uncached URL. This is not a bug — it is a missing architecture layer: the origin shield.
The four-layer cache hierarchy
When a browser makes a request, four caches may answer before origin:
- Browser memory cache (~sub-ms, in-tab lifetime)
- Browser disk cache (~10 ms, persists across tabs)
- CDN edge POP cache (~20–50 ms over the network from user)
- CDN origin shield / regional cache (~50–100 ms)
Only if all four miss does the origin server answer (~100–300 ms depending on geography). Each layer obeys the same Cache-Control directives but applies them independently.
Cache-Control directives
The Cache-Control response header tells every caching layer what to do with the response:
| Directive | Meaning |
|---|---|
max-age=3600 | Fresh for 1 hour at both browser and CDN |
s-maxage=86400 | Fresh for 1 day at CDN only (browser ignores s-maxage) |
public | Any cache (browser, CDN, proxy) may store this |
private | Only the browser cache; CDN must not store |
no-store | No cache anywhere may store this response |
no-cache | Must revalidate with origin before serving stored copy |
stale-while-revalidate=604800 | Serve stale for up to 7 days while refreshing in background |
immutable | Do not revalidate — content will never change at this URL |
Most important rule: without Cache-Control: public (or s-maxage) the CDN passes through — no caching happens. Origin response headers govern cacheability; the CDN cannot cache what the origin does not permit.
- Static assets (content-hashed JS/CSS)
- public, max-age=31536000, immutable
- Images (with hash in URL)
- public, max-age=31536000, immutable
- HTML pages (frequently updated)
- public, max-age=300, stale-while-revalidate=3600
- API responses (public, read-only)
- public, s-maxage=60, stale-while-revalidate=600
- User-specific API (auth required)
- private, no-store
- Checkout / transactional pages
- no-store
Origin shield architecture
Every CDN region may have dozens of edge POPs. Without a shield, a cache miss at all 200 POPs for a popular URL generates 200 simultaneous origin requests — a thundering herd.
Origin shield (called “Tiered Cache” at Cloudflare, “Origin Shield” at Fastly, same feature at CloudFront) is a regional intermediate cache between edge POPs and origin. All edge POPs in a region funnel their misses through one shield node. The shield maintains a larger cache; it typically absorbs 90%+ of misses without contacting origin.
Workflow for a cold URL:
- 200 edge POPs all miss simultaneously.
- All 200 forward to the regional shield.
- Shield has one outstanding origin request; the other 199 queue.
- Origin responds once; shield propagates to all 199 waiting edges.
- Origin saw 1 request instead of 200.
Static-asset versioning: making invalidation unnecessary
The cleverest cache trick: include the content hash in the filename (e.g. app.f3a2b8c.js). Set max-age=31536000, immutable (1 year). When the file changes, the hash changes, the URL changes — the cache has no entry for the new URL and fetches fresh automatically. No purge needed. Tools that do this automatically: Webpack, Vite, esbuild, Astro.
Cache invalidation patterns (when you need them)
- TTL expiry — wait for
max-ageto expire. Cheap, no API calls, but slow for urgent fixes. - Explicit purge — CDN API call:
POST /purge {"url": "/api/products"}. Fast, but slow when purging thousands of URLs per deploy. - Cache tags — tag responses at origin (
Cache-Tag: article-1001), purge by tag (POST /purge {"tag": "article-1001"}). Most flexible; requires CDN enterprise tier (Fastly, Cloudflare Enterprise).
Conditional requests and 304 Not Modified
After a browser’s local cache expires, it revalidates with If-None-Match: <etag>. If the response has not changed, the CDN (or origin) returns 304 Not Modified — empty body, saves bandwidth. CDNs handle ETags transparently for cacheable responses, forwarding to origin only when the ETag actually changed.
What does the s-maxage directive do that max-age alone does not?
Why are static-asset URLs typically content-hashed (e.g. app.f3a2b8c.js)?
Trace a cold load of an article page through the full CDN cache hierarchy.
Order Cache-Control directives from most-cacheable to least-cacheable:
- 1 public, max-age=31536000, immutable — 1 year, never re-fetched
- 2 public, max-age=3600 — 1 hour at any cache
- 3 public, max-age=60, stale-while-revalidate=600 — 60s fresh, then stale-serve for 10 min
- 4 private, max-age=300 — browser only, 5 min
- 5 no-cache — caches must revalidate every request
- 6 no-store — no cache may store this at all
- 01Why is content-hashed URL versioning preferred over manual cache purges for static assets?
- 02An origin shield is between edges and origin. 200 edges all miss the same URL simultaneously. How many origin requests does the shield generate?
- 03Your HTML page has Cache-Control: public, max-age=3600. You push a hotfix deploy. Users continue seeing the old page for up to 1 hour. What is the fastest way to make all CDN edges serve the new version within seconds?
The CDN cache hierarchy has four layers — browser memory, browser disk, edge POP, and origin shield — each obeying the same Cache-Control directives. The key directives: max-age sets the freshness window for all caches; s-maxage overrides it for shared caches (CDN) only; private excludes CDN caching; no-store forbids all caching. The origin shield prevents thundering herds by collapsing all edge misses in a region into a single origin request. Content-hashed URLs with immutable, max-age=31536000 eliminate the cache invalidation problem for static assets entirely. For mutable content, choose between TTL expiry (simple), URL purge (fast but URL-specific), or cache-tag purge (flexible, requires enterprise tier).
appears again in162
- 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
- What the three signals are: logs, metrics, and tracesjunior
- Metrics and cardinality: the cost model of a time-series databasemiddle
- Logs and volume: the cost model of structured loggingmiddle
- Traces and sampling: the cost model of distributed tracingmiddle
- Join keys and exemplars: making the three signals composemiddle
- Observability 2.0: wide events and the cost shiftsenior
- Failure modes and engineering practice: cardinality budgets, PII, and samplingsenior
- Why structured logs exist: the diary vs the spreadsheetjunior
- The production log schema: fields every line must carrymiddle
- Log levels and alert routingmiddle
- Sampling strategies and log costmiddle
- PII redaction and log injectionsenior
- Trace context propagation in logssenior
- OTel Logs Data Model and audit logs as a subsystemsenior
- OTel signals, Semantic Conventions, and the OTLP wire formatmiddle
- Auto-instrumentation and manual spans: the 80/20 of OTelmiddle
- The OTel Collector: receivers, processors, exporters, and deployment patternsmiddle
- Sampling strategies: head, tail, and parent-basedmiddle
- Vendor neutrality, eBPF instrumentation, the Operator, and browser/serverless OTelsenior
- Operating the OTel Collector: reliability, version skew, failure modes, and governancesenior
- RED and USE: two checklists, one triage disciplinejunior
- Instrumenting RED in Prometheus: counters, histograms, and cardinality disciplinemiddle
- USE on Linux: CPU, memory, disk, network, and PSImiddle
- Golden signals, dashboard layout, and service mesh auto-REDmiddle
- Cardinality as a cost driver: labels, PII, exemplars, and samplingmiddle
- Native histograms, SLO tie-in, and production failure patternsmiddle
- Choosing SLIs and SLO targets: ratios, not feelingsmiddle
- Multi-window multi-burn-rate alerting: why AND beats ORmiddle
- Error budget policy, latency SLOs, and composite journeysmiddle
- Iceberg SLIs, composite SLO math, and SLA vs SLOsenior
- Flame graphs: reading the picture that shows where time goesjunior
- Sampling vs instrumentation profiling: why 99 Hz wins in productionmiddle
- Profile types: CPU, memory, off-CPU, mutex — which one to reach formiddle
- Continuous profiling: always-on flame graphs with eBPF and trace-id correlationmiddle
- How flame graphs are built from samples, and the production workflows that use themmiddle
- Linux perf, eBPF internals, PGO, and the limits of samplingsenior
- Profiling in production: security, war stories, OTel profiles, and the infrastructure designsenior
- The debugging funnel: SLO → RED → trace → profilejunior
- OTel architecture: one SDK, four signals, one wire formatmiddle
- Cost discipline: keeping observability under 5% of infra spendmiddle
- Scale, security, and the ROI of observable systemssenior
- 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