Skip to content

Comments

[FLINK-39073][runtime] Defer alignment check for idle splits#27638

Merged
pnowojski merged 3 commits intoapache:masterfrom
Efrat19:FLINK-39073
Feb 23, 2026
Merged

[FLINK-39073][runtime] Defer alignment check for idle splits#27638
pnowojski merged 3 commits intoapache:masterfrom
Efrat19:FLINK-39073

Conversation

@Efrat19
Copy link
Contributor

@Efrat19 Efrat19 commented Feb 19, 2026

What is the purpose of the change

If a split emits watermarks far into the future and then goes idle, alignment check will incorrectly mark it paused.
As max allowed watermark advances, Source operator will transition the split back to active state, (while its still idle)
This change aims to fix the issue by deferring the alignment check for idle splits until they break out of idleness.

Brief change log

  1. Tracking currentlyIdleSplits in sourceOperator
  2. Avoiding pause of idle splits
  3. Adding alignment check when a split switches to not idle to compensate on 2)
  4. Improved logging around invalid split transitions

Verifying this change

This change added tests and can be verified. (unitTest)

Does this pull request potentially affect one of the following parts:

  • Dependencies (does it add or upgrade a dependency): no
  • The public API, i.e., is any changed class annotated with @Public(Evolving): no
  • The serializers: no
  • The runtime per-record code paths (performance sensitive): no
  • Anything that affects deployment or recovery: JobManager (and its components), Checkpointing, Kubernetes/Yarn, ZooKeeper: no
  • The S3 file system connector: no

Documentation

  • Does this pull request introduce a new feature? no
  • If yes, how is the feature documented? not applicable

If a split emits watermarks far into the future and then goes idle, alignment check will incorrectly mark it paused.
As max allowed watermark advances, Source operator will transition the split back to active state, (while its still idle)
This change aims to fix the issue by deferring the alignment check for idle splits until they break out of idleness.
@flinkbot
Copy link
Collaborator

flinkbot commented Feb 19, 2026

CI report:

Bot commands The @flinkbot bot supports the following commands:
  • @flinkbot run azure re-run the last Azure build

Split transitions directly from paused to idle and from idle to pause don't make any sense, improving the logs to allow further analysis. It is a convention for flink metrics system to not fail the job though.
Copy link
Contributor

@pnowojski pnowojski left a comment

Choose a reason for hiding this comment

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

LGTM % one small comment. Thanks for the fix!

Comment on lines +537 to +539
// Alignment check fires but doesn't pause the idle split
operator.handleOperatorEvent(new WatermarkAlignmentEvent(allowedWatermark4));
assertThat(operator.getSplitMetricGroup(split0.splitId()).isIdle()).isTrue();
Copy link
Contributor

Choose a reason for hiding this comment

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

Can we assert that the split hasn't been paused?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

done

}
}

private void maybePauseSplit(String splitId) {
Copy link
Contributor

@davidradl davidradl Feb 20, 2026

Choose a reason for hiding this comment

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

the method name is strange - I was expecting it to start with a verb like the other methods. Maybe `updateCurrentSplitPausedWatermark

Copy link
Contributor Author

Choose a reason for hiding this comment

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

This method checks if the split watermark is too advanced and if yes calls pauseOrResumeSplit for it, unless already paused.
I am not aware of a "paused watermark" concept, but open to other suggestions on how to name this method.

Copy link
Contributor

Choose a reason for hiding this comment

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

I think the maybePauseSplit decsribes pretty well what's happening. Also there are plenty of other cases with similar naming convention (method named maybeACTION).

Re updateCurrentSplitPausedWatermark:

  • I presume you ment updateCurrentPausedSplitWatermark, but in this case "Paused watermark" is still confusing as pointed by @Efrat19 . Even more correct would have been updateCurrentlyPausedSplit...
  • but updateCurrentlyPausedSplit doesn't capture that currently paused split split might not be updated
  • and updateCurrentlyPausedSplit is basically as synonym of pauseSplits

So:

  • maybePauseSplit and maybeUpdateCurrentlyPausedSplit are both technically correct maybePauseSplits imo sounds better, so I would keep it as is.

@Efrat19
Copy link
Contributor Author

Efrat19 commented Feb 22, 2026

@flinkbot run azure

@pnowojski pnowojski merged commit 7536cfe into apache:master Feb 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants