feat(spring): [Logs and Metrics Enable Flags 6] Add logging Logs opt-in

CHANGELOG.md

@@ -4,6 +4,7 @@
 
 ### Features
 
+- Add an explicit Logs opt-in to Spring Boot logging auto-configuration ([#5946](https://github.com/getsentry/sentry-java/pull/5946))
 - Add an explicit Logs opt-in to the Android Logcat integration ([#5945](https://github.com/getsentry/sentry-java/pull/5945))
 - Add an explicit Logs opt-in to the Android Timber integration ([#5943](https://github.com/getsentry/sentry-java/pull/5943))
 - Add an explicit Logs opt-in to the JUL handler ([#5942](https://github.com/getsentry/sentry-java/pull/5942))

sentry-samples/sentry-samples-spring-boot-4-opentelemetry-noagent/src/main/resources/application.properties

@@ -16,6 +16,7 @@ sentry.enable-backpressure-handling=true
 sentry.enable-spotlight=true
 sentry.enablePrettySerializationOutput=false
 sentry.logs.enabled=true
+sentry.logging.enable-logs=true
 sentry.in-app-includes="io.sentry.samples"
 sentry.profile-session-sample-rate=1.0
 sentry.profiling-traces-dir-path=tmp/sentry/profiling-traces

sentry-samples/sentry-samples-spring-boot-4-opentelemetry/src/main/resources/application.properties

@@ -16,6 +16,7 @@ sentry.enable-backpressure-handling=true
 sentry.enable-spotlight=true
 sentry.enablePrettySerializationOutput=false
 sentry.logs.enabled=true
+sentry.logging.enable-logs=true
 sentry.in-app-includes="io.sentry.samples"
 sentry.profile-session-sample-rate=1.0
 sentry.profiling-traces-dir-path=tmp/sentry/profiling-traces

sentry-samples/sentry-samples-spring-boot-4-otlp/src/main/resources/application.properties

@@ -17,6 +17,7 @@ sentry.enable-spotlight=true
 sentry.enablePrettySerializationOutput=false
 sentry.in-app-includes="io.sentry.samples"
 sentry.logs.enabled=true
+sentry.logging.enable-logs=true
 sentry.profile-session-sample-rate=1.0
 sentry.profiling-traces-dir-path=tmp/sentry/profiling-traces
 sentry.profile-lifecycle=TRACE

sentry-samples/sentry-samples-spring-boot-4-webflux/src/main/resources/application.properties

@@ -11,6 +11,7 @@ sentry.reactive.thread-local-accessor-enabled=true
 sentry.traces-sample-rate=1.0
 sentry.enable-backpressure-handling=true
 sentry.logs.enabled=true
+sentry.logging.enable-logs=true
 sentry.enable-spotlight=true
 sentry.profile-session-sample-rate=1.0
 sentry.profiling-traces-dir-path=tmp/sentry/profiling-traces

sentry-samples/sentry-samples-spring-boot-4/src/main/resources/application.properties

@@ -17,6 +17,7 @@ sentry.enable-spotlight=true
 sentry.enablePrettySerializationOutput=false
 sentry.in-app-includes="io.sentry.samples"
 sentry.logs.enabled=true
+sentry.logging.enable-logs=true
 sentry.profile-session-sample-rate=1.0
 sentry.profiling-traces-dir-path=tmp/sentry/profiling-traces
 sentry.profile-lifecycle=TRACE

sentry-samples/sentry-samples-spring-boot-jakarta-opentelemetry-noagent/src/main/resources/application.properties

@@ -16,6 +16,7 @@ sentry.enable-backpressure-handling=true
 sentry.enable-spotlight=true
 sentry.enablePrettySerializationOutput=false
 sentry.logs.enabled=true
+sentry.logging.enable-logs=true
 sentry.in-app-includes="io.sentry.samples"
 sentry.profile-session-sample-rate=1.0
 sentry.profiling-traces-dir-path=tmp/sentry/profiling-traces

sentry-samples/sentry-samples-spring-boot-jakarta-opentelemetry/src/main/resources/application.properties

@@ -16,6 +16,7 @@ sentry.enable-backpressure-handling=true
 sentry.enable-spotlight=true
 sentry.enablePrettySerializationOutput=false
 sentry.logs.enabled=true
+sentry.logging.enable-logs=true
 sentry.in-app-includes="io.sentry.samples"
 sentry.profile-session-sample-rate=1.0
 sentry.profiling-traces-dir-path=tmp/sentry/profiling-traces

sentry-samples/sentry-samples-spring-boot-jakarta/src/main/resources/application.properties

@@ -17,6 +17,7 @@ sentry.enable-spotlight=false
 sentry.enablePrettySerializationOutput=false
 sentry.in-app-includes="io.sentry.samples"
 sentry.logs.enabled=true
+sentry.logging.enable-logs=true
 sentry.profile-session-sample-rate=1.0
 sentry.profiling-traces-dir-path=tmp/sentry/profiling-traces
 sentry.profile-lifecycle=TRACE

sentry-samples/sentry-samples-spring-boot-opentelemetry-noagent/src/main/resources/application.properties

@@ -15,6 +15,7 @@ sentry.graphql.ignored-error-types=SOME_ERROR,ANOTHER_ERROR
 sentry.enable-backpressure-handling=true
 sentry.enable-spotlight=true
 sentry.logs.enabled=true
+sentry.logging.enable-logs=true
 sentry.in-app-includes="io.sentry.samples"
 sentry.profile-session-sample-rate=1.0
 sentry.profiling-traces-dir-path=tmp/sentry/profiling-traces

sentry-samples/sentry-samples-spring-boot-opentelemetry/src/main/resources/application.properties

@@ -15,6 +15,7 @@ sentry.graphql.ignored-error-types=SOME_ERROR,ANOTHER_ERROR
 sentry.enable-backpressure-handling=true
 sentry.enable-spotlight=true
 sentry.logs.enabled=true
+sentry.logging.enable-logs=true
 sentry.in-app-includes="io.sentry.samples"
 sentry.profile-session-sample-rate=1.0
 sentry.profiling-traces-dir-path=tmp/sentry/profiling-traces

sentry-samples/sentry-samples-spring-boot-webflux-jakarta/src/main/resources/application.properties

@@ -11,6 +11,7 @@ sentry.reactive.thread-local-accessor-enabled=true
 sentry.traces-sample-rate=1.0
 sentry.enable-backpressure-handling=true
 sentry.logs.enabled=true
+sentry.logging.enable-logs=true
 sentry.enable-spotlight=true
 sentry.in-app-includes="io.sentry.samples"
 sentry.profile-session-sample-rate=1.0

sentry-samples/sentry-samples-spring-boot-webflux/src/main/resources/application.properties

@@ -13,6 +13,7 @@ spring.graphql.websocket.path=/graphql
 spring.graphql.schema.printer.enabled=true
 sentry.enable-backpressure-handling=true
 sentry.logs.enabled=true
+sentry.logging.enable-logs=true
 sentry.enable-spotlight=true
 sentry.in-app-includes="io.sentry.samples"
 sentry.profile-session-sample-rate=1.0

sentry-samples/sentry-samples-spring-boot/src/main/resources/application.properties

@@ -15,6 +15,7 @@ sentry.graphql.ignored-error-types=SOME_ERROR,ANOTHER_ERROR
 sentry.enable-backpressure-handling=true
 sentry.enable-spotlight=true
 sentry.logs.enabled=true
+sentry.logging.enable-logs=true
 sentry.in-app-includes="io.sentry.samples"
 sentry.profile-session-sample-rate=1.0
 sentry.profiling-traces-dir-path=tmp/sentry/profiling-traces

sentry-spring-boot-4/api/sentry-spring-boot-4.api

@@ -60,7 +60,9 @@ public class io/sentry/spring/boot4/SentryProperties$Logging {
 	public fun getMinimumBreadcrumbLevel ()Lorg/slf4j/event/Level;
 	public fun getMinimumEventLevel ()Lorg/slf4j/event/Level;
 	public fun getMinimumLevel ()Lorg/slf4j/event/Level;
+	public fun isEnableLogs ()Z
 	public fun isEnabled ()Z
+	public fun setEnableLogs (Z)V
 	public fun setEnabled (Z)V
 	public fun setLoggers (Ljava/util/List;)V
 	public fun setMinimumBreadcrumbLevel (Lorg/slf4j/event/Level;)V

sentry-spring-boot-4/src/main/java/io/sentry/spring/boot4/SentryLogbackInitializer.java

@@ -45,6 +45,7 @@ public void onApplicationEvent(final @NotNull ApplicationEvent event) {
           if (!isSentryAppenderRegistered(logger)) {
             final SentryAppender sentryAppender = getSentryAppender();
 
+            sentryAppender.setEnableLogs(sentryProperties.getLogging().isEnableLogs());
             Optional.ofNullable(sentryProperties.getLogging().getMinimumBreadcrumbLevel())
                 .map(slf4jLevel -> Level.toLevel(slf4jLevel.name()))
                 .ifPresent(sentryAppender::setMinimumBreadcrumbLevel);

sentry-spring-boot-4/src/main/java/io/sentry/spring/boot4/SentryProperties.java

@@ -129,6 +129,9 @@ public static class Logging {
     /** Enable/Disable logging auto-configuration. */
     private boolean enabled = true;
 
+    /** Enable/Disable Sentry Logs capture from the auto-configured appender. */
+    private boolean enableLogs = false;
+
     /** Minimum logging level for recording breadcrumbs. */
     private @Nullable Level minimumBreadcrumbLevel;
 
@@ -149,6 +152,14 @@ public void setEnabled(boolean enabled) {
       this.enabled = enabled;
     }
 
+    public boolean isEnableLogs() {
+      return enableLogs;
+    }
+
+    public void setEnableLogs(boolean enableLogs) {
+      this.enableLogs = enableLogs;
+    }
+
     public @Nullable Level getMinimumBreadcrumbLevel() {
       return minimumBreadcrumbLevel;
     }

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

@@ -244,6 +244,7 @@ class SentryAutoConfigurationTest {
         "sentry.cron.default-failure-issue-threshold=40",
         "sentry.cron.default-recovery-threshold=50",
         "sentry.logs.enabled=true",
+        "sentry.logging.enable-logs=true",
         "sentry.strict-trace-continuation=true",
         "sentry.org-id=12345",
       )
@@ -301,6 +302,7 @@ class SentryAutoConfigurationTest {
         assertThat(options.cron!!.defaultFailureIssueThreshold).isEqualTo(40L)
         assertThat(options.cron!!.defaultRecoveryThreshold).isEqualTo(50L)
         assertThat(options.logs.isEnabled).isEqualTo(true)
+        assertThat(options.logging.isEnableLogs).isTrue()
         assertThat(options.isStrictTraceContinuation).isEqualTo(true)
         assertThat(options.orgId).isEqualTo("12345")
       }

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

@@ -112,6 +112,7 @@ class SentryLogbackAppenderAutoConfigurationTest {
         "sentry.logging.minimum-event-level=info",
         "sentry.logging.minimum-breadcrumb-level=debug",
         "sentry.logging.minimum-level=error",
+        "sentry.logging.enable-logs=true",
       )
       .run {
         val appenders = rootLogger.getAppenders(SentryAppender::class.java)
@@ -121,9 +122,19 @@ class SentryLogbackAppenderAutoConfigurationTest {
         assertThat(sentryAppender.minimumBreadcrumbLevel).isEqualTo(Level.DEBUG)
         assertThat(sentryAppender.minimumEventLevel).isEqualTo(Level.INFO)
         assertThat(sentryAppender.minimumLevel).isEqualTo(Level.ERROR)
+        assertThat(sentryAppender.isEnableLogs).isTrue()
       }
   }
 
+  @Test
+  fun `SentryAppender Logs are disabled by default`() {
+    dsnEnabledRunner.run {
+      val sentryAppender = rootLogger.getAppenders(SentryAppender::class.java).single()
+
+      assertThat((sentryAppender as SentryAppender).isEnableLogs).isFalse()
+    }
+  }
+
   @Test
   fun `does not configure SentryAppender when logging is disabled`() {
     contextRunner.withPropertyValues("sentry.logging.enabled=false").run {

sentry-spring-boot-jakarta/api/sentry-spring-boot-jakarta.api

@@ -60,7 +60,9 @@ public class io/sentry/spring/boot/jakarta/SentryProperties$Logging {
 	public fun getMinimumBreadcrumbLevel ()Lorg/slf4j/event/Level;
 	public fun getMinimumEventLevel ()Lorg/slf4j/event/Level;
 	public fun getMinimumLevel ()Lorg/slf4j/event/Level;
+	public fun isEnableLogs ()Z
 	public fun isEnabled ()Z
+	public fun setEnableLogs (Z)V
 	public fun setEnabled (Z)V
 	public fun setLoggers (Ljava/util/List;)V
 	public fun setMinimumBreadcrumbLevel (Lorg/slf4j/event/Level;)V

sentry-spring-boot-jakarta/src/main/java/io/sentry/spring/boot/jakarta/SentryLogbackInitializer.java

@@ -45,6 +45,7 @@ public void onApplicationEvent(final @NotNull ApplicationEvent event) {
           if (!isSentryAppenderRegistered(logger)) {
             final SentryAppender sentryAppender = getSentryAppender();
 
+            sentryAppender.setEnableLogs(sentryProperties.getLogging().isEnableLogs());
             Optional.ofNullable(sentryProperties.getLogging().getMinimumBreadcrumbLevel())
                 .map(slf4jLevel -> Level.toLevel(slf4jLevel.name()))
                 .ifPresent(sentryAppender::setMinimumBreadcrumbLevel);

sentry-spring-boot-jakarta/src/main/java/io/sentry/spring/boot/jakarta/SentryProperties.java

@@ -129,6 +129,9 @@ public static class Logging {
     /** Enable/Disable logging auto-configuration. */
     private boolean enabled = true;
 
+    /** Enable/Disable Sentry Logs capture from the auto-configured appender. */
+    private boolean enableLogs = false;
+
     /** Minimum logging level for recording breadcrumbs. */
     private @Nullable Level minimumBreadcrumbLevel;
 
@@ -149,6 +152,14 @@ public void setEnabled(boolean enabled) {
       this.enabled = enabled;
     }
 
+    public boolean isEnableLogs() {
+      return enableLogs;
+    }
+
+    public void setEnableLogs(boolean enableLogs) {
+      this.enableLogs = enableLogs;
+    }
+
     public @Nullable Level getMinimumBreadcrumbLevel() {
       return minimumBreadcrumbLevel;
     }

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

@@ -246,6 +246,7 @@ class SentryAutoConfigurationTest {
         "sentry.cron.default-failure-issue-threshold=40",
         "sentry.cron.default-recovery-threshold=50",
         "sentry.logs.enabled=true",
+        "sentry.logging.enable-logs=true",
         "sentry.profile-session-sample-rate=1.0",
         "sentry.profiling-traces-dir-path=tmp/sentry/profiling-traces",
         "sentry.profile-lifecycle=TRACE",
@@ -305,6 +306,7 @@ class SentryAutoConfigurationTest {
         assertThat(options.cron!!.defaultFailureIssueThreshold).isEqualTo(40L)
         assertThat(options.cron!!.defaultRecoveryThreshold).isEqualTo(50L)
         assertThat(options.logs.isEnabled).isEqualTo(true)
+        assertThat(options.logging.isEnableLogs).isTrue()
         assertThat(options.profileSessionSampleRate).isEqualTo(1.0)
         assertThat(options.profilingTracesDirPath)
           .startsWith(File("tmp/sentry/profiling-traces").absolutePath)

sentry-spring-boot-jakarta/src/test/kotlin/io/sentry/spring/boot/jakarta/SentryLogbackAppenderAutoConfigurationTest.kt

@@ -112,6 +112,7 @@ class SentryLogbackAppenderAutoConfigurationTest {
         "sentry.logging.minimum-event-level=info",
         "sentry.logging.minimum-breadcrumb-level=debug",
         "sentry.logging.minimum-level=error",
+        "sentry.logging.enable-logs=true",
       )
       .run {
         val appenders = rootLogger.getAppenders(SentryAppender::class.java)
@@ -121,9 +122,19 @@ class SentryLogbackAppenderAutoConfigurationTest {
         assertThat(sentryAppender.minimumBreadcrumbLevel).isEqualTo(Level.DEBUG)
         assertThat(sentryAppender.minimumEventLevel).isEqualTo(Level.INFO)
         assertThat(sentryAppender.minimumLevel).isEqualTo(Level.ERROR)
+        assertThat(sentryAppender.isEnableLogs).isTrue()
       }
   }
 
+  @Test
+  fun `SentryAppender Logs are disabled by default`() {
+    dsnEnabledRunner.run {
+      val sentryAppender = rootLogger.getAppenders(SentryAppender::class.java).single()
+
+      assertThat((sentryAppender as SentryAppender).isEnableLogs).isFalse()
+    }
+  }
+
   @Test
   fun `does not configure SentryAppender when logging is disabled`() {
     contextRunner.withPropertyValues("sentry.logging.enabled=false").run {

sentry-spring-boot/api/sentry-spring-boot.api

@@ -56,7 +56,9 @@ public class io/sentry/spring/boot/SentryProperties$Logging {
 	public fun getMinimumBreadcrumbLevel ()Lorg/slf4j/event/Level;
 	public fun getMinimumEventLevel ()Lorg/slf4j/event/Level;
 	public fun getMinimumLevel ()Lorg/slf4j/event/Level;
+	public fun isEnableLogs ()Z
 	public fun isEnabled ()Z
+	public fun setEnableLogs (Z)V
 	public fun setEnabled (Z)V
 	public fun setLoggers (Ljava/util/List;)V
 	public fun setMinimumBreadcrumbLevel (Lorg/slf4j/event/Level;)V

sentry-spring-boot/src/main/java/io/sentry/spring/boot/SentryLogbackInitializer.java

@@ -45,6 +45,7 @@ public void onApplicationEvent(final @NotNull ApplicationEvent event) {
           if (!isSentryAppenderRegistered(logger)) {
             final SentryAppender sentryAppender = getSentryAppender();
 
+            sentryAppender.setEnableLogs(sentryProperties.getLogging().isEnableLogs());
             Optional.ofNullable(sentryProperties.getLogging().getMinimumBreadcrumbLevel())
                 .map(slf4jLevel -> Level.toLevel(slf4jLevel.name()))
                 .ifPresent(sentryAppender::setMinimumBreadcrumbLevel);

sentry-spring-boot/src/main/java/io/sentry/spring/boot/SentryProperties.java

@@ -103,6 +103,9 @@ public static class Logging {
     /** Enable/Disable logging auto-configuration. */
     private boolean enabled = true;
 
+    /** Enable/Disable Sentry Logs capture from the auto-configured appender. */
+    private boolean enableLogs = false;
+
     /** Minimum logging level for recording breadcrumbs. */
     private @Nullable Level minimumBreadcrumbLevel;
 
@@ -123,6 +126,14 @@ public void setEnabled(boolean enabled) {
       this.enabled = enabled;
     }
 
+    public boolean isEnableLogs() {
+      return enableLogs;
+    }
+
+    public void setEnableLogs(boolean enableLogs) {
+      this.enableLogs = enableLogs;
+    }
+
     public @Nullable Level getMinimumBreadcrumbLevel() {
       return minimumBreadcrumbLevel;
     }

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

@@ -244,6 +244,7 @@ class SentryAutoConfigurationTest {
         "sentry.cron.default-failure-issue-threshold=40",
         "sentry.cron.default-recovery-threshold=50",
         "sentry.logs.enabled=true",
+        "sentry.logging.enable-logs=true",
         "sentry.profile-session-sample-rate=1.0",
         "sentry.profiling-traces-dir-path=tmp/sentry/profiling-traces",
         "sentry.profile-lifecycle=TRACE",
@@ -303,6 +304,7 @@ class SentryAutoConfigurationTest {
         assertThat(options.cron!!.defaultFailureIssueThreshold).isEqualTo(40L)
         assertThat(options.cron!!.defaultRecoveryThreshold).isEqualTo(50L)
         assertThat(options.logs.isEnabled).isEqualTo(true)
+        assertThat(options.logging.isEnableLogs).isTrue()
         assertThat(options.profileSessionSampleRate).isEqualTo(1.0)
         assertThat(options.profilingTracesDirPath)
           .startsWith(File("tmp/sentry/profiling-traces").absolutePath)

sentry-spring-boot/src/test/kotlin/io/sentry/spring/boot/SentryLogbackAppenderAutoConfigurationTest.kt

@@ -112,6 +112,7 @@ class SentryLogbackAppenderAutoConfigurationTest {
         "sentry.logging.minimum-event-level=info",
         "sentry.logging.minimum-breadcrumb-level=debug",
         "sentry.logging.minimum-level=error",
+        "sentry.logging.enable-logs=true",
       )
       .run {
         val appenders = rootLogger.getAppenders(SentryAppender::class.java)
@@ -121,9 +122,19 @@ class SentryLogbackAppenderAutoConfigurationTest {
         assertThat(sentryAppender.minimumBreadcrumbLevel).isEqualTo(Level.DEBUG)
         assertThat(sentryAppender.minimumEventLevel).isEqualTo(Level.INFO)
         assertThat(sentryAppender.minimumLevel).isEqualTo(Level.ERROR)
+        assertThat(sentryAppender.isEnableLogs).isTrue()
       }
   }
 
+  @Test
+  fun `SentryAppender Logs are disabled by default`() {
+    dsnEnabledRunner.run {
+      val sentryAppender = rootLogger.getAppenders(SentryAppender::class.java).single()
+
+      assertThat((sentryAppender as SentryAppender).isEnableLogs).isFalse()
+    }
+  }
+
   @Test
   fun `does not configure SentryAppender when logging is disabled`() {
     contextRunner.withPropertyValues("sentry.logging.enabled=false").run {