NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #283 most downloaded on pub.dev
A crash reporting library for Dart that sends crash reports to Sentry.io. This library supports Dart VM and Web. For Flutter consider sentry_flutter instead.
Latest stable
10.6.0
Last release 2 days ago
20 Nov 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
9 years old
271 releases · first in 2017
Drag across the ruler to compare, or tap a release to open it.
Bump Cocoa SDK from v8.21.0 to v8.25.0
"{{auto}}" if sendDefaultPii is enabled (#4071)
Bump compileSdkVersion to 34 in Gradle buildscripts
Your coding agent can read these notes before it upgrades. Set up the MCP server →
To enable Replay use the sessionReplay.sessionSampleRate or sessionReplay.onErrorSampleRate options.
import io.sentry.SentryReplayOptions
import io.sentry.android.core.SentryAndroid
SentryAndroid.init(context) { options ->
options.sessionReplay.sessionSampleRate = 1.0
options.sessionReplay.onErrorSampleRate = 1.0
// To change default redaction behavior (defaults to true)
options.sessionReplay.redactAllImages = true
options.sessionReplay.redactAllText = true
// To change quality of the recording (defaults to MEDIUM)
options.sessionReplay.quality = SentryReplayOptions.SentryReplayQuality.MEDIUM // (LOW|MEDIUM|HIGH)
}
SdkVersion for replay events (#4014)experimental to the main options object (#4017)Experimental: Add support for Sentry Developer Metrics (#1940, #1949, #1954, #1958) Use the Metrics API to track processing time, download sizes, user
Sentry.metrics()
.increment(
'button_login_click', // key
value: 1.0,
unit: null,
tags: {"provider": "e-mail"}
);
To learn more about Sentry Developer Metrics, head over to our Dart and Flutter docs page.package_info_plus version range to 6.0.0 (#1948)sentry_flutter.podspec version from pubspec.yaml (#1941)IndexOutOfBoundsException when tracking window changesIllegalStateException when adding/removing draw listener for a dead viewConcurrentModificationException when registering window listeners and stopping WindowRecorder/GestureRecorderAdd TTFD (time to full display), which allows you to measure the time it takes to render the full screen
enableTimeToFullDisplayTracing = true in your SentryFlutterOptions to enable TTFDSentryFlutter.reportFullyDisplayed()deadline_exceededautomatic mode is enabled by default for all screens and will yield only an approximation result.manual mode requires manual instrumentation and will yield a more accurate result.
manual mode, you need to wrap your desired widget: SentryDisplayWidget(child: MyScreen()).didPop doesn't trigger a new transactionui.load instead of navigationcaptureFailedRequests option (#1931)
dio integration and SentryHttpClient now take an additional captureFailedRequests option.dio for example.root / instead of root ("/").beforeSendReplay callback (#3855)Fix transaction end timestamp trimming
recordHttpBreadcrumbs to set iOS enableNetworkBreadcrumbs (#1884)beforeBreadcrumb on native iOS crumbs (#1914)maxQueueSize to limit the number of unawaited events sent to Sentry (#1868)Random instance per thread to improve SDK performance (#3835)Remove Flutter dependency from Drift integration
Prefer to use SentryWidget now instead of SentryScreenshotWidget and SentryUserInteractionWidget directly
SentryWidget (#1846)
SentryWidget now instead of SentryScreenshotWidget and SentryUserInteractionWidget directlyMap<String, dynamic> in Hint class (#1807)
Hint
Hint.withMap(Map<String, dynamic> map) now takes Map<String, dynamic> instead of Map<String, Object>hint.addAll(Map<String, dynamic> keysAndValues) now takes Map<String, dynamic> instead of Map<String, Object>set(String key, dynamic value) now takes value of dynamic instead of Objecthint.get(String key) now returns dynamic instead of Object?enableTracing option (#3777)java.util.Random and replace java.security.SecureRandom usages (#3783)Log calls on app startup (#3793)addIntegrationToSdkVersion(Ljava/lang/Class;)V has been removed from the core (io.sentry:sentry) package. Please make sure all of the packages (e.g. io.sentry:sentry-android-core, io.sentry:sentry-android-fragment, io.sentry:sentry-okhttp and others) are all aligned and using the same version to prevent the NoSuchMethodError exception.Set options.spotlight = Spotlight(enabled: true) to enable Spotlight
options.spotlight = Spotlight(enabled: true) to enable SpotlightConnectivityIntegration for web (#1765)
wifi or none.appFlavor to the flutter_context (#1799)readTransaction in sqflite (#1819)feedback envelope header item type (#3687)android:tag="sentry-mask|sentry-unmask" in XML or view.setTag("sentry-mask|sentry-unmask") in code tags
<tag android:id="@id/sentry_privacy" android:value="mask|unmask"/> in XML or view.setTag(io.sentry.android.replay.R.id.sentry_privacy, "mask|unmask") in codeview.sentryReplayMask() or view.sentryReplayUnmask() extension functionsViews of a certain type by adding fully-qualified classname to one of the lists options.experimental.sessionReplay.addMaskViewClass() or options.experimental.sessionReplay.addUnmaskViewClass(). Note, that all of the view subclasses/subtypes will be masked/unmasked as well
TextViews and their subclasses (RadioButton, EditText, etc.): options.experimental.sessionReplay.addMaskViewClass("android.widget.TextView")Modifier.sentryReplayMask() and Modifier.sentryReplayUnmask() modifiersWebView, VideoView and androidx.media3.ui.PlayerView by default (#3775)TextViews with Spans (#3682)Calendar.getInstance usage in Breadcrumbs constructor (#3736)SentryOptions members to avoid ANRs on app start (#3749)Breaking changes:
options.experimental.sessionReplay.errorSampleRate was renamed to options.experimental.sessionReplay.onErrorSampleRate (#3637)io.sentry.session-replay.error-sample-rate was renamed to io.sentry.session-replay.on-error-sample-rate (#3637)redactAllText and redactAllImages to maskAllText and maskAllImages (#3741)Fixes obfuscated stacktraces when captureMessage or captureEvent is called with attachStacktrace option
buffer replay type for the entire replay when converting from buffer mode to session modebuffer modeRejectedExecutionException when redacting a screenshotFileNotFoundException when persisting segment valuesReplayShadowMediaCodec and refactor tests using custom encoder (#3612)Fix SIGSEV, SIGABRT and SIGBUS crashes happening after/around the August Google Play System update, see #2955 for more details (fix provided by Native
Fixes release of drift & hive and adds missing integration & sdk version information in the hub options
Fixes setting the correct locale to contexts with navigatorKey
PlatformException.message will get nicely formatted too when present (#1716)attachScreenshotOnlyWhenResumed to options (#1700)session mode at 1 hour deadlineLog warning if both tracesSampleRate and tracesSampler are set
Session Replay Public Beta (#3339)
To enable Replay use the sessionReplay.sessionSampleRate or sessionReplay.errorSampleRate experimental options.
import io.sentry.SentryReplayOptions
import io.sentry.android.core.SentryAndroid
SentryAndroid.init(context) { options ->
// Currently under experimental options:
options.experimental.sessionReplay.sessionSampleRate = 1.0
options.experimental.sessionReplay.errorSampleRate = 1.0
// To change default redaction behavior (defaults to true)
options.experimental.sessionReplay.redactAllImages = true
options.experimental.sessionReplay.redactAllText = true
// To change quality of the recording (defaults to MEDIUM)
options.experimental.sessionReplay.quality = SentryReplayOptions.SentryReplayQuality.MEDIUM // (LOW|MEDIUM|HIGH)
}
To learn more visit Sentry's Mobile Session Replay documentation page.
Session: missing mechanism.handled is considered crash
User.segment. Use a custom tag or context instead. (#3511)Add Sampling Decision to Trace Envelope Header
fatal even if debug is disabled (#1635)SentryUser and Breadcrumb before sending over method channel (#1591)Fix faulty span.frame_delay calculation for early app start spans
Trace origin indicates what created a trace or a span. Not all transactions and spans contain enough information to tell whether the user or what prec
Trace origin indicates what created a trace or a span. Not all transactions and spans contain enough information to tell whether the user or what precisely in the SDK created it. Origin solves this problem. The SDK now sends origin for transactions and spans.
appHangTimeoutInterval to SentryFlutterOptions (#1568)maxResponseBodySizedio packageAdd apiTarget field to SentryRequest and data field to SentryResponse
Enums use its name instead of non exhaustive switches (##1506)
Check if the Native SDKs are enabled when using autoInitializeNativeSdk=false
autoInitializeNativeSdk=false (#1489)Future instead of executing right away (#1476)
SentryAssetBundle returns Future by default
Deprecate extra in favor of contexts
sent_at to envelope header (#1428)minSdkVersion is now 19 (Flutter already defines 19-20 as best effort)extra in favor of contexts (#1435)Experimental: Add support for Sentry Developer Metrics (#3205, #3238, #3248, #3250) Use the Metrics API to track processing time, download sizes, user
Sentry.metrics()
.increment(
"button_login_click", // key
1.0, // value
null, // unit
mapOf( // tags
"provider" to "e-mail"
)
)
To learn more about Sentry Developer Metrics, head over to our Java and Android docs page.Fallback Uri parsing to unknown if its invalid
unknown if its invalid (#1414)Add SentryIOOverridesIntegration that automatically wraps File into SentryFile
SentryIOOverridesIntegration that automatically wraps File into SentryFile (#1362)import 'package:sentry_file/sentry_file.dart';
// SDK init. options
options.addIntegration(SentryIOOverridesIntegration());
enableTracing option (#1395)
null meaning existing behaviour remains unchanged (setting either tracesSampleRate or tracesSampler enables performance).true, performance is enabled, even if no tracesSampleRate or tracesSampler have been configured.true, sampler will use default sample rate of 1.0, if no tracesSampleRate is set.false performance is disabled, regardless of tracesSampleRate and tracesSampler options.// SDK init. options
options.enableTracing = true;
connectionTimeout and readTimeout to Android (#1397)// SDK init. options
options.connectionTimeout = Duration(seconds: 10);
options.readTimeout = Duration(seconds: 10);
name and geo in native plugins (#1393)Sentry.configureScope(
(scope) => scope.setUser(SentryUser(
id: '1234',
name: 'Jane Doe',
email: 'jane.doe@example.com',
geo: SentryGeo(
city: 'Vienna',
countryCode: 'AT',
region: 'Austria',
))),
);
import 'dart:convert';
options.beforeSend = (event, {hint}) {
final text = 'This event should not be sent happen in prod. Investigate.';
final textAttachment = SentryAttachment.fromIntList(
utf8.encode(text),
'event_info.txt',
contentType: 'text/plain',
);
hint?.attachments.add(textAttachment);
return event;
};
FutureOr<T> if it's not a future (#1385)enableScopePersistence option to disable PersistingScopeObserver used for ANR reporting which may increase performance overhead. Defaults to true (#3218)
Runnable/Callable/Supplier is executed instead of setting it to the hub that was used on the thread where the Runnable/Callable/Supplier was created.Fix breadcrumbs not being sent on Android web
Fix Dart web builds breaking due to dart:io imports when using SentryIsolate or SentryIsolateExtension
SentryUserInteractionWidget: add support for PopupMenuButton and PopupMenuItem
options.isEnableSpotlight = true to enable SpotlightRuntimeException is thrown by the system (#3212)
RuntimeInit$MethodAndArgsCaller to have them split up properly by the original root cause exceptionSanitize sensitive data from URLs (span desc, span data, crumbs, client errors)
io.sentry.profiling.enable-app-start, other than the already existing io.sentry.traces.profiling.sample-rate.isForNextAppStart flag, to adjust startup profiling sampling programmatically.
Relevant PRs:OnFrameMetricsAvailableListener (#3111)mechanism:AppExitInfoHostnameVerifier option as it's flagged by security tools of some app stores (#3150)
ITransportFactory through SentryOptions.setTransportFactory(), where you can copy over most of the parts like HttpConnection and AsyncHttpTransport from the SDK with necessary modificationsDioErrorExtractor no longer extracts DioError.stackTrace which is done via DioStackTraceExtractor instead
monitor/check_in in client reports and rate limiter (#3096)graphql-java version 21 (#3090)SentryJobListenerrelease and other fields for ANRs reported with mechanism:AppExitInfo (#3074)opentelemetry-sdk to 1.33.0 and opentelemetry-javaagent to 1.32.0 (#3112)Bump Cocoa SDK from v8.0.0 to v8.3.1
enable-backpressure-handling=true.tracesSampleRate automatically.tracesSampleRate to its original value.4.1.0 or neweroptions.isEnablePerformanceV2 = trueSentryOkHttpEventListener even without transactions (#3087)io.sentry.exception.SentryHttpClientException from obfuscation to display proper issue title on Sentry (#3093)Remove deprecated fields from the Scope class.
500-599 if captureFailedRequests is enabledthrowable to SentryExceptionHint data bag (#1136)Hint for screenshots (#1165)toImage with toImageSync for Flutter >= 3.7 (1268)FutureOr<T> if it's not a future. This should marginally improve the performance (#1310)StackTrace.empty with StackTrace.current (#1183)sentry_dio to dio v5 (#1282)Scope class.
user(SentryUser? user), using the setUser(SentryUser? user) instead.attachements, using the attachments instead.SentryFlutterOptions class.
anrTimeoutIntervalMillis, using the anrTimeoutInterval instead.autoSessionTrackingIntervalMillis, using the autoSessionTrackingInterval instead.device context
options.attachThreadssentryClientName instead of sdk.identifier (#1135)BindingUtils to BindingWrapper to enable the use of custom bindings (#1184)Version 7 of the Sentry Android/Java SDK brings a variety of features and fixes. The most notable changes are:
minSdk level to 19 (Android 4.4)Sentry.getSpan now returns the root transaction, which should improve the span hierarchy and make it leanersentry-okhttp artifact is unbundled from Android and can be used in pure JVM-only appsPlatform Exception Event Processor
500-599 if captureFailedRequests is enabledAdd In Foreground to App context
Nothing published for this version
Nothing published for this version
### Fixes - isWeb check for WASM
Error Cause Extractor (#1198, #1236)
Remove deprecated fields from the Scope class.
Scope class.
user(SentryUser? user), using the setUser(SentryUser? user) instead.attachements, using the attachments instead.SentryFlutterOptions class.
anrTimeoutIntervalMillis, using the anrTimeoutInterval instead.autoSessionTrackingIntervalMillis, using the autoSessionTrackingInterval instead.Rename APM tracking feature flags to tracing
Mark transaction as internal_error in case of unhandled errors
Removed various deprecated fields (#1036):
Hint data bag (#1136)Hint for screenshots (#1165)SentryOptions related parameters from classes which also take Hub as a parameter (#816)StackTrace.empty with StackTrace.current (#1183)device context
options.attachThreadssentryClientName instead of sdk.identifier (#1135)BindingUtils to BindingWrapper to enable the use of custom bindings (#1184)Add proguard_uui property to SentryFlutterOptions to set proguard information at runtime
lock attribute to the SentryStackFrame protocol to better highlight offending frames in the UI (#2761)api_target to Request and data to Response Protocols (#2775)String.join in Baggage as it requires API level 26 (#2778)Implement loadStructuredBinaryData from updated AssetBundle
sentry-android-sqlite integration (#2722)
androidx.sqlite database instrumentation in the Sentry Android Gradle pluginandroidx.sqlite databases.
SupportSQLiteOpenHelper instance into SentrySupportSQLiteOpenHelper(myHelper) if you're not using the Sentry Android Gradle plugin and still benefit from performance auto-instrumentation.SentryExecutorService in 6.19.0 which caused the application to hang on shutdown unless Sentry.close() was called. By using daemon threads we no longer block shutdown.ComposeViewHierarchyExporter class (#2743)Try to avoid ConcurrentModificationError by not using a Future.forEach
Add support for Sentry Kotlin Compiler Plugin
client.eventListener(new SentryOkHttpEventListener()).addInterceptor(new SentryOkHttpInterceptor()).build();client.eventListener(new SentryOkHttpEventListener(myListener)).addInterceptor(new SentryOkHttpInterceptor()).build();RootChecker (#2735)intl is now more version permissive (>=0.17.0 <1.0.0)
mechanism:AppExitInfo.mechanism:ANR.TransactionOptions, ITransaction and IHub methods allowing consumers modify start/end timestamp of transactions and spans (#2701)configureScope instead of withScope in Hub.close(). This ensures that the main scope releases the in-memory data when closing a hub instance. (#2688)enableUserInteractionTracing sometimes finds the wrong widget
Missing slow and frozen frames for Auto transactions
Tracing for File IO integration
Log4j2Plugins.datUser and Breadcrumb from map (#2614)sent_at to envelope header item (#2638)Capture Future errors for Flutter Web automatically
name and geo to User (#2556)Add request context to HttpException, SocketException and NetworkImageLoadException
HttpException, SocketException and NetworkImageLoadException (#1118)SocketException and FileSystemException with OSErrors report the OSError as root exception (#1118)enableUserInteractionBreadcrumbs on Android when enableAutoNativeBreadcrumbs is disabled (#1131)sentry.enable-tracing=true to your application.propertiesSentryAppender to specific loggers instead of the ROOT logger (#2173)
"sentry.logging.loggers[0]=foo.bar and "sentry.logging.loggers[1]=baz in your application.propertiesHandlerExceptionResolver, SentryWebExceptionHandler) in your dashboards please update them to use the new types.server.servlet.session.cookie.name and filter it outbeforeSend / beforeSendTransaction throws (#2591)Bump Cocoa SDK from v7.30.1 to v7.30.2
Merging of integrations and packages
enableTracing option (#2530)
null meaning existing behaviour remains unchanged (setting either tracesSampleRate or tracesSampler enables performance).true, performance is enabled, even if no tracesSampleRate or tracesSampler have been configured.false performance is disabled, regardless of tracesSampleRate and tracesSampler options.ThreadLocalAccessor for propagating Sentry hub with reactor / WebFlux (#2570)
io.micrometer:context-propagation:1.0.2+ as well as Spring Boot 3.0.3+sentry.reactive.thread-local-accessor-enabled=trueinApp flag for stack frames undecided in SDK if unsure and let ingestion decide instead (#2547)0.0 error sample rate (#2573)compileOnly in sentry-compose-android (#2578)
androidx.navigation:navigation-compose:androidx.compose.runtime:runtime:androidx.compose.ui:ui:Capture response information in SentryHttpClient
main flag to threads and in_foreground flag for app contexts (#2516)Avoid dependency conflict with package_info_plus v3
One column per quarter.