perf: Schedule rate-limit notifications on shared executor (JAVA-653) by runningcode · Pull Request #5814 · getsentry/sentry-java

runningcode · 2026-07-22T11:06:35Z

📜 Description

RateLimiter created a java.util.Timer (a dedicated thread) whose thread stayed alive for the rest of the process once the SDK got rate limited. The "rate limit lifted" observer notification now runs on the shared timer executor (SentryOptions#getTimerExecutorService), already used for transaction timeouts, whose single worker thread is reused and self-terminates when idle.

The notification is scheduled with the delay until the limit expires; to avoid an extra getCurrentTimeMillis() call the already-computed retryAfterMillis is passed through as the delay.
Pending notification futures are tracked (completed ones pruned on each schedule) and cancelled on close(), preserving the old Timer#cancel() semantics.

💡 Motivation and Context

Part of reducing the number of threads created by the SDK: JAVA-653.

Once an app got rate limited, this timer thread lived forever. The shared timer executor's worker is reused and idles out.

💚 How did you test it?

Existing RateLimiterTest, adapted from the Timer-mock verification to the executor/future model, plus AsyncHttpTransportTest.

📝 Checklist

I added GH Issue ID & Linear ID
I added tests to verify the changes.
No new PII added or SDK only sends newly added PII if sendDefaultPII is enabled.
I updated the docs if needed.
I updated the wizard if needed.
Review from the native team if needed.
No breaking change or entry added to the changelog.
No breaking change for hybrid SDKs or communicated to hybrid SDKs.

🔮 Next steps

Related PRs in this effort: LifecycleWatcher (#5819), performance collector (#5816), HostnameCache (#5817), batch processors (#5818).

🤖 Generated with Claude Code

linear-code · 2026-07-22T11:06:39Z

JAVA-653

github-actions · 2026-07-22T11:06:51Z

🚨 Detected changes in high risk code 🚨

High-risk code has higher potential to break the SDK and may be hard to test. To prevent severe bugs, apply the rollout process for releasing such changes and be extra careful when changing and reviewing these files:

sentry/src/main/java/io/sentry/transport/RateLimiter.java

github-actions · 2026-07-22T11:07:41Z

🚨 Detected changes in high risk code 🚨

High-risk code has higher potential to break the SDK and may be hard to test. To prevent severe bugs, apply the rollout process for releasing such changes and be extra careful when changing and reviewing these files:

sentry/src/main/java/io/sentry/transport/RateLimiter.java

sentry · 2026-07-22T11:11:33Z

📲 Install Builds

Android

🔗 App Name	App ID	Version	Configuration
SDK Size	io.sentry.tests.size	8.50.0 (1)	release

⚙️ sentry-android Build Distribution Settings

github-actions · 2026-07-22T11:16:33Z

Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	319.27 ms	373.26 ms	53.99 ms
Size	0 B	0 B	0 B

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
`eb95ded`	317.51 ms	369.08 ms	51.57 ms
`2124a46`	319.19 ms	415.04 ms	95.85 ms
`c3ee041`	310.64 ms	361.90 ms	51.26 ms
`dcc6bbf`	382.58 ms	462.13 ms	79.54 ms
`7a19fee`	315.46 ms	368.62 ms	53.16 ms
`9054d65`	330.94 ms	403.24 ms	72.30 ms
`d500866`	326.13 ms	378.70 ms	52.58 ms
`ad8da22`	365.86 ms	427.00 ms	61.14 ms
`ed33deb`	337.52 ms	484.06 ms	146.54 ms
`d15471f`	310.26 ms	377.04 ms	66.78 ms

App size

Revision	Plain	With Sentry	Diff
`eb95ded`	0 B	0 B	0 B
`2124a46`	1.58 MiB	2.12 MiB	551.51 KiB
`c3ee041`	0 B	0 B	0 B
`dcc6bbf`	1.58 MiB	2.12 MiB	553.10 KiB
`7a19fee`	0 B	0 B	0 B
`9054d65`	1.58 MiB	2.29 MiB	723.38 KiB
`d500866`	0 B	0 B	0 B
`ad8da22`	1.58 MiB	2.29 MiB	719.83 KiB
`ed33deb`	1.58 MiB	2.13 MiB	559.52 KiB
`d15471f`	1.58 MiB	2.13 MiB	559.54 KiB

Previous results on branch: no/perf/reuse-timer-executor

Startup times

Revision	Plain	With Sentry	Diff
`a70f7a7`	324.94 ms	379.86 ms	54.92 ms
`91c5190`	392.32 ms	460.78 ms	68.46 ms

App size

Revision	Plain	With Sentry	Diff
`a70f7a7`	0 B	0 B	0 B
`91c5190`	0 B	0 B	0 B

github-actions · 2026-07-22T11:41:29Z

🚨 Detected changes in high risk code 🚨

High-risk code has higher potential to break the SDK and may be hard to test. To prevent severe bugs, apply the rollout process for releasing such changes and be extra careful when changing and reviewing these files:

sentry/src/main/java/io/sentry/transport/RateLimiter.java

github-actions · 2026-07-22T15:53:03Z

🚨 Detected changes in high risk code 🚨

High-risk code has higher potential to break the SDK and may be hard to test. To prevent severe bugs, apply the rollout process for releasing such changes and be extra careful when changing and reviewing these files:

sentry/src/main/java/io/sentry/transport/RateLimiter.java

RateLimiter created a java.util.Timer whose thread stayed alive forever once the SDK got rate limited. Schedule the "rate limit lifted" observer notification on the shared timer executor instead, whose single worker thread is reused across all timeouts and self-terminates when idle. Pending notifications are cancelled on close(). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

github-actions · 2026-07-23T09:49:21Z

🚨 Detected changes in high risk code 🚨

High-risk code has higher potential to break the SDK and may be hard to test. To prevent severe bugs, apply the rollout process for releasing such changes and be extra careful when changing and reviewing these files:

sentry/src/main/java/io/sentry/transport/RateLimiter.java

cursor

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit b040430. Configure here.}

cursor · 2026-07-23T09:56:32Z

+          notifyObserversFutures.add(
+              options
+                  .getTimerExecutorService()
+                  .schedule(() -> notifyRateLimitObservers(), delayMillis));


Relative delay desyncs lift notification

Medium Severity

The old Timer.schedule(task, date) fired on an absolute wall-clock time matching the stored limit date. The new path schedules a relative delayMillis on the shared executor (monotonic/nanoTime-based), while isActiveForCategory still decides activity from wall-clock via currentDateProvider. If the clock moves backward during the wait, the task can run while the limit still looks active, and because nothing reschedules, observers such as session replay may never get a later “lifted” callback and can stay paused.

Additional Locations (1)

sentry/src/main/java/io/sentry/transport/RateLimiter.java#L307-L309

^{Reviewed by Cursor Bugbot for commit b040430. Configure here.}

romtsn · 2026-07-23T12:56:16Z

    fun getSUT(): RateLimiter {
      val options = SentryOptions().apply { setLogger(NoOpLogger.getInstance()) }
+      // a real executor so scheduled rate-limit-lifted notifications actually run
+      options.setTimerExecutorService(SentryExecutorService(options))


do we need to close it in teardown perhaps, so it doesn't leak across tests?

romtsn · 2026-07-23T13:00:36Z

-          timer = new Timer(true);
+      // notify observers again once the rate limit is lifted, using the shared timer executor
+      // instead of a dedicated Timer thread
+      try (final @NotNull ISentryLifecycleToken ignored = notifyFuturesLock.acquire()) {


l: unsure if we need to protect this with checking for instanceof NoOpSentryExecutorService to avoid allocating FutureTasks for nothing (isDone also returns false when no-op, so pruning wouldn't do anything), but we're not really doing that anywhere else I believe, so I'm fine with keeping it as-is.

romtsn

couple of nits, but LGTM 🎉

This was referenced Jul 22, 2026

perf: Collect performance data on shared timer executor (JAVA-653) #5816

Draft

perf: Let HostnameCache worker thread idle out (JAVA-653) #5817

Draft

perf: Share one executor between log and metrics batch processors (JAVA-653) #5818

Draft

runningcode force-pushed the no/perf/reuse-timer-executor branch from 81bc25c to 00ed5c3 Compare July 22, 2026 11:41

runningcode changed the title ~~perf: Replace Timer threads with shared timer executor (JAVA-653)~~ perf: Schedule rate-limit notifications on shared executor (JAVA-653) Jul 22, 2026

runningcode mentioned this pull request Jul 22, 2026

perf: Schedule session end on shared executor (JAVA-653) #5819

Merged

8 tasks

runningcode force-pushed the no/perf/reuse-timer-executor branch from 00ed5c3 to 4f33cf7 Compare July 22, 2026 15:52

runningcode and others added 2 commits July 23, 2026 11:46

changelog

b040430

runningcode force-pushed the no/perf/reuse-timer-executor branch from 4f33cf7 to b040430 Compare July 23, 2026 09:48

runningcode marked this pull request as ready for review July 23, 2026 09:53

runningcode requested review from 0xadam-brown, adinauer, markushi and romtsn as code owners July 23, 2026 09:53

cursor Bot reviewed Jul 23, 2026

View reviewed changes

romtsn reviewed Jul 23, 2026

View reviewed changes

romtsn approved these changes Jul 23, 2026

View reviewed changes

Uh oh!

Uh oh!

Conversation

runningcode commented Jul 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📜 Description

💡 Motivation and Context

💚 How did you test it?

📝 Checklist

🔮 Next steps

Uh oh!

linear-code Bot commented Jul 22, 2026

Uh oh!

github-actions Bot commented Jul 22, 2026

🚨 Detected changes in high risk code 🚨

Uh oh!

github-actions Bot commented Jul 22, 2026

🚨 Detected changes in high risk code 🚨

Uh oh!

sentry Bot commented Jul 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📲 Install Builds

Android

Uh oh!

github-actions Bot commented Jul 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Performance metrics 🚀

Baseline results on branch: main

Startup times

App size

Previous results on branch: no/perf/reuse-timer-executor

Startup times

App size

Uh oh!

github-actions Bot commented Jul 22, 2026

🚨 Detected changes in high risk code 🚨

Uh oh!

github-actions Bot commented Jul 22, 2026

🚨 Detected changes in high risk code 🚨

Uh oh!

github-actions Bot commented Jul 23, 2026

🚨 Detected changes in high risk code 🚨

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

cursor Bot Jul 23, 2026

Choose a reason for hiding this comment

Relative delay desyncs lift notification

Uh oh!

romtsn Jul 23, 2026

Choose a reason for hiding this comment

Uh oh!

romtsn Jul 23, 2026

Choose a reason for hiding this comment

Uh oh!

romtsn left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

runningcode commented Jul 22, 2026 •

edited

Loading

sentry Bot commented Jul 22, 2026 •

edited

Loading

github-actions Bot commented Jul 22, 2026 •

edited

Loading