Canary deploy lab
Instrument metrics and rollout decisions
Metrics for canary_weight, error_rate_by_revision, grounded_rate_by_revision must distinguish bad input from component failure for release commander watching revision-sliced error rate.
1Try it yourself
Decision drill
Canary deploy desk
Split traffic, watch metrics, rollback or promote — never big-bang without a safety net.
1/3You routed 10% of traffic to v2. Smoke looks fine so far.
2Learn the idea
Read
Golden signals for this system
Instrument containerized answer API releasing image v2 at 5%→25%→100% weights so release commander watching revision-sliced error rate can answer: demand, errors, latency/age, saturation. Emit fields needed by canary_weight, error_rate_by_revision, grounded_rate_by_revision with bounded labels. Sample successful high-volume traces; keep errors and rollout transitions denser within policy.
Read
Alert path worth paging
Define at least one alert that would fire for CANARY-PROMOTE-BLIND-6, with a for/pending window that survives deploy blips. Missing scrape or missing revision labels must not look like health. Include a trace/log example id format you will actually search.
Read
Implementation artifact
{"gate":"two_windows","error_delta_pp":0.5,"grounded_floor_delta_pp":1}
Read
Tests for telemetry
Add a unit/integration check that metrics increment on the happy path and on the automation promotes while scrape_up{revision=v2}==0 branch. Store machine-readable output in CI artifacts when practical.
Read
Stage depth
Cardinality discipline: tenant and revision are usually enough; raw question text is not a label. Exemplars or trace links beat screenshots alone when debugging CANARY-PROMOTE-BLIND-6. Define who owns alert fatigue review. If you export to a vendor, record retention and access. Synthetic probes should use non-sensitive fixtures and still exercise POST /answer. Practice the query you will type at 2am once, while calm.
Read
Field notes for `canary-deploy-lab` / `observability`
Document the exact PromQL or log query in the runbook stub for this service. Verify histograms have buckets around your SLO target. Add a canary synthetic check that exercises the oracle path every few minutes in staging. Confirm that PII redaction happens before export. Track build/version as a label on the golden signals. Delete noisy debug logs before they become accidental product dependencies. In this chapter the product is containerized answer API releasing image v2 at 5%→25%→100% weights, the human stakeholder is release commander watching revision-sliced error rate, and the incident id you design against is CANARY-PROMOTE-BLIND-6. Re-state the oracle in your notes — 5% canary healthy 20m → promote to 25%; guardrail breach → weight 0 in < 2m — and keep the invariant visible: promote only if canary error_rate ≤ baseline+0.5pp and groundedness ≥ baseline−1pp for two 10m windows. Track canary_weight, error_rate_by_revision, grounded_rate_by_revision as the scoreboard. Surface under change control: POST /answer. If you only have forty minutes, finish the fixture for automation promotes while scrape_up{revision=v2}==0 before polishing UI. Promotion language stays ternary: promote, hold, or roll back based on evidence, not hope.
Read
Extra rehearsal for Canary deploy lab (observability)
Set a timer for twelve minutes and attempt only the observability concerns for Canary deploy lab. Speak aloud what release commander watching revision-sliced error rate would see on success versus on automation promotes while scrape_up{revision=v2}==0. Write three bullet artifacts you must keep: a fixture name tied to CANARY-PROMOTE-BLIND-6, a metric query for canary_weight, error_rate_by_revision, grounded_rate_by_revision, and the rollback or refuse command for POST /answer. Then extend the notes with one sentence on how promote only if canary error_rate ≤ baseline+0.5pp and groundedness ≥ baseline−1pp for two 10m windows would be violated if you skipped this page. Close by restating the oracle in your own words without looking: 5% canary healthy 20m → promote to 25%; guardrail breach → weight 0 in < 2m.
Go deeper
Before you start
Why this matters
Name the dashboard row or log line release commander watching revision-sliced error rate opens first during CANARY-PROMOTE-BLIND-6. It must include a correlation id and a bounded label from canary_weight, error_rate_by_revision, grounded_rate_by_revision. If telemetry is missing, write whether you promote, hold, or roll back — and why hold is the default.
In the wild
See how this idea shows up as a product and a company — then come back to the lesson. Skills transfer across vendors.
Related lessons
Check your understanding
Page assessment
Answer from memory. Completion is saved from this evidence, not from opening the next page.
All responses are required.