observability

The agent wired the success path and left the failure branch silent

The agent implemented the happy path, returned 200, and declared done. The failure branch emitted nothing: no log, no trace, no surfaced error, so when it fired in production on-call had nothing to grep for. Covers a structured breadcrumb on every exit branch and verifying it under fault.

Oct 26, 2026 2 min read

Health checks for APIs: /healthz, /readyz, /livez, version, and metrics in OpenAPI

Liveness and readiness are different questions: is the process running, and can it serve traffic right now including its dependencies? Collapse them into one /health endpoint and Kubernetes kills a pod briefly waiting on its database, or routes traffic to a half-warmed instance. Here is the...

Oct 8, 2026 4 min read