sentry 8.11.1 copy "sentry: ^8.11.1" to clipboard
sentry: ^8.11.1 copied to clipboard

Published 5 days ago • verified publishersentry.ioDart 3 compatible• Latest: 8.11.2 / Prerelease: 8.12.0-beta.2
SDKDartFlutter
PlatformAndroidiOSLinuxmacOSwebWindows
→

Metadata

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.

More...

Changelog #

8.11.1 #

Improvements #

  • Check for type before casting in TTID (#2497)

Fixes #

  • SentryWidgetsFlutterBinding initializing even if a binding already exists (#2494)

8.11.0 #

Features #

  • Support for screenshot PII content masking (#2361) By default, masking is enabled for SessionReplay. To also enable it for screenshots captured with events, you can specify options.experimental.privacy:

    await SentryFlutter.init(
  (options) {
    ...
    // the defaults are:
    options.experimental.privacy.maskAllText = true;
    options.experimental.privacy.maskAllImages = true;
    options.experimental.privacy.maskAssetImages = false;
    // you cal also set up custom masking, for example:
    options.experimental.privacy.mask<WebView>();
  },
  appRunner: () => runApp(MyApp()),
);

    Actually, just accessing this field will cause it to be initialized with the default settings to mask all text and images:

    await SentryFlutter.init(
  (options) {
    ...
    // this has a side-effect of creating the default privacy configuration, thus enabling Screenshot masking:
    options.experimental.privacy;
  },
  appRunner: () => runApp(MyApp()),
);

  • Linux native error & obfuscation support (#2431)

  • Improve Device context on plain Dart and Flutter desktop apps (#2441)

  • Add debounce to capturing screenshots (#2368)

    • Per default, screenshots are debounced for 2 seconds.

    • If you need more granular screenshots, you can opt out of debouncing:

      await SentryFlutter.init((options) {
  options.beforeCaptureScreenshot = (event, hint, debounce) {
    if (debounce) {
      return true; // Capture screenshot even if the SDK wants to debounce it.
    } else {
      // check event and hint
      ...
    }
  };
});

    • Replace deprecated BeforeScreenshotCallback with new BeforeCaptureCallback.

  • Windows native error & obfuscation support (#2286, #2426)

  • Improve app start measurements by using addTimingsCallback instead of addPostFrameCallback to determine app start end (#2405)

    • ⚠️ This change may result in reporting of shorter app start durations

  • Improve frame tracking accuracy (#2372)

    • Introduces SentryWidgetsFlutterBinding that tracks a frame starting from handleBeginFrame and ending in handleDrawFrame, this is approximately the buildDuration time

    • By default, SentryFlutter.init() automatically initializes SentryWidgetsFlutterBinding through the WidgetsFlutterBindingIntegration

    • If you need to initialize the binding before SentryFlutter.init, use SentryWidgetsFlutterBinding.ensureInitialized instead of WidgetsFlutterBinding.ensureInitialized:

      void main() async {
  // Replace WidgetsFlutterBinding.ensureInitialized()
  SentryWidgetsFlutterBinding.ensureInitialized();

  await SentryFlutter.init(...);
  runApp(MyApp());
}

    • ⚠️ Frame tracking will be disabled if a different binding is used

Enhancements #

  • Only send debug images referenced in the stacktrace for events (#2329)
  • Remove sentry frames if SDK falls back to current stack trace (#2351)
    • Flutter doesn't always provide stack traces for unhandled errors - this is normal Flutter behavior
    • When no stack trace is provided (in Flutter errors, captureException, or captureMessage):
      • SDK creates a synthetic trace using StackTrace.current
      • Internal SDK frames are removed to reduce noise
    • Original stack traces (when provided) are left unchanged

Fixes #

  • Catch errors thrown during handleBeginFrame and handleDrawFrame (#2446)
  • OS & device contexts missing on Windows (#2439)
  • Native iOS/macOS SDK session didn't start after Flutter hot-restart (#2452)
  • Kotlin 2.1.0 compatibility on Android, bump Kotlin language version from 1.4 to 1.6 (#2456)
  • Apply default IP address ({{auto}}) to transactions (#2395)
    • Previously, transactions weren't getting the default IP address when user context was loaded
    • Now consistently applies default IP address to both events and transactions when:
      • No user context exists
      • User context exists but IP address is null

Dependencies #

8.11.0-beta.2 #

Features #

  • Support for screenshot PII content masking (#2361) By default, masking is enabled for SessionReplay. To also enable it for screenshots captured with events, you can specify options.experimental.privacy: 
    await SentryFlutter.init(
  (options) {
    ...
    // the defaults are:
    options.experimental.privacy.maskAllText = true;
    options.experimental.privacy.maskAllImages = true;
    options.experimental.privacy.maskAssetImages = false;
    // you cal also set up custom masking, for example:
    options.experimental.privacy.mask<WebView>();
  },
  appRunner: () => runApp(MyApp()),
);
    Actually, just accessing this field will cause it to be initialized with the default settings to mask all text and images: 
    await SentryFlutter.init(
  (options) {
    ...
    // this has a side-effect of creating the default privacy configuration, thus enabling Screenshot masking:
    options.experimental.privacy;
  },
  appRunner: () => runApp(MyApp()),
);
  • Linux native error & obfuscation support (#2431)
  • Improve Device context on plain Dart and Flutter desktop apps (#2441)
  • Add debounce to capturing screenshots (#2368)
    • Per default, screenshots are debounced for 2 seconds.
    • If you need more granular screenshots, you can opt out of debouncing:
    await SentryFlutter.init((options) {
  options.beforeCaptureScreenshot = (event, hint, debounce) {
    if (debounce) {
      return true; // Capture screenshot even if the SDK wants to debounce it.
    } else {
      // check event and hint
      ...
    }
  };
});
    • Replace deprecated BeforeScreenshotCallback with new BeforeCaptureCallback.

Fixes #

  • Catch errors thrown during handleBeginFrame and handleDrawFrame (#2446)
  • OS & device contexts missing on Windows (#2439)
  • Native iOS/macOS SDK session didn't start after Flutter hot-restart (#2452)
  • Kotlin 2.1.0 compatibility on Android, bump Kotlin language version from 1.4 to 1.6 (#2456)

Dependencies #

8.11.0-beta.1 #

Features #

  • Windows native error & obfuscation support (#2286, #2426)
  • Improve app start measurements by using addTimingsCallback instead of addPostFrameCallback to determine app start end (#2405)
    • ⚠️ This change may result in reporting of shorter app start durations
  • Improve frame tracking accuracy (#2372)
    • Introduces SentryWidgetsFlutterBinding that tracks a frame starting from handleBeginFrame and ending in handleDrawFrame, this is approximately the buildDuration time
    • By default, SentryFlutter.init() automatically initializes SentryWidgetsFlutterBinding through the WidgetsFlutterBindingIntegration
    • If you need to initialize the binding before SentryFlutter.init, use SentryWidgetsFlutterBinding.ensureInitialized instead of WidgetsFlutterBinding.ensureInitialized:
    void main() async {
  // Replace WidgetsFlutterBinding.ensureInitialized()
  SentryWidgetsFlutterBinding.ensureInitialized();

  await SentryFlutter.init(...);
  runApp(MyApp());
}
    • ⚠️ Frame tracking will be disabled if a different binding is used

Enhancements #

  • Only send debug images referenced in the stacktrace for events (#2329)
  • Remove sentry frames if SDK falls back to current stack trace (#2351)
    • Flutter doesn't always provide stack traces for unhandled errors - this is normal Flutter behavior
    • When no stack trace is provided (in Flutter errors, captureException, or captureMessage):
      • SDK creates a synthetic trace using StackTrace.current
      • Internal SDK frames are removed to reduce noise
    • Original stack traces (when provided) are left unchanged

Fixes #

  • Apply default IP address ({{auto}}) to transactions (#2395)
    • Previously, transactions weren't getting the default IP address when user context was loaded
    • Now consistently applies default IP address to both events and transactions when:
      • No user context exists
      • User context exists but IP address is null

Dependencies #

8.10.1 #

Fixes #

  • Android build error when compiling (#2397)

8.10.0 #

Features #

  • Emit transaction.data inside contexts.trace.data (#2284)

  • Blocking app starts span if "appLaunchedInForeground" is false. (Android only) (#2291)

  • Replay: user-configurable masking (redaction) for widget classes and specific widget instances. (#2324) Some examples of the configuration:

    await SentryFlutter.init(
  (options) {
    ...
    options.experimental.replay.mask<IconButton>();
    options.experimental.replay.unmask<Image>();
    options.experimental.replay.maskCallback<Text>(
        (Element element, Text widget) =>
            (widget.data?.contains('secret') ?? false)
                ? SentryMaskingDecision.mask
                : SentryMaskingDecision.continueProcessing);
  },
  appRunner: () => runApp(MyApp()),
);

    Also, you can wrap any of your widgets with SentryMask() or SentryUnmask() widgets to mask/unmask them, respectively. For example:

     SentryUnmask(Text('Not secret at all'));

  • Support captureFeedback (#2230)

    • Deprecated Sentry.captureUserFeedback, use captureFeedback instead.
    • Deprecated Hub.captureUserFeedback, use captureFeedback instead.
    • Deprecated SentryClient.captureUserFeedback, use captureFeedback instead.
    • Deprecated SentryUserFeedback, use SentryFeedback instead.

  • Add SentryFeedbackWidget (#2240)

    Navigator.push(
  context,
  MaterialPageRoute(
    builder: (context) => SentryFeedbackWidget(associatedEventId: id),
    fullscreenDialog: true,
  ),
);

  • Add screenshot to SentryFeedbackWidget (#2369)

    • Use SentryFlutter.captureScreenshot to create a screenshot attachment
    • Call SentryFeedbackWidget with this attachment to add it to the user feedback
    final id = await Sentry.captureMessage('UserFeedback');
final screenshot = await SentryFlutter.captureScreenshot();

Navigator.push(
  context,
  MaterialPageRoute(
    builder: (context) => SentryFeedbackWidget(
        associatedEventId: id,
        screenshot: screenshot,
    ),
    fullscreenDialog: true,
  ),
);

Enhancements #

  • Avoid sending too many empty client reports when Http Transport is used (#2380)
  • Cache parsed DSN (#2365)
  • Handle backpressure earlier in pipeline (#2371)
    • Drops max un-awaited parallel tasks earlier, so event processors & callbacks are not executed for them.
    • Change by setting SentryOptions.maxQueueSize. Default is 30.
  • Use native spotlight integrations on Flutter Android, iOS, macOS (#2285)
  • Improve app start integration (#2266)
    • Fixes pendingTimer during tests (#2103)
    • Fixes transaction slows app start (#2233)
  • Only store slow and frozen frames for frame delay calculation (#2337)
  • Add ReplayIntegration to the integrations list on events when replay is enabled. (#2349)

Fixes #

  • App lag with frame tracking enabled when span finishes after a long time (#2311)
  • Only start frame tracking if we receive valid display refresh data (#2307)
  • Rounding error used on frames.total and reject frame measurements if frames.total is less than frames.slow or frames.frozen (#2308)
  • iOS replay integration when only onErrorSampleRate is specified (#2306)
  • Fix TTID timing issue (#2326)
  • TTFD fixes
    • Start missing TTFD for root screen transaction (#2332)
    • Match TTFD to TTID end timespan if TTFD is unfinished when user navigates to another screen (#2347)
    • TTFD measurements should only be added for successful TTFD spans (#2348)
    • Error when calling SentryFlutter.reportFullyDisplayed() twice (#2339)
  • Accessing invalid json fields from fetchNativeAppStart should return null (#2340)

Deprecate #

Dependencies #

8.10.0-beta.2 #

Fixes #

  • Temporarily disable Windows native error & obfuscation support (#2363)

8.10.0-beta.1 #

Features #

  • Emit transaction.data inside contexts.trace.data (#2284)

  • Blocking app starts if "appLaunchedInForeground" is false. (Android only) (#2291)

  • Windows native error & obfuscation support (#2286)

  • Replay: user-configurable masking (redaction) for widget classes and specific widget instances. (#2324) Some examples of the configuration:

    await SentryFlutter.init(
  (options) {
    ...
    options.experimental.replay.mask<IconButton>();
    options.experimental.replay.unmask<Image>();
    options.experimental.replay.maskCallback<Text>(
        (Element element, Text widget) =>
            (widget.data?.contains('secret') ?? false)
                ? SentryMaskingDecision.mask
                : SentryMaskingDecision.continueProcessing);
  },
  appRunner: () => runApp(MyApp()),
);

    Also, you can wrap any of your widgets with SentryMask() or SentryUnmask() widgets to mask/unmask them, respectively. For example:

     SentryUnmask(Text('Not secret at all'));

  • Support captureFeedback (#2230)

    • Deprecated Sentry.captureUserFeedback, use captureFeedback instead.
    • Deprecated Hub.captureUserFeedback, use captureFeedback instead.
    • Deprecated SentryClient.captureUserFeedback, use captureFeedback instead.
    • Deprecated SentryUserFeedback, use SentryFeedback instead.

  • Add SentryFeedbackWidget (#2240)

    Navigator.push(
  context,
  MaterialPageRoute(
    builder: (context) => SentryFeedbackWidget(associatedEventId: id),
    fullscreenDialog: true,
  ),
);

Enhancements #

  • Use native spotlight integrations on Flutter Android, iOS, macOS (#2285)
  • Improve app start integration (#2266)
  • Only store slow and frozen frames for frame delay calculation (#2337)
  • Add ReplayIntegration to the integrations list on events when replay is enabled. (#2349)

Fixes #

  • App lag with frame tracking enabled when span finishes after a long time (#2311)
  • Only start frame tracking if we receive valid display refresh data (#2307)
  • Rounding error used on frames.total and reject frame measurements if frames.total is less than frames.slow or frames.frozen (#2308)
  • iOS replay integration when only onErrorSampleRate is specified (#2306)
  • Fix TTID timing issue (#2326)
  • Start missing TTFD for root screen transaction (#2332)
  • Match TTFD to TTID end timespan if TTFD is unfinished when user navigates to another screen (#2347)
  • Accessing invalid json fields from fetchNativeAppStart should return null (#2340)
  • Error when calling SentryFlutter.reportFullyDisplayed() twice (#2339)
  • TTFD measurements should only be added for successful TTFD spans (#2348)

Deprecate #

Dependencies #

8.9.0 #

Features #

  • Session replay Alpha for Android and iOS (#2208, #2269, #2236, #2275, #2270). To try out replay, you can set following options (access is limited to early access orgs on Sentry. If you're interested, sign up for the waitlist):

    await SentryFlutter.init(
  (options) {
    ...
    options.experimental.replay.sessionSampleRate = 1.0;
    options.experimental.replay.onErrorSampleRate = 1.0;
  },
  appRunner: () => runApp(MyApp()),
);

  • Support allowUrls and denyUrls for Flutter Web (#2227)

    await SentryFlutter.init(
  (options) {
    ...
    options.allowUrls = ["^https://sentry.com.*\$", "my-custom-domain"];
    options.denyUrls = ["^.*ends-with-this\$", "denied-url"];
  },
  appRunner: () => runApp(MyApp()),
);

  • Collect touch breadcrumbs for all buttons, not just those with key specified. (#2242)

  • Add enableDartSymbolication option to Sentry.init() for Flutter iOS, macOS and Android (#2256)

    • This flag enables symbolication of Dart stack traces when native debug images are not available.
    • Useful when using Sentry.init() instead of SentryFlutter.init() in Flutter projects for example due to size limitations.
    • true by default but automatically set to false when using SentryFlutter.init() because the SentryFlutter fetches debug images from the native SDK integrations.

Dependencies #

Fixes #

  • Only access renderObject if hasSize is true (#2263)

8.8.0 #

Features #

  • Add SentryFlutter.nativeCrash() using MethodChannels for Android and iOS (#2239)
    • This can be used to test if native crash reporting works
  • Add ignoreRoutes parameter to SentryNavigatorObserver. (#2218)
    • This will ignore the Routes and prevent the Route from being pushed to the Sentry server.
    • Ignored routes will also create no TTID and TTFD spans.
SentryNavigatorObserver(ignoreRoutes: ["/ignoreThisRoute"]),

Improvements #

  • Debouncing of SentryWidgetsBindingObserver.didChangeMetrics with delay of 100ms. (#2232)

Dependencies #

8.8.0-alpha.1 #

Features #

  • iOS Session Replay Alpha (#2209)
  • Android replay touch tracking support (#2228)
  • Add ignoreRoutes parameter to SentryNavigatorObserver. (#2218)
    • This will ignore the Routes and prevent the Route from being pushed to the Sentry server.
    • Ignored routes will also create no TTID and TTFD spans.
SentryNavigatorObserver(ignoreRoutes: ["/ignoreThisRoute"]),

Dependencies #

8.7.0 #

Features #

  • Add support for span level measurements. (#2214)

  • Add ignoreTransactions and ignoreErrors to options (#2207)

    await SentryFlutter.init(
  (options) {
    options.dsn = 'https://examplePublicKey@o0.ingest.sentry.io/0';
    options.ignoreErrors = ["my-error", "^error-.*\$"];
    options.ignoreTransactions = ["my-transaction", "^transaction-.*\$"];
    ...
  },
  appRunner: () => runApp(MyApp()),
);

  • Add proxy support (#2192)

    • Configure a SentryProxy object and set it on SentryFlutter.init
    import 'package:flutter/widgets.dart';
import 'package:sentry_flutter/sentry_flutter.dart';

Future<void> main() async {
  await SentryFlutter.init(
    (options) {
      options.dsn = 'https://example@sentry.io/add-your-dsn-here';
      options.proxy = SentryProxy(
        type: SentryProxyType.http,
        host: 'localhost',
        port: 8080,
      );
    },
    // Init your App.
    appRunner: () => runApp(MyApp()),
  );
}

Improvements #

  • Deserialize and serialize unknown fields (#2153)

Dependencies #

8.6.0 #

Improvements #

  • Add error type identifier to improve obfuscated Flutter issue titles (#2170)
    • Example: transforms issue titles from GA to FlutterError or minified:nE to FlutterError
    • This is enabled automatically and will change grouping if you already have issues with obfuscated titles
    • If you want to disable this feature, set enableExceptionTypeIdentification to false in your Sentry options
    • You can add your custom exception identifier if there are exceptions that we do not identify out of the box
    // How to add your own custom exception identifier
class MyCustomExceptionIdentifier implements ExceptionIdentifier {
  @override
  String? identifyType(Exception exception) {
    if (exception is MyCustomException) {
      return 'MyCustomException';
    }
    if (exception is MyOtherCustomException) {
      return 'MyOtherCustomException';
    }
    return null;
  }
}

SentryFlutter.init((options) =>
  options..prependExceptionTypeIdentifier(MyCustomExceptionIdentifier()));

Deprecated #

  • Deprecate enableTracing (#2199)
    • The enableTracing option has been deprecated and will be removed in the next major version. We recommend removing it in favor of the tracesSampleRate and tracesSampler options. If you want to enable performance monitoring, please set the tracesSampleRate to a sample rate of your choice, or provide a sampling function as tracesSampler option instead. If you want to disable performance monitoring, remove the tracesSampler and tracesSampleRate options.

Dependencies #

8.6.0-alpha.2 #

Features #

  • Android Session Replay Alpha (#2032)

    To try out replay, you can set following options:

    await SentryFlutter.init(
  (options) {
    ...
    options.experimental.replay.sessionSampleRate = 1.0;
    options.experimental.replay.onErrorSampleRate = 1.0;
  },
  appRunner: () => runApp(MyApp()),
);

    Access is limited to early access orgs on Sentry. If you're interested, sign up for the waitlist

8.5.0 #

Features #

  • Add dart platform to sentry frames (#2193)
    • This allows viewing the correct dart formatted raw stacktrace in the Sentry UI
  • Support ignoredExceptionsForType (#2150)
    • Filter out exception types by calling SentryOptions.addExceptionFilterForType(Type exceptionType)

Fixes #

  • Disable sff & frame delay detection on web, linux and windows (#2182)
    • Display refresh rate is locked at 60 for these platforms which can lead to inaccurate metrics

Improvements #

  • Capture meaningful stack traces when unhandled errors have empty or missing stack traces (#2152)
    • This will affect grouping for unhandled errors that have empty or missing stack traces.

Dependencies #

8.4.0 #

Features #

  • Add API for pausing/resuming iOS and macOS app hang tracking (#2134)
    • This is useful to prevent the Cocoa SDK from reporting wrongly detected app hangs when the OS shows a system dialog for asking specific permissions.
    • Use SentryFlutter.pauseAppHangTracking() and SentryFlutter.resumeAppHangTracking()
  • Capture total frames, frames delay, slow & frozen frames and attach to spans (#2106)
  • Support WebAssembly compilation (dart2wasm) (#2113)
  • Add flag to disable reporting of view hierarchy identifiers (#2158)
    • Use reportViewHierarchyIdentifiers to enable or disable the option
  • Record dropped spans in client reports (#2154)
  • Add memory usage to contexts (#2133)
    • Only for Linux/Windows applications, as iOS/Android/macOS use native SDKs

Fixes #

  • Fix sentry_drift compatibility with Drift 2.19.0 (#2162)
  • App starts hanging for 30s (#2140)
    • Time out for app start info retrieval has been reduced to 10s
    • If autoAppStarts is false and setAppStartEnd has not been called, the app start event processor will now return early instead of waiting for getAppStartInfo to finish

Improvements #

  • Set dart runtime version with parsed Platform.version (#2156)

Dependencies #

Deprecated #

  • User segment is now deprecated and will be removed in version 9.0.0. Use a custom tag or context instead. (#2119)
  • Deprecate setExtra and removeExtra (#2159)
    • Use the Contexts structure via setContexts instead

8.4.0-beta.1 #

Features #

  • Add API for pausing/resuming iOS and macOS app hang tracking (#2134)
    • This is useful to prevent the Cocoa SDK from reporting wrongly detected app hangs when the OS shows a system dialog for asking specific permissions.
    • Use SentryFlutter.pauseAppHangTracking() and SentryFlutter.resumeAppHangTracking()
  • Capture total frames, frames delay, slow & frozen frames and attach to spans (#2106)
  • Support WebAssembly compilation (dart2wasm) (#2113)

Deprecated #

  • User segment is now deprecated and will be removed in version 9.0.0. Use a custom tag or context instead. (#2119)

Dependencies #

8.3.0 #

Fixes #

  • Load contexts integration not setting SentryUser (#2089)
  • Change app start span description from Cold start to Cold Start and Warm start to Warm Start (#2076)
  • Parse PlatformException from details instead of message (#2052)

Dependencies #

  • Bump sqflite minimum version from ^2.0.0 to ^2.2.8 (#2075)
    • This is not a breaking change since we are using api internally that is only valid from that version.
  • Bump Cocoa SDK from v8.25.2 to v8.29.0 (#2060, #2092, #2100)
  • Bump Android SDK from v7.9.0 to v7.10.0 (#2090)

8.2.0 #

Enhancements #

  • Include sentry frames in stacktraces to enable SDK crash detection (#2050)

Fixes #

  • Event processor blocking transactions from being sent if autoAppStart is false (#2028)

Features #

  • Create app start transaction when no SentryNavigatorObserver is present (#2017)
  • Adds native spans to app start transaction (#2027)
  • Adds app start spans to first transaction (#2009)

Fixes #

  • Fix PlatformException title parsing (#2033)

Dependencies #

8.1.0 #

Features #

  • Set snapshot to true if stacktrace is not provided (#2000)
    • If the stacktrace is not provided, the Sentry SDK will fetch the current stacktrace via StackTrace.current and the snapshot will be set to true - this may change the grouping behavior
    • snapshot = true means it's a synthetic exception, reflecting the current state of the thread rather than the stack trace of a real exception

Fixes #

  • Timing metric aggregates metrics in the created span (#1994)

Dependencies #

  • Bump Cocoa SDK from v8.21.0 to v8.25.0 (#2018)
  • Expand dependency range of package_info_plus to allow an open range starting from version 1 (#2010)

8.0.0 #

This release contains breaking changes, please read the changelog carefully.

Changes from the latest v7 release are included in this major release

Breaking Changes #

  • Bump iOS minimum deployment target from 11 to 12 (#1821)
  • Mark exceptions not handled by the user as handled: false (#1535)
    • This will affect your release health data, and is therefore considered a breaking change.
  • Refrain from overwriting the span status for unfinished spans (#1577)
    • Older self-hosted sentry instances will drop transactions containing unfinished spans.
  • Do not leak extensions of external classes (#1576)
  • Make hint non-nullable in BeforeSendCallback, BeforeBreadcrumbCall and EventProcessor (#1574)
    • This will affect your callbacks, making this a breaking change.
  • Load Device Contexts from Sentry Java (#1616)
    • Now the device context from Android is available in BeforeSendCallback
  • Set ip_address to {{auto}} by default, even if sendDefaultPII is disabled (#1665)
    • Instead use the "Prevent Storing of IP Addresses" option in the "Security & Privacy" project settings on sentry.io

Features #

  • Add support for exception aggregates (#1866)

7.20.0 #

Build #

  • Bump compileSdkVersion to 34 in Gradle buildscripts (#1980)

Features #

  • Add textScale(r) value to Flutter context (#1886)

Dependencies #

  • Expand dependency range of package_info_plus to include major version 7 (#1984)
  • Bump Android SDK from v7.6.0 to v7.8.0 (#1977)

7.19.0 #

Features #

  • Experimental: Add support for Sentry Developer Metrics (#1940, #1949, #1954, #1958) Use the Metrics API to track processing time, download sizes, user signups, and conversion rates and correlate them back to tracing data in order to get deeper insights and solve issues faster. Our API supports counters, distributions, sets, gauges and timers, and it's easy to get started: 
    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.

Dependencies #

  • Expand package_info_plus version range to 6.0.0 (#1948)

Improvements #

  • Set sentry_flutter.podspec version from pubspec.yaml (#1941)

7.18.0 #

Features #

  • Add TTFD (time to full display), which allows you to measure the time it takes to render the full screen (#1920)
    • Requires using the routing instrumentation.
    • Set enableTimeToFullDisplayTracing = true in your SentryFlutterOptions to enable TTFD
    • Manually report the end of the full display by calling SentryFlutter.reportFullyDisplayed()
    • If not reported within 30 seconds, the span will be automatically finish with the status deadline_exceeded
  • Add TTID (time to initial display), which allows you to measure the time it takes to render the first frame of your screen (#1910)
    • Requires using the routing instrumentation.
    • Introduces two modes:
      • automatic 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.
        • To use manual mode, you need to wrap your desired widget: SentryDisplayWidget(child: MyScreen()).
      • You can mix and match both modes in your app.
    • Other significant fixes
      • didPop doesn't trigger a new transaction
      • Change transaction operation name to ui.load instead of navigation
  • Add override captureFailedRequests option (#1931)
    • The dio integration and SentryHttpClient now take an additional captureFailedRequests option.
    • This is useful if you want to disable this option on native and only enable it on dio for example.

Improvements #

  • Update root name for navigator observer (#1934)
    • The root name for transactions is now root / instead of root ("/").

Dependencies #

7.17.0 #

Fixes #

  • Fix transaction end timestamp trimming (#1916)
    • Transaction end timestamps are now correctly trimmed to the latest child span end timestamp
  • remove transitive dart:io reference for web (#1898)

Features #

  • Use recordHttpBreadcrumbs to set iOS enableNetworkBreadcrumbs (#1884)
  • Apply beforeBreadcrumb on native iOS crumbs (#1914)
  • Add maxQueueSize to limit the number of unawaited events sent to Sentry (#1868)

Improvements #

  • App start is now fetched within integration instead of event processor (#1905)

Dependencies #

7.16.1 #

Fixes #

  • Remove Flutter dependency from Drift integration (#1867)
  • Remove dead code, cold start bool is now always present (#1861)
  • Fix iOS "Arithmetic Overflow" (#1874)

Dependencies #

8.0.0-beta.2 #

Breaking Changes #

  • Bump iOS minimum deployment target from 11 to 12 (#1821)
  • Mark exceptions not handled by the user as handled: false (#1535)
    • This will affect your release health data, and is therefore considered a breaking change.
  • Refrain from overwriting the span status for unfinished spans (#1577)
    • Older self-hosted sentry instances will drop transactions containing unfinished spans.
  • Do not leak extensions of external classes (#1576)
  • Make hint non-nullable in BeforeSendCallback, BeforeBreadcrumbCall and EventProcessor (#1574)
    • This will affect your callbacks, making this a breaking change.
  • Load Device Contexts from Sentry Java (#1616)
    • Now the device context from Android is available in BeforeSendCallback
  • Set ip_address to {{auto}} by default, even if sendDefaultPII is disabled (#1665)
    • Instead use the "Prevent Storing of IP Addresses" option in the "Security & Privacy" project settings on sentry.io

Fixes #

  • Remove Flutter dependency from Drift integration (#1867)
  • Remove dead code, cold start bool is now always present (#1861)
  • Fix iOS "Arithmetic Overflow" (#1874)

Dependencies #

8.0.0-beta.1 #

This release is replaced by 8.0.0-beta.2

7.16.0 #

Features #

  • Add SentryWidget (#1846)
    • Prefer to use SentryWidget now instead of SentryScreenshotWidget and SentryUserInteractionWidget directly
  • Performance monitoring support for Isar (#1726)
  • Tracing without performance for Dio integration (#1837)
  • Accept Map<String, dynamic> in Hint class (#1807)
    • Please check if everything works as expected when using Hint
      • Factory constructor Hint.withMap(Map<String, dynamic> map) now takes Map<String, dynamic> instead of Map<String, Object>
      • Method hint.addAll(Map<String, dynamic> keysAndValues) now takes Map<String, dynamic> instead of Map<String, Object>
      • Method set(String key, dynamic value) now takes value of dynamic instead of Object
      • Method hint.get(String key) now returns dynamic instead of Object?

Dependencies #

7.15.0 #

Features #

  • Add Spotlight support (#1786)
    • Set options.spotlight = Spotlight(enabled: true) to enable Spotlight
  • Add ConnectivityIntegration for web (#1765)
    • We only get the info if online/offline on web platform. The added breadcrumb is set to either wifi or none.
  • Add isar breadcrumbs (#1800)
  • Starting with Flutter 3.16, Sentry adds the appFlavor to the flutter_context (#1799)
  • Add beforeScreenshotCallback to SentryFlutterOptions (#1805)
  • Add support for readTransaction in sqflite (#1819)

Dependencies #

7.14.0 #

  • Add option to opt out of fatal level for automatically collected errors (#1738)

Fixes #

  • Add debug_meta to all events (#1756)
    • Fixes obfuscated stacktraces when captureMessage or captureEvent is called with attachStacktrace option

Features #

  • Add option to opt out of fatal level for automatically collected errors (#1738)
  • Add Hive breadcrumbs (#1773)

Dependencies #

7.13.2 #

Fixes #

  • Fix SIGSEV, SIGABRT and SIGBUS crashes happening after/around the August Google Play System update, see #2955 for more details (fix provided by Native SDK bump)

Dependencies #

  • Update package-info-plus constraint to include 5.0.1 (#1749)
  • Bump Android SDK from v6.33.1 to v6.34.0 (#1746)

7.13.1 #

Fixes #

  • Fixes release of drift & hive and adds missing integration & sdk version information in the hub options (#1729)

7.13.0 #

Fixes #

  • Fixes setting the correct locale to contexts with navigatorKey (#1724)
    • If you have a selected locale in e.g MaterialApp, this fix will retrieve the correct locale for the event context.
  • Flutter renderer information was removed on dart:io platforms since it didn't add the correct value (#1723)
  • Unsupported types with Expando (#1690)

Features #

  • Add APM integration for Drift (#1709)
  • StackTraces in PlatformException.message will get nicely formatted too when present (#1716)
  • Breadcrumbs for database operations (#1656)
  • APM for hive (#1672)
  • Add attachScreenshotOnlyWhenResumed to options (#1700)

Dependencies #

7.12.0 #

Enhancements #

  • Log warning if both tracesSampleRate and tracesSampler are set (#1701)
  • Better Flutter framework stack traces - we now collect Flutter framework debug symbols for iOS, macOS and Android automatically on the Sentry server (#1673)

Features #

  • Initial (alpha) support for profiling on iOS and macOS (#1611)
  • Add SentryNavigatorObserver current route to event.app.contexts.viewNames (#1545)
    • Requires relay version 23.9.0 for self-hosted instances

7.11.0 #

Fixes #

  • Session: missing mechanism.handled is considered crash (#3353)

Features #

  • Breadcrumbs for file I/O operations (#1649)

Dependencies #

7.10.1 #

Enhancements #

  • Add Sampling Decision to Trace Envelope Header (#1639)
  • Add http.request.method attribute to http spans data (#1633)
  • Add db.system and db.name attributes to db spans data (#1629)
  • Log SDK errors to the console if the log level is fatal even if debug is disabled (#1635)

Features #

  • Tracing without performance (#1621)

Fixes #

  • Normalize data properties of SentryUser and Breadcrumb before sending over method channel (#1591)
  • Fixing memory leak issue in SentryFlutterPlugin (Android Plugin) (#1588)
  • Discard empty stack frames (#1625)
  • Disable scope sync for cloned scopes (#1628)

Dependencies #

7.9.0 #

Features #

  • Send trace origin (#1534)

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.

  • Add appHangTimeoutInterval to SentryFlutterOptions (#1568)
  • DioEventProcessor: Append http response body (#1557)
    • This is opt-in and depends on maxResponseBodySize
    • Only for dio package

Dependencies #

7.8.0 #

Enhancements #

  • Add apiTarget field to SentryRequest and data field to SentryResponse (#1517)

Dependencies #

7.7.0 #

Fixes #

  • Enums use its name instead of non exhaustive switches (##1506)

Enhancements #

  • Add http fields to span.data (#1497)
    • Set http.response.status_code
    • Set http.response_content_length
  • Improve SentryException#value, remove stringified stack trace (##1470)

Dependencies #

7.6.3 #

Fixes #

  • Check if the Native SDKs are enabled when using autoInitializeNativeSdk=false (#1489)
  • Align http method to span convention (#1477)
  • Wrapped methods return a Future instead of executing right away (#1476)
  • Fix readTimeoutMillis wrongly configures connectionTimeoutMillis instead of the correct field (#1485)

Dependencies #

7.6.2 #

Enhancements #

  • SentryAssetBundle returns Future by default (#1462)

Features #

  • Support http >= 1.0.0 (#1475)

Dependencies #

7.6.1 #

Features #

  • Add sent_at to envelope header (#1428)

Fixes #

  • Fix battery level conversion for iOS 16.4 (#1433)
  • Adds a namespace for compatibility with AGP 8.0. (#1427)
  • Avoid dependency conflict with package_info_plus v4 (#1440)

Breaking Changes #

  • Android minSdkVersion is now 19 (Flutter already defines 19-20 as best effort)
  • Deprecate extra in favor of contexts (#1435)

Dependencies #

7.5.2 #

Fixes #

  • Fix event.origin and event.environment on unhandled exceptions (#1419)
  • Fix authority redaction (#1424)

Dependencies #

7.5.1 #

Fixes #

  • Fallback Uri parsing to unknown if its invalid (#1414)

7.5.0 #

Features #

  • Add SentryIOOverridesIntegration that automatically wraps File into SentryFile (#1362)
import 'package:sentry_file/sentry_file.dart';

// SDK init. options
options.addIntegration(SentryIOOverridesIntegration());
  • Add enableTracing option (#1395)
    • This change is backwards compatible. The default is null meaning existing behaviour remains unchanged (setting either tracesSampleRate or tracesSampler enables performance).
    • If set to true, performance is enabled, even if no tracesSampleRate or tracesSampler have been configured.
    • If set to true, sampler will use default sample rate of 1.0, if no tracesSampleRate is set.
    • If set to false performance is disabled, regardless of tracesSampleRate and tracesSampler options.
// SDK init. options
options.enableTracing = true;
  • Sync connectionTimeout and readTimeout to Android (#1397)
// SDK init. options
options.connectionTimeout = Duration(seconds: 10);
options.readTimeout = Duration(seconds: 10);
  • Set User 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',
      ))),
);
  • Add processor count to device info (#1402)
  • Add attachments to Hint (#1404)
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;
};

Fixes #

  • Screenshots and View Hierarchy should only be added to errors (#1385)
    • View Hierarchy is removed from Web errors since we don't symbolicate minified View Hierarchy yet.
  • More improvements related to not awaiting FutureOr<T> if it's not a future (#1385)
  • Do not report only async gap frames for logging calls (#1398)

Dependencies #

7.4.2 #

Fixes #

  • Fix breadcrumbs not being sent on Android web (#1378)

7.4.1 #

Fixes #

  • Fix Dart web builds breaking due to dart:io imports when using SentryIsolate or SentryIsolateExtension (#1371)
    • When using SentryIsolate or SentryIsolateExtension, import sentry_io.dart.
  • Export SentryBaggage (#1377)
  • Remove breadcrumbs from transaction to avoid duplication (#1366)

Dependencies #

7.4.0 #

Features #

  • SentryUserInteractionWidget: add support for PopupMenuButton and PopupMenuItem (#1361)

Fixes #

  • Fix SentryUserInteractionWidget throwing when Sentry is not enabled (#1363)
  • Fix enableAutoNativeBreadcrumbs and enableNativeCrashHandling sync flags (#1367)

7.3.0 #

Features #

  • Sanitize sensitive data from URLs (span desc, span data, crumbs, client errors) (#1327)

Dependencies #

Fixes #

  • Sync missing properties to the Native SDKs (#1354)

7.2.0 #

Features #

  • sqflite Support for Flutter (#1306)

Fixes #

  • DioErrorExtractor no longer extracts DioError.stackTrace which is done via DioStackTraceExtractor instead (#1344)
  • LoadImageListIntegration won't throw bad state if there is no exceptions in the event (#1347)

Dependencies #

7.1.0 #

Features #

  • Exception StackTrace Extractor (#1335)

Dependencies #

Fixes #

  • SentryUserInteractionWidget checks if the Elements are mounted before comparing them (#1339)

7.0.0 #

Features #

  • Platform Exception Event Processor (#1297)
  • Support failedRequestTargets for HTTP Client errors (#1285)
    • Captures errors for the default range 500-599 if captureFailedRequests is enabled
  • Sentry Isolate Extension (#1266)
  • Allow sentry user to control resolution of captured Flutter screenshots (#1288)
  • Support beforeSendTransaction (#1238)
  • Add In Foreground to App context (#1260)
  • Error Cause Extractor (#1198, #1236)
    • Add throwable to SentryException
  • Dart 3 Support (#1220)
  • Introduce Hint data bag (#1136)
  • Use Hint for screenshots (#1165)
  • Support custom units for custom measurements (#1181)

Enhancements #

  • Replace toImage with toImageSync for Flutter >= 3.7 (1268)
  • Don't await FutureOr<T> if it's not a future. This should marginally improve the performance (#1310)
  • Replace StackTrace.empty with StackTrace.current (#1183)

Breaking Changes #

Dart Migration guide.

Flutter Migration guide.

  • Enable enableNdkScopeSync by default (#1276)
  • Update sentry_dio to dio v5 (#1282)
  • Remove deprecated fields (#1227)
    • Remove deprecated fields from the Scope class.
      • user(SentryUser? user), using the setUser(SentryUser? user) instead.
      • attachements, using the attachments instead.
    • Remove deprecated field from the SentryFlutterOptions class.
      • anrTimeoutIntervalMillis, using the anrTimeoutInterval instead.
      • autoSessionTrackingIntervalMillis, using the autoSessionTrackingInterval instead.
  • Rename APM tracking feature flags to tracing (#1222)
    • Rename
      • enableAutoPerformanceTracking to enableAutoPerformanceTracing
      • enableOutOfMemoryTracking to enableWatchdogTerminationTracking
  • Enable APM features by default (#1217)
    • Enable by default
      • captureFailedRequests
      • enableStructuredDataTracing
      • enableUserInteractionTracing
  • Mark transaction as internal_error in case of unhandled errors (#1218)
  • Removed various deprecated fields (#1036):
    • Removed the following fields from the device context
      • language
      • timezone
      • screenResolution
      • theme
    • Removed isolate name from Dart context. It's now reported via the threads interface. It can be enabled via options.attachThreads
  • Use sentryClientName instead of sdk.identifier (#1135)
  • Refactor BindingUtils to BindingWrapper to enable the use of custom bindings (#1184)
  • Bump Flutter min to 3.0.0 and Dart to 2.17.0 (#1180)

Dependencies #

Fixes #

  • View hierarchy reads size from RenderBox only (#1258)
  • Try to avoid ConcurrentModificationError by not using a Future.forEach (#1259)
  • isWeb check for WASM (#1249)
  • Don't suppress error logs (#1228)
  • Fix: Remove SentryOptions related parameters from classes which also take Hub as a parameter (#816)

7.0.0-rc.2 #

Features #

  • Platform Exception Event Processor (#1297)
  • Support failedRequestTargets for HTTP Client errors (#1285)
    • Captures errors for the default range 500-599 if captureFailedRequests is enabled
  • Sentry Isolate Extension (#1266)
  • Allow sentry user to control resolution of captured Flutter screenshots (#1288)

Enhancements #

  • Replace toImage with toImageSync for Flutter >= 3.7 (1268)
  • Don't await FutureOr<T> if it's not a future. This should marginally improve the performance (#1310)

6.22.0 #

Features #

  • Add proguard_uui property to SentryFlutterOptions to set proguard information at runtime (#1312)

Fixes #

  • Change podspec EXCLUDED_ARCHS value to allow podfiles to add more excluded architetures (#1303)

Dependencies #

7.0.0-rc.1 #

Breaking Changes #

  • Enable enableNdkScopeSync by default (#1276)
  • Update sentry_dio to dio v5 (#1282)

Dependencies #

6.21.0 #

Features #

  • Implement loadStructuredBinaryData from updated AssetBundle (#1272)

Dependencies #

Fixes #

  • Pass processed Breadcrumb to scope observer (#1298)
  • Remove duplicated breadcrumbs when syncing with iOS/macOS (#1283)

6.20.1 #

Fixes #

  • Set client name with version in Android SDK (#1274)

7.0.0-beta.4 #

Features #

  • Support beforeSendTransaction (#1238)
  • Add In Foreground to App context (#1260)

Fixes #

  • View hierarchy reads size from RenderBox only (#1258)
  • Try to avoid ConcurrentModificationError by not using a Future.forEach (#1259)

Dependencies #

7.0.0-beta.1 #

Fixes #

  • isWeb check for WASM (#1249)

7.0.0-alpha.5 #

Features #

  • Error Cause Extractor (#1198, #1236)
    • Add throwable to SentryException

Fixes #

  • Don't suppress error logs (#1228)
  • Fix export for BindingWrapper (#1234)

7.0.0-alpha.4 #

Breaking Changes #

  • Remove deprecated fields (#1227)
    • Remove deprecated fields from the Scope class.
      • user(SentryUser? user), using the setUser(SentryUser? user) instead.
      • attachements, using the attachments instead.
    • Remove deprecated field from the SentryFlutterOptions class.
      • anrTimeoutIntervalMillis, using the anrTimeoutInterval instead.
      • autoSessionTrackingIntervalMillis, using the autoSessionTrackingInterval instead.

Dependencies #

7.0.0-alpha.3 #

Breaking Changes #

  • Rename APM tracking feature flags to tracing (#1222)
    • Rename
      • enableAutoPerformanceTracking to enableAutoPerformanceTracing
      • enableOutOfMemoryTracking to enableWatchdogTerminationTracking

Enhancements #

  • Migrate to sentry cocoa v8 (#1197)

7.0.0-alpha.2 #

Features #

Breaking Changes #

  • Enable APM features by default (#1217)
    • Enable by default
      • captureFailedRequests
      • enableStructuredDataTracing
      • enableUserInteractionTracing
  • Mark transaction as internal_error in case of unhandled errors (#1218)

7.0.0-alpha.1 #

Features #

  • Feat: Introduce Hint data bag (#1136)
  • Feat: Use Hint for screenshots (#1165)
  • Feat: Support custom units for custom measurements (#1181)

Fixes #

  • Fix: Remove SentryOptions related parameters from classes which also take Hub as a parameter (#816)

Enhancements #

  • Enha: Replace StackTrace.empty with StackTrace.current (#1183)

Breaking Changes #

  • Removed various deprecated fields (#1036):
    • Removed the following fields from the device context
      • language
      • timezone
      • screenResolution
      • theme
    • Removed isolate name from Dart context. It's now reported via the threads interface. It can be enabled via options.attachThreads
  • Use sentryClientName instead of sdk.identifier (#1135)
  • Refactor BindingUtils to BindingWrapper to enable the use of custom bindings (#1184)
  • Bump Flutter min to 3.0.0 and Dart to 2.17.0 (#1180)

6.19.0 #

Fixes #

  • intl is now more version permissive (>=0.17.0 <1.0.0) (#1247)

Breaking Changes: #

  • sentry_file now requires Dart >= 2.19 (#1240)

6.18.3 #

Fixes #

  • Fix Pod target for iOS (#1237)

Dependencies #

6.18.2 #

Fixes #

  • enableUserInteractionTracing sometimes finds the wrong widget (#1212)
  • Only call method channels on native platforms (#1196)

Dependencies #

6.18.1 #

Fixes #

  • Missing slow and frozen frames for Auto transactions (#1172)

Dependencies #

6.18.0 #

Features #

  • Tracing for File IO integration (#1160)

Dependencies #

6.17.0 #

Fixes #

  • Capture Future errors for Flutter Web automatically (#1152)

Features #

  • User Interaction transactions and breadcrumbs (#1137)

6.16.1 #

Fixes #

  • Do not attach headers if Span is NoOp (#1143)

Dependencies #

6.16.0 #

Features #

  • Add request context to HttpException, SocketException and NetworkImageLoadException (#1118)
  • SocketException and FileSystemException with OSErrors report the OSError as root exception (#1118)

Fixes #

  • VendorId should be a String (#1112)
  • Disable enableUserInteractionBreadcrumbs on Android when enableAutoNativeBreadcrumbs is disabled (#1131)
  • Transaction name is reset after the transaction finishes (#1125)

Dependencies #

6.15.1 #

Dependencies #

6.15.0 #

Features #

  • Feat: Screenshot Attachment (#1088)

Fixes #

  • Merging of integrations and packages (#1111)
  • Add missing fragment for HTTP Client Errors (#1102)
  • Sync user name and geo for Android (#1102)
  • Add mechanism to Dio Http Client error (#1114)

Dependencies #

6.14.0 #

Features #

  • Capture response information in SentryHttpClient (#1095)

Changes #

  • Remove experimental SentryResponse fields: url, body, redirected, status (#1095)
  • SentryHttpClient request body capture checks default PII capture setting, same as the DIO integration (#1095)

Dependencies #

6.13.1 #

Fixes #

  • Avoid dependency conflict with package_info_plus v3 (#1084)

6.13.0 #

Features #

  • Use PlatformDispatcher.onError in Flutter 3.3 (#1039)

Fixes #

  • Bring protocol up to date with latest Sentry protocol (#1038)

Dependencies #

6.12.2 #

Fixes #

  • Avoid dependency conflict with package_info_plus v2 (#1068)

6.12.1 #

Dependencies #

6.12.0 #

Fixes #

  • Handle traces sampler exception (#1040)
  • tracePropagationTargets ignores invalid Regex (#1043)
  • SentryDevice cast error (#1059)

Features #

Dependencies #

6.11.2 #

Fixes #

  • Tracer does not allow setting measurement if finished (#1026)
  • Add missing measurements units (#1033)

Features #

6.11.1 #

Fixes #

  • Align span spec for serialize ops (#1024)
  • Pin sentry version (#1020)

Features #

6.11.0 #

Fixes #

  • Scope cloning method was not setting the user (#1013)

Features #

  • Dynamic sampling (#1004)
  • Set custom measurements on transactions (#1011)

6.10.0 #

Fixes #

  • Capture Callback Exceptions (#990)
  • Allow routeNameExtractor to set transaction names (#1005)

Features #

6.9.1 #

Fixes #

  • Scope.clone incorrectly accesses tags (#978)
  • beforeBreadcrumb was not adding the mutated breadcrumb (#982)

Features #

6.9.0 #

Features #

  • Bump Flutter's min. supported version from 1.17.0 to 2.0.0 (#966)

This should not break anything since the Dart's min. version is already 2.12.0 and Flutter 2.0.0 uses Dart 2.12.0

Fixes #

  • Back compatibility of Object.hash for Dart 2.12.0 (#966)
  • Fix back compatibility for OnErrorIntegration integration (#965)

6.8.1 #

Fixes #

  • Scope#setContexts pasing a List value would't not work (#932)

Features #

  • Add integration for PlatformDispatcher.onError (#915)

6.8.0 #

Fixes #

  • Missing OS context for iOS events (#958)
  • Fix: Scope#clone calls the Native bridges again via the scopeObserver (#959)

Features #

  • Dio Integration adds response data (#934)

6.7.0 #

Fixes #

  • Maps with Key Object, Object would fail during serialization if not String, Object (#935)
  • Breadcrumbs "Concurrent Modification" (#948)
  • Duplicative Screen size changed breadcrumbs (#888)
  • Duplicated Android Breadcrumbs with no Mechanism (#954)
  • Fix windows native method need default result (#943)
  • Add request instead of response data to SentryRequest in DioEventProcessor #933

Features #

6.6.3 #

Fixes #

  • Context Escape with ScopeCallback (#925)

6.6.2 #

Features #

Fixes #

  • Send DidBecomeActiveNotification when OOM enabled (#905)
  • dio.addSentry hangs if dsn is empty and SDK NoOp (#920)
  • addBreadcrumb throws on Android API < 24 because of NewApi usage (#923)
  • sentry_dio is promoted to GA and not experimental anymore (#914)

6.6.1 #

Fixes #

  • Filter out app starts with more than 60s (#895)

6.6.0 #

Fixes #

  • Bump: Sentry-Cocoa to 7.18.0 and Sentry-Android to 6.1.2 (#892)
  • Fix: Add missing iOS contexts (#761)
  • Fix serialization of threads (#844)
  • Fix: SentryAssetBundle on Flutter >= 3.1 (#877)

Features #

  • Feat: Client Reports (#829)
  • Feat: Allow manual init of the Native SDK (#765)
  • Feat: Attach Isolate name to thread context (#847)
  • Feat: Add Android thread to platform stacktraces (#853)
  • Feat: Sync Scope to Native (#858)

Sentry Self-hosted Compatibility #

  • Starting with version 6.6.0 of sentry, Sentry's version >= v21.9.0 is required or you have to manually disable sending client reports via the sendClientReports option. This only applies to self-hosted Sentry. If you are using sentry.io, no action is needed.

6.6.0-beta.4 #

  • Bump: Sentry-Cocoa to 7.17.0 and Sentry-Android to 6.1.1 (#891)

6.6.0-beta.3 #

  • Bump: Sentry-Cocoa to 7.16.1 (#886)

6.6.0-beta.2 #

  • Fix: Add user setter back in the scope (#883)
  • Fix: clear method sets all properties synchronously (#882)

6.6.0-beta.1 #

  • Feat: Sync Scope to Native (#858)

6.6.0-alpha.3 #

  • Feat: Attach Isolate name to thread context (#847)
  • Fix: SentryAssetBundle on Flutter >= 3.1 (#877)
  • Feat: Add Android thread to platform stacktraces (#853)
  • Fix: Rename auto initialize property (#857)
  • Bump: Sentry-Android to 6.0.0 (#879)

6.6.0-alpha.2 #

  • Fix serialization of threads (#844)
  • Feat: Allow manual init of the Native SDK (#765)

6.6.0-alpha.1 #

  • Feat: Client Reports (#829)
  • Fix: Add missing iOS contexts (#761)

Sentry Self-hosted Compatibility #

  • Starting with version 6.6.0 of sentry, Sentry's version >= v21.9.0 is required or you have to manually disable sending client reports via the sendClientReports option. This only applies to self-hosted Sentry. If you are using sentry.io, no action is needed.

6.5.1 #

  • Update event contexts (#838)

6.5.0 #

  • No documented changes.

6.5.0-beta.2 #

  • Fix: Do not set the transaction to scope if no op (#828)

6.5.0-beta.1 #

  • No documented changes.

6.5.0-alpha.3 #

  • Feat: Support for platform stacktraces on Android (#788)

6.5.0-alpha.2 #

  • Bump: Sentry-Android to 5.7.0 and Sentry-Cocoa to 7.11.0 (#796)
  • Fix: Dio event processor safelly bails if no DioError in the exception list (#795)

6.5.0-alpha.1 #

  • Feat: Mobile Vitals - Native App Start (#749)
  • Feat: Mobile Vitals - Native Frames (#772)

6.4.0 #

Various fixes & improvements #

  • Fix: Missing userId on iOS when userId is not set (#782) by @marandaneto
  • Allow to set startTimestamp & endTimestamp manually to SentrySpan (#676) by @fatihergin

6.4.0-beta.3 #

  • Feat: Allow to set startTimestamp & endTimestamp manually to SentrySpan (#676)
  • Bump: Sentry-Cocoa to 7.10.0 (#777)
  • Feat: Additional Dart/Flutter context information (#778)
  • Bump: Kotlin plugin to 1.5.31 (#763)
  • Fix: Missing userId on iOS when userId is not set (#782)

6.4.0-beta.2 #

  • No documented changes.

6.4.0-beta.1 #

  • Fix: Disable log by default in debug mode (#753)
  • [Dio] Ref: Replace FailedRequestAdapter with FailedRequestInterceptor (#728)
  • Fix: Add missing return values - dart analyzer (#742)
  • Feat: Add DioEventProcessor which improves DioError crash reports (#718)
  • Fix: Do not report duplicated packages and integrations (#760)
  • Feat: Allow manual init of the Native SDK or no Native SDK at all (#765)

6.3.0 #

  • Feat: Support maxSpan for performance API and expose SentryOptions through Hub (#716)
  • Fix: await ZonedGuard integration to run (#732)
  • Fix: sentry_logging incorrectly setting SDK name (#725)
  • Bump: Sentry-Android to 5.6.1 and Sentry-Cocoa to 7.9.0 (#736)
  • Feat: Support Attachment.addToTransactions (#709)
  • Fix: captureTransaction should return emptyId when transaction is discarded (#713)
  • Add SentryAssetBundle for automatic spans for asset loading (#685)
  • Fix: maxRequestBodySize should be never by default when using the FailedRequestClientAdapter directly (#701)
  • Feat: Add support for Dio (#688)
  • Fix: Use correct data/extras type in tracer (#693)
  • Fix: Do not throw when Throwable type is not supported for associating errors to a transaction (#692)
  • Feat: Automatically create transactions when navigating between screens (#643)

6.3.0-beta.4 #

  • Feat: Support Attachment.addToTransactions (#709)
  • Fix: captureTransaction should return emptyId when transaction is discarded (#713)

6.3.0-beta.3 #

  • Feat: Auto transactions duration trimming (#702)
  • Add SentryAssetBundle for automatic spans for asset loading (#685)
  • Feat: Configure idle transaction duration (#705)
  • Fix: maxRequestBodySize should be never by default when using the FailedRequestClientAdapter directly (#701)

6.3.0-beta.2 #

  • Feat: Improve configuration options of SentryNavigatorObserver (#684)
  • Feat: Add support for Dio (#688)
  • Bump: Sentry-Android to 5.5.2 and Sentry-Cocoa to 7.8.0 (#696)

6.3.0-beta.1 #

  • Enha: Replace flutter default root name '/' with 'root' (#678)
  • Fix: Use 'navigation' instead of 'ui.load' for auto transaction operation (#675)
  • Fix: Use correct data/extras type in tracer (#693)
  • Fix: Do not throw when Throwable type is not supported for associating errors to a transaction (#692)

6.3.0-alpha.1 #

  • Feat: Automatically create transactions when navigating between screens (#643)

6.2.2 #

  • Fix: ConcurrentModificationError in when finishing span (#664)
  • Feat: Add enableNdkScopeSync Android support (#665)

6.2.1 #

  • Fix: sentry_logging works now on web (#660)
  • Fix: sentry_logging timestamps are in UTC (#660)
  • Fix: sentry_logging Level.Off is never recorded (#660)
  • Fix: Rate limiting fallback to retryAfterHeader (#658)

6.2.0 #

  • Feat: Integration for logging (#631)
  • Feat: Add logger name to SentryLogger and send errors in integrations to the registered logger (#641)

6.1.2 #

  • Fix: Remove is Enum check to support older Dart versions (#635)

6.1.1 #

  • Fix: Transaction serialization if not encodable (#633)

6.1.0 #

  • Bump: Sentry-Android to 5.3.0 and Sentry-Cocoa to 7.5.1 (#629)
  • Fix: event.origin tag for macOS and other Apple platforms (#622)
  • Feat: Add current route as transaction (#615)
  • Feat: Add Breadcrumbs for Flutters debugPrint (#618)
  • Feat: Enrich Dart context with isolate name (#600)
  • Feat: Sentry Performance for HTTP client (#603)
  • Performance API for Dart/Flutter (#530)

Breaking Changes: #

  • SentryEvent inherits from the SentryEventLike mixin
  • Scope#transaction sets and reads from the Scope#span object if bound to the Scope

6.1.0-beta.1 #

  • Feat: Add current route as transaction (#615)
  • Feat: Add Breadcrumbs for Flutters debugPrint (#618)

6.1.0-alpha.2 #

  • Bump Sentry Android SDK to 5.2.0 (#594)
  • Feat: Enrich Dart context with isolate name (#600)
  • Feat: Sentry Performance for HTTP client (#603)

6.1.0-alpha.1 #

  • Performance API for Dart/Flutter (#530)

Breaking Changes: #

  • SentryEvent inherits from the SentryEventLike mixin
  • Scope#transaction sets and reads from the Scope#span object if bound to the Scope

6.0.1 #

  • Fix: Set custom SentryHttpClientError when HTTP error is captured without an exception (#580)
  • Bump: Android AGP 4.1 (#586)
  • Bump: Sentry Cocoa to 7.3.0 (#589)

6.0.0 #

  • Fix: Update SentryUser according to docs (#561)
  • Feat: Enable or disable reporting of packages (#563)
  • Bump: Sentry-Cocoa to 7.2.7 (#578)
  • Bump: Sentry-Android to 5.1.2 (#578)
  • Fix: Read Sentry config from environment variables as fallback (#567)

6.0.0-beta.4 #

Breaking Changes: #

  • Feat: Lists of exceptions and threads (#524)
  • Feat: Collect more information for exceptions collected via FlutterError.onError (#538)
  • Feat: Add maxAttachmentSize option (#553)
  • Feat: HTTP breadcrumbs have the request & response size if available (#552)

6.0.0-beta.3 #

  • Fix: Re-initialization of Flutter SDK (#526)
  • Enhancement: Call toString() on all non-serializable fields (#528)
  • Fix: Always call Flutter.onError in order to not swallow messages (#533)
  • Bump: Android SDK to 5.1.0-beta.6 (#535)

6.0.0-beta.2 #

  • Fix: Serialization of Flutter Context (#520)
  • Feat: Add support for attachments (#505)
  • Feat: Add support for User Feedback (#506)

6.0.0-beta.1 #

  • Feat: Browser detection (#502)
  • Feat: Enrich events with more context (#452)
  • Feat: Add Culture Context (#491)
  • Feat: Add DeduplicationEventProcessor (#498)
  • Feat: Capture failed requests as event (#473)
  • Feat: beforeSend callback accepts async code (#494)

Breaking Changes: #

  • Ref: EventProcessor changed to an interface (#489)
  • Feat: Support envelope based transport for events (#391)
    • The method signature of Transport changed from Future<SentryId> send(SentryEvent event) to Future<SentryId> send(SentryEnvelope envelope)
  • Remove Sentry.currentHub (#490)
  • Ref: Rename cacheDirSize to maxCacheItems and add maxCacheItems for iOS (#495)
  • Ref: Add error and stacktrace parameter to logger (#503)
  • Feat: Change timespans to Durations in SentryOptions (#504)
  • Feat: beforeSend callback accepts async code (#494)

Sentry Self Hosted Compatibility #

  • Since version 6.0.0 of the sentry, Sentry's version >= v20.6.0 is required. This only applies to on-premise Sentry, if you are using sentry.io no action is needed.

5.1.0 #

  • Fix: Merge user from event and scope (#467)
  • Feature: Allow setting of default values for in-app-frames via SentryOptions.considerInAppFramesByDefault (#482)
  • Bump: sentry-android to v5.0.1 (#486)
  • Bump: Sentry-Cocoa to 7.1.3 for iOS and macOS (#488)

5.1.0-beta.1 #

  • Fix: Sentry.close() closes native SDK integrations (#388)
  • Feat: Support for macOS (#389)
  • Feat: Support for Linux (#402)
  • Feat: Support for Windows (#407)
  • Fix: Mark Sentry.currentHub as deprecated (#406)
  • Fix: Set console logger as default logger in debug mode (#413)
  • Fix: Use name from pubspec.yaml for release if package id is not available (#411)
  • Feat: SentryHttpClient tracks the duration which a request takes and logs failed requests (#414)
  • Bump: sentry-cocoa to v7.0.0 (#424)
  • Feat: Support for Out-of-Memory-Tracking on macOS/iOS (#424)
  • Fix: Trim \u0000 from Windows package info (#420)
  • Feature: Log calls to print() as Breadcrumbs (#439)
  • Fix: dist was read from SENTRY_DSN, now it's read from SENTRY_DIST (#442)
  • Bump: sentry-cocoa to v7.0.3 (#445)
  • Fix: Fix adding integrations on web (#450)
  • Fix: Use log() instead of print() for SDK logging (#453)
  • Bump: sentry-android to v5.0.0-beta.2 (#457)
  • Feature: Add withScope callback to capture methods (#463)
  • Fix: Add missing properties language, screenHeightPixels and screenWidthPixels to SentryDevice (#465)

Sentry Self Hosted Compatibility #

  • This version of the sentry Dart package requires Sentry server >= v20.6.0. This only applies to on-premise Sentry, if you are using sentry.io no action is needed.

5.0.0 #

  • Sound null safety
  • Fix: event.origin and event.environment tags have wrong value for iOS (#365) and (#369)
  • Fix: Fix deprecated registrar.messenger call in SentryFlutterWeb (#364)
  • Fix: Enable breadcrumb recording mechanism based on platform (#366)
  • Feat: Send default PII options (#360)
  • Bump: sentry-cocoa to v6.2.1 (#360)
  • Feat: Migration from package_info to package_info_plus plugin (#370)
  • Fix: Set SentryOptions.debug in sentry (#376)
  • Fix: Read all environment variables in sentry (#375)

Breaking Changes: #

  • Return type of Sentry.close() changed from void to Future<void> and Integration.close() changed from void to FutureOr<void> (#395)
  • Remove deprecated member enableLifecycleBreadcrumbs. Use enableAppLifecycleBreadcrumbs instead. (#366)

4.1.0-nullsafety.1 #

  • Bump: sentry-android to v4.3.0 (#343)
  • Fix: Multiple FlutterError.onError calls in FlutterErrorIntegration (#345)
  • Fix: Pass hint to EventProcessors (#356)
  • Fix: EventProcessors were not dropping events when returning null (#353)

Breaking Changes: #

  • Fix: Plugin Registrant class moved to barrel file (#358)
    • This changed the import from import 'package:sentry_flutter/src/sentry_flutter_web.dart'; to import 'package:sentry_flutter/sentry_flutter_web.dart';
    • This could lead to breaking changes. Typically it shouldn't because the referencing file is auto-generated.
  • Fix: Prefix classes with Sentry (#357)
    • A couple of classes were often conflicting with user's code. Thus this change renames the following classes:
      • App -> SentryApp
      • Browser -> SentryBrowser
      • Device -> SentryDevice
      • Gpu -> SentryGpu
      • Integration -> SentryIntegration
      • Message -> SentryMessage
      • OperatingSystem -> SentryOperatingSystem
      • Request -> SentryRequest
      • User -> SentryUser
      • Orientation -> SentryOrientation

4.1.0-nullsafety.0 #

  • Fix: Do not append stack trace to the exception if there are no frames
  • Fix: Empty DSN disables the SDK and runs the App
  • Feat: sentry and sentry_flutter null-safety thanks to @ueman and @fzyzcjy

4.0.6 #

  • Fix: captureMessage defaults SentryLevel to info
  • Fix: SentryEvent.throwable returns the unwrapped throwable instead of the throwableMechanism
  • Feat: Support enableNativeCrashHandling on iOS

4.0.5 #

  • Bump: sentry-android to v4.0.0
  • Fix: Pana Flutter upper bound deprecation
  • Fix: sentry_flutter static analysis (pana) using stable version

4.0.4 #

  • Fix: Call WidgetsFlutterBinding.ensureInitialized() within runZoneGuarded

4.0.3 #

  • Fix: Auto session tracking start on iOS #274
  • Bump: Sentry-cocoa to 6.1.4

4.0.2 #

  • Fix: Mark session as errored in iOS #270
  • Fix: Pass auto session tracking interval to iOS
  • Fix: Deprecated binaryMessenger (MethodChannel member) for Flutter Web
  • Ref: Make WidgetsFlutterBinding.ensureInitialized(); the first thing the Sentry SDK calls.
  • Bump: Sentry-cocoa to 6.0.12
  • Feat: Respect FlutterError silent flag #248
  • Bump: Android SDK to v3.2.1 #273

4.0.1 #

  • Ref: Changed category of Flutter lifecycle tracking #240
  • Fix: Envelope length should be based on the UTF8 array instead of String length

4.0.0 #

Release of Sentry's new SDK for Dart/Flutter.

New features not offered by <= v4.0.0:

Dart SDK #

Flutter SDK #

  • The Flutter SDK is built on top of the Dart SDK, so it includes all the available features, plus
  • Flutter SDK docs.
  • Automatic NavigatorObserver Breadcrumbs
  • Automatic Device's Breadcrumbs through the Android and iOS SDKs or via Sentry's WidgetsBindingObserver wrapper
  • No boilerplate for FlutterError.onError
  • All events are enriched with Contexts's data, this includes Device's, OS, App info, etc...
  • Offline caching
  • Release health
  • Captures not only Dart and Flutter errors, but also errors caused on the native platforms, Like Kotlin, Java, C and C++ for Android and Swift, ObjC, C, C++ for iOS
  • Supports Fatal crashes, Event is going to be sent on App's restart
  • Supports split-debug-info for Android only
  • Flutter Android, iOS and limited support for Flutter Web

Improvements:

  • Feat: Added a copyWith method to all the protocol classes

Packages were released on sentry pubdev and sentry_flutter pubdev

Sentry Self Hosted Compatibility #

  • Since version 4.0.0 of the sentry_flutter, Sentry's version >= v20.6.0 is required. This only applies to on-premise Sentry, if you are using sentry.io no action is needed.

4.0.0-beta.2 #

  • Ref: Remove duplicated attachStackTrace field
  • Fix: Flutter Configurations should be able to mutate the SentryFlutterOptions
  • Enhancement: Add SentryWidgetsBindingObserver, an Integration that captures certain window and device events.
  • Enhancement: Set options.environment on SDK init based on the flags (kReleaseMode, kDebugMode, kProfileMode or SENTRY_ENVIRONMENT).
  • Feature: SentryHttpClient to capture HTTP requests as breadcrumbs
  • Ref: Only assign non-null option values in Android native integration in order preserve default values
  • Enhancement: Add 'attachThreads' in options. When enabled, threads are attached to all logged events for Android
  • Ref: Rename typedef Logger to SentryLogger to prevent name clashes with logging packages
  • Fix: Scope Event processors should be awaited
  • Fix: Package usage as git dependency

Breaking changes #

  • Logger typedef is renamed to SentryLogger
  • attachStackTrace is renamed to attachStacktrace

4.0.0-beta.1 #

  • Fix: StackTrace frames with 'package' uri.scheme are inApp by default #185
  • Fix: Missing App's StackTrace frames for Flutter errors
  • Enhancement: Add isolateErrorIntegration and runZonedGuardedIntegration to default integrations in sentry-dart
  • Fix: Breadcrumb list is a plain list instead of a values list #201
  • Ref: Remove deprecated classes (Flutter Plugin for Android) and cleaning up #186
  • Fix: Handle immutable event lists and maps
  • Fix: NDK integration was being disabled by a typo
  • Fix: Missing toList for debug meta #192
  • Enhancement: NavigationObserver to record Breadcrumbs for navigation events #197
  • Fix: Integrations should be closeable
  • Feat: Support split-debug-info for Android #191
  • Fix: the event payload must never serialize null or empty fields
  • Ref: Make hints optional

Breaking changes #

  • Sentry.init and SentryFlutter.init have an optional callback argument which runs the host App after Sentry initialization.
  • Integration is an Interface instead of a pure Function
  • Hints are optional arguments
  • Sentry Dart SDK adds an IsolateError handler by default

4.0.0-alpha.2 #

  • Enhancement: Contexts were added to the Scope #154
  • Fix: App. would hang if debug mode was enabled and refactoring ##157
  • Enhancement: Sentry Protocol v7
  • Enhancement: Added missing Protocol fields, Request, SentryStackTrace...) #155
  • Feat: Added attachStackTrace options to attach stack traces on captureMessage calls
  • Feat: Flutter SDK has the Native SDKs embedded (Android and Apple) #158

Breaking changes #

  • Sentry.init returns a Future.
  • Dart min. SDK is 2.8.0
  • Flutter min. SDK is 1.17.0
  • Timestamp has millis precision.
  • For better groupping, add your own package to the addInAppInclude list, e.g. options.addInAppInclude('sentry_flutter_example');
  • A few classes of the Protocol were renamed.

Sentry Self Hosted Compatibility #

  • Since version 4.0.0 of the sentry_flutter, Sentry version >= v20.6.0 is required. This only applies to on-premise Sentry, if you are using sentry.io no action is needed.

4.0.0-alpha.1 #

First Release of Sentry's new SDK for Dart/Flutter.

New features not offered by <= v4.0.0:

  • Sentry's Unified API.
  • Complete Sentry Protocol available.
  • Docs and Migration is under review on this PR
  • For all the breaking changes follow this PR, they'll be soon available on the Migration page.

Packages were released on pubdev

We'd love to get feedback and we'll work in getting the GA 4.0.0 out soon. Until then, the stable SDK offered by Sentry is at version 3.0.1

3.0.1 #

  • Add support for Contexts in Sentry events

3.0.0+1 #

  • pubspec.yaml and example code clean-up.

3.0.0 #

  • Support Web
    • SentryClient from package:sentry/sentry.dart with conditional import
    • SentryBrowserClient for web from package:sentry/browser_client.dart
    • SentryIOClient for VM and Flutter from package:sentry/io_client.dart

2.3.1 #

  • Support non-standard port numbers and paths in DSN URL.

2.3.0 #

2.2.0 #

  • Add a stackFrameFilter argument to SentryClient's capture method (96be842).
  • Clean-up code using pre-Dart 2 API (91c7706, b01ebf8).

2.1.1 #

2.1.0 #

  • Support DNS format without secret key.
  • Remove dependency on package:quiver.
  • The clock argument to SentryClient constructor should now be ClockProvider (but still accepts Clock for backwards compatibility).

2.0.2 #

  • Add support for user context in Sentry events.

2.0.1 #

  • Invert stack frames to be compatible with Sentry's default culprit detection.

2.0.0 #

  • Fixed deprecation warnings for Dart 2
  • Refactored tests to work with Dart 2

1.0.0 #

  • first and last Dart 1-compatible release (we may fix bugs on a separate branch if there's demand)
  • fix code for Dart 2

0.0.6 #

  • use UTC in the timestamp field

0.0.5 #

  • remove sub-seconds from the timestamp

0.0.4 #

  • parse and report async gaps in stack traces

0.0.3 #

  • environment attributes
  • auto-generate event_id and timestamp for events

0.0.2 #

  • parse and report stack traces
  • use x-sentry-error HTTP response header
  • gzip outgoing payloads by default

0.0.1 #

  • basic ability to send exception reports to Sentry.io

← Metadata

504
likes
140
points
670k
downloads

Publisher

verified publishersentry.io

Weekly Downloads

Metadata

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.

Homepage
Repository (GitHub)
View/report issues
Contributing

Documentation

Documentation
API reference

License

BSD-3-Clause (license)

Dependencies

collection, http, meta, stack_trace, uuid

More

Packages that depend on sentry

Back