From 4e83a5dee0dbd3a2dbc84188a18b7d97199d206e Mon Sep 17 00:00:00 2001 From: Emmett Butler Date: Wed, 19 Nov 2025 08:37:48 -0800 Subject: [PATCH 1/2] add 4.0 upgrade section --- docs/upgrading.rst | 20 +++++++++++++++++++- 1 file changed, 19 insertions(+), 1 deletion(-) diff --git a/docs/upgrading.rst b/docs/upgrading.rst index be4e41dfc86..ccbfc56cb40 100644 --- a/docs/upgrading.rst +++ b/docs/upgrading.rst @@ -95,4 +95,22 @@ Use the following patterns to identify the deprecated environment variables in a Legacy tracing interfaces ^^^^^^^^^^^^^^^^^^^^^^^^^ -Reference the [3.0 release note](https://github.com/DataDog/dd-trace-py/releases/tag/v3.0.0) to identify and update deprecated interfaces in ddtrace products. \ No newline at end of file +Reference the [3.0 release note](https://github.com/DataDog/dd-trace-py/releases/tag/v3.0.0) to identify and update deprecated interfaces in ddtrace products. + + +Upgrade to 4.0 +************** + +Environment variables +^^^^^^^^^^^^^^^^^^^^^ + +Use the following patterns to identify the deprecated environment variables in a code base. These configurations will not be supported in v3.0. Refer to the migration guide below for next steps:: + +```bash +git grep -P -e "DD_DYNAMIC_INSTRUMENTATION_UPLOAD_FLUSH_INTERVAL" \ +-e "DD_EXCEPTION_DEBUGGING_ENABLED" \ +-e "DD_PROFILING_STACK_V2_ENABLED" \ +-e "DEFAULT_RUNTIME_METRICS_INTERVAL" +``` + +Reference the [4.0 release note](https://github.com/DataDog/dd-trace-py/releases/tag/v4.0.0) to identify and update deprecated interfaces in ddtrace products. From 79f2c407d32aa63636264c76e9e638afb2643326 Mon Sep 17 00:00:00 2001 From: Emmett Butler Date: Wed, 19 Nov 2025 08:49:24 -0800 Subject: [PATCH 2/2] formatting --- docs/upgrading.rst | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/docs/upgrading.rst b/docs/upgrading.rst index ccbfc56cb40..9c0be93b488 100644 --- a/docs/upgrading.rst +++ b/docs/upgrading.rst @@ -106,11 +106,9 @@ Environment variables Use the following patterns to identify the deprecated environment variables in a code base. These configurations will not be supported in v3.0. Refer to the migration guide below for next steps:: -```bash -git grep -P -e "DD_DYNAMIC_INSTRUMENTATION_UPLOAD_FLUSH_INTERVAL" \ --e "DD_EXCEPTION_DEBUGGING_ENABLED" \ --e "DD_PROFILING_STACK_V2_ENABLED" \ --e "DEFAULT_RUNTIME_METRICS_INTERVAL" -``` + git grep -P -e "DD_DYNAMIC_INSTRUMENTATION_UPLOAD_FLUSH_INTERVAL" \ + -e "DD_EXCEPTION_DEBUGGING_ENABLED" \ + -e "DD_PROFILING_STACK_V2_ENABLED" \ + -e "DEFAULT_RUNTIME_METRICS_INTERVAL" Reference the [4.0 release note](https://github.com/DataDog/dd-trace-py/releases/tag/v4.0.0) to identify and update deprecated interfaces in ddtrace products.