gw-11 — Execution

Prerequisites

  • Go ≥ 1.25 (stdlib only, offline).

One-shot

cd gw-11-data-plane-observability && bash scripts/verify.sh   # tests + demos

Per-language workflow (Go)

cd gw-11-data-plane-observability/src/go
go test -race -count=1 ./...        # histogram/quantile/merge, traceparent, RED
go run ./cmd/obsdemo               # percentile-merge + trace-propagation demos

Package map

FileWhat
obs/histogram.gobucketed latency histogram; bucket-based quantiles; bucket-wise Merge (correct fleet percentiles)
obs/trace.goW3C traceparent parse/format; extract → new-span child → inject (don't sever the trace)
obs/red.goRED metrics per route: rate, error ratio, p99, retry ratio (the gw-06 amplification signal)
cmd/obsdemothe "can't average p99" + trace-propagation demonstrations

See GUIDE.md for the deep dive and the "p99 doubled" debugging drill.