for engineers running agents in prod

What breaks when you ship an agent.

A weekly trace of one real incident, one runtime fix, and the line of code that would have stopped it. No framework tutorials. No demo screenshots. Read the log, not the pitch.

one email a week. unsubscribe from the footer link, not a preference centre.

4,812 engineers on-call · issue 47 out thursday

agent.trace — incident PD-58213
live
  1. 01logs.query { svc: "api-gateway", range: "15m", level: "error" } → 412 rows · top: upstream timeout (389) [200] 890tok · 640ms
  2. 02metrics.fetch { query: "rate(http_5xx[5m])" } → spike at 03:12:04 UTC, +38x baseline [retry] 305tok · 180ms
  3. 03↳ metrics.fetch.retry { attempt: 2, backoff: "240ms" } → ok on retry · upstream was cold [retry] 61tok · 240ms
  4. 04k8s.describe_pod { ns: "prod", pod: "checkout-7f9d4" } → OOMKilled · restarts: 6 [err] 220tok · 310ms
  5. 05git.blame { file: "checkout/pool.go", line: 88 } → commit a3f9c2 · raised pool size 3d ago [200] 176tok · 260ms
  6. 06memory.write { key: "PD-58213.hypothesis" } → stored · confidence 0.81 [200] 94tok · 90ms
  7. 07k8s.scale { deploy: "checkout", replicas: 8 } → rolled out · 4/8 ready [200] 130tok · 420ms
  8. 08metrics.fetch

recent issues

archive →
  1. #472026-08-06the retry storm that took down its own fallback
  2. #462026-07-30context windows are not memory — a taxonomy
  3. #452026-07-23we cut escalations 34% by deleting a tool
  4. #442026-07-16eval suites lie to you the same way unit tests do
  5. #432026-07-09the 12-line budget guard we now ship by default

one incident, worked start to finish

One issue. One incident, worked start to finish. Five minutes, timed against the actual word count.

from the rotation

  • Marcus Ude
    Platform eng, Fenwick Logistics
    The budget-guard snippet from issue 41 is now a required review comment on every agent PR at our shop. Caught two runaway loops before they hit the API bill.
  • Ren Okafor
    Staff SRE, Lumen Health
    Forwarded the retry-storm issue to our whole on-call rotation. First newsletter that's actually changed how we write tool schemas.
  • Dana Sorensen
    Eng lead, Northbeam
    Most agent content is either hype or a LangChain tutorial. This is the only one that reads like it was written by someone who's been paged at 3am.

Next incident is already in the queue.

one email a week. unsubscribe from the footer link, not a preference centre.