I9Intermediate 60 minutes reading and codeUnlocked

Shadow Traffic, Canary Rollout, and Progressive Deployment for LLMs

LLM rollouts combine the hardest parts of software deployment: no unit tests, diffuse failure modes, delayed signals. The sequence is (1) shadow mode — duplicate prod requests to candidate model, log, compare with zero user impact; catches obvious distribution issues but is not a quality guarantee; (2) canary rollout — progressive traffic shift 10% → 25% → 50% → 75% → 100% with gates at each step; track latency percentiles, cost/request, error/refusal rate, output length distribution, user-feedback rate; (3) A/B testing for distinct alternatives after stability confirmed. Non-determinism is irreducible — up to 15% accuracy variation across runs with identical inputs due to GPU FP non-associativity plus batch-size variance. Cost is a variable, not constant — a 20% better model can be 3x more expensive per call. Rollback speed is decisive: if rollback requires redeploy, you are too slow. Policy lives in config/flags; model lives in registry with pinned digests; rollback = flip policy + revert threshold + pin old model in seconds.

Warm-up

Before you read: see what you already know.

What is the right way to order shadow, canary, and A/B testing for an LLM rollout?

Learning Objectives

  • Distinguish shadow mode (zero-impact compare), canary (live traffic progressive), and A/B (stability-confirmed comparison).
  • Enumerate five LLM-specific canary metrics (latency, cost/request, error/refusal, output-length distribution, user feedback).
  • Explain why LLM non-determinism (up to 15%) changes what "stable" means in a rollout.
  • Design a rollback path that takes seconds (policy flip) not hours (redeploy).

The Problem

You ship a new model. Offline evals show 3% accuracy gain. You flip it on in production. Within 24 hours, cost is up 40%, user thumbs-down is up 8%, three customer tickets report "weird answers." You roll back. Redeploy takes 3 hours. Your weekend is ruined.

Every piece of that was avoidable. Shadow mode would have caught the 40% cost spike before any user saw it. Canary would have stopped at 10% when thumbs-down moved. Policy-flag rollback would have taken 30 seconds. The discipline is what fills in the gap between "offline evals look good" and "real users are happy."

The Concept

Shadow mode

Candidate receives the same requests as production; outputs are logged, not returned to users. Zero user impact. Log:

  • Output content (diff against production).
  • Token counts (cost delta).
  • Latency.
  • Refusal and error.

Catches: cost blow-ups, length regressions, obvious refusal changes, hard errors. Does NOT catch: quality delta users would perceive. Shadow is a smoke test, not a quality test.

Canary rollout

Progressive traffic shift with gates. Typical progression: 1% → 10% → 25% → 50% → 75% → 100%. Gate on 5 metrics at each step:

  1. Latency percentiles — P50, P95, P99. Breach: canary has P99 > 1.5x baseline.
  2. Cost per request — blended $. Breach: >20% above baseline.
  3. Error / refusal rate — 5xx plus explicit refusals. Breach: 2x baseline.
  4. Output length distribution — mean + P99. Breach: distributional shift.
  5. User-feedback rate — thumbs-down / ticket filings. Breach: 1.5x baseline.

Non-determinism is the new variance

Identical inputs produce non-identical outputs. Reasons:

  • GPU FP non-associativity (floating-point reduction order varies by batch).
  • Batch-size variance (same prompt in a batch of 128 vs batch of 16).
  • Sampling (temperature > 0).

Measured: up to 15% accuracy variation run-to-run on identical eval sets. "Stable" in a rollout means metrics are within expected variance, not identical to baseline. Set gates above the noise floor.

Cost is a variable

A 20% better model can be 3x more expensive per call. Cost/request is one of the five gates. Shipping a "better" model that breaks unit economics is a rollback case.

Rollback is the weapon

  • Policy flag (feature flag system): flip percentage in config; takes seconds.
  • Model pinning (registry digest): pinned model does not auto-upgrade.
  • Rollback = revert flag + set pinned digest to previous. Seconds, not hours.

If your stack requires redeploy to rollback, fix that before rolling.

Tooling

Argo Rollouts / Flagger — Kubernetes progressive delivery controllers. Integrate with Istio/Linkerd weighted routing.

Istio weighted routing — service-mesh-level traffic split.

KServe / Seldon Core — model serving with built-in canary.

Feature flags — LaunchDarkly, Flagsmith, Unleash. Policy-level flip, no redeploy.

Metrics cadence

Canary gates check every 5-15 minutes depending on traffic volume. 1% traffic with 10 req/min gives 50-150 data points per window — enough for latency but noisy for user feedback. 10% gives ~10x more. Progressions should pause long enough to accumulate enough samples at each step.

The A/B step is optional

If the new model is distinctly different (different behavior, different cost curve, different tone), A/B test it at 50% after canary passes. If it's just an improved version, skip to 100% when canary gates pass.

Numbers you should remember

  • Canary progression: 1% → 10% → 25% → 50% → 75% → 100%.
  • Non-determinism ceiling: up to 15% run-to-run variance on identical inputs.
  • Five canary metrics: latency, cost, error/refusal, output length, user feedback.
  • Cost gate: >20% above baseline is a breach.
  • Rollback: seconds, not hours.

Use it

code/main.py simulates a canary rollout with injected regressions. Reports which stage the rollout halts at and which gate triggered.

Exercises

  1. Run code/main.py. Inject a 25% cost regression. At which stage does the canary halt?
  2. Your new model has 3% accuracy gain offline but cost/request is +18%. Is it a ship? Depends on the policy — write both paths.
  3. Design a rollback that takes under 60 seconds end-to-end. List the required infrastructure.
  4. Non-determinism shows ±7% on your eval. Set canary gates so you don't false-alarm. What multipliers do you use?
  5. Shadow mode catches a 40% cost spike before canary. Write the alert rule that fires in shadow.

Key Terms

Term What people say What it actually means
Shadow mode "duplicate to new" Zero-impact send-to-candidate for logging
Canary "progressive traffic" Gradual user-exposed rollout with gates
Gates "rollout checks" Metric thresholds that block progression
Non-determinism "LLM variance" Irreducible run-to-run differences
Policy flag "flag flip rollback" Config-level rollback, seconds not hours
Model pin "registry digest" Immutable reference to a model version
Argo Rollouts "K8s progressive" Kubernetes-native canary/rollback controller
KServe "inference K8s" Model serving with canary primitives
Istio weighted "mesh split" Service-mesh traffic splitter

Further Reading

The code

The lesson’s full source

The complete runnable files this lesson builds.

Check yourself

Questions on what you just read. Your score is saved in this browser.

Which set of five metrics does the lesson gate canary progressions on?

Milestone forA production labour-compliance assistant

Release without betting the business

Run a new prompt or model in shadow against live traffic, then canary it to 5% and 50% with gates on faithfulness, red-team pass rate, cost and latency. Write down the rollback decision.

Done when

  • A shadow comparison of a new prompt on at least 100 real questions
  • Canary at 5% then 50% with written gates on faithfulness, red-team pass rate, cost and latency
  • A rollout record ending in promote or roll back, with the numbers

Stretch: Automate the rollback when a gate fails

200 more characters to go

Interview practice

Questions on this topic that AI engineering interviews ask, with the companies reported to ask them. Answer the way you would out loud; your answer is scored against production standards with concrete guidance on what to improve.

80 more characters to go

Adapted from open-source work: AI Engineering from Scratch by Rohit Ghumare (MIT, lesson text, code and quizzes); Awesome LLM Apps by Shubham Saboo (Apache-2.0, starter code); AI Engineering Interview Questions by Outcome School (Apache-2.0, interview questions). Capstones, milestones, data packs and Zambian context by Zambrite.

Chat on WhatsApp