ref: Deprecate enableTracing

CHANGELOG.md

@@ -8,6 +8,16 @@
 
 - "You miss 100 percent of the chances you don't take. — Wayne Gretzky" — Michael Scott
 
+### Important Changes
+
+- **ref: Deprecate `enableTracing` (12897)**
+
+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 wan't to disable performance monitoring, remove the `tracesSampler` option and set the
+`tracesSampleRate` to `0` or `undefined`.
+
 Work in this release was contributed by @GitSquared. Thank you for your contribution!
 
 ## 8.17.0

packages/types/src/options.ts

@@ -89,9 +89,13 @@ export interface ClientOptions<TO extends BaseTransportOptions = BaseTransportOp
   tracesSampleRate?: number;
 
   /**
-   * If this is enabled, transactions and trace data will be generated and captured.
+   * If this is enabled, spans and trace data will be generated and captured.
    * This will set the `tracesSampleRate` to the recommended default of `1.0` if `tracesSampleRate` is undefined.
    * Note that `tracesSampleRate` and `tracesSampler` take precedence over this option.
+   *
+   * @deprecated This option is deprecated and will be removed in the next major version. If you want to enable performance monitoring, please set the `tracesSampleRate` or
+   * `tracesSampler` options instead. If you wan't to disable performance monitoring, remove the `tracesSampler` option
+   * and set the `tracesSampleRate` to `0` or `undefined`.
    */
   enableTracing?: boolean;