Fix profiling init for Spring and Spring Boot w Agent auto-init #4815

lbloder · 2025-10-20T08:53:19Z

📜 Description

Add @Configuration classes to initialize the profiler when running in OTEL Agent auto-init mode.

💡 Motivation and Context

Fixes #4855

💚 How did you test it?

📝 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

…options, add configuration class to load the profiler and converter after spring boot starts in agent mode

lbloder · 2025-10-20T08:57:55Z

...oot-jakarta/src/main/java/io/sentry/spring/boot/jakarta/SentryProfilerAutoConfiguration.java

+import org.springframework.context.annotation.Import;
+
+@Configuration(proxyBeanMethods = false)
+@ConditionalOnClass(name = {"io.sentry.opentelemetry.agent.AgentMarker"})


Make it conditional on the async profiler class too?

Sounds good, I see no reason to run this if profiler isn't there.

github-actions · 2025-10-20T09:04:58Z

Performance metrics 🚀

	Plain	With Sentry	Diff
Startup time	313.91 ms	378.00 ms	64.09 ms
Size	1.58 MiB	2.12 MiB	552.67 KiB

Baseline results on branch: main

Startup times

Revision	Plain	With Sentry	Diff
`9fbb112`	401.87 ms	515.87 ms	114.00 ms
`b3d8889`	371.84 ms	447.49 ms	75.65 ms
`d217708`	411.22 ms	430.86 ms	19.63 ms
`27d7cf8`	397.90 ms	498.65 ms	100.75 ms
`fcec2f2`	311.35 ms	384.94 ms	73.59 ms
`ee747ae`	358.21 ms	389.41 ms	31.20 ms
`ee747ae`	554.98 ms	611.50 ms	56.52 ms
`b77456b`	393.26 ms	441.10 ms	47.84 ms
`27d7cf8`	309.43 ms	364.27 ms	54.85 ms
`b3d8889`	371.33 ms	426.24 ms	54.92 ms

App size

Revision	Plain	With Sentry	Diff
`9fbb112`	1.58 MiB	2.11 MiB	539.18 KiB
`b3d8889`	1.58 MiB	2.10 MiB	535.07 KiB
`d217708`	1.58 MiB	2.10 MiB	532.97 KiB
`27d7cf8`	1.58 MiB	2.12 MiB	549.42 KiB
`fcec2f2`	1.58 MiB	2.12 MiB	551.51 KiB
`ee747ae`	1.58 MiB	2.10 MiB	530.95 KiB
`ee747ae`	1.58 MiB	2.10 MiB	530.95 KiB
`b77456b`	1.58 MiB	2.12 MiB	548.11 KiB
`27d7cf8`	1.58 MiB	2.12 MiB	549.42 KiB
`b3d8889`	1.58 MiB	2.10 MiB	535.07 KiB

Previous results on branch: feat/profiling-w-spring-otel-agent

Startup times

Revision	Plain	With Sentry	Diff
`d76029f`	339.65 ms	357.82 ms	18.17 ms
`c4729d6`	315.52 ms	362.84 ms	47.32 ms
`2b6b804`	312.35 ms	370.80 ms	58.45 ms
`db75a56`	331.37 ms	402.82 ms	71.45 ms
`c773a3a`	406.73 ms	491.63 ms	84.90 ms
`3832729`	297.73 ms	353.21 ms	55.48 ms
`b59fc8e`	399.24 ms	444.62 ms	45.38 ms
`30b9948`	314.20 ms	354.71 ms	40.51 ms

App size

Revision	Plain	With Sentry	Diff
`d76029f`	1.58 MiB	2.12 MiB	549.52 KiB
`c4729d6`	1.58 MiB	2.12 MiB	548.31 KiB
`2b6b804`	1.58 MiB	2.12 MiB	551.86 KiB
`db75a56`	1.58 MiB	2.12 MiB	551.94 KiB
`c773a3a`	1.58 MiB	2.12 MiB	549.51 KiB
`3832729`	1.58 MiB	2.12 MiB	551.94 KiB
`b59fc8e`	1.58 MiB	2.11 MiB	539.90 KiB
`30b9948`	1.58 MiB	2.12 MiB	551.90 KiB

lbloder · 2025-10-20T09:08:37Z

sentry-spring-jakarta/src/main/java/io/sentry/spring/jakarta/SentryProfilerConfiguration.java

+
+  @Bean
+  @ConditionalOnMissingBean(name = "sentryOpenTelemetryProfilerConfiguration")
+  public IContinuousProfiler sentryOpenTelemetryProfilerConfiguration() {


Extract init into util to streamline initialization code

lbloder · 2025-10-20T09:08:41Z

sentry-spring-jakarta/src/main/java/io/sentry/spring/jakarta/SentryProfilerConfiguration.java

+
+  @Bean
+  @ConditionalOnMissingBean(name = "sentryOpenTelemetryProfilerConverterConfiguration")
+  public IProfileConverter sentryOpenTelemetryProfilerConverterConfiguration() {


Extract init into util to streamline initialization code

lbloder · 2025-11-03T07:43:05Z

@sentry review

lbloder · 2025-11-03T07:43:11Z

@cursor review

sentry-async-profiler/src/test/java/io/sentry/asyncprofiler/init/AsyncProfilerInitUtilTest.kt

adinauer · 2025-11-04T08:16:07Z

sentry-async-profiler/src/test/java/io/sentry/asyncprofiler/init/AsyncProfilerInitUtilTest.kt

+  }
+
+  @Test
+  fun `initialize converter returns no-op converter if converter already initialized`() {


m should it simply return the existing one instead of noop that potentially causes profiling to break?

sentry-spring-7/src/main/java/io/sentry/spring7/SentryProfilerConfiguration.java

adinauer · 2025-11-04T08:35:03Z

sentry-spring-7/src/main/java/io/sentry/spring7/SentryProfilerConfiguration.java

+
+  @Bean
+  @ConditionalOnMissingBean(name = "sentryOpenTelemetryProfilerConfiguration")
+  public IContinuousProfiler sentryOpenTelemetryProfilerConfiguration() {


Is there an expected order to these bean evaluations?

adinauer · 2025-11-04T08:36:19Z

sentry-spring-boot-4/src/test/kotlin/io/sentry/spring/boot4/SentryAutoConfigurationTest.kt

+    contextRunner
+      .withPropertyValues(
+        "sentry.dsn=http://key@localhost/proj",
+        "sentry.traces-sample-rate=1.0",


Should this also have "sentry.profile-session-sample-rate=1.0",?

adinauer · 2025-11-04T09:01:13Z

sentry-spring-boot-4/src/test/kotlin/io/sentry/spring/boot4/SentryAutoConfigurationTest.kt

+        "debug=true",
+      )
+      .run {
+        assertThat(it).hasSingleBean(IContinuousProfiler::class.java)


Is this currently simply asserting it has noop instances?

adinauer · 2025-11-04T09:01:48Z

...oot-jakarta/src/main/java/io/sentry/spring/boot/jakarta/SentryProfilerAutoConfiguration.java

+import org.springframework.context.annotation.Import;
+
+@Configuration(proxyBeanMethods = false)
+@ConditionalOnClass(name = {"io.sentry.opentelemetry.agent.AgentMarker"})


Sounds good, I see no reason to run this if profiler isn't there.

adinauer · 2025-11-04T10:06:48Z

sentry/src/main/java/io/sentry/util/InitUtil.java

    return previousOptions.getInitPriority().ordinal() <= newOptions.getInitPriority().ordinal();
  }
+
+  public static IContinuousProfiler initializeProfiler(@NotNull SentryOptions options) {


m should we instead check if options already have a profiler / converter set (that's not noop) and return that?
IMO that makes it easier to reason about SDK init.
Looking at the tests it seems we're potentially replacing a working profiler / converter with noop (if misusing this util).

…Configuration.java Co-authored-by: Alexander Dinauer <adinauer@users.noreply.github.com>

…ve tests

…ntry/sentry-java into feat/profiling-w-spring-otel-agent

cursor · 2025-11-04T13:51:48Z

sentry-spring-boot-4/src/test/kotlin/io/sentry/spring/boot4/SentryAutoConfigurationTest.kt

+        assertThat(it).hasSingleBean(IContinuousProfiler::class.java)
+        assertThat(it).hasSingleBean(IProfileConverter::class.java)
+      }
+  }


Bug: Continuous Profiling Test Lacks Required Sample Rate

The test "when AgentMarker is on the classpath and ContinuousProfiling is enabled..." doesn't actually enable continuous profiling. It's missing the sentry.profile-session-sample-rate=1.0 property, which results in NoOp profiler beans being created instead of functional ones. This makes the test misleading about verifying actual continuous profiling setup, especially since the companion test correctly includes this property.

Additional Locations (2)

sentry-spring-boot/src/test/kotlin/io/sentry/spring/boot/SentryAutoConfigurationTest.kt#L916-L930

sentry-spring-boot-jakarta/src/test/kotlin/io/sentry/spring/boot/jakarta/SentryAutoConfigurationTest.kt#L1065-L1079

also load converter at sentry initialization time and hold in sentry-…

a4ce01a

…options, add configuration class to load the profiler and converter after spring boot starts in agent mode

lbloder commented Oct 20, 2025

View reviewed changes

lbloder added 7 commits October 20, 2025 15:24

use InitUtil to initialize profiler and converter

39225ff

add new configuration class to spring and spring4 variants

40395fb

add tests for profiler and converter init

f8f253f

format code

c02c3dd

add test for auto profiler config

d180c19

bump api

5e75584

Merge branch 'main' into feat/profiling-w-spring-otel-agent

dde02b9

lbloder mentioned this pull request Nov 3, 2025

JVM Profiling Follow ups #4778

Open

16 tasks

sentry bot reviewed Nov 3, 2025

View reviewed changes

sentry-async-profiler/src/test/java/io/sentry/asyncprofiler/init/AsyncProfilerInitUtilTest.kt Show resolved Hide resolved

sentry-async-profiler/src/test/java/io/sentry/asyncprofiler/init/AsyncProfilerInitUtilTest.kt Outdated Show resolved Hide resolved

This comment was marked as outdated.

Sign in to view

lbloder added 3 commits November 3, 2025 09:30

add missing package to test, adapt log statement

0514903

add changelog entry, improve logs

2cb26e1

Merge branch 'main' into feat/profiling-w-spring-otel-agent

737c147

lbloder marked this pull request as ready for review November 3, 2025 13:29

lbloder requested review from adinauer, lcian, markushi, romtsn and stefanosiano as code owners November 3, 2025 13:29

This comment was marked as outdated.

Sign in to view

adinauer reviewed Nov 4, 2025

View reviewed changes

lbloder and others added 2 commits November 4, 2025 12:22

Update sentry-spring-7/src/main/java/io/sentry/spring7/SentryProfiler…

41d2c6a

…Configuration.java Co-authored-by: Alexander Dinauer <adinauer@users.noreply.github.com>

Format code

87071dd

This comment was marked as outdated.

Sign in to view

lbloder added 2 commits November 4, 2025 14:47

make initUtil methods more readable, return value from options, impro…

8fca29a

…ve tests

Merge branch 'feat/profiling-w-spring-otel-agent' of github.com:getse…

40bb0a2

…ntry/sentry-java into feat/profiling-w-spring-otel-agent

cursor bot reviewed Nov 4, 2025

View reviewed changes

Uh oh!

Fix profiling init for Spring and Spring Boot w Agent auto-init #4815

Are you sure you want to change the base?

Fix profiling init for Spring and Spring Boot w Agent auto-init #4815

Uh oh!

Conversation

lbloder commented Oct 20, 2025 • 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!

lbloder Oct 20, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Oct 20, 2025 • 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: feat/profiling-w-spring-otel-agent

Startup times

App size

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

lbloder commented Nov 3, 2025

Uh oh!

lbloder commented Nov 3, 2025

Uh oh!

Uh oh!

Uh oh!

This comment was marked as outdated.

Uh oh!

This comment was marked as outdated.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

This comment was marked as outdated.

Uh oh!

This comment was marked as outdated.

Uh oh!

cursor bot Nov 4, 2025

Choose a reason for hiding this comment

Bug: Continuous Profiling Test Lacks Required Sample Rate

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

lbloder commented Oct 20, 2025 •

edited

Loading

lbloder Oct 20, 2025 •

edited

Loading

github-actions bot commented Oct 20, 2025 •

edited

Loading