fshttp: add --dump errors to dump only failed HTTP transactions - fixes #9471

The new "errors" dump flag makes the HTTP dump conditional on the
transaction failing with a retryable error (a transport error, HTTP 429
or HTTP 5xx), so first-failure diagnostics can be captured without the
noise of dumping every transaction. The existing dump flags continue to
control what is dumped, for example --dump errors,bodies, and on its own
--dump errors dumps the headers.
This commit is contained in:
Nick Craig-Wood
2026-05-30 16:41:12 +01:00
parent 9c9fbebf7f
commit 875a666f9c
4 changed files with 207 additions and 14 deletions

View File

@@ -3289,6 +3289,13 @@ The available flags are:
the other HTTP debugging flags (e.g. `requests`, `bodies`). By
default the auth will be masked - use with `auth` to have the curl
commands with authentication too.
- `errors` only dumps the HTTP transactions which fail with a retryable
error - that is a transport error, an HTTP 429 (too many requests) or an
HTTP 5xx server error. The other dump flags control what is dumped, so
for example use `--dump errors,bodies` to dump the headers and bodies of
failed transactions only. On its own `--dump errors` dumps the headers.
This lets you capture first-failure diagnostics without the noise of
dumping every transaction. May contain sensitive info.
## Filtering