Skip to content

Conversation

@buger
Copy link
Member

@buger buger commented Dec 5, 2025

Summary

  • Updated documentation note under proxy_default_timeout to clarify that only http_server_options.write_timeout needs to be adjusted when proxy_default_timeout exceeds 120 seconds

Changes Made

Based on team feedback:

  • read_timeout is for the client sending a request TO Tyk - not dependent on upstream timeout
  • write_timeout is for Tyk writing the response BACK to the client - must be adjusted when upstream timeout increases

Test plan

  • Verify the note renders correctly in the documentation
  • Confirm internal links to read_timeout and write_timeout sections work

Resolves DX-1962

🤖 Generated with Claude Code

…imeout

When setting proxy_default_timeout to a value greater than 120 seconds,
the http_server_options.read_timeout and http_server_options.write_timeout
settings must also be increased accordingly, as they default to 120 seconds.

Resolves DX-1962

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
@github-actions
Copy link

github-actions bot commented Dec 5, 2025

PR Reviewer Guide 🔍

Here are some key observations to aid the review process:

⏱️ Estimated effort to review: 1 🔵⚪⚪⚪⚪
🧪 No relevant tests
🔒 No security concerns identified
⚡ Recommended focus areas for review

Anchor Accuracy

Verify that the fragment identifiers used in the links to http_server_options.read_timeout and http_server_options.write_timeout match the actual generated IDs in the rendered docs; MDX/markdown heading-to-id rules may differ (underscores vs hyphens, case, dots).

<Note>

If you set `proxy_default_timeout` to a value greater than 120 seconds, you must also increase the [http_server_options.read_timeout](#http_server_optionsread_timeout) and [http_server_options.write_timeout](#http_server_optionswrite_timeout) settings to match or exceed this value. These settings default to 120 seconds, so if they are not adjusted, they will terminate the connection before the upstream timeout is reached.

</Note>
Wording Clarity

Consider clarifying whether the read/write timeouts must “match or exceed the upstream timeout” or simply be “greater than or equal to proxy_default_timeout,” and whether both must be raised or only the limiting one, to prevent confusion.

<Note>

If you set `proxy_default_timeout` to a value greater than 120 seconds, you must also increase the [http_server_options.read_timeout](#http_server_optionsread_timeout) and [http_server_options.write_timeout](#http_server_optionswrite_timeout) settings to match or exceed this value. These settings default to 120 seconds, so if they are not adjusted, they will terminate the connection before the upstream timeout is reached.

</Note>

@github-actions
Copy link

github-actions bot commented Dec 5, 2025

PR Code Suggestions ✨

Explore these optional code suggestions:

CategorySuggestion                                                                                                                                    Impact
General
Fix potentially broken anchors

The in-page anchors #http_server_optionsread_timeout and
#http_server_optionswrite_timeout may not resolve if section IDs include dots or
different casing. Update links to the exact, working anchors or use full paths to
prevent broken navigation.

snippets/gateway-config.mdx [1012-1016]

 <Note>
 
-If you set `proxy_default_timeout` to a value greater than 120 seconds, you must also increase the [http_server_options.read_timeout](#http_server_optionsread_timeout) and [http_server_options.write_timeout](#http_server_optionswrite_timeout) settings to match or exceed this value. These settings default to 120 seconds, so if they are not adjusted, they will terminate the connection before the upstream timeout is reached.
+If you set `proxy_default_timeout` to a value greater than 120 seconds, you must also increase the [http_server_options.read_timeout](#http_server_options-read_timeout) and [http_server_options.write_timeout](#http_server_options-write_timeout) settings to match or exceed this value. These settings default to 120 seconds, so if they are not adjusted, they will terminate the connection before the upstream timeout is reached.
 
 </Note>
Suggestion importance[1-10]: 6

__

Why: The suggestion correctly targets the newly added Note block and proposes adding hyphens in the anchor IDs, which can fix common MDX/Markdown slug generation issues; however, without full context of the actual heading IDs, this is a cautious improvement rather than a guaranteed fix.

Low

Updated the note under proxy_default_timeout to clarify that only
http_server_options.write_timeout needs to be adjusted when setting
proxy_default_timeout beyond 120 seconds.

The read_timeout setting is for client-to-Tyk request reading and is
independent of upstream timeouts. Only write_timeout affects the
response delivery to the client and must be adjusted accordingly.

Addresses feedback on DX-1962.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
Copy link

@OldStubbsy OldStubbsy left a comment

Choose a reason for hiding this comment

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

Great! Thanks very much

@sharadregoti sharadregoti merged commit ee98d27 into main Dec 9, 2025
7 checks passed
@buger
Copy link
Member Author

buger commented Dec 9, 2025

/release to release-5.8

@buger
Copy link
Member Author

buger commented Dec 9, 2025

/release to release-5.10

@github-actions
Copy link

github-actions bot commented Dec 9, 2025

✅ Cherry-pick successful. A PR was created and auto-merged (if allowed): #1171

@github-actions
Copy link

github-actions bot commented Dec 9, 2025

✅ Cherry-pick successful. A PR was created and auto-merged (if allowed): #1172

buger added a commit that referenced this pull request Dec 9, 2025
…s for proxy_default_timeout > 120s (#1128)

[DX-1962] docs: document timeout requirements for proxy_default_timeout > 120s (#1128)
buger added a commit that referenced this pull request Dec 9, 2025
… for proxy_default_timeout > 120s (#1128)

[DX-1962] docs: document timeout requirements for proxy_default_timeout > 120s (#1128)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants