[
https://issues.apache.org/jira/browse/HTTPCLIENT-2404?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=18032764#comment-18032764
]
Oleg Kalnichevski commented on HTTPCLIENT-2404:
-----------------------------------------------
> However I only work with a very small part and would need someone to review
> and extend
[~jaypi75] Naturally I (or some other project committer) can review the changes
and work with you on the content. What is important for me is that there is
understanding in all-volunteer open-source project nothing happens someone
makes it happen. If one wants documentation improved one must seriously
consider contributing them.
> I assume making a fork and pull request on github is the way to go?
Yes, it is. Fork this project [1], make changes that you deem necessary and
raise a pull request for review
There is _a lot_ that can be improved in documentation and website. So, feel
free to do so.
Oleg
[1] https://github.com/apache/httpcomponents-website
> Provide comprehensive timeout configuration documentation with interaction
> matrix and override behavior
> -------------------------------------------------------------------------------------------------------
>
> Key: HTTPCLIENT-2404
> URL: https://issues.apache.org/jira/browse/HTTPCLIENT-2404
> Project: HttpComponents HttpClient
> Issue Type: Wish
> Components: HttpClient (async), HttpClient (classic)
> Affects Versions: 5.5, 5.5.1
> Reporter: Jens Popp
> Priority: Major
> Labels: volunteers-wanted
> Fix For: Future
>
>
> Apache HTTP Client currently exposes numerous timeout settings across
> different configuration points (connection manager, request config, socket
> config, etc.). Right now they are documented (as far as I was able to find)
> only on the point, where they can be set. The lack of comprehensive
> documentation about their interactions, precedence rules, and override
> behavior makes it difficult to configure clients correctly—especially in
> distributed systems where timeout handling is critical for failover and
> performance.
> *Problem Statement:*
> As demonstrated my comment in HTTPCLIENT-2386, seemingly minor implementation
> changes can have severe production impacts. In our case, upgrading from 5.5
> to 5.5.1 changed timeout behavior during TLS handshake scenarios. When
> servers under heavy load (100% CPU) could establish socket connections but
> failed TLS handshakes, the increased timeout (defaulted back to request
> timeout instead of connection timeout) prevented proper failover to backup
> servers, causing service degradation.
> *Requested Documentation:*
> # *Complete timeout inventory* - All configurable timeouts with their
> default values and scope
> # *Interaction matrix* - How timeouts interact when multiple apply to the
> same operation
> # *Override rules* - Precedence order when timeouts are set at different
> levels (global, connection manager, request)
> # *Lifecycle coverage* - Which timeout applies to each phase (DNS, connect,
> TLS handshake, data transfer)
> # *System best practices* - Recommended patterns for different scenarios
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
