8.24.0

Features

• Attach MDC properties to logs as attributes (#4786)
  • MDC properties set using supported logging frameworks (Logback, Log4j2, java.util.Logging) are now attached to structured logs as attributes.
  • The attribute reflected on the log is mdc.<key>, where <key> is the original key in the MDC.
  • This means that you will be able to filter/aggregate logs in the product based on these properties.
  • Only properties with keys matching the configured contextTags are sent as log attributes.
    • You can configure which properties are sent using options.setContextTags if initalizing manually, or by specifying a comma-separated list of keys with a context-tags entry in sentry.properties or sentry.context-tags in application.properties.
    • Note that keys containing spaces are not supported.
• Add experimental Sentry Android Distribution module for integrating with Sentry Build Distribution to check for and install updates (#4804)
• Allow passing a different Handler to SystemEventsBreadcrumbsIntegration and AndroidConnectionStatusProvider so their callbacks are deliver to that handler (#4808)
• Session Replay: Add new experimental Canvas Capture Strategy (#4777)
  • A new screenshot capture strategy that uses Android's Canvas API for more accurate and reliable text and image masking
  • Any .drawText() or .drawBitmap() calls are replaced by rectangles, ensuring no text or images are present in the resulting output
  • Note: If this strategy is used, all text and images will be masked, regardless of any masking configuration
  • To enable this feature, set the screenshotStrategy, either via code:

    SentryAndroid.init(context) { options ->
      options.sessionReplay.screenshotStrategy = ScreenshotStrategyType.CANVAS
    }

    or AndroidManifest.xml:

    <application>
      <meta-data android:name="io.sentry.session-replay.screenshot-strategy" android:value="canvas" />
    </application>

Fixes

• Avoid StrictMode warnings (#4724)
• Use logger from options for JVM profiler (#4771)
• Session Replay: Avoid deadlock when pausing replay if no connection (#4788)
• Session Replay: Fix capturing roots with no windows (#4805)
• Session Replay: Fix java.lang.IllegalArgumentException: width and height must be > 0 (#4805)
• Handle NoOpScopes in Context when starting a span through OpenTelemetry (#4823)
  • This fixes "java.lang.IllegalArgumentException: The DSN is required" when combining WebFlux and OpenTelemetry
• Session Replay: Do not use recycled screenshots for masking (#4790)
  • This fixes native crashes seen in Canvas.<init>/ScreenshotRecorder.capture
• Session Replay: Ensure bitmaps are recycled properly (#4820)

Miscellaneous

• Mark SentryClient(SentryOptions) constructor as not internal (#4787)

Dependencies

• Bump Native SDK from v0.10.1 to v0.11.2 (#4775)
  • changelog
  • diff

8.24.0-alpha.2

Features

• Attach MDC properties to logs as attributes (#4786)
  • MDC properties set using supported logging frameworks (Logback, Log4j2, java.util.Logging) are now attached to structured logs as attributes.
  • The attribute reflected on the log is mdc.<key>, where <key> is the original key in the MDC.
  • This means that you will be able to filter/aggregate logs in the product based on these properties.
  • Only properties with keys matching the configured contextTags are sent as log attributes.
    • You can configure which properties are sent using options.setContextTags if initalizing manually, or by specifying a comma-separated list of keys with a context-tags entry in sentry.properties or sentry.contex-tags in application.properties.
    • Note that keys containing spaces are not supported.
• Add experimental Sentry Android Distribution module for integrating with Sentry Build Distribution to check for and install updates (#4804)
• Allow passing a different Handler to SystemEventsBreadcrumbsIntegration and AndroidConnectionStatusProvider so their callbacks are deliver to that handler (#4808)

Fixes

• Avoid StrictMode warnings (#4724)
• Use logger from options for JVM profiler (#4771)
• Session Replay: Avoid deadlock when pausing replay if no connection (#4788)

Miscellaneous

• Mark SentryClient(SentryOptions) constructor as not internal (#4787)

Dependencies

• Bump Native SDK from v0.10.1 to v0.11.2 (#4775)
  • changelog
  • diff

8.23.1-alpha.1

Fixes

• Use logger from options for JVM profiler (#4771)

Miscellaneous

• Mark SentryClient(SentryOptions) constructor as not internal (#4787)

Dependencies

• Bump Native SDK from v0.10.1 to v0.11.2 (#4775)
  • changelog
  • diff

8.23.0

Features

• Add session replay id to Sentry Logs (#4740)
• Add support for continuous profiling of JVM applications on macOS and Linux (#4556)
  • Sentry continuous profiling on the JVM is using async-profiler under the hood.
  • By default this feature is disabled. Set a profile sample rate and chose a lifecycle (see below) to enable it.
  • Add the sentry-async-profiler dependency to your project
  • Set a sample rate for profiles, e.g. 1.0 to send all of them. You may use options.setProfileSessionSampleRate(1.0) in code or profile-session-sample-rate=1.0 in sentry.properties
  • Set a profile lifecycle via options.setProfileLifecycle(ProfileLifecycle.TRACE) in code or profile-lifecycle=TRACE in sentry.properties
    • By default the lifecycle is set to MANUAL, meaning you have to explicitly call Sentry.startProfiler() and Sentry.stopProfiler()
    • You may change it to TRACE which will create a profile for each transaction
  • To automatically upload Profiles for each transaction in a Spring Boot application
    • set sentry.profile-session-sample-rate=1.0 and sentry.profile-lifecycle=TRACE in application.properties
    • or set sentry.profile-session-sample-rate: 1.0 and sentry.profile-lifecycle: TRACE in application.yml
  • Profiling can also be combined with our OpenTelemetry integration

Fixes

• Start performance collection on AppStart continuous profiling (#4752)
• Preserve modifiers in SentryTraced (#4757)

Improvements

• Handle RejectedExecutionException everywhere (#4747)
• Mark SentryEnvelope as not internal (#4748)

8.22.0

Features

• Move SentryLogs out of experimental (#4710)
• Add support for w3c traceparent header (#4671)
  • This feature is disabled by default. If enabled, outgoing requests will include the w3c traceparent header.
  • See https://develop.sentry.dev/sdk/telemetry/traces/distributed-tracing/#w3c-trace-context-header for more details.

  Sentry(Android).init(context) { options ->
    // ...
    options.isPropagateTraceparent = true
  }

• Sentry now supports Spring Boot 4 M3 pre-release (#4739)

Improvements

• Remove internal API status from get/setDistinctId (#4708)
• Remove ApiStatus.Experimental annotation from check-in API (#4721)

Fixes

• Session Replay: Fix NoSuchElementException in BufferCaptureStrategy (#4717)
• Session Replay: Fix continue recording in Session mode after Buffer is triggered (#4719)

Dependencies

• Bump Native SDK from v0.10.0 to v0.10.1 (#4695)
  • changelog
  • diff

8.21.1

Fixes

• Use Kotlin stdlib 1.9.24 dependency instead of 2.2.0 for all Android modules (#4707)
  • This fixes compile time issues if your app is using Kotlin < 2.x

8.21.0

Fixes

• Only set log template for logging integrations if formatted message differs from template (#4682)

Features

• Add support for Spring Boot 4 and Spring 7 (#4601)
  • NOTE: Our sentry-opentelemetry-agentless-spring is not working yet for Spring Boot 4. Please use sentry-opentelemetry-agent until OpenTelemetry has support for Spring Boot 4.
• Replace UUIDGenerator implementation with Apache licensed code (#4662)
• Replace Random implementation with MIT licensed code (#4664)
• Add support for vars attribute in SentryStackFrame (#4686)
  • Breaking change: The type of the vars attribute has been changed from Map<String, String> to Map<String, Object>.

8.20.0

Fixes

• Do not use named capturing groups for regular expressions (#4652)
  • This fixes a crash on Android versions below 8.0 (API level 26)

Features

• Add onDiscard to enable users to track the type and amount of data discarded before reaching Sentry (#4612)
  • Stub for setting the callback on Sentry.init:

    Sentry.init(options -> {
      ...
      options.setOnDiscard(
       (reason, category, number) -> {
         // Your logic to process discarded data
       });
    });

8.19.1

Warning

Android: This release is incompatible with API levels below 26. We recommend using SDK version 8.20.0 or higher instead.

Fixes

• Do not store No-Op scopes onto OpenTelemetry Context when wrapping (#4631)
  • In 8.18.0 and 8.19.0 the SDK could break when initialized too late.

8.19.0

Warning

Android: This release is incompatible with API levels below 26. We recommend using SDK version 8.20.0 or higher instead.

Features

• Add a isEnableSystemEventBreadcrumbsExtras option to disable reporting system events extras for breadcrumbs (#4625)

Improvements

• Session Replay: Use main thread looper to schedule replay capture (#4542)
• Use single LifecycleObserver and multi-cast it to the integrations interested in lifecycle states (#4567)
• Add sentry.origin attribute to logs (#4618)
  • This helps identify which integration captured a log event
• Prewarm SentryExecutorService for better performance at runtime (#4606)

Fixes

• Cache network capabilities and status to reduce IPC calls (#4560)
• Deduplicate battery breadcrumbs (#4561)
• Remove unused method in ManifestMetadataReader (#4585)
• Have single NetworkCallback registered at a time to reduce IPC calls (#4562)
• Do not register for SystemEvents and NetworkCallbacks immediately when launched with non-foreground importance (#4579)
• Limit ProGuard keep rules for native methods within sentry-android-ndk to the io.sentry.** namespace. (#4427)
  • If you relied on the Sentry SDK to keep native method names for JNI compatibility within your namespace, please review your ProGuard rules and ensure the configuration still works. Especially when you're not consuming any of the default Android proguard rules (proguard-android.txt or proguard-android-optimize.txt) the following config should be present:

  -keepclasseswithmembernames class * {
    native <methods>;
  }
  

• Fix abstract method error in SentrySupportSQLiteDatabase (#4597)
• Ensure frame metrics listeners are registered/unregistered on the main thread (#4582)
• Do not report cached events as lost (#4575)
  • Previously events were recorded as lost early despite being retried later through the cache
• Move and flush unfinished previous session on init (#4624)
  • This removes the need for unnecessary blocking our background queue for 15 seconds in the case of a background app start
• Switch to compileOnly dependency for compose-ui-material (#4630)
  • This fixes StackOverflowError when using OSS Licenses plugin

Dependencies

• Bump Native SDK from v0.8.4 to v0.10.0 (#4623)
  • changelog
  • diff