Skip to content

Commit db0def7

Browse files
committed
Add downloads landing page prose for deep-dives in articles
1 parent 3902829 commit db0def7

83 files changed

Lines changed: 1415 additions & 405 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

_TODO.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -280,3 +280,4 @@ $2500 onboarding + $500 just for being on call for the week + hours paid for act
280280
## Content Issues
281281

282282
- "### Geographic/Currency Mismatches" in src/content/articles/cdn-edge-caching-cache-keys-vary-headers/index.mdx
283+
- src/content/articles/chaos-engineering-failure-injection-low-cost-experiments/pdf.mdx is empty
Lines changed: 18 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,29 @@
11
---
2-
title: ""
3-
description: ""
2+
title: "Download Your Alert Fatigue Reduction Guide"
3+
description: "Get the e-book: Systematic triage to reduce alert noise and make the alerts that remain actually actionable."
44
author: "kevin-brown"
55
cover: "./download.png"
66
coverAlt: ""
7-
publishDate: 2025-01-15
7+
publishDate: 2025-10-05
88
isDraft: false
99
fileType: "Whitepaper"
1010
fileSize: "2.3 MB"
1111
pages: 24
1212
fileName: "*.pdf"
1313
---
1414

15+
On-call rotations with high alert volume drain engineers and slow incident response. An audit found one team managing 47 alerts per 24-hour shift—44 required no action, while the real issue went unnoticed in the noise.
16+
17+
This complete guide walks you through the systematic process used to reduce a 200-alert-per-week system to 35 actionable alerts, with a 90% action rate—transforming on-call from a burnout machine into a sustainable feedback loop.
18+
19+
Read this e-book to understand:
20+
21+
- The quantifiable cost of alert fatigue (MTTA, action rate, burnout indicators)
22+
- How to audit and inventory your alerts systematically
23+
- Classification frameworks for separating signal from noise
24+
- Threshold tuning strategies that adapt to your actual traffic patterns
25+
- Aggregation and grouping techniques to consolidate related alerts
26+
- Inhibition rules to suppress downstream consequences
27+
- Long-term maintenance practices to prevent alert creep
28+
29+
Download Your Alert Fatigue Reduction Guide now to implement a sustainable on-call system where alerts actually matter.
Lines changed: 19 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,30 @@
11
---
2-
title: ""
3-
description: ""
2+
title: "Download Your API Deprecation Playbook"
3+
description: "Get the e-book: Sunset headers, usage tracking, and migration incentives that actually get consumers off deprecated endpoints."
44
author: "kevin-brown"
55
cover: "./download.png"
66
coverAlt: ""
7-
publishDate: 2025-01-15
7+
publishDate: 2023-06-04
88
isDraft: false
99
fileType: "Whitepaper"
1010
fileSize: "2.3 MB"
1111
pages: 24
1212
fileName: "*.pdf"
1313
---
1414

15+
API deprecation looks simple on paper: announce a sunset date, send emails, flip the switch. In practice, deprecated endpoints live forever. Consumers ignore warnings, sunset dates slip, and enterprise customers have contracts that guarantee availability. One API marked "deprecated" two years prior was still handling 30% of production traffic—and nobody wanted to be the engineer who broke their integration.
16+
17+
This complete guide walks you through the full deprecation lifecycle and the organizational coordination needed to actually remove APIs instead of just wishing they would go away.
18+
19+
Read this e-book to understand:
20+
21+
- Realistic timeline guidance based on consumer type (internal, external, enterprise)
22+
- RFC 8594 Sunset headers and Deprecation headers as technical foundations
23+
- Usage tracking systems to identify which consumers still depend on deprecated endpoints
24+
- Migration support strategies that reduce friction for consumers
25+
- Communication tactics that move consumers from awareness to action
26+
- Enforcement mechanisms—read-only modes, graduated restrictions, and final removal
27+
- How to handle contractual obligations and political pressure
28+
- Real-world lessons from successful large-scale deprecations
29+
30+
Download Your API Deprecation Playbook now to move deprecated endpoints from "technically sunset" to actually removed.
Lines changed: 20 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,31 @@
11
---
2-
title: ""
3-
description: ""
2+
title: "Download Your API Gateway Observability Guide"
3+
description: "Get the e-book: Metrics, traces, and logs from your gateway that help debug production issues instead of generating noise."
44
author: "kevin-brown"
55
cover: "./download.png"
66
coverAlt: ""
7-
publishDate: 2025-01-15
7+
publishDate: 2024-09-01
88
isDraft: false
99
fileType: "Whitepaper"
1010
fileSize: "2.3 MB"
1111
pages: 24
1212
fileName: "*.pdf"
1313
---
1414

15+
Four hours debugging a latency spike revealed the problem: the gateway metrics measured the wrong thing. Users saw 5-second delays, the gateway dashboard showed 200ms P99 latency, and every backend claimed sub-100ms response times. The real issue—4 seconds spent waiting for slow consumers to upload request bodies—never appeared in any metric. Gateway observability that does not connect to upstream and downstream services is useless.
16+
17+
This complete guide shows you how to instrument API gateways so the data actually helps during incidents instead of obscuring what is really happening.
18+
19+
Read this e-book to understand:
20+
21+
- Why gateway observability is fundamentally different from service observability
22+
- The RED method applied correctly to gateways with meaningful label dimensions
23+
- Decomposing latency into gateway time vs. backend time vs. network time
24+
- Distributed tracing that flows through the gateway boundary
25+
- Structured logging with trace context for correlation across services
26+
- Dashboard design for debugging rather than status page aesthetics
27+
- Vendor-agnostic patterns using Kong Gateway, AWS API Gateway, and Envoy
28+
- Real-world examples of metrics that revealed hidden problems
29+
- Sampling strategies that capture rare errors without overwhelming your system
30+
31+
Download Your API Gateway Observability Guide now to make your gateway transparent instead of a black box in the middle of your request path.
Lines changed: 23 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,34 @@
11
---
2-
title: ""
3-
description: ""
2+
title: "Download Your API Cost Management Guide"
3+
description: "Get the e-book: How to track API usage, enforce quotas, and implement charge-back models without a finance degree."
44
author: "kevin-brown"
55
cover: "./download.png"
66
coverAlt: ""
7-
publishDate: 2025-01-15
7+
publishDate: 2023-08-06
88
isDraft: false
99
fileType: "Whitepaper"
1010
fileSize: "2.3 MB"
1111
pages: 24
1212
fileName: "*.pdf"
1313
---
1414

15+
A finance director lost his mind during budget review: infrastructure costs doubled but when asked why, engineering had no answer. The real problem—one internal team consuming 80% of an API's capacity while costs were split evenly across six teams. Their allocated budget: $15,000. Their actual cost: $120,000. The other five teams were subsidizing them, and nobody knew.
16+
17+
Without usage metering, you're flying blind on capacity planning, pricing decisions, and cost allocation. You can't manage API costs you don't measure.
18+
19+
This complete guide walks you through building cost visibility into your API infrastructure and implementing billing models that scale with usage.
20+
21+
Read this e-book to understand:
22+
23+
- Metering architecture: synchronous vs. asynchronous tracking
24+
- What dimensions to capture (request count, data transfer, compute time, storage, features)
25+
- Quota enforcement strategies with graceful degradation
26+
- Chargebacks to internal teams and external customers
27+
- Rate limiting models (token bucket, leaky bucket, adaptive)
28+
- Billing system integration and cost reconciliation
29+
- Pricing models (per-request, per-GB, tiered, usage-based)
30+
- Cost allocation between shared infrastructure and teams
31+
- Real-world examples of cost surprises discovered through metering
32+
- Tools and patterns for building metering without custom development
33+
34+
Download Your API Cost Management Guide now to implement usage tracking that supports capacity planning, pricing, and accountability.
Lines changed: 22 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,33 @@
11
---
2-
title: ""
3-
description: ""
2+
title: "Download Your GitOps Debugging Guide"
3+
description: "Get the e-book: Troubleshooting sync waves, hooks, and deadlocks when declarative does not mean debuggable."
44
author: "kevin-brown"
55
cover: "./download.png"
66
coverAlt: ""
7-
publishDate: 2025-01-15
7+
publishDate: 2022-06-05
88
isDraft: false
99
fileType: "Whitepaper"
1010
fileSize: "2.3 MB"
1111
pages: 24
1212
fileName: "*.pdf"
1313
---
1414

15+
GitOps sells you on declarative simplicity: define your desired state in Git, and ArgoCD makes it so. The pitch works beautifully in demos. In production, you'll eventually stare at a sync that's been "Progressing" for 20 minutes, wondering what's happening inside the black box. A production deployment hung during sync with no error, no timeout, no logs—just a spinner. The root cause: a sync wave ordering issue where a PreSync hook was waiting for a service that wouldn't exist until a later wave.
16+
17+
This is the gap between GitOps theory and operational reality. The declarative model abstracts away the _how_ until something goes wrong. Then you need to understand exactly what ArgoCD is doing.
18+
19+
This complete guide breaks down the sync process and catalogs the failure modes to help you debug when ArgoCD gets stuck.
20+
21+
Read this e-book to understand:
22+
23+
- The ArgoCD sync process phase by phase: detection, manifest generation, diff calculation, resource ordering, health checks
24+
- Sync waves and resource ordering—explicit control over which resources deploy first
25+
- Hook execution (PreSync, Sync, PostSync) and common deadlock scenarios
26+
- Health assessment and why your perfectly valid manifests might not become healthy
27+
- Progressive sync strategies to reduce blast radius and enable rollback
28+
- Debugging techniques: reading sync logs, understanding resource status, tracing hook execution
29+
- Common failure modes and their recognition patterns
30+
- The mental model behind ArgoCD's behavior to reason about failures
31+
- Real examples of production sync failures and how they were resolved
32+
33+
Download Your GitOps Debugging Guide now to move beyond the declarative abstraction and understand what ArgoCD is actually doing.
Lines changed: 20 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,31 @@
11
---
2-
title: ""
3-
description: ""
2+
title: "Download Your Availability Targets Cost-Benefit Guide"
3+
description: "Get the e-book: Engineering and business tradeoffs that make extreme availability targets rarely worth the investment."
44
author: "kevin-brown"
55
cover: "./download.png"
66
coverAlt: ""
7-
publishDate: 2025-01-15
7+
publishDate: 2023-02-11
88
isDraft: false
99
fileType: "Whitepaper"
1010
fileSize: "2.3 MB"
1111
pages: 24
1212
fileName: "*.pdf"
1313
---
1414

15+
A startup was spending 40% of their infrastructure budget chasing 99.99% availability with multi-region failover and 24/7 on-call rotations burning out their team. Their revenue loss from downtime was roughly $15,000 annually. They were spending $150,000 to save $15,000—meanwhile competitors shipped features faster by not over-engineering their infrastructure.
16+
17+
Availability targeting becomes a badge of engineering honor rather than an economic decision. Every additional nine costs roughly 10x more than the previous one. Before committing to a target, you need to know exactly what you're buying and whether the business value justifies the investment.
18+
19+
This complete guide provides the cost-benefit framework for making informed availability decisions rather than chasing prestigious numbers.
20+
21+
Read this e-book to understand:
22+
23+
- What availability percentages mean: concrete downtime hours and composite availability math
24+
- Cost scaling: why each additional nine costs roughly 10x more than the previous one
25+
- Infrastructure, operational, and team burden costs at different targets
26+
- SLOs, SLAs, and SLIs: defining objectives, agreements, and indicators that matter
27+
- Serial vs. parallel redundancy: different cost profiles and diminishing returns
28+
- Risk-based targeting: finding your actual economic crossover point, not prestigious numbers
29+
- Real-world case studies: where money is wasted on extreme availability and where it's essential
30+
31+
Download Your Availability Targets Cost-Benefit Guide now to make data-driven availability decisions instead of chasing impressive numbers.
Lines changed: 20 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,31 @@
11
---
2-
title: ""
3-
description: ""
2+
title: "Download Your Backpressure Patterns Guide"
3+
description: "Get the e-book: Load shedding, queue depth limits, and admission control that keep systems responsive when overloaded."
44
author: "kevin-brown"
55
cover: "./download.png"
66
coverAlt: ""
7-
publishDate: 2025-01-15
7+
publishDate: 2022-08-07
88
isDraft: false
99
fileType: "Whitepaper"
1010
fileSize: "2.3 MB"
1111
pages: 24
1212
fileName: "*.pdf"
1313
---
1414

15+
An e-commerce platform's flash sale traffic spiked to 10x normal within minutes. The system accepted every request—that was the problem. Database connections exhausted. Response times climbed from 200ms to 30 seconds. Clients timed out and retried, doubling the load again. What could have been a recoverable 15-minute degradation became a 4-hour outage. The fix wasn't more capacity—it was teaching the system to say "no."
16+
17+
Without explicit overload handling, systems accept work they cannot complete. Queues grow unbounded, latency spikes, timeouts cascade, and client retries compound the problem. Backpressure is the survival mechanism that lets systems handle design capacity reliably and degrade gracefully beyond it.
18+
19+
This complete guide teaches you how to implement backpressure patterns that keep systems responsive under load.
20+
21+
Read this e-book to understand:
22+
23+
- Cascading failure anatomy: how overload feeds retries that compound the problem
24+
- Little's Law and queue growth: why queue depth becomes unbounded when arrivals exceed capacity
25+
- Goodput vs. throughput: why systems can look busy while being useless
26+
- Load shedding and admission control: gracefully rejecting requests when over capacity
27+
- Backpressure signaling: communicating overload across service boundaries (HTTP 503, gRPC flow control)
28+
- Timeout tuning and priority queues: preventing cascades while protecting critical traffic
29+
- Monitoring and real-world case studies: detecting overload early and recovering gracefully
30+
31+
Download Your Backpressure Patterns Guide now to implement the survival mechanisms that keep your system responsive under load.
Lines changed: 22 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,33 @@
11
---
2-
title: ""
3-
description: ""
2+
title: "Download Your Incident Analysis & Blameless Postmortem Guide"
3+
description: "Get the e-book: Blameless postmortems that find systemic causes instead of stopping at who made the mistake."
44
author: "kevin-brown"
55
cover: "./download.png"
66
coverAlt: ""
7-
publishDate: 2025-01-15
7+
publishDate: 2025-04-06
88
isDraft: false
99
fileType: "Whitepaper"
1010
fileSize: "2.3 MB"
1111
pages: 24
1212
fileName: "*.pdf"
1313
---
1414

15+
An engineer fat-fingers a production config change. The payment service goes down for two hours. The instinctive investigation finds the engineer and assigns blame. But three months later, a different engineer makes a different config mistake, and the system fails the same way. The "solution" didn't prevent anything—it just rotated blame to someone new.
16+
17+
The blameless investigation asks different questions: Why could a single engineer make that change without review? Why was there no canary deployment? Why didn't monitoring catch the error rate spike before customers did? That investigation finds five systemic improvements instead of one scapegoat.
18+
19+
This isn't about being soft on mistakes. It's about being rigorous enough to find causes that actually prevent recurrence.
20+
21+
This complete guide helps you build postmortem practices that actually improve your systems.
22+
23+
Read this e-book to understand:
24+
25+
- Why blame-focused investigations fail: hidden risks, concealment, and recurrence of the same failure modes
26+
- The bad apple fallacy: how fatigue, time pressure, and confusing interfaces create errors in everyone
27+
- Hindsight bias and outcome bias: counteracting the clarity that comes from knowing the outcome
28+
- Timeline reconstruction and causal analysis: frameworks (STAMP, CAST, fault trees) for systemic causes
29+
- Interview techniques that surface information without inducing defensiveness
30+
- Turning postmortems into action items: preventing recurrence instead of rotating blame
31+
- Building psychological safety: creating culture where people report near-misses instead of hiding them
32+
33+
Download Your Incident Analysis & Blameless Postmortem Guide now to move beyond blame and build postmortem practices that actually improve your systems.
Lines changed: 20 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,31 @@
11
---
2-
title: ""
3-
description: ""
2+
title: "Download Your Deployment Strategies Comparison Guide"
3+
description: "Get the e-book: Tradeoffs between deployment strategies for stateless and stateful workloads, with and without service mesh."
44
author: "kevin-brown"
55
cover: "./download.png"
66
coverAlt: ""
7-
publishDate: 2025-01-15
7+
publishDate: 2023-08-20
88
isDraft: false
99
fileType: "Whitepaper"
1010
fileSize: "2.3 MB"
1111
pages: 24
1212
fileName: "*.pdf"
1313
---
1414

15+
A team spent six months implementing canary deployments because it seemed like the mature choice. Then they hit their first schema migration and realized canary couldn't help. They needed expand-contract migrations and feature flags. Blue/green with feature flags would have given them instant rollback, pre-production validation, and gradual feature exposure without the complexity.
16+
17+
Sophisticated isn't always better. The right deployment strategy depends on your actual constraints: state management, traffic control capabilities, rollback requirements, and operational maturity.
18+
19+
This complete guide helps you choose the right deployment strategy instead of adopting complexity you don't need.
20+
21+
Read this e-book to understand:
22+
23+
- The deployment spectrum: recreate, rolling, blue/green, canary, progressive, and their tradeoffs
24+
- Blue/green vs. canary: instant rollback and pre-production validation vs. gradual traffic shifting
25+
- Resource costs and infrastructure requirements: multi-region failover and traffic management
26+
- Database migrations and backward compatibility: constraints that matter more than your deployment strategy
27+
- Stateless vs. stateful workloads: different requirements for long-running connections and data consistency
28+
- Feature flags as an orthogonal concern: how to decouple deployment from feature exposure
29+
- Decision framework: choosing the right strategy based on your actual constraints and maturity level
30+
31+
Download Your Deployment Strategies Comparison Guide now to choose the right strategy based on your actual constraints instead of perceived sophistication.

0 commit comments

Comments
 (0)