Merge branch 'master' into fix/flutter-replay

Author: vaind

docs/concepts/migration/index.mdx

@@ -7,7 +7,7 @@ description: "Learn more about the reasons to move to Sentry's SaaS solution, wh
 Sentry offers a cloud-hosted, software-as-a-service (SaaS) solution in addition to a self-hosted solution, which are both functionally the same. However, many customers find that self-hosted Sentry can quickly become expensive to maintain, scale, and support, making our SaaS product the better and less costly option. To facilitate moving from self-hosted to SaaS, we provide a self-serve process known as "relocation".
 
 <Alert>
-Check out this video on [**Migrating to Sentry SaaS**](https://sentry.io/resources/migrate-to-sentry-saas-workshop/) to learn about our relocation tooling.
+Check out this video on <a href="https://sentry.io/resources/migrate-to-sentry-saas-workshop/" className="plausible-event-name=migrating+to+saas+video">**Migrating to Sentry SaaS**</a> to learn about our relocation tooling.
 </Alert>
 
 For additional reading on considering SaaS, take a look at:

docs/organization/integrations/index.mdx

@@ -16,6 +16,7 @@ For more details, see the [full Integration Platform documentation](/organizatio
 
 | Integration                                                              | Issue alerts | Metric alerts | Link Unfurling |
 | ------------------------------------------------------------------------ | ------------ | ------------- | -------------- |
+| [All Quiet](https://docs.allquiet.app/integrations/inbound/sentry)               | X            |               |                |
 | [Blar](/organization/integrations/notification-incidents/blar/)               | X            |               |                |
 | [Datadog](https://docs.datadoghq.com/integrations/sentry/)               | X            |               |                |
 | [Microsoft Teams](/organization/integrations/notification-incidents/msteams/) | X            | X             |                |

docs/organization/integrations/notification-incidents/index.mdx

@@ -4,6 +4,7 @@ sidebar_order: 20
 description: "Learn more about Sentry's notification and incidents integrations."
 ---
 
+- [All Quiet](https://docs.allquiet.app/integrations/inbound/sentry)
 - [Blar](/organization/integrations/notification-incidents/blar/)
 - [Datadog](https://docs.datadoghq.com/integrations/sentry/)
 - [Microsoft Teams](/organization/integrations/notification-incidents/msteams/)

docs/platforms/dart/configuration/releases.mdx

@@ -57,3 +57,14 @@ Setting the release name tags each event with that release name. We recommend th
 If you don't tell Sentry about a new release, Sentry will automatically create a release entity in the system the first time it sees an event with that release ID.
 
 After configuring your SDK, you can install a repository integration or manually supply Sentry with your own commit metadata. Read our documentation about [setting up releases](/product/releases/setup/) for further information about integrations, associating commits, and telling Sentry when deploying releases.
+
+## Release Health
+
+<Note>
+
+Looking for Flutter release health? [See the Flutter documentation](/platforms/flutter/configuration/releases/#release-health).
+
+</Note>
+
+Monitoring release health is currently not supported for pure Dart applications.
+

docs/platforms/dart/index.mdx

@@ -68,7 +68,7 @@ Verify that your app is sending events to Sentry by adding the following snippet
 import 'package:sentry/sentry.dart';
 
 try {
-  aMethodThatMightFail();
+  throw Exception('Sentry Test Error');
 } catch (exception, stackTrace) {
   await Sentry.captureException(
     exception,

docs/platforms/flutter/configuration/options.mdx

@@ -151,6 +151,7 @@ This option can be overridden using <PlatformIdentifier name="in-app-include" />
 <ConfigKey name="attach-screenshot">
 
 Takes a screenshot of the application when an error happens and includes it as an attachment.
+Enable this option by setting <PlatformIdentifier name="attach-screenshot" /> to `true` and wrapping your root widget with `SentryWidget(child: MyApp())`.
 Learn more about enriching events with screenshots in our <PlatformLink to="/enriching-events/screenshots/">Screenshots documentation</PlatformLink>.
 
 </ConfigKey>

docs/platforms/flutter/configuration/releases.mdx

@@ -62,14 +62,14 @@ After configuring your SDK, you can install a repository integration or manually
 
 Monitor the [health of releases](/product/releases/health/) by observing user adoption, usage of the application, percentage of [crashes](/product/releases/health/#crash), and [session data](/product/releases/health/#session). Release health will provide insight into the impact of crashes and bugs as it relates to user experience, and reveal trends with each new issue through the [Release Details](/product/releases/release-details/) graphs and filters.
 
+In order to monitor release health, the SDK sends session data.
+
 <Note>
 
-Crash reporting and app hang detection are not available for watchOS.
+Release health in Flutter is only available for Android, iOS, and macOS.
 
 </Note>
 
-In order to monitor release health, the SDK sends session data.
-
 ### Sessions
 
 A session represents the interaction between the user and the application. Sessions contain a timestamp, a status (if the session was OK or if it crashed), and are always linked to a release. Most Sentry SDKs can manage sessions automatically.

docs/platforms/flutter/enriching-events/screenshots/index.mdx

@@ -9,7 +9,7 @@ This feature is only available for SDKs with a user interface, like the ones for
 
 ## Enabling Screenshots
 
-Because screenshots may contain <PlatformLink to="/data-management/sensitive-data/">PII</PlatformLink>, they are an opt-in feature. You can enable screenshots as shown below:
+Because screenshots may contain <PlatformLink to="/data-management/sensitive-data/">PII</PlatformLink>, they are an opt-in feature.
 
 <PlatformContent includePath="enriching-events/attach-screenshots" />
 

docs/platforms/flutter/integrations/routing-instrumentation.mdx

@@ -30,7 +30,7 @@ Before starting, ensure:
 
 Add an instance of `SentryNavigationObserver` to your application's `navigatorObservers`.
 
-```dart {tabTitle: Flutter Routing}
+```dart {8} {tabTitle: Flutter Routing}
 import 'package:flutter/material.dart';
 import 'package:sentry_flutter/sentry_flutter.dart';
 
@@ -43,7 +43,7 @@ return MaterialApp(
 );
 ```
 
-```dart {tabTitle: GoRouter}
+```dart {6} {tabTitle: GoRouter}
 import 'package:go_router/go_router.dart';
 import 'package:sentry_flutter/sentry_flutter.dart';
 
@@ -62,21 +62,15 @@ For transactions to be created when navigation changes, you need to provide rout
 - Flutter routing: use `RouteSettings` and set the name in the constructor.
 - GoRouter: use the `name` parameter to set the route name.
 
-```dart {tabTitle: Flutter Routing}
-import 'package:flutter/material.dart';
-import 'package:sentry_flutter/sentry_flutter.dart';
-
+```dart {4} {tabTitle: Flutter Routing}
 /// Setting the route name is required
 MaterialPageRoute(
   builder: (BuildContext context) => MyWidget(),
   settings: RouteSettings(name: 'My Widget'),
 )
 ```
 
-```dart {tabTitle: GoRouter}
-import 'package:go_router/go_router.dart';
-import 'package:sentry_flutter/sentry_flutter.dart';
-
+```dart {13} {tabTitle: GoRouter}
 final GoRouter _router = GoRouter(
   observers: [SentryNavigatorObserver()],
   routes: <RouteBase>[
@@ -110,8 +104,6 @@ There are two ways to set up TTID:
 The default setup is enabled automatically, but only provides an approximation of TTID. To set a more accurate TTID, manually wrap the desired widget with `SentryDisplayWidget`, as shown below:
 
 ```dart
-import 'package:sentry_flutter/sentry_flutter.dart';
-
 SentryDisplayWidget(
   child: MyWidget(),
 )
@@ -129,23 +121,17 @@ TTFD is disabled by default. To enable TTFD measurements, follow these steps:
 
 1. Enable the `enableTimeToFullDisplayTracing` option in the SDK configuration:
 
-```dart
-import 'package:flutter/widgets.dart';
-import 'package:sentry_flutter/sentry_flutter.dart';
-
-Future<void> main() async {
-  await SentryFlutter.init(
-    (options) => options.enableTimeToFullDisplayTracing = true,
-    appRunner: () => runApp(MyApp()),
-  );
-}
+```dart {3}
+await SentryFlutter.init(
+  (options) {
+    options.enableTimeToFullDisplayTracing = true;
+  }, appRunner: () => runApp(MyApp()),
+);
 ```
 
 2. Report the span manually:
 
 ```dart
-import 'package:sentry_flutter/sentry_flutter.dart';
-
 SentryFlutter.reportFullyDisplayed();
 ```
 
@@ -231,9 +217,6 @@ Log into [sentry.io](https://sentry.io) and open your project's performance page
 Adjust the duration before a routing transaction automatically finishes. The default is 3 seconds.
 
 ```dart
-import 'package:sentry_flutter/sentry_flutter.dart';
-
-/// Change how long navigation transactions idle before being finished
 SentryNavigatorObserver(
   autoFinishAfter: Duration(seconds: 5)
 )
@@ -251,9 +234,6 @@ Set `enableAutoTransactions` to `false` if you only want to track navigation bre
 Enabled by default.
 
 ```dart
-import 'package:sentry_flutter/sentry_flutter.dart';
-
-/// Only track navigation breadcrumbs
 SentryNavigatorObserver(
   enableAutoTransactions: false,
 )
@@ -265,9 +245,6 @@ Set `ignoreRoutes` if you want routes to be ignored and not processed by the nav
 Empty by default.
 
 ```dart
-import 'package:sentry_flutter/sentry_flutter.dart';
-
-/// Ignore matching routes
 SentryNavigatorObserver(
   ignoreRoutes: ["/ignoreThisRoute", "/my/ignored/route"],
 )
@@ -280,9 +257,6 @@ An existing transaction in the scope 'CustomTransaction' will be renamed to 'MyW
 Disabled by default.
 
 ```dart
-import 'package:sentry_flutter/sentry_flutter.dart';
-
-/// Override transaction name with route name
 SentryNavigatorObserver(
   setRouteNameAsTransaction: true,
 )

docs/platforms/flutter/session-replay/index.mdx

@@ -60,8 +60,22 @@ Sampling starts as soon as a session begins. The `sessionSampleRate` is then eva
 
 ## Privacy
 
-The SDK is recording and aggressively redacting (masking) all text and images, according to the configuration in `options.experimental.replay`.
-You can tune this and add custom masking rules to fit your needs. For example, you can explicitly mask or unmask widgets by type,
+The SDK is recording and aggressively redacting (masking) all `Text`, `EditableText`, and `Image` widgets.
+Masking in the Sentry Flutter SDK is based on Widget *types*, e.g. `Image`, not the string representation of the type (i.e. we check whether
+a `widgetInstance` should be masked by checking `if (widgetInstance is Image)` instead of `if (widgetInstance.runtimeType == 'Image')`).
+This means we can ensure masking works regardless of obfuscation in release builds and also works for subclasses.
+However, it also means we can only automatically mask widgets that are part of the Flutter SDK itself.
+
+<Alert level="warning">
+We cannot mask widgets defined in various 3rd-party packages (because the type is not known in the Sentry Flutter SDK),
+even though many should be masked.
+
+Therefore, you need to consider the widgets your application uses and ensure they're masked correctly with custom masking rules.
+Examples of widgets that usually should be masked include (but are not limited to): VideoPlayer, WebView, Chart, etc.
+</Alert>
+
+You can tune this and add custom masking rules to fit your needs by adjusting the configuration in `options.experimental.replay`.
+For example, you can explicitly mask or unmask widgets by type,
 or you can even have a callback to decide whether a specific widget instance should be masked:
 
 ```dart