La instrumentación automática de Datadog depende de la API de perfilado de .NET CLR. Esta API permite solo un suscriptor (por ejemplo, el rastreador .NET de Datadog con el perfilador habilitado). Para garantizar la máxima visibilidad, ejecute solo una solución de APM dentro de su entorno de aplicación.

Además, si está utilizando la integración de Azure Native, puede usar el recurso de Datadog en Azure para agregar la extensión a sus aplicaciones .NET. Para obtener instrucciones, consulte la sección de extensión de App Service de la guía de integración de Azure Native de Datadog.

El soporte para aplicaciones web Java está en versión preliminar para la extensión v2.4+.

No hay implicaciones de facturación para la traza de aplicaciones web Java durante este período.

Localmente

Instale la CLI de Datadog

npm install -g @datadog/datadog-ci @datadog/datadog-ci-plugin-aas

Instale la CLI de Azure y autentíquese con az login.

Luego, ejecute el siguiente comando para configurar el contenedor sidecar:

export DD_API_KEY=<DATADOG_API_KEY>
export DD_SITE=<DATADOG_SITE>
datadog-ci aas instrument -s <subscription-id> -g <resource-group-name> -n <app-service-name>

Establezca su sitio de Datadog en . Se establece de forma predeterminada en datadoghq.com.

La CLI de Datadog inferirá automáticamente el entorno de ejecución de su aplicación e instalará la aplicación correspondiente. Si esto falla por cualquier motivo, puede anular este comportamiento especificando un tiempo de ejecución con la bandera --windows-runtime.

Se pueden usar flags adicionales, como --service y --env, para establecer las etiquetas de servicio y entorno. Para obtener una lista completa de opciones, ejecute datadog-ci aas instrument --help.

datadog-ci aas instrument solo necesita ejecutarse una vez para configurar la instrumentación. No necesita volver a ejecutarlo en cada implementación de código, solo vuelva a ejecutarlo para cambiar su configuración de Datadog.

Azure Cloud Shell

Para usar la CLI de Datadog en Azure Cloud Shell, abra un cloud shell, establezca su clave de API y sitio en las variables de entorno DD_API_KEY y DD_SITE, y use npx para ejecutar la CLI directamente:

export DD_API_KEY=<DATADOG_API_KEY>
export DD_SITE=<DATADOG_SITE>
npx @datadog/datadog-ci aas instrument -s <subscription-id> -g <resource-group-name> -n <app-service-name>

El módulo de Terraform de Datadog para aplicaciones web de Windows envuelve el recurso azurerm_windows_web_app y configura automáticamente su aplicación web para Datadog Serverless Monitoring agregando las variables de entorno requeridas y la extensión de aplicación web de Windows para su tiempo de ejecución.

Si aún no tiene configurado Terraform, instale Terraform, cree un nuevo directorio y cree un archivo llamado main.tf.

Luego, agregue lo siguiente a su configuración de Terraform, actualizándolo según sea necesario según sus necesidades:

variable "datadog_api_key" {
  description = "Your Datadog API key"
  type        = string
  sensitive   = true
}

provider "azurerm" {
  features {}
  subscription_id = "00000000-0000-0000-0000-000000000000" // Replace with your subscription ID
}

resource "azurerm_service_plan" "my_asp" {
  name                = "my-app-service-plan" // Replace with your app service plan name
  resource_group_name = "my-resource-group"   // Replace with your resource group
  os_type             = "Windows"
  location            = "eastus"
  sku_name            = "P1v2"
}

module "my_web_app" {
  source  = "DataDog/web-app-datadog/azurerm//modules/windows"
  version = "~> 1.0"

  name                = "my-web-app"        // Replace with your web app name
  resource_group_name = "my-resource-group" // Replace with your resource group
  service_plan_id     = azurerm_service_plan.my_asp.id
  location            = "eastus"

  datadog_api_key = var.datadog_api_key
  datadog_service = "my-service" // Replace with your service name
  datadog_env     = "prod"       // Replace with your environment (e.g. prod, staging)
  datadog_version = "0.0.0"      // Replace with your application version

  site_config = {
    application_stack = {
      node_version = "~22" // change for your specific runtime
    }
  }
  app_settings = {
    DD_TRACE_ENABLED = "true" // Example setting
  }
}

Finalmente, ejecute terraform apply y siga las instrucciones.

El módulo de Datadog para aplicaciones web de Windows solo implementa el recurso y la extensión de la aplicación web, por lo que debe implementar su código por separado.

Actualice su aplicación web existente para incluir la configuración de la aplicación Datadog necesaria y la extensión, de la siguiente manera:

// Version: 1.0.0
@secure()
param datadogApiKey string

resource webApp 'Microsoft.Web/sites@2025-03-01' = {
  // ...
  properties: {
    // ...
    siteConfig: {
      // ...
      appSettings: [
        //... Your existing app settings
        { name: 'DD_API_KEY', value: datadogApiKey }
        { name: 'DD_SITE', value: 'datadoghq.com' }  // Replace with your Datadog site
        { name: 'DD_SERVICE', value: 'my-service' }  // Replace with your service name
        { name: 'DD_ENV', value: 'prod' }            // Replace with your environment (e.g. prod, staging)
        { name: 'DD_VERSION', value: '0.0.0' }       // Replace with your application version
        // Add any additional options here
      ]
    }
  }
}

resource datadogExtension 'Microsoft.Web/sites/siteextensions@2025-03-01' = {
  parent: webApp
  // Uncomment the extension for your runtime:
  // name: 'Datadog.AzureAppServices.Node.Apm'
  // name: 'Datadog.AzureAppServices.DotNet'
  // name: 'Datadog.AzureAppServices.Java.Apm'
}

Implemente su plantilla actualizada:

az deployment group create --resource-group <RESOURCE GROUP> --template-file <TEMPLATE FILE>

Nota: Deberá detener e iniciar la aplicación manualmente (o mediante un script); de lo contrario, la traza automática no funcionará. Para las actualizaciones, debe asegurarse de que la aplicación esté detenida antes de implementar la plantilla y que se inicie nuevamente una vez finalizada la implementación.

Consulte la pestaña Manual para ver las descripciones de todas las variables de entorno.

Actualice su aplicación web existente para incluir la configuración de la aplicación Datadog necesaria y el sidecar, de la siguiente manera:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": { "version": "1.0.0" },
  "parameters": {
    "webAppName": {
      "type": "string"
    },
    // ...
    "datadogApiKey": {
      "type": "securestring"
    }
  },
  "resources": {
    "webApp": {
      "type": "Microsoft.Web/sites",
      "apiVersion": "2025-03-01",
      "name": "[parameters('webAppName')]",
      // ...
      "properties": {
        // ...
        "siteConfig": {
          // ...
          "appSettings": [
            //... Your existing app settings
            { "name": "DD_API_KEY", "value": "[parameters('datadogApiKey')]" },
            { "name": "DD_SITE", "value": "datadoghq.com" }, // Replace with your Datadog site
            { "name": "DD_SERVICE", "value": "my-service" }, // Replace with your service name
            { "name": "DD_ENV", "value": "prod" },           // Replace with your environment (e.g. prod, staging)
            { "name": "DD_VERSION", "value": "0.0.0" },      // Replace with your application version
            // Add any additional options here
          ]
        }
      }
    },
    "datadogExtension": {
      "type": "Microsoft.Web/sites/siteextensions",
      "apiVersion": "2025-03-01",
      // Uncomment the extension for your runtime:
      // "name": "[concat(parameters('webAppName'), '/Datadog.AzureAppServices.Node.Apm')]"
      // "name": "[concat(parameters('webAppName'), '/Datadog.AzureAppServices.DotNet')]"
      // "name": "[concat(parameters('webAppName'), '/Datadog.AzureAppServices.Java.Apm')]"
    }
  }
}

Implemente su plantilla actualizada:

az deployment group create --resource-group <RESOURCE GROUP> --template-file <TEMPLATE FILE>

Nota: Deberá detener e iniciar la aplicación manualmente (o mediante un script); de lo contrario, la traza automática no funcionará. Para las actualizaciones, debe asegurarse de que la aplicación esté detenida antes de implementar la plantilla y que se inicie nuevamente una vez finalizada la implementación.

Consulte la pestaña Manual para ver las descripciones de todas las variables de entorno.

1. En su Azure Portal, navegue al panel de la aplicación de Azure que desea instrumentar con Datadog.

2. Configure la siguiente configuración de la aplicación:

   Variables de entorno requeridas

   DD_API_KEY

   Valor: Su clave de Datadog API.
   Consulte Organization Settings > API Keys en Datadog.
   

   DD_SITE

   Valor: Su sitio de Datadog
   Su sitio de Datadog. Se establece de forma predeterminada en datadoghq.com.
   

   Unified Service Tagging

   Datadog recomienda etiquetar su aplicación con las etiquetas env, service y version para el unified service tagging.

   DD_SERVICE

   Valor: El nombre del servicio de su aplicación.
   

   DD_ENV

   Valor: El nombre del entorno de su aplicación.
   No hay un valor predeterminado para este campo.
   

   DD_VERSION

   Valor: La versión de su aplicación.
   No hay un valor predeterminado para este campo.
   

   Variables de entorno adicionales

   DD_LOGS_INJECTION

   Valor: true (recomendado)
   Habilita la correlación de registros de traza al inyectar IDs de traza en los registros de su aplicación.
   Esto le permite correlacionar registros con traza en la interfaz de usuario de Datadog.
   

3. Haga clic en Save. Esto reinicia su aplicación.

4. Detenga su aplicación haciendo clic en Stop.

   Usted debe detener su aplicación para instalar Datadog correctamente.

5. En su Portal de Azure, navegue a la página Extensions y seleccione la extensión de Datadog APM.

6. Acepte los términos legales, haga clic en OK y espere a que se complete la instalación.

   Este paso requiere que su aplicación esté en un estado detenido.

7. Inicie la aplicación principal, haga clic en Start:

8. Verifique que la extensión esté instalada y en ejecución comprobando la página Extensions en su Portal de Azure.

1. Add the DogStatsD NuGet package to your Visual Studio project.
2. Initialize DogStatsD and write custom metrics in your application.
3. Deploy your code to Azure App Service.
4. If you have not already, install the Datadog App Service extension.

To send metrics, use this code:

// Configure your DogStatsd client and configure any tags
if (!DogStatsd.Configure(new StatsdConfig() { ConstantTags = new[] { "app:sample.mvc.aspnetcore" } }))
{
    // `Configure` returns false if the necessary environment variables are not present.
    // These environment variables are present in Azure App Service, but
    // need to be set in order to test your custom metrics: DD_API_KEY:{api_key}, DD_AGENT_HOST:localhost
    // Ignore or log the error as it suits you
    Console.WriteLine("Cannot initialize DogstatsD.");
}

// Send a metric
DogStatsd.Increment("sample.startup");

1. Agregue el cliente de DogStatsD a su proyecto.
2. Inicialice DogStatsD y escriba métricas personalizadas en su aplicación.
3. Implemente su código en una aplicación web de Azure compatible.
4. Si aún no lo ha hecho, instale la extensión de Datadog App Service.

Para enviar métricas, use este código:

// Configure your DogStatsd client and configure any tags
StatsDClient client = new NonBlockingStatsDClientBuilder()
                            .constantTags("app:sample.service")
                            .build();
// Send a metric
client.Increment("sample.startup");

1. Inicialice DogStatsD y escriba métricas personalizadas en su aplicación.
2. Implemente su código en una Azure Web App compatible.
3. Si aún no lo ha hecho, instale la extensión de Node.js de Azure App Service de Datadog.

Para enviar métricas, use este código:

const tracer = require('dd-trace');
tracer.init();

tracer.dogstatsd.increment('example_metric.increment', 1, { environment: 'dev' });
tracer.dogstatsd.decrement('example_metric.decrement', 1, { environment: 'dev' });

You can send logs from your application in Azure App Service to Datadog in one of the following ways:

• Use the installation steps on this page to enable APM with the Datadog APM extension. Then enable Agentless logging.
• Use Agentless logging with the Serilog sink.

Both methods allow trace ID injection, making it possible to connect logs and traces in Datadog. To enable trace ID injection with the extension, add the application setting DD_LOGS_INJECTION:true.

El envío de registros desde su aplicación en Azure App Service a Datadog requiere transmitir los registros a Datadog directamente desde su aplicación. El envío de registros con este método permite la inyección de ID de traza, lo que hace posible conectar registros y trazas en Datadog.

El envío de registros desde su aplicación en Azure App Service a Datadog requiere transmitir los registros a Datadog directamente desde su aplicación. El envío de registros con este método permite la inyección de ID de traza, lo que hace posible conectar registros y trazas en Datadog.

Ejemplo de código: Registro nativo de Microsoft

Un ejemplo de cómo configurar el registro en una aplicación .NET usando Microsoft.Extensions.Logging:

using Microsoft.Extensions.Logging;

public class WeatherForecastController : ControllerBase
{
    private readonly ILogger<WeatherForecastController> _logger;

    public WeatherForecastController(ILogger<WeatherForecastController> logger)
    {
        _logger = logger;
    }

    [HttpGet]
    public IActionResult Get()
    {
        _logger.LogInformation("Processing weather forecast request");

        // Your business logic here
        var forecast = GetWeatherForecast();

        _logger.LogInformation("Weather forecast retrieved for user: {UserId}", userId);

        return Ok(forecast);
    }
}

Configuración de Program.cs

using Microsoft.Extensions.Logging;

var builder = WebApplication.CreateBuilder(args);

// Configure logging
builder.Logging.ClearProviders();
builder.Logging.AddConsole();
builder.Logging.AddDebug();

// Add structured logging with JSON format
builder.Logging.AddJsonConsole(options =>
{
    options.JsonWriterOptions = new JsonWriterOptions
    {
        Indented = true
    };
});

var app = builder.Build();
// ... rest of your application configuration

configuración de appsettings.json

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    },
    "Console": {
      "FormatterName": "json",
      "FormatterOptions": {
        "IncludeScopes": true,
        "TimestampFormat": "yyyy-MM-dd HH:mm:ss "
      }
    }
  }
}

Esta configuración incluye automáticamente la correlación de traza cuando DD_LOGS_INJECTION=true se establece en la Configuración de la aplicación de Azure App Service.

Consulte [Stream logs directly to the Agent][1] para configurar el registro de aplicaciones para Java en Azure App Service.

[1]: /logs/log_collection/java/ stream-logs-directly-to-the-agent

Para configurar el registro de aplicaciones para Node.js en Azure App Service, consulte Agentless logging with Node.js.

Datadog proporciona scripts para actualizar o instalar la extensión de Azure App Service mediante PowerShell. La administración de extensiones mediante scripts le permite actualizar extensiones de forma masiva por grupo de recursos y designar la instalación de versiones específicas de la extensión de sitio. También puede usar scripts para agregar la extensión mediante programación en canalizaciones de CI/CD, así como para descubrir y actualizar extensiones que ya están instaladas.

Requisitos previos

• La CLI de Azure o Azure Cloud Shell.
• Azure App Servicecredenciales de ámbito de usuario. Si aún no tiene credenciales, vaya a su portal de Azure y acceda a su Web App o Function App. Navegue a Deployment > Deployment Center para crear o recuperar sus credenciales de ámbito de usuario.

Instalación de la extensión por primera vez

El script de instalación agrega la versión más reciente de la extensión a una Azure Web App o Azure Function App. Esto ocurre por aplicación, en lugar de a nivel de grupo de recursos.

1. Abra Azure CLI o Azure Cloud Shell.

2. Descargue el script de instalación mediante el siguiente comando:

   Invoke-WebRequest -Uri "https://raw.githubusercontent.com/DataDog/datadog-aas-extension/master/management-scripts/extension/install-latest-extension.ps1" -OutFile "install-latest-extension.ps1"
   

3. Ejecute el siguiente comando, pasando los argumentos obligatorios y opcionales según sea necesario.

   .\install-latest-extension.ps1 -Username <USERNAME> -Password <PASSWORD> -SubscriptionId <SUBSCRIPTION_ID> -ResourceGroup <RESOURCE_GROUP_NAME> -SiteName <SITE_NAME> -DDApiKey <DATADOG_API_KEY> -DDSite <DATADOG_SITE> -DDEnv <DATADOG_ENV> -DDService <DATADOG_SERVICE> -DDVersion <DATADOG_VERSION> [-SlotName <SLOT_NAME>]
   

Nota: Los siguientes argumentos son obligatorios para el comando anterior:

• <USERNAME>: Su nombre de usuario de contexto de usuario de Azure.
• <PASSWORD>: Su contraseña de contexto de usuario de Azure.
• <SUBSCRIPTION_ID>: Su ID de suscripción de Azure.
• <RESOURCE_GROUP_NAME>: El nombre de su grupo de recursos de Azure.
• <SITE_NAME>: El nombre de su aplicación.
• <DATADOG_API_KEY>: Su clave de Datadog API.

Además, establezca DATADOG_SITE en su sitio de Datadog. DATADOG_SITE se establece de forma predeterminada en datadoghq.com. Su sitio es: .

Para apuntar a una ranura de implementación en lugar de a la aplicación principal, agregue -SlotName <SLOT_NAME>. En Azure Function Apps, esto también aplica automáticamente la configuración de ranura fija WEBSITE_PRIVATE_EXTENSIONS=0 para evitar errores de instalación de la extensión. Consulte Azure Functions .NET APM Extension para obtener más detalles.

Actualización de la extensión para un grupo de recursos

El script de actualización se aplica a todo un grupo de recursos. Este script actualiza todas las Web Apps o Function Apps que tengan la extensión instalada. Las aplicaciones de App Service que no tienen instalada la extensión de Datadog no se ven afectadas.

1. Abra Azure CLI o Azure Cloud Shell.

2. Descargue el script de actualización mediante el siguiente comando:

   $baseUri="https://raw.githubusercontent.com/DataDog/datadog-aas-extension/master/management-scripts/extension"; Invoke-WebRequest -Uri "$baseUri/update-all-site-extensions.ps1" -OutFile "update-all-site-extensions.ps1"; Invoke-WebRequest -Uri "$baseUri/install-latest-extension.ps1" -OutFile "install-latest-extension.ps1"
   

3. Ejecute el siguiente comando. Todos los argumentos son obligatorios.

   .\update-all-site-extensions.ps1 -SubscriptionId <SUBSCRIPTION_ID> -ResourceGroup <RESOURCE_GROUP_NAME> -Username <USERNAME> -Password <PASSWORD>
   

Instale una versión específica de la extensión

La interfaz de usuario de Azure App Service no admite la capacidad de instalar una versión específica de una extensión. Puede hacerlo con el script de instalación o actualización.

Instalar una versión específica en un solo recurso

Para instalar una versión específica en una sola instancia, siga las instrucciones para instalar la extensión por primera vez y agregue el parámetro -ExtensionVersion al comando de instalación.

.\install-latest-extension.ps1 -Username <USERNAME> -Password <PASSWORD> -SubscriptionId <SUBSCRIPTION_ID> -ResourceGroup <RESOURCE_GROUP_NAME> -SiteName <SITE_NAME> -DDApiKey <DATADOG_API_KEY> -ExtensionVersion <EXTENSION_VERSION>

Reemplace <EXTENSION_VERSION> con la versión de la extensión que desea instalar. Por ejemplo, 1.4.0.

Instalar una versión específica en todo un grupo de recursos

Para instalar una versión específica para un grupo de recursos, siga las instrucciones para actualizar la extensión para un grupo de recursos y agregue el parámetro -ExtensionVersion al comando de instalación.

.\update-all-site-extensions.ps1 -SubscriptionId <SUBSCRIPTION_ID> -ResourceGroup <RESOURCE_GROUP_NAME> -Username <USERNAME> -Password <PASSWORD> -ExtensionVersion <EXTENSION_VERSION>

Reemplace <EXTENSION_VERSION> con la versión de la extensión que desea instalar. Por ejemplo, 1.4.0.

Plantilla ARM

Muchas organizaciones utilizan plantillas de Azure Resource Management (ARM) para implementar la práctica de infraestructura como código. Para integrar la extensión de App Service en estas plantillas, incorpore plantillas de instalación de la extensión de App Service de Datadog en sus implementaciones para agregar la extensión y configurarla junto con sus recursos de App Service.