Skip to content

Document HTTP/2 to origin configuration - #13693

Open
bneradt wants to merge 1 commit into
apache:masterfrom
bneradt:document-http2-to-origin
Open

bneradt wants to merge 1 commit into
apache:masterfrom
bneradt:document-http2-to-origin

Conversation

@bneradt

@bneradt bneradt commented Sep 15, 2026

Copy link
Copy Markdown
Contributor

Operators need a coherent path from enabling origin ALPN to evaluating
HTTP/2 under production traffic. The individual record descriptions do
not explain how flow control, pooling, and timeouts interact, or how to
distinguish origin failures from unrelated changes in aggregate metrics.

This guide explains per-route and global negotiation, fixed stream
windows with policy 1, connection reuse, and timeout selection. It
separates client-side tuning from origin settings and explains the
tradeoffs behind deployment-specific values rather than prescribing a
single configuration for every workload.

The guide also describes origin protocol logging, separate HTTP/1 and
HTTP/2 connection gauges, and a gradual rollout with error attribution.
The flow-control discussion explains why dynamic stream-window SETTINGS
can trigger origin rate limits and why policy changes require a restart.

Related to #12175.

Co-authored-by: GPT-6 Astra Medium

Copilot AI lite review requested due to automatic review settings September 15, 2026 19:33
@bneradt bneradt added this to the 11.0.0 milestone Sep 15, 2026
@bneradt bneradt self-assigned this Sep 15, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Operators need a coherent path from enabling origin ALPN to evaluating
HTTP/2 under production traffic. The individual record descriptions do
not explain how flow control, pooling, and timeouts interact, or how to
distinguish origin failures from unrelated changes in aggregate metrics.

This guide explains per-route and global negotiation, fixed stream
windows with policy 1, connection reuse, and timeout selection. It
separates client-side tuning from origin settings and explains the
tradeoffs behind deployment-specific values rather than prescribing a
single configuration for every workload.

The guide also describes origin protocol logging, separate HTTP/1 and
HTTP/2 connection gauges, and a gradual rollout with error attribution.
The flow-control discussion explains why dynamic stream-window SETTINGS
can trigger origin rate limits and why policy changes require a restart.

Related to apache#12175.

Co-authored-by: GPT-6 Astra Medium
@bneradt
bneradt force-pushed the document-http2-to-origin branch from ccd4342 to 574335b Compare September 15, 2026 19:47
Copilot AI review requested due to automatic review settings September 15, 2026 19:47

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

2 participants