Skip to content

docs: document the pprof upstream kind - #12

Merged
tsenart merged 1 commit into
mainfrom
docs/pprof-kind
Oct 1, 2026
Merged

tsenart merged 1 commit into
mainfrom
docs/pprof-kind

Conversation

@tsenart

@tsenart tsenart commented Oct 1, 2026

Copy link
Copy Markdown
Contributor

The pprof upstream kind merged in #9 (495db17) but the docs still said Go pprof was "next". This PR documents it exactly as config.go, routes.go, and relay.go define it. Docs only.

  • README.md: pprof in the list of kinds; drops the "next" wording; line count updated (947).
  • docs/configuration.md: a pprof upstream with two targets in the annotated example, max_seconds (1 to 45, default 30) and max_concurrent (1 to 8, default 1), and a short "pprof upstreams" section on routes, the seconds query rule, and refusals.
  • docs/security.md: the pprof row in the read-route table and its 404 unknown target, 400, and 429 refusals.
  • docs/operations.md: -print-routes output for pprof and the unknown-target, query, busy decisions.
  • docs/setup.md, examples/kubernetes/relay.yaml: pprof in the kind lists.

Proof: the complete YAML block in docs/configuration.md was extracted and run through go run ./cmd/perfloop-relay -config <file> -print-routes; it validates and prints the two targets, the caps, and the six routes. go test -race ./... and go vet ./... pass.

🤖 Generated with Claude Code

The pprof kind merged in #9 without its docs. Describe it as config.go,
routes.go, and relay.go define it: targets in place of url, max_seconds
(default 30, at most 45) and max_concurrent (default 1, at most 8), the six
read routes, seconds as the only query key, and the 404, 400, and 429
refusals. The configuration.md example was validated with -print-routes.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@tsenart
tsenart merged commit 484414e into main Oct 1, 2026
7 checks passed
@tsenart
tsenart deleted the docs/pprof-kind branch October 1, 2026 03:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant