From fbcdaf4b8d94e71f9d939e0e9f2056eb79911711 Mon Sep 17 00:00:00 2001 From: Lucas Pimentel Date: Wed, 29 Oct 2025 13:44:11 -0400 Subject: [PATCH 1/3] Add decision trees to .NET Core and Framework APM docs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add "Before you begin" sections with environment-specific decision trees to help users quickly navigate to the correct setup guide for their deployment environment (AWS Lambda, Azure Functions, Azure App Service, Google Cloud Run, or traditional hosts). Key changes: - Add decision tree table at the top of both documents - Replace generic serverless alerts with urgent, specific warnings - .NET Framework version explicitly shows platform limitations (not supported on AWS Lambda, Linux, or Google Cloud Run) - Direct links to all serverless-specific setup guides This prevents users from following incorrect installation steps for serverless environments, which would result in broken instrumentation. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- .../dd_libraries/dotnet-core.md | 30 +++++++++++++++++-- .../dd_libraries/dotnet-framework.md | 29 ++++++++++++++++-- 2 files changed, 55 insertions(+), 4 deletions(-) diff --git a/content/en/tracing/trace_collection/automatic_instrumentation/dd_libraries/dotnet-core.md b/content/en/tracing/trace_collection/automatic_instrumentation/dd_libraries/dotnet-core.md index 41ef401c101e8..ab8caa7f53f3c 100644 --- a/content/en/tracing/trace_collection/automatic_instrumentation/dd_libraries/dotnet-core.md +++ b/content/en/tracing/trace_collection/automatic_instrumentation/dd_libraries/dotnet-core.md @@ -47,6 +47,24 @@ further_reading: text: "Source code" --- +## Before you begin + +Choose the setup guide for your deployment environment: + +| Environment | Setup Guide | +|------------|-------------| +| **AWS Lambda** | [Instrumenting .NET Serverless Applications on AWS Lambda](/serverless/aws_lambda/instrumentation/dotnet) | +| **Azure Functions** | [Install Serverless Monitoring for Azure Functions](/serverless/azure_functions/) | +| **Azure App Service (Windows)** | [Azure App Service - Windows Code](/serverless/azure_app_service/windows_code) | +| **Azure App Service (Linux - Code)** | [Azure App Service - Linux Code](/serverless/azure_app_service/linux_code) | +| **Azure App Service (Linux - Container)** | [Azure App Service - Linux Container](/serverless/azure_app_service/linux_container) | +| **Google Cloud Run** | [Google Cloud Run - .NET](/serverless/google_cloud_run/containers/in_container/dotnet) | +| **All other environments** | Continue with this guide ↓ | + +
+Important: Serverless environments require different installation steps than traditional hosts. Do not install the Datadog Agent or MSI installer for serverless environments. +
+ ## Compatibility requirements ### Supported .NET Core runtimes @@ -57,8 +75,16 @@ For a full list of Datadog's .NET Core library and processor architecture suppor ## Installation and getting started -
- To set up Datadog APM in Serverless environments, such as AWS Lambda or Azure Functions, see Serverless. +
+Are you deploying to a serverless environment?
+If you're using AWS Lambda, Azure Functions, Azure App Service, or Google Cloud Run, STOP and use the appropriate serverless setup guide instead: + +The installation instructions below will NOT work for serverless environments.
diff --git a/content/en/tracing/trace_collection/automatic_instrumentation/dd_libraries/dotnet-framework.md b/content/en/tracing/trace_collection/automatic_instrumentation/dd_libraries/dotnet-framework.md index f01811b060b9a..707ee45bc9929 100644 --- a/content/en/tracing/trace_collection/automatic_instrumentation/dd_libraries/dotnet-framework.md +++ b/content/en/tracing/trace_collection/automatic_instrumentation/dd_libraries/dotnet-framework.md @@ -51,6 +51,24 @@ further_reading: tag: "Source Code" text: "Source code" --- + +## Before you begin + +Choose the setup guide for your deployment environment: + +| Environment | Setup Guide | .NET Framework Support | +|------------|-------------|----------------------| +| **AWS Lambda** | N/A | ❌ Not supported - requires .NET Core 3.1+ or .NET 5+ | +| **Azure Functions** | [Install Serverless Monitoring for Azure Functions](/serverless/azure_functions/) | ✅ In-Process model only | +| **Azure App Service (Windows)** | [Azure App Service - Windows Code](/serverless/azure_app_service/windows_code) | ✅ Supported | +| **Azure App Service (Linux)** | N/A | ❌ Not supported - requires .NET Core/.NET 5+ | +| **Google Cloud Run** | N/A | ❌ Not supported - requires .NET Core/.NET 5+ | +| **All other environments** | Continue with this guide ↓ | ✅ Supported | + +
+Important: .NET Framework is only supported on Windows-based platforms. For Linux or AWS Lambda, use .NET Core or .NET 5+. +
+ ## Compatibility requirements ### Supported .NET Framework runtimes @@ -61,8 +79,15 @@ For a full list of Datadog's .NET Framework library and processor architecture s ## Installation and getting started -
- To set up Datadog APM in Serverless environments, such as AWS Lambda or Azure Functions, see Serverless. +
+Are you deploying to a serverless environment?
+If you're using Azure Functions or Azure App Service, STOP and use the appropriate serverless setup guide instead: + +The installation instructions below will NOT work for serverless environments.
+Note: .NET Framework is NOT supported on AWS Lambda, Azure App Service Linux, or Google Cloud Run. Use .NET Core or .NET 5+ for those platforms.
From 992e361140f3cfa7d46e1ef808c2a5e458d50ea6 Mon Sep 17 00:00:00 2001 From: Lucas Pimentel Date: Wed, 29 Oct 2025 16:55:42 -0400 Subject: [PATCH 2/3] Address PR review feedback on .NET decision trees MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Replace arrow symbols with "Continue below" for accessibility - Change "you're using" to "If using" for direct, imperative language - Soften "STOP" to "stop:" for more empathetic tone 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- .../automatic_instrumentation/dd_libraries/dotnet-core.md | 4 ++-- .../dd_libraries/dotnet-framework.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/content/en/tracing/trace_collection/automatic_instrumentation/dd_libraries/dotnet-core.md b/content/en/tracing/trace_collection/automatic_instrumentation/dd_libraries/dotnet-core.md index ab8caa7f53f3c..b9c5626922dea 100644 --- a/content/en/tracing/trace_collection/automatic_instrumentation/dd_libraries/dotnet-core.md +++ b/content/en/tracing/trace_collection/automatic_instrumentation/dd_libraries/dotnet-core.md @@ -59,7 +59,7 @@ Choose the setup guide for your deployment environment: | **Azure App Service (Linux - Code)** | [Azure App Service - Linux Code](/serverless/azure_app_service/linux_code) | | **Azure App Service (Linux - Container)** | [Azure App Service - Linux Container](/serverless/azure_app_service/linux_container) | | **Google Cloud Run** | [Google Cloud Run - .NET](/serverless/google_cloud_run/containers/in_container/dotnet) | -| **All other environments** | Continue with this guide ↓ | +| **All other environments** | Continue below |
Important: Serverless environments require different installation steps than traditional hosts. Do not install the Datadog Agent or MSI installer for serverless environments. @@ -77,7 +77,7 @@ For a full list of Datadog's .NET Core library and processor architecture suppor
Are you deploying to a serverless environment?
-If you're using AWS Lambda, Azure Functions, Azure App Service, or Google Cloud Run, STOP and use the appropriate serverless setup guide instead: +If using AWS Lambda, Azure Functions, Azure App Service, or Google Cloud Run, stop: use the appropriate serverless setup guide instead:
  • AWS Lambda .NET Setup
  • Azure Functions Setup
    • diff --git a/content/en/tracing/trace_collection/automatic_instrumentation/dd_libraries/dotnet-framework.md b/content/en/tracing/trace_collection/automatic_instrumentation/dd_libraries/dotnet-framework.md index 707ee45bc9929..a3ff75d9d0b04 100644 --- a/content/en/tracing/trace_collection/automatic_instrumentation/dd_libraries/dotnet-framework.md +++ b/content/en/tracing/trace_collection/automatic_instrumentation/dd_libraries/dotnet-framework.md @@ -63,7 +63,7 @@ Choose the setup guide for your deployment environment: | **Azure App Service (Windows)** | [Azure App Service - Windows Code](/serverless/azure_app_service/windows_code) | ✅ Supported | | **Azure App Service (Linux)** | N/A | ❌ Not supported - requires .NET Core/.NET 5+ | | **Google Cloud Run** | N/A | ❌ Not supported - requires .NET Core/.NET 5+ | -| **All other environments** | Continue with this guide ↓ | ✅ Supported | +| **All other environments** | Continue below | ✅ Supported |
    Important: .NET Framework is only supported on Windows-based platforms. For Linux or AWS Lambda, use .NET Core or .NET 5+. @@ -81,7 +81,7 @@ For a full list of Datadog's .NET Framework library and processor architecture s
    Are you deploying to a serverless environment?
    -If you're using Azure Functions or Azure App Service, STOP and use the appropriate serverless setup guide instead: +If using Azure Functions or Azure App Service, stop: use the appropriate serverless setup guide instead:
    • Azure Functions Setup (In-Process model only)
    • Azure App Service - Windows Setup
      • From ac0037357d7099f478cc455cd6f69de3c6f2380d Mon Sep 17 00:00:00 2001 From: Lucas Pimentel Date: Wed, 29 Oct 2025 22:38:27 -0400 Subject: [PATCH 3/3] Remove "Before you begin" decision tree sections from .NET docs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude --- .../dd_libraries/dotnet-core.md | 30 ++----------------- .../dd_libraries/dotnet-framework.md | 29 ++---------------- 2 files changed, 4 insertions(+), 55 deletions(-) diff --git a/content/en/tracing/trace_collection/automatic_instrumentation/dd_libraries/dotnet-core.md b/content/en/tracing/trace_collection/automatic_instrumentation/dd_libraries/dotnet-core.md index b9c5626922dea..41ef401c101e8 100644 --- a/content/en/tracing/trace_collection/automatic_instrumentation/dd_libraries/dotnet-core.md +++ b/content/en/tracing/trace_collection/automatic_instrumentation/dd_libraries/dotnet-core.md @@ -47,24 +47,6 @@ further_reading: text: "Source code" --- -## Before you begin - -Choose the setup guide for your deployment environment: - -| Environment | Setup Guide | -|------------|-------------| -| **AWS Lambda** | [Instrumenting .NET Serverless Applications on AWS Lambda](/serverless/aws_lambda/instrumentation/dotnet) | -| **Azure Functions** | [Install Serverless Monitoring for Azure Functions](/serverless/azure_functions/) | -| **Azure App Service (Windows)** | [Azure App Service - Windows Code](/serverless/azure_app_service/windows_code) | -| **Azure App Service (Linux - Code)** | [Azure App Service - Linux Code](/serverless/azure_app_service/linux_code) | -| **Azure App Service (Linux - Container)** | [Azure App Service - Linux Container](/serverless/azure_app_service/linux_container) | -| **Google Cloud Run** | [Google Cloud Run - .NET](/serverless/google_cloud_run/containers/in_container/dotnet) | -| **All other environments** | Continue below | - -
      -Important: Serverless environments require different installation steps than traditional hosts. Do not install the Datadog Agent or MSI installer for serverless environments. -
      - ## Compatibility requirements ### Supported .NET Core runtimes @@ -75,16 +57,8 @@ For a full list of Datadog's .NET Core library and processor architecture suppor ## Installation and getting started -
      -Are you deploying to a serverless environment?
      -If using AWS Lambda, Azure Functions, Azure App Service, or Google Cloud Run, stop: use the appropriate serverless setup guide instead: - -The installation instructions below will NOT work for serverless environments. +
      + To set up Datadog APM in Serverless environments, such as AWS Lambda or Azure Functions, see Serverless.
      diff --git a/content/en/tracing/trace_collection/automatic_instrumentation/dd_libraries/dotnet-framework.md b/content/en/tracing/trace_collection/automatic_instrumentation/dd_libraries/dotnet-framework.md index a3ff75d9d0b04..f01811b060b9a 100644 --- a/content/en/tracing/trace_collection/automatic_instrumentation/dd_libraries/dotnet-framework.md +++ b/content/en/tracing/trace_collection/automatic_instrumentation/dd_libraries/dotnet-framework.md @@ -51,24 +51,6 @@ further_reading: tag: "Source Code" text: "Source code" --- - -## Before you begin - -Choose the setup guide for your deployment environment: - -| Environment | Setup Guide | .NET Framework Support | -|------------|-------------|----------------------| -| **AWS Lambda** | N/A | ❌ Not supported - requires .NET Core 3.1+ or .NET 5+ | -| **Azure Functions** | [Install Serverless Monitoring for Azure Functions](/serverless/azure_functions/) | ✅ In-Process model only | -| **Azure App Service (Windows)** | [Azure App Service - Windows Code](/serverless/azure_app_service/windows_code) | ✅ Supported | -| **Azure App Service (Linux)** | N/A | ❌ Not supported - requires .NET Core/.NET 5+ | -| **Google Cloud Run** | N/A | ❌ Not supported - requires .NET Core/.NET 5+ | -| **All other environments** | Continue below | ✅ Supported | - -
      -Important: .NET Framework is only supported on Windows-based platforms. For Linux or AWS Lambda, use .NET Core or .NET 5+. -
      - ## Compatibility requirements ### Supported .NET Framework runtimes @@ -79,15 +61,8 @@ For a full list of Datadog's .NET Framework library and processor architecture s ## Installation and getting started -
      -Are you deploying to a serverless environment?
      -If using Azure Functions or Azure App Service, stop: use the appropriate serverless setup guide instead: - -The installation instructions below will NOT work for serverless environments.
      -Note: .NET Framework is NOT supported on AWS Lambda, Azure App Service Linux, or Google Cloud Run. Use .NET Core or .NET 5+ for those platforms. +
      + To set up Datadog APM in Serverless environments, such as AWS Lambda or Azure Functions, see Serverless.