Release notes from sentry-java

8.35.0

2026-03-12T11:44:37Z

Fixes

Android: Remove the dependency on protobuf-lite for tombstones (#5157)

Features

Add new experimental option to capture profiles for ANRs (#4899)
- This feature will capture a stack profile of the main thread when it gets unresponsive
- The profile gets attached to the ANR event on the next app start, providing a flamegraph of the ANR issue on the sentry issue details page
- Enable via options.setAnrProfilingSampleRate(<sample-rate>) or AndroidManifest.xml: <meta-data android:name="io.sentry.anr.profiling.sample-rate" android:value="[0.0-1.0]" />
- The sample rate controls the probability of collecting a profile for each detected foreground ANR (0.0 to 1.0, null to disable)

Behavioral Changes

Add enableAnrFingerprinting option which assigns static fingerprints to ANR events with system-only stacktraces
- When enabled, ANRs whose stacktraces contain only system frames (e.g. java.lang or android.os) are grouped into a single issue instead of creating many separate issues
- This will help to reduce overall ANR issue noise in the Sentry dashboard
- IMPORTANT: This option is enabled by default.
- Disable via options.setEnableAnrFingerprinting(false) or AndroidManifest.xml: <meta-data android:name="io.sentry.anr.enable-fingerprinting" android:value="false" />

8.34.1

2026-03-05T15:54:49Z

Fixes

Common: Finalize previous session even when auto session tracking is disabled (#5154)
Android: Add filterTouchesWhenObscured to prevent Tapjacking on user feedback dialog (#5155)
Android: Add proguard rules to prevent error about missing Replay classes (#5153)

8.34.0

2026-03-04T11:56:52Z

Features

Add scope-level attributes API (#5118) via (#5148)
- Automatically include scope attributes in logs and metrics (#5120)
- New APIs are Sentry.setAttribute, Sentry.setAttributes, Sentry.removeAttribute
Support collections and arrays in attribute type inference (#5124)
Add support for SENTRY_SAMPLE_RATE environment variable / sample-rate property (#5112)
Create sentry-opentelemetry-otlp and sentry-opentelemetry-otlp-spring modules for combining OpenTelemetry SDK OTLP export with Sentry SDK (#5100)
- OpenTelemetry is configured to send spans to Sentry directly using an OTLP endpoint.
- Sentry only uses trace and span ID from OpenTelemetry (via OpenTelemetryOtlpEventProcessor) but will not send spans through OpenTelemetry nor use OpenTelemetry Context for Scopes propagation.
- See the OTLP setup docs for Java and Spring Boot for installation and configuration instructions.

Add screenshot masking support using view hierarchy (#5077)

Masks sensitive content (text, images) in error screenshots using the same view hierarchy approach as Session Replay
Requires the sentry-android-replay module to be present at runtime for masking to work

Enable via code:

SentryAndroid.init(context) { options ->
    options.isAttachScreenshot = true
    options.screenshot.setMaskAllText(true)
    options.screenshot.setMaskAllImages(true)
    // Or mask specific view classes
    options.screenshot.addMaskViewClass("com.example.MyCustomView")
}

Or via AndroidManifest.xml:

<meta-data android:name="io.sentry.attach-screenshot" android:value="true" />
<meta-data android:name="io.sentry.screenshot.mask-all-text" android:value="true" />
<meta-data android:name="io.sentry.screenshot.mask-all-images" android:value="true" />

The ManifestMetaDataReader now read the DIST (#5107)

Fixes

Fix attribute type detection for Long, Short, Byte, BigInteger, AtomicInteger, and AtomicLong being incorrectly inferred as double instead of integer (#5122)
Remove AndroidRuntimeManager StrictMode relaxation to prevent ANRs during SDK init (#5127)
- IMPORTANT: StrictMode violations may appear again in debug builds. This is intentional to prevent ANRs in production releases.
Fix crash when unregistering SystemEventsBroadcastReceiver with try-catch block. (#5106)
Use peekDecorView instead of getDecorView in SentryGestureListener to avoid forcing view hierarchy construction (#5134)
Log an actionable error message when Relay returns HTTP 413 (Content Too Large) (#5115)
- Also switch the client report discard reason for all HTTP 4xx/5xx errors (except 429) from network_error to send_error
Trim DSN string before parsing to avoid URISyntaxException caused by trailing whitespace (#5113)
Reduce allocations and bytecode instructions during Sentry.init (#5135)

Dependencies

Bump Native SDK from v0.12.7 to v0.13.1 (#5104)
- changelog
- diff

8.33.0

2026-02-18T13:28:40Z

Features

Add installGroupsOverride parameter to Build Distribution SDK for programmatic filtering, with support for configuration via properties file using io.sentry.distribution.install-groups-override (#5066)

Fixes

When merging tombstones with Native SDK, use the tombstone message if the Native SDK didn't explicitly provide one. (#5095)
Fix thread leak caused by eager creation of SentryExecutorService in SentryOptions (#5093)
- There were cases where we created options that ended up unused but we failed to clean those up.
Attach user attributes to logs and metrics regardless of sendDefaultPii (#5099)
No longer log a warning if a logging integration cannot initialize Sentry due to missing DSN (#5075)
- While this may have been useful to some, it caused lots of confusion.
Session Replay: Add androidx.camera.view.PreviewView to default maskedViewClasses to mask camera previews by default. (#5097)

Dependencies

Bump Native SDK from v0.12.4 to v0.12.7 (#5071, #5098)
- changelog
- diff

Internal

Add integration to track session replay custom masking (#5070)

8.32.0

2026-02-09T10:10:38Z

Features

Add installGroupsOverride parameter and installGroups property to Build Distribution SDK (#5062)
Update Android targetSdk to API 36 (Android 16) (#5016)
Add AndroidManifest support for Spotlight configuration via io.sentry.spotlight.enable and io.sentry.spotlight.url (#5064)
Collect database transaction spans (BEGIN, COMMIT, ROLLBACK) (#5072)
- To enable creation of these spans, set options.enableDatabaseTransactionTracing to true
- enable-database-transaction-tracing=true when using sentry.properties
- For Spring Boot, use sentry.enable-database-transaction-tracing=true in application.properties or in application.yml:
```
sentry:
  enable-database-transaction-tracing: true
```
Add support for collecting native crashes using Tombstones (#4933, #5037)
- Added Tombstone integration that detects native crashes using ApplicationExitInfo.REASON_CRASH_NATIVE on Android 12+
- Crashes enriched with Tombstones contain more crash details and detailed thread info
- Tombstone and NDK integrations are now automatically merged into a single crash event, eliminating duplicate reports
- To enable it, add the integration in your Sentry initialization:
```
SentryAndroid.init(context, options -> {
    options.isTombstoneEnabled = true
})
```
  or in the AndroidManifest.xml using:
```
<meta-data android:name="io.sentry.tombstone.enable" android:value="true" />
```

Fixes

Extract SpotlightIntegration to separate sentry-spotlight module to prevent insecure HTTP URLs from appearing in release APKs (#5064)
- Breaking: Users who enable Spotlight must now add the io.sentry:sentry-spotlight dependency:
```
dependencies {
    debugImplementation("io.sentry:sentry-spotlight:<version>")
}
```
Fix scroll target detection for Jetpack Compose (#5017)
No longer fork Sentry Scopes for reactor-kafka consumer poll Runnable (#5080)
- This was causing a memory leak because reactor-kafka's poll event reschedules itself infinitely, and each invocation of SentryScheduleHook created forked scopes with a parent reference, building an unbounded chain that couldn't be garbage collected.
Fix cold/warm app start type detection for Android devices running API level 34+ (#4999)

Internal

Establish new native exception mechanisms to differentiate events generated by sentry-native from ApplicationExitInfo. (#5052)
Set write permission for statuses in the changelog preview GHA workflow. (#5053)

Dependencies

Bump Native SDK from v0.12.3 to v0.12.4 (#5061)
- changelog
- diff

8.31.0 (Stable)

2026-02-25T13:00:16Z

Features

Added io.sentry.ndk.sdk-name Android manifest option to configure the native SDK's name (#5027)
Replace sentry.trace.parent_span_id attribute with spanId property on SentryLogEvent (#5040)

Fixes

Only attach user attributes to logs if sendDefaultPii is enabled (#5036)
Reject new logs if LoggerBatchProcessor is shutting down (#5041)
Downgrade protobuf-javalite dependency from 4.33.1 to 3.25.8 (#5044)

Dependencies

Bump Native SDK from v0.12.2 to v0.12.3 (#5012)
- changelog
- diff

8.30.0

2026-01-15T10:01:08Z

Fixes

Fix ANRs when collecting device context (#4970)
- IMPORTANT: This disables collecting external storage size (total/free) by default, to enable it back
  use options.isCollectExternalStorageContext = true or <meta-data android:name="io.sentry.external-storage-context" android:value="true" />
Fix NullPointerException when reading ANR marker (#4979)
Report discarded log in batch processor as log_byte (#4971)

Improvements

Expose MAX_EVENT_SIZE_BYTES constant in SentryOptions (#4962)
Discard envelopes on 4xx and 5xx response (#4950)
- This aims to not overwhelm Sentry after an outage or load shedding (including HTTP 429) where too many events are sent at once

Feature

Add a Tombstone integration that detects native crashes without relying on the NDK integration, but instead using ApplicationExitInfo.REASON_CRASH_NATIVE on Android 12+. (#4933)
- Currently exposed via options as an internal API only.
- If enabled alongside the NDK integration, crashes will be reported as two separate events. Users should enable only one; deduplication between both integrations will be added in a future release.
Add Sentry Metrics to Java SDK (#5026)
- Metrics are enabled by default
- APIs are namespaced under Sentry.metrics()
- We offer the following APIs:
  - count: A metric that increments counts
  - gauge: A metric that tracks a value that can go up or down
  - distribution: A metric that tracks the statistical distribution of values
- For more details, see the Metrics documentation: https://docs.sentry.io/product/explore/metrics/getting-started/

8.29.0 (Stable)

2026-01-23T14:47:06Z

Fixes

Support serialization of primitive arrays (boolean[], byte[], short[], char[], int[], long[], float[], double[]) (#4968)
Session Replay: Improve network body parsing and truncation handling (#4958)

Internal

Support metric envelope item type (#4956)

8.28.0

2025-12-04T14:05:09Z

Features

Android: Flush logs when app enters background (#4951)
Add option to capture additional OkHttp network request/response details in session replays (#4919)
- Depends on SentryOkHttpInterceptor to intercept the request and extract request/response bodies
- To enable, add url regexes via the io.sentry.session-replay.network-detail-allow-urls metadata tag in AndroidManifest (code sample)
  - Or you can manually specify SentryReplayOptions via SentryAndroid#init:
    (Make sure you disable the auto init via manifest meta-data: io.sentry.auto-init=false)

Kotlin

[email protected]/0" // options.sessionReplay.sessionSampleRate = 1.0 // options.sessionReplay.onErrorSampleRate = 1.0 // .. options.sessionReplay.networkDetailAllowUrls = listOf(".*") options.sessionReplay.networkDetailDenyUrls = listOf(".*deny.*") options.sessionReplay.networkRequestHeaders = listOf("Authorization", "X-Custom-Header", "X-Test-Request") options.sessionReplay.networkResponseHeaders = listOf("X-Response-Time", "X-Cache-Status", "X-Test-Response") });">

SentryAndroid.init(
    this,
    options -> {
      // options.dsn = "https://[email protected]/0"
      // options.sessionReplay.sessionSampleRate = 1.0
      // options.sessionReplay.onErrorSampleRate = 1.0
      // ..

      options.sessionReplay.networkDetailAllowUrls = listOf(".*")
      options.sessionReplay.networkDetailDenyUrls = listOf(".*deny.*")
      options.sessionReplay.networkRequestHeaders = listOf("Authorization", "X-Custom-Header", "X-Test-Request")
      options.sessionReplay.networkResponseHeaders = listOf("X-Response-Time", "X-Cache-Status", "X-Test-Response")
    });

Java

SentryAndroid.init(
    this,
    options -> {
        options.getSessionReplay().setNetworkDetailAllowUrls(Arrays.asList(".*"));
        options.getSessionReplay().setNetworkDetailDenyUrls(Arrays.asList(".*deny.*"));
        options.getSessionReplay().setNetworkRequestHeaders(
            Arrays.asList("Authorization", "X-Custom-Header", "X-Test-Request"));
        options.getSessionReplay().setNetworkResponseHeaders(
            Arrays.asList("X-Response-Time", "X-Cache-Status", "X-Test-Response"));
    });

Improvements

Avoid forking rootScopes for Reactor if current thread has NoOpScopes (#4793)
- This reduces the SDKs overhead by avoiding unnecessary scope forks

Fixes

Fix missing thread stacks for ANRv1 events (#4918)
Fix handling of unparseable mime-type on request filter (#4939)

Internal

Support span envelope item type (#4935)

Dependencies

Bump Native SDK from v0.12.1 to v0.12.2 (#4944)
- changelog
- diff

8.27.1

2025-11-24T13:32:48Z

Fixes

Do not log if sentry.properties in rundir has not been found (#4929)