add IsGlobalModeEnabled docs for dotnet (#5531)

Author: SimonCropp

src/platform-includes/configuration/config-intro/dotnet.mdx

@@ -9,6 +9,8 @@ using (SentrySdk.Init(o =>
     o.Dsn = "___PUBLIC_DSN___";
     o.MaxBreadcrumbs = 50;
     o.Debug = true;
+    // Enable Global Mode if running in a client app
+    o.IsGlobalModeEnabled = true;
 })
 {
     // app code here
@@ -22,6 +24,8 @@ use __ = SentrySdk.Init(fun o ->
     o.Dsn <- "___PUBLIC_DSN___"
     o.MaxBreadcrumbs <- 50
     o.Debug <- true
+    // Enable Global Mode if running in a client app
+    o.IsGlobalModeEnabled <- true
   )
 
 // app code here

src/platform-includes/getting-started-config/dotnet.mdx

@@ -1,15 +1,17 @@
 For example, initialize in the `Main` method in `Program.cs`:
 
 ```csharp {filename:Program.cs}
-using (SentrySdk.Init(o => 
+using (SentrySdk.Init(o =>
 {
     // Tells which project in Sentry to send events to:
     o.Dsn = "___PUBLIC_DSN___";
     // When configuring for the first time, to see what the SDK is doing:
     o.Debug = true;
     // Set traces_sample_rate to 1.0 to capture 100% of transactions for performance monitoring.
     // We recommend adjusting this value in production.
-    o.TracesSampleRate = 1.0; 
+    o.TracesSampleRate = 1.0;
+    // Enable Global Mode if running in a client app
+    o.IsGlobalModeEnabled = true;
 }))
 {
     // App code goes here - Disposing will flush events out
@@ -24,6 +26,8 @@ use __ = SentrySdk.Init (fun o ->
     // Set traces_sample_rate to 1.0 to capture 100% of transactions for performance monitoring.
     // We recommend adjusting this value in production.
     o.TracesSampleRate <- 1.0
+    // Enable Global Mode if running in a client app
+    o.IsGlobalModeEnabled <- true
     )
 
 // App code goes here - Disposing will flush events out

src/platforms/common/configuration/options.mdx

@@ -41,6 +41,21 @@ Changing this value will affect issue grouping. Since the frame significantly ch
 
 </ConfigKey>
 
+<ConfigKey name="is-global-mode-enabled" supported={["dotnet"]}>
+
+Specifies whether to use global scope management mode. Should be `true` for client applications and `false` for server applications.
+
+Example scenarios where it should be explicitly set to true:
+
+ * Universal Windows platform (UWP) applications
+ * WinForms applications
+ * Windows Presentation Foundation (WPF) applications
+ * Single user console applications
+
+Defaults to `false`, unless in Blazor WASM, MAUI, Unity, or Xamarin where the default is `true`.
+
+</ConfigKey>
+
 <ConfigKey name="database-path" supported={["native"]}>
 
 Allows you to specify a path to the local event- and crash-database of the Native SDK. This path will default to `.sentry-native` relative to the current working directory (`CWD`). While this is a convenient setting for development, we strongly urge you to provide an explicit database path for our production deployments. In many deployment scenarios, the path relative to the `CWD` will not be writable. For this reason, you should store the database in your application's user-specific data/cache directory (e.g., under `%AppData%\Local` on Windows, `~/Library/Application Support` on macOS, or `XDG_CACHE_HOME` on Linux).

src/platforms/dotnet/guides/uwp/index.mdx

@@ -32,11 +32,18 @@ sealed partial class App : Application
         {
             // Tells which project in Sentry to send events to:
             o.Dsn = "___PUBLIC_DSN___";
+
             // When configuring for the first time, to see what the SDK is doing:
             o.Debug = true;
+
             // Set traces_sample_rate to 1.0 to capture 100% of transactions for performance monitoring.
             // We recommend adjusting this value in production.
             o.TracesSampleRate = 1.0;
+
+            // Enable Global Mode since this is a client app
+            o.IsGlobalModeEnabled = true;
+
+            //TODO: any other options you need go here
         });
         Current.UnhandledException += ExceptionHandler;
     }

src/platforms/dotnet/guides/winforms/index.mdx

@@ -45,8 +45,20 @@ namespace WindowsFormsApp1
             // Configure the options for Sentry
             var sentryOptions = new SentryOptions
             {
-                Dsn = "___PUBLIC_DSN___",
-                // any other options you need go here
+                // Tells which project in Sentry to send events to:
+                o.Dsn = "___PUBLIC_DSN___",
+
+                // When configuring for the first time, to see what the SDK is doing:
+                o.Debug = true,
+
+                // Set traces_sample_rate to 1.0 to capture 100% of transactions for performance monitoring.
+                // We recommend adjusting this value in production.
+                o.TracesSampleRate = 1.0,
+
+                // Enable Global Mode since this is a client app
+                o.IsGlobalModeEnabled = true,
+
+                //TODO: any other options you need go here
             };
 
             // Initialize Sentry and run the main form of the application
@@ -61,7 +73,7 @@ namespace WindowsFormsApp1
 
 ### Visual Basic Initialization
 
-Windows Forms applications written in VB have two different intialization options.  Pick one of them (not both).
+Windows Forms applications written in VB have two different initialization options.  Pick one of them (not both).
 
 #### Option 1
 
@@ -97,6 +109,10 @@ Module Program
         Dim sentryOptions = New SentryOptions With
         {
             .Dsn = "___PUBLIC_DSN___",
+
+            ' Enable Global Mode since this is a client app
+            .IsGlobalModeEnabled = True,
+
             ' any other options you need go here
         }
 
@@ -148,6 +164,10 @@ Namespace My
             Dim sentryOptions = New SentryOptions With
             {
                 .Dsn = "___PUBLIC_DSN___",
+
+                ' Enable Global Mode since this is a client app
+                .IsGlobalModeEnabled = True,
+
                 ' any other options you need go here
             }
 

src/platforms/dotnet/guides/wpf/index.mdx

@@ -26,6 +26,23 @@ public partial class App : Application
 {
     public App()
     {
+        SentrySdk.Init(o => 
+        {
+            // Tells which project in Sentry to send events to:
+            o.Dsn = "___PUBLIC_DSN___";
+
+            // When configuring for the first time, to see what the SDK is doing:
+            o.Debug = true;
+
+            // Set traces_sample_rate to 1.0 to capture 100% of transactions for performance monitoring.
+            // We recommend adjusting this value in production.
+            o.TracesSampleRate = 1.0;
+
+            // Enable Global Mode since this is a client app
+            o.IsGlobalModeEnabled = true;
+
+            //TODO: any other options you need go here
+        });
         DispatcherUnhandledException += App_DispatcherUnhandledException;
     }
 

src/wizard/dotnet/index.md

@@ -30,6 +30,8 @@ using (SentrySdk.Init(o =>
         // Set traces_sample_rate to 1.0 to capture 100% of transactions for performance monitoring.
         // We recommend adjusting this value in production.
         o.TracesSampleRate = 1.0;
+        // Enable Global Mode if running in a client app
+        o.IsGlobalModeEnabled = true;
     }))
 {
     // App code goes here. Dispose the SDK before exiting to flush events.