Skip to content

Conversation

@kaxil
Copy link
Member

@kaxil kaxil commented Oct 21, 2025

Workers can now configure the timeout for HTTP requests to the Execution API server via the [workers] execution_api_timeout configuration option. The default remains 5 seconds (httpx default) to preserve existing behavior.

https://www.python-httpx.org/advanced/timeouts/

This prevents timeout errors in high-load environments where API servers may take longer than 5 seconds to respond. Users experiencing timeout issues can now increase this value without code changes.

The timeout controls how long a worker waits for a single API request to complete, which is different from execution_api_retries that controls retry behavior after failures.

Fixes #56571


^ Add meaningful description above
Read the Pull Request Guidelines for more information.
In case of fundamental code changes, an Airflow Improvement Proposal (AIP) is needed.
In case of a new dependency, check compliance with the ASF 3rd Party License Policy.
In case of backwards incompatible changes please leave a note in a newsfragment file, named {pr_number}.significant.rst or {issue_number}.significant.rst, in airflow-core/newsfragments.

@kaxil kaxil force-pushed the exec-timeout-conf branch from 41e871c to f68feac Compare October 21, 2025 17:29
Workers can now configure the timeout for HTTP requests to the Execution
API server via the `[workers] execution_api_timeout` configuration option.
The default remains 5 seconds (httpx default) to preserve existing behavior.

https://www.python-httpx.org/advanced/timeouts/

This prevents timeout errors in high-load environments where API servers
may take longer than 5 seconds to respond. Users experiencing timeout
issues can now increase this value without code changes.

The timeout controls how long a worker waits for a single API request
to complete, which is different from execution_api_retries that controls
retry behavior after failures.

Fixes apache#56571
@kaxil kaxil force-pushed the exec-timeout-conf branch from f68feac to fdbb9a7 Compare October 21, 2025 17:30
@kaxil kaxil modified the milestones: Airflow 3.1.2, Airflow 3.1.1 Oct 21, 2025
@kaxil kaxil merged commit 0511604 into apache:main Oct 21, 2025
76 of 78 checks passed
@kaxil kaxil deleted the exec-timeout-conf branch October 21, 2025 18:58
kaxil added a commit that referenced this pull request Oct 21, 2025
Workers can now configure the timeout for HTTP requests to the Execution
API server via the `[workers] execution_api_timeout` configuration option.
The default remains 5 seconds (httpx default) to preserve existing behavior.

https://www.python-httpx.org/advanced/timeouts/

This prevents timeout errors in high-load environments where API servers
may take longer than 5 seconds to respond. Users experiencing timeout
issues can now increase this value without code changes.

The timeout controls how long a worker waits for a single API request
to complete, which is different from execution_api_retries that controls
retry behavior after failures.

Fixes #56571

(cherry picked from commit 0511604)
Copy link
Contributor

@amoghrajesh amoghrajesh left a comment

Choose a reason for hiding this comment

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

Nice, thats a valuable change.

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.

Instability at large scales - workers get ReadTimeout when calling api-server

5 participants