Merge branch 'master' of github.com:getsentry/sentry-docs into smi/quick-start/react-manual-tracing

Author: inventarSarah

develop-docs/backend/application-domains/options.mdx

@@ -69,15 +69,13 @@ If you expect to frequently update your option, you can make it editable in the
 If you're working on a system-wide feature, you may choose to use options for your rollout instead of feature flags. Unlike feature flags, options don't allow for easy segmentation, but they are performant, stable, and simple to implement. e.g.,
 
 ```python
-import random
-from sentry import options
+from sentry.options.rollout import in_random_rollout
 
-rate = options.get("performance.some-feature-rate")
-if rate > random.random():
+if in_random_rollout("performance.some-feature-rate"):
     do_feature_stuff()
 ```
 
-However, be careful! Using `random.random` will cause your feature to be enabled and disabled randomly between page requests. This may be unacceptable for user-facing features. To avoid this, you can use the `sample_modulo` helper. e.g.,
+However, be careful! `in_random_rollout` uses `random.random` under the hood, and will cause your feature to be enabled and disabled randomly between page requests. This may be unacceptable for user-facing features. To avoid this, you can use the `sample_modulo` helper. e.g.,
 
 ```python
 from sentry.utils.options import sample_modulo

docs/concepts/key-terms/tracing/span-metrics.mdx

@@ -20,22 +20,17 @@ By attaching attributes directly to spans, you create a unified view of both the
 // Simple database query with dynamic attributes
 Sentry.startSpan(
   {
-    name: 'Database Query',
-    op: 'db.query'
+    name: "Database Query",
+    op: "db.query",
   },
-  () => {
-    // Get active span to set attributes as data becomes available
-    const span = Sentry.getActiveSpan();
-    
+  (span) => {
     // Execute query and add results to span
-    const result = executeQuery('SELECT * FROM users WHERE active = true');
-    
+    const result = executeQuery("SELECT * FROM users WHERE active = true");
+
     // Set attributes with the results data
-    if (span) {
-      span.setAttribute('db.rows_returned', result.length);
-      span.setAttribute('db.execution_time_ms', result.executionTime);
-    }
-    
+    span.setAttribute("db.rows_returned", result.length);
+    span.setAttribute("db.execution_time_ms", result.executionTime);
+
     return result;
   }
 );
@@ -55,14 +50,14 @@ By integrating these attributes into tracing, you can maintain a single telemetr
 // Adding business context to a payment processing span
 Sentry.startSpan(
   {
-    name: 'Process Payment',
-    op: 'payment.process',
+    name: "Process Payment",
+    op: "payment.process",
     attributes: {
-      'payment.amount': 99.99,
-      'payment.currency': 'USD',
-      'payment.method': 'credit_card',
-      'customer.type': 'returning'
-    }
+      "payment.amount": 99.99,
+      "payment.currency": "USD",
+      "payment.method": "credit_card",
+      "customer.type": "returning",
+    },
   },
   async () => {
     // Payment processing implementation
@@ -91,12 +86,12 @@ Augment automatically-created or manually-defined spans with additional attribut
 const span = Sentry.getActiveSpan();
 if (span) {
   // User context
-  span.setAttribute('user.subscription_tier', 'premium');
-  
+  span.setAttribute("user.subscription_tier", "premium");
+
   // Multiple metrics in a single operation
   span.setAttributes({
-    'memory.heap_used': 1024000,
-    'processing.total_steps': 5
+    "memory.heap_used": 1024000,
+    "processing.total_steps": 5,
   });
 }
 ```
@@ -109,16 +104,16 @@ Create spans specifically for grouping related attributes or metrics, particular
 // Creating a span for monitoring external API usage
 Sentry.startSpan(
   {
-    name: 'Third-Party API Usage',
-    op: 'external.api',
+    name: "Third-Party API Usage",
+    op: "external.api",
     attributes: {
       // Performance metrics
-      'api.response_time_ms': 245,
-      
+      "api.response_time_ms": 245,
+
       // Context data
-      'feature.using_api': 'image_recognition',
-      'user.plan': 'enterprise'
-    }
+      "feature.using_api": "image_recognition",
+      "user.plan": "enterprise",
+    },
   },
   async () => {
     // API call implementation
@@ -138,15 +133,15 @@ Monitor client-side performance metrics related to user experience:
 // UI performance monitoring
 Sentry.startSpan(
   {
-    name: 'Page Interaction',
-    op: 'ui.interaction',
+    name: "Page Interaction",
+    op: "ui.interaction",
     attributes: {
-      'ui.first_input_delay_ms': 24,
-      'ui.time_to_interactive_ms': 320,
-      'ui.frames_dropped': 0,
-      'user.device_type': 'mobile',
-      'feature.being_used': 'image_carousel'
-    }
+      "ui.first_input_delay_ms": 24,
+      "ui.time_to_interactive_ms": 320,
+      "ui.frames_dropped": 0,
+      "user.device_type": "mobile",
+      "feature.being_used": "image_carousel",
+    },
   },
   async () => {
     // UI interaction handling
@@ -162,17 +157,17 @@ Track database performance characteristics and their impact on application behav
 // Database query monitoring
 Sentry.startSpan(
   {
-    name: 'Product Search Query',
-    op: 'db.query',
+    name: "Product Search Query",
+    op: "db.query",
     attributes: {
-      'db.query_type': 'SELECT',
-      'db.table': 'products',
-      'db.execution_time_ms': 145,
-      'db.rows_returned': 87,
-      'db.index_used': 'product_category_idx',
-      'business.search_term': 'winter jacket',
-      'business.search_filters_applied': 3
-    }
+      "db.query_type": "SELECT",
+      "db.table": "products",
+      "db.execution_time_ms": 145,
+      "db.rows_returned": 87,
+      "db.index_used": "product_category_idx",
+      "business.search_term": "winter jacket",
+      "business.search_filters_applied": 3,
+    },
   },
   async () => {
     // Database query execution
@@ -188,21 +183,21 @@ Monitor file handling operations across your application stack:
 // File processing monitoring
 Sentry.startSpan(
   {
-    name: 'Process Uploaded Image',
-    op: 'file.process',
+    name: "Process Uploaded Image",
+    op: "file.process",
     attributes: {
       // Technical metrics
-      'file.size_bytes': 2500000,
-      'file.type': 'image/jpeg',
-      
+      "file.size_bytes": 2500000,
+      "file.type": "image/jpeg",
+
       // Processing metrics
-      'processing.steps_completed': ['virus_scan', 'resize', 'compress'],
-      'processing.total_time_ms': 850,
-      
+      "processing.steps_completed": ["virus_scan", "resize", "compress"],
+      "processing.total_time_ms": 850,
+
       // Context data
-      'feature.using_upload': 'user_avatar',
-      'subscription.allows_hd': true
-    }
+      "feature.using_upload": "user_avatar",
+      "subscription.allows_hd": true,
+    },
   },
   async () => {
     // Image processing implementation
@@ -218,21 +213,21 @@ Monitor performance and reliability of third-party service interactions:
 // Payment gateway monitoring
 Sentry.startSpan(
   {
-    name: 'Payment Gateway',
-    op: 'payment.gateway',
+    name: "Payment Gateway",
+    op: "payment.gateway",
     attributes: {
       // Performance metrics
-      'gateway.response_time_ms': 980,
-      'gateway.retry_count': 0,
-      
+      "gateway.response_time_ms": 980,
+      "gateway.retry_count": 0,
+
       // Transaction data
-      'order.total_amount': 159.99,
-      'order.items_count': 3,
-      
+      "order.total_amount": 159.99,
+      "order.items_count": 3,
+
       // Service metrics
-      'gateway.fee_amount': 4.50,
-      'gateway.fee_percent': 0.029
-    }
+      "gateway.fee_amount": 4.5,
+      "gateway.fee_percent": 0.029,
+    },
   },
   async () => {
     // Payment gateway integration
@@ -255,6 +250,7 @@ Maintain consistent naming patterns following the format `category.metric_name`
 #### Data Type Selection
 
 Choose appropriate data types for your metrics:
+
 - Numeric values for measurements (`response_time_ms`: 250)
 - Boolean values for state indicators (`cache.hit`: true)
 - String values for categorical data (`user.subscription`: 'premium')
@@ -263,6 +259,7 @@ Choose appropriate data types for your metrics:
 #### Performance Considerations
 
 Be mindful of the performance impact of collecting metrics, especially for high-volume operations:
+
 - Consider implementing sampling for high-frequency operations
 - Prioritize metrics with the highest analytical value
 - Avoid redundant or closely correlated metrics
@@ -276,6 +273,7 @@ If you're currently using Sentry's standalone Metrics product, migrating to span
 - **Improved correlation**: Direct association between attributes, traces, and errors
 
 Migration process:
+
 1. Identify your current metric instrumentation points
 2. Locate corresponding spans in your application
 3. Transfer your metrics to span attributes

docs/organization/membership/index.mdx

@@ -118,9 +118,6 @@ Projects can only be accessed by that project's team(s). Team Admins, Org Manage
 Any Org Member can get access to a project by joining the team that's associated with that project. Once you've joined a project you'll also be able to edit [ownership rules](/product/issues/ownership-rules/) for that project.
 
 ### Adding New Members
-<Alert>
-This feature is currently only available for [Early Adopters](/organization/early-adopter-features/).
-</Alert>
 
 Users with Manager and Owner-level permissions can add, remove, and change members for a project or organization. They can also toggle on the "Let Members Invite Others" setting to allow any org member to freely invite anyone they like without needing org owner or manager approval.
 

docs/platforms/dotnet/common/configuration/options.mdx

@@ -49,9 +49,13 @@ Example scenarios where it should be explicitly set to true:
 
 Defaults to `false`, unless in Blazor WASM, MAUI, Unity, or Xamarin where the default is `true`.
 
-In server applications, when Global Mode is **disabled**, data stored in the scope is only available in the context of the particular request in which it is created.
+When Global Mode is **disabled** data stored in the scope is set on the current [ExecutionContext](https://learn.microsoft.com/en-us/dotnet/api/system.threading.executioncontext).
+In server applications data stored in the scope is only available in the context of the particular request in which it is created.
+Broadly, the ExecutionContext passes to child tasks and threads, but not to parent tasks and threads.
 
-For UI applications (like MAUI) when Global mode is **enabled**, a single scope stack is shared by the whole application.
+When Global Mode is **enabled**, a single scope stack is shared by the whole application.
+
+Since version 5.0.0 the transaction is always set on the current ExecutionContext, regardless of the Global Mode, so that spans from the UI don't get mixed up with transactions in background services.
 
 See the <PlatformLink to="/enriching-events/scopes/">Scopes and Hubs documentation</PlatformLink> for more information.
 

docs/platforms/javascript/common/apis.mdx

@@ -86,8 +86,13 @@ Sentry.setTag("tag", "value");
     },
   ]}
 >
-  Flushes all pending events and disables the SDK. Note that this does not
-  remove any listeners the SDK may have set up.
+Flushes all pending events and disables the SDK. Note that this does not
+remove any listeners the SDK may have set up. After a call to `close`, the current client cannot be used anymore. It's
+important to only call `close` immediately before shutting down the application.
+
+Alternatively, the [`flush`](#flush) method drains the event queue while keeping the
+client enabled for continued use.
+
 </SdkApi>
 
 <SdkApi

docs/platforms/javascript/common/configuration/draining.mdx

@@ -176,9 +176,8 @@ Learn more about <PlatformLink to="/configuration/sampling/">configuring the sam
 
 ## Filtering Spans
 
-Available since JavaScript SDK version `8.2.0`.
-
 Use the <PlatformIdentifier name="before-send-span" /> configuration option which allows you to provide a function to modify a span.
 This function is called for the root span and all child spans. If you want to drop the root span, including its child spans, use [`beforeSendTransaction`](#using-beforesendtransaction) instead.
+Please note that you cannot use `beforeSendSpan` to drop a span, you can only modify it and filter data on it.
 
 <PlatformContent includePath="configuration/before-send-span" />

docs/platforms/javascript/common/configuration/filtering.mdx

@@ -6,18 +6,20 @@ sidebar_order: 30
 
 Sentry's tracing functionality helps you monitor application performance by capturing distributed traces, attaching attributes, and span performance across your application. However, Capturing traces for every transaction can generate significant volumes of data. Sampling allows you to control the amount of spans that are sent to Sentry from your application.
 
-## Sampling Configuration Options
-
 The JavaScript SDK provides two main options for controlling the sampling rate:
 
-1. Uniform Sample Rate (`tracesSampleRate`)
+1. [Uniform Sample Rate](#uniform-sample-rate-tracessamplerate) (recommended)
+2. [Sampling Function](#sampling-function-tracessampler)
+
+## Uniform Sample Rate (`tracesSampleRate`)
+
 `tracesSampleRate` is floating point value 0.0 and 1.0, which controls the probability that a transaction will be sampled.
 
 <PlatformContent includePath="/tracing/sample-rate" />
 
 With `tracesSampleRate` set to `0.25`, each transaction in your application is randomly sampled with a probability of 25%, so you can expect that one in every four transactions will be sent to Sentry.
 
-### Sampling Function (`tracesSampler`)
+## Sampling Function (`tracesSampler`)
 
 For more granular control, you provide a `tracesSampler` function. This approach allows you to:
 
@@ -36,16 +38,16 @@ When the `tracesSampler` function is called, it receives a `samplingContext` obj
 interface SamplingContext {
   // Name of the span/transaction
   name: string;
-  
+
   // Initial attributes of the span/transaction
   attributes: SpanAttributes | undefined;
-  
+
   // Whether the parent span was sampled (undefined if no incoming trace)
   parentSampled: boolean | undefined;
-  
+
   // Sample rate from incoming trace (undefined if no incoming trace)
   parentSampleRate: number | undefined;
-  
+
   // Utility function to inherit parent decision or fallback
   inheritOrSampleWith: (fallbackRate: number) => number;
 }
@@ -125,7 +127,7 @@ tracesSampler: (samplingContext) => {
 
 When multiple sampling mechanisms could apply, Sentry follows this order of precedence:
 
-- If `tracesSampler` is defined, its decision is used. Although the `tracesSampler` can override the parent sampling decision, most users will want to ensure their `tracesSampler` respects the parent sampling decision. 
+- If `tracesSampler` is defined, its decision is used. Although the `tracesSampler` can override the parent sampling decision, most users will want to ensure their `tracesSampler` respects the parent sampling decision.
 - If no `tracesSampler` is defined, but there is a parent sampling decision from an incoming distributed trace, we use the parent sampling decision
 - If neither of the above, `tracesSampleRate` is used
 - If `tracesSampleRate` is set to 0, no spans will be sampled, and no downstream spans will be sampled either since they inherit the parent sampling decision
@@ -134,4 +136,3 @@ When multiple sampling mechanisms could apply, Sentry follows this order of prec
 ## Conclusion
 
 Effective sampling is key to getting the most value from Sentry's performance monitoring while minimizing overhead. The `tracesSampler` function gives you precise control over which transactions to record, allowing you to focus on the most important parts of your application.
-