8.26.0

Features

• Add feature flags API (#4812) and (#4831)
  • You may now keep track of your feature flag evaluations and have them show up in Sentry.
  • Top level API (Sentry.addFeatureFlag("my-feature-flag", true);) writes to scopes and the current span (if there is one)
  • It is also possible to use API on IScope, IScopes, ISpan and ITransaction directly
  • Feature flag evaluations tracked on scope(s) will be added to any errors reported to Sentry.
    • The SDK keeps the latest 100 evaluations from scope(s), replacing old entries as new evaluations are added.
  • For feature flag evaluations tracked on spans:
    • Only 10 evaluations are tracked per span, existing flags are updated but new ones exceeding the limit are ignored
    • Spans do not inherit evaluations from their parent
• Drop log events once buffer hits hard limit (#4889)
  • If we have 1000 log events queued up, we drop any new logs coming in to prevent OOM
• Remove vendored code and upgrade to async profiler 4.2 (#4856)
  • This adds support for JDK 23+

Fixes

• Removed SentryExecutorService limit for delayed scheduled tasks (#4846)
• Fix visual artifacts for the Canvas strategy on some devices (#4861)
• [Config] Trim whitespace on properties path (#4880)
• Only set DefaultReplayBreadcrumbConverter if replay is available (#4888)
• Session Replay: Cache connection status instead of using blocking calls (#4891)
• Fix log count in client reports (#4869)
• Fix profilerId propagation (#4833)
• Fix profiling init for Spring and Spring Boot w Agent auto-init (#4815)
• Copy active span on scope clone (#4878)

Improvements

• Fallback to distinct-id as user.id logging attribute when user is not set (#4847)
• Report Timber.tag() as timber.tag log attribute (#4845)
• Session Replay: Add screenshot strategy serialization to RRWeb events (#4851)
• Report discarded log bytes (#4871)
• Log why a properties file was not loaded (#4879)

Dependencies

• Bump Native SDK from v0.11.3 to v0.12.1 (#4859)
  • changelog
  • diff
• Bump Spring Boot 4 to RC2 (#4886)

8.25.0

Fixes

• [ANR] Removed AndroidTransactionProfiler lock (#4817)
• Avoid ExecutorService for DefaultCompositePerformanceCollector timeout (#4841)
  • This avoids infinite data collection for never stopped transactions, leading to OOMs
• Fix wrong .super() call in SentryTimberTree (#4844)

Improvements

• [ANR] Defer some class availability checks (#4825)
• Collect PerformanceCollectionData only for sampled transactions (#4834)
  • Breaking change: Transactions with a deferred sampling decision (sampled == null) won't be collecting any performance data anymore (CPU, RAM, slow/frozen frames).

Dependencies

• Bump Native SDK from v0.11.2 to v0.11.3 (#4810)
  • changelog
  • diff

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
       });
    });