Deprecated enable_tracing option in Python docs. (#12439)

Author: antonpirker

docs/platforms/python/configuration/options.mdx

@@ -332,6 +332,8 @@ sentry_sdk.init(
 
 <ConfigKey name="enable-tracing">
 
+_Deprecated in version 2.21.0._
+
 A boolean value, if true, transactions and trace data will be generated and captured. This will set the `traces-sample-rate` to the recommended default of 1.0 if `traces-sample-rate` is not defined. Note that `traces-sample-rate` and `traces-sampler` take precedence over this option.
 
 </ConfigKey>
@@ -342,7 +344,7 @@ A number between 0 and 1, controlling the percentage chance a given transaction
 
 If <PlatformIdentifier name="traces-sample-rate" /> is 0, this means that no new traces will be created. However, if you have another service (for example a JS frontend) that makes requests to your service that include trace information, those traces will be continued and thus transactions will be sent to Sentry.
 
-If you want to disable all tracing you need to set <PlatformIdentifier name="traces-sample-rate" />`=None` or set <PlatformIdentifier name="enable-tracing" />`=False`. In this case, no new traces will be started and no incoming traces will be continued.
+If you want to disable all tracing you need to set <PlatformIdentifier name="traces-sample-rate" />`=None`. In this case, no new traces will be started and no incoming traces will be continued.
 
 </ConfigKey>
 

docs/platforms/python/integrations/django/index.mdx

@@ -93,7 +93,7 @@ The following parts of your Django project are monitored:
 
 <Alert>
 
-The parameter `enable_tracing` needs to be set when initializing the Sentry SDK for performance measurements to be recorded.
+The parameter [traces_sample_rate](/platforms/python/configuration/options/#traces-sample-rate) needs to be set when initializing the Sentry SDK for performance measurements to be recorded.
 
 </Alert>
 

docs/platforms/python/integrations/fastapi/index.mdx

@@ -63,7 +63,7 @@ The following parts of your FastAPI project are monitored:
 
 <Alert>
 
-The parameter `enable_tracing` needs to be set when initializing the Sentry SDK for performance measurements to be recorded.
+The parameter [traces_sample_rate](/platforms/python/configuration/options/#traces-sample-rate) needs to be set when initializing the Sentry SDK for performance measurements to be recorded.
 
 </Alert>
 

docs/platforms/python/integrations/starlette/index.mdx

@@ -45,7 +45,7 @@ It takes a couple of moments for the data to appear in [sentry.io](https://sentr
 
 - Request data is attached to all events: **HTTP method, URL, headers, form data, JSON payloads**. Sentry excludes raw bodies and multipart file uploads. Sentry also excludes personally identifiable information (such as user ids, usernames, cookies, authorization headers, IP addresses) unless you set `send_default_pii` to `True`.
 
-- If `enable_tracing` or a `traces_sample_rate` is set, then performance information is also reported, which you can see on the **Performance** page of [sentry.io](https://sentry.io).
+- If [traces_sample_rate](/platforms/python/configuration/options/#traces-sample-rate) is set, then performance information is also reported, which you can see on the **Performance** page of [sentry.io](https://sentry.io).
 
 ## Options
 

platform-includes/configuration/config-intro/python.mdx

@@ -8,7 +8,9 @@ sentry_sdk.init(
     dsn="___PUBLIC_DSN___",
     max_breadcrumbs=50,
     debug=True,
-    enable_tracing=True,
+    # Set traces_sample_rate to 1.0 to capture 100%
+    # of transactions for tracing.
+    tracees_sample_rate=1.0,
 
     # By default the SDK will try to use the SENTRY_RELEASE
     # environment variable, or infer a git commit

platform-includes/performance/opentelemetry-setup/python.mdx

@@ -6,9 +6,11 @@ import sentry_sdk
 
 sentry_sdk.init(
     dsn="___PUBLIC_DSN___",
-    enable_tracing=True,
+    # Set traces_sample_rate to 1.0 to capture 100%
+    # of transactions for tracing.
+    traces_sample_rate=1.0,
 
-    # set the instrumenter to use OpenTelemetry instead of Sentry
+    # Set the instrumenter to use OpenTelemetry instead of Sentry
     instrumenter="otel",
 )
 ```

public/_platforms/python/performance-onboarding-2-configure.json

@@ -5,5 +5,5 @@
     "name": "Python",
     "aliases": [],
     "categories": [],
-    "body": "<h4 id=\"configure\" style=\"position:relative;\">Configure</h4>\n<p>Configuration should happen as early as possible in your application's lifecycle.</p>\n<p>Once this is done, Sentry's Python SDK captures all unhandled exceptions and transactions. Note that enable_tracing is available in Sentry Python SDK <code>version ≥ 1.16.0</code>. To enable tracing in older SDK versions (≥ 0.11.2), use <code>traces_sample_rate=1.0</code>.</p>\n<div class=\"gatsby-highlight\" data-language=\"python\"><pre class=\"language-python highlight\"><code class=\"language-python\"><span class=\"token keyword\">import</span> sentry-sdk\n\nsentry_sdk<span class=\"token punctuation\">.</span><span class=\"token function\">init</span><span class=\"token punctuation\">(</span>\n  <span class=\"token literal-property property\">dsn</span><span class=\"token operator\">:</span> <span class=\"token string\">\"___PUBLIC_DSN___\"</span><span class=\"token punctuation\">,</span>\n  <span class=\"token literal-property property\">enable_tracing=True,</span>\n<span class=\"token punctuation\">)</span></code></pre></div>\n<p>Learn more about tracing <a href=\"https://docs.sentry.io/platforms/python/configuration/options/#tracing-options\">options,</a> how to use the <a href=\"https://docs.sentry.io/platforms/python/configuration/sampling/\">traces_sampler</a> function, or how to <a href=\"https://docs.sentry.io/platforms/python/configuration/sampling/\">sample transactions</a>.</p>"
+    "body": "<h4 id=\"configure\" style=\"position:relative;\">Configure</h4>\n<p>Configuration should happen as early as possible in your application's lifecycle.</p>\n<p>Once this is done, Sentry's Python SDK captures all unhandled exceptions and transactions. </p>\n<div class=\"gatsby-highlight\" data-language=\"python\"><pre class=\"language-python highlight\"><code class=\"language-python\"><span class=\"token keyword\">import</span> sentry-sdk\n\nsentry_sdk<span class=\"token punctuation\">.</span><span class=\"token function\">init</span><span class=\"token punctuation\">(</span>\n  <span class=\"token literal-property property\">dsn</span><span class=\"token operator\">:</span> <span class=\"token string\">\"___PUBLIC_DSN___\"</span><span class=\"token punctuation\">,</span>\n  <span class=\"token literal-property property\">traces_sample_rate=1.0,</span>\n<span class=\"token punctuation\">)</span></code></pre></div>\n<p>Learn more about tracing <a href=\"https://docs.sentry.io/platforms/python/configuration/options/#tracing-options\">options,</a> how to use the <a href=\"https://docs.sentry.io/platforms/python/configuration/sampling/\">traces_sampler</a> function, or how to <a href=\"https://docs.sentry.io/platforms/python/configuration/sampling/\">sample transactions</a>.</p>"
 }