Skip to content

Stop fetching the run conf once per task instance in the scheduler - #73022

Closed
rjgoyln wants to merge 1 commit into
apache:mainfrom
rjgoyln:fix/scheduler-dag-run-conf-memory
Closed

rjgoyln wants to merge 1 commit into
apache:mainfrom
rjgoyln:fix/scheduler-dag-run-conf-memory

Conversation

@rjgoyln

@rjgoyln rjgoyln commented Sep 12, 2026 •

Copy link
Copy Markdown
Contributor

Summary

A Dag run triggered with a large conf makes scheduler memory scale with the number of task instances in the run: while a mapped task is being scheduled the scheduler grows to several times its usual footprint, and recovers only once the run finishes.

TaskInstance.dag_run is a joined eager load, so the run's conf comes back on every row a task-instance query returns, even though the ORM keeps a single DagRun object — and nothing in the scheduling loop reads it. Scheduling a run with 200 mapped task instances and a 0.9 MB conf peaks at 372 MiB of heap, against 3.7 MiB once the column leaves those queries, at an identical query count.

Change

  • DagRun.fetch_task_instances and the scheduler's critical-section query defer DagRun.conf.
  • The state re-check in _get_ready_tis, the mapped-dependency check and mapped expansion skip the dag_run join entirely.

A query whose callers use the run keeps it and drops only the column; one that reads nothing but task-instance state drops the join. conf still loads on demand.

The callback paths keep the column: they serialize ti.dag_run into the execution API DagRun datamodel, so a batch of finishing task instances still fetches one copy each.

Behavior change

Reading ti.dag_run.conf after the loading session has closed now raises DetachedInstanceError instead of returning the eagerly loaded value. No caller in the tree does this.

closes: #71267


Was generative AI tooling used to co-author this PR?
  • Yes — Claude Code (Opus 5)

Generated-by: Claude Code (Opus 5) following the guidelines

A Dag run triggered with a large conf makes scheduler memory scale with the
number of task instances in the run. TaskInstance.dag_run is a joined eager
load, so the run's conf comes back on every row of every task-instance query
the scheduling loop makes, and a mapped task with several hundred instances
repeats a multi-megabyte conf on every loop while the run is alive.

Closes: apache#71267
@rjgoyln
rjgoyln force-pushed the fix/scheduler-dag-run-conf-memory branch from bf9ce13 to 4bcc197 Compare September 14, 2026 16:54
@rjgoyln
rjgoyln marked this pull request as ready for review September 14, 2026 16:54
@potiuk potiuk added the closed because of open PR limit Closed as a one-time step of introducing the open pull request limit label Sep 25, 2026
@potiuk

potiuk commented Sep 25, 2026

Copy link
Copy Markdown
Member

Hello @rjgoyln - thank you for your contributions to Apache Airflow!

The Airflow community has introduced a limit of 5 open pull requests at a time for contributors without write access to the repository. You currently have 24 open pull requests, so - as a one-time step of introducing the limit - we closed the ones where maintainers have not engaged yet:

These pull requests stay open because maintainers are already engaged in them - they count towards your limit:

This is not a judgement of you or of your changes. We never told contributors before that opening many pull requests at once was a problem, so there is nothing to feel bad about - and nothing is lost: your branches, commits and the review history stay where they are.

What we ask you to do is to make your first prioritization decision: choose which of the pull requests above matter most to you, and reopen them (up to 5 open at a time, including the ones still open) with the "Reopen pull request" button or gh pr reopen <PR_NUMBER> --repo apache/airflow. Reopen the ones you are ready to follow through - keep them rebased, respond to review comments and fix failing checks.

While your pull requests are waiting for review, the most valuable thing you can do is help in other ways - reviewing other contributors' pull requests, helping with issues, and taking part in the discussions on the devlist and Slack.

Why we introduced the limit, what it means for you and how to reopen or restore a pull request is explained in https://github.com/apache/airflow/blob/main/contributing-docs/32_open_pull_request_limit.rst.


Drafted-by: Claude Code (Opus 5); reviewed by @potiuk before posting

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

Labels

area:scheduler closed because of open PR limit Closed as a one-time step of introducing the open pull request limit

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Airflow scheduler memory spikes when a dag is run with large run config

2 participants